# Live Debugger, Traces, and OTEL Telemetry (/get-started/traces)

Set up SigNoz to enable full observability with traces and live debugging capabilities for your agents.



## Overview

The Inkeep Agent Framework provides powerful **traces** and **live debugging** capabilities powered by SigNoz. Setting up SigNoz gives you:

* **Real-time trace visualization** - See exactly how your agents execute step-by-step
* **Live debugging** - Debug agent conversations as they happen
* **Export traces as JSON** - Copy complete traces for offline analysis and debugging
* **Full observability** - Complete OpenTelemetry instrumentation for monitoring
* **Performance insights** - Identify bottlenecks and optimize agent performance

<Image src="/images/live-traces.png" alt="Live traces interface showing real-time agent execution" />

## Setup Options

You can set up SigNoz in two ways:

1. **Cloud Setup**: Use SigNoz Cloud
2. **Local Setup**: Run SigNoz locally using Docker

## Option 1: SigNoz Cloud Setup

<Video src="https://www.youtube.com/watch?v=F8n6427hjUE&t=3s" title="SigNoz Cloud Setup steps" />

### Step 1: Create a SigNoz Cloud Project

1. Sign up at [SigNoz](https://signoz.io/teams/)
2. Create a new project or use an existing one

### Step 2: Save Your SigNoz Credentials

You'll need to collect three pieces of information from your SigNoz dashboard:

1. **API Key**:

   * Navigate to Settings → Workspace Settings → API Keys → New Key
   * 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
   * Copy the generated API key

2. **Ingestion Key**:

   * Navigate to Settings → Workspace Settings → Ingestion
   * Set the expiration field to "No Expiry" to prevent the key from expiring
   * Copy the ingestion key

3. **SigNoz URL**:
   * Copy the URL from your browser's address bar
   * It will look like: `https://<your-organization>.signoz.cloud`

### Step 3: Configure Your Root `.env` File

```bash