From b7765a95a05a548c55c841b889eb83a2b9790321 Mon Sep 17 00:00:00 2001
From: Dmitri Melikyan <dmelikyan@users.noreply.github.com>
Date: Thu, 23 Feb 2023 16:33:00 +0100
Subject: [PATCH] docs: add Graphsignal ecosystem page (#1228)

Adds a Graphsignal ecosystem page
---
 docs/ecosystem/graphsignal.md | 38 +++++++++++++++++++++++++++++++++++
 1 file changed, 38 insertions(+)
 create mode 100644 docs/ecosystem/graphsignal.md

diff --git a/docs/ecosystem/graphsignal.md b/docs/ecosystem/graphsignal.md
new file mode 100644
index 0000000000..2666f59ce3
--- /dev/null
+++ b/docs/ecosystem/graphsignal.md
@@ -0,0 +1,38 @@
+# Graphsignal
+
+This page covers how to use the Graphsignal to trace and monitor LangChain.
+
+## Installation and Setup
+
+- Install the Python library with `pip install graphsignal`
+- Create free Graphsignal account [here](https://graphsignal.com)
+- Get an API key and set it as an environment variable (`GRAPHSIGNAL_API_KEY`)
+
+## Tracing and Monitoring
+
+Graphsignal automatically instruments and starts tracing and monitoring chains. Traces, metrics and errors are then available in your [Graphsignal dashboard](https://app.graphsignal.com/). No prompts or other sensitive data are sent to Graphsignal cloud, only statistics and metadata.
+
+Initialize the tracer by providing a deployment name:
+
+```python
+import graphsignal
+
+graphsignal.configure(deployment='my-langchain-app-prod')
+```
+
+In order to trace full runs and see a breakdown by chains and tools, you can wrap the calling routine or use a decorator:
+
+```python
+with graphsignal.start_trace('my-chain'):
+    chain.run("some initial text")
+```
+
+Optionally, enable profiling to record function-level statistics for each trace.
+
+```python
+with graphsignal.start_trace(
+        'my-chain', options=graphsignal.TraceOptions(enable_profiling=True)):
+    chain.run("some initial text")
+```
+
+See the [Quick Start](https://graphsignal.com/docs/guides/quick-start/) guide for complete setup instructions.