> ## Documentation Index
> Fetch the complete documentation index at: https://docs.langchain.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Graphsignal integrations

> Integrate with Graphsignal using LangChain Python.

This page covers how to use [Graphsignal](https://app.graphsignal.com) to trace and monitor LangChain. Graphsignal enables full visibility into your application. It provides latency breakdowns by chains and tools, exceptions with full context, data monitoring, compute/GPU utilization, OpenAI cost analytics, and more.

## Installation and setup

* Install the Python library with `pip install graphsignal`
* Create a free [Graphsignal account](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 and metrics are then available in your [Graphsignal dashboards](https://app.graphsignal.com).

Initialize the tracer by providing a deployment name:

```python theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
import graphsignal

graphsignal.configure(deployment='my-langchain-app-prod')
```

To additionally trace any function or code, you can use a decorator or a context manager:

```python theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
@graphsignal.trace_function
def handle_request():
    chain.run("some initial text")
```

```python theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
with graphsignal.start_trace('my-chain'):
    chain.run("some initial text")
```

Optionally, enable profiling to record function-level statistics for each trace.

```python theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
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.

***

<div className="source-links">
  <Callout icon="terminal-2">
    [Connect these docs](/use-these-docs) to Claude, VSCode, and more via MCP for real-time answers.
  </Callout>

  <Callout icon="edit">
    [Edit this page on GitHub](https://github.com/langchain-ai/docs/edit/main/src/oss/python/integrations/providers/graphsignal.mdx) or [file an issue](https://github.com/langchain-ai/docs/issues/new/choose).
  </Callout>
</div>