# OTEL_EXPORTER_OTLP_TRACES_HEADERS="signoz-ingestion-key=<your-ingestion-key>"
```

To get your SigNoz API key:

1. Open SigNoz at `http://localhost:3080`
2. Navigate to Settings → Account Settings → API Keys → New Key
3. Create a new API key or copy an existing one.
   * Choose any role (Admin, Editor, or Viewer) - Viewer is sufficient for observability
   * Set the expiration field to "No Expiry" to prevent the key from expiring

### Step 4: Verify Setup

1. Restart your Inkeep agents:

   ```bash
   pnpm dev
   ```

2. Make some requests to your agents to generate traces

3. Open SigNoz at `http://localhost:3080` and navigate to the "Traces" section to see your agent traces

## Viewing Traces and Using the Live Debugger

Once SigNoz is set up, you can access traces and live debugging in two ways:

### 1. Visual Builder Traces Interface

If you're using the Visual Builder:

1. Open your agent project in the Visual Builder
2. Navigate to the **Traces** section
3. You'll see real-time traces of your agent executions
4. Click on any trace to see detailed execution flow and timing

The traces overview shows conversation metrics and recent activity:

<Image src="/images/trace-overview.png" alt="Traces overview dashboard showing conversation metrics and recent activity" />

Click on any conversation to see detailed execution flow:

<Image src="/images/trace-detail.png" alt="Detailed conversation trace showing step-by-step execution and timing" />

<>
  ### Copy Trace for Debugging

  The `Copy Trace` button in the timeline view allows you to export the entire conversation trace as JSON. This is particularly useful for offline analysis and debugging complex flows.

  <Image src="/images/copy-trace.png" alt="Copy Trace button in the timeline view for exporting conversation traces" />

  #### What's Included in the Trace Export

  When you click `Copy Trace`, the system exports a JSON object containing:

  ```json
  {
    "metadata": {
      "conversationId": "unique-conversation-id",
      "traceId": "distributed-trace-id",
      "agentId": "agent-identifier",
      "agentName": "Agent Name",
      "exportedAt": "2025-10-14T12:00:00.000Z"
    },
    "timing": {
      "startTime": "2025-10-14T11:59:00.000Z",
      "endTime": "2025-10-14T12:00:00.000Z",
      "durationMs": 60000
    },
    "timeline": [
      // Array of all activities with complete details:
      // - Agent messages and responses
      // - Tool calls and results
      // - Agent transfers
      // - Artifact information
      // - Execution context
    ]
  }
  ```

  #### How to Use Copy Trace

  1. Navigate to the **Traces** section in the management UI
  2. Open the conversation you want to debug
  3. Click the **Copy Trace** button at the top of the timeline
  4. The complete trace JSON is copied to your clipboard
  5. Paste it into your preferred tool for analysis

  This exported trace contains all the activities shown in the timeline, making it easy to share complete execution context with team members or support.
</>

### 2. SigNoz Dashboard

For detailed analysis and further debugging:

1. Open your SigNoz dashboard (cloud or local)
2. Navigate to **Traces** to see all agent executions
3. Use filters to find specific conversations or agents
4. Click on traces to see:
   * Step-by-step execution details
   * Performance metrics
   * Error information
   * Agent-to-agent communication flows

For more detailed information on using traces, see the [SigNoz Usage guide](/typescript-sdk/signoz-usage).

## Additional Observability and Evals

👉 For additional observability or a dedicated Evals platform, you can connect to any OTEL-based provider. For example, check out the [Langfuse Usage guide](/typescript-sdk/langfuse-usage) for end-to-end instructions.

## Next steps

Next, we recommend setting up the Nango credential store for production-ready credential management. See [Credentials](/typescript-sdk/credentials/overview) to get started.