# SigNoz
SIGNOZ_URL=https://<your-organization>.signoz.cloud
SIGNOZ_API_KEY=<your-api-key>

OTEL_EXPORTER_OTLP_TRACES_ENDPOINT=https://ingest.us.signoz.cloud:443/v1/traces
OTEL_EXPORTER_OTLP_TRACES_HEADERS="signoz-ingestion-key=<your-ingestion-key>"
```

### Step 4: Verify Cloud Setup

1. Restart your development environment:

   ```bash
   pnpm dev
   ```

2. Generate some traces by interacting with your agents

3. Open your SigNoz cloud dashboard and navigate to "Traces" to see your agent traces

## Option 2: Local SigNoz Setup

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

### Prerequisites

* Docker installed on your machine

### Step 1: Clone the Optional Services Repository

Clone the Inkeep optional local development services repository:

```bash
git clone https://github.com/inkeep/agents-optional-local-dev
cd agents-optional-local-dev
```

### Step 2: Start SigNoz Services

Run the following command to start SigNoz and related services:

```bash
docker-compose --profile signoz up -d
```

This will start:

* SigNoz frontend (accessible at `http://localhost:3080`)
* SigNoz query service
* SigNoz OTEL collector
* ClickHouse database

When you visit `http://localhost:3080`, you can sign up with your desired credentials.

### Step 3: Configure Environment Variables

In your **root project directory** (e.g., `my-agents`), update your `.env` file:

```bash