​

SigNoz Integration

​

Quick Start

docker compose -f signoz/docker/docker-compose.yaml up -d
# ... later
docker compose -f signoz/docker/docker-compose.yaml down

​

1. Create an API key

​

2. Configure environment variables

export SIGNOZ_URL="http://localhost:8080"
export SIGNOZ_API_KEY="<service-account-api-key>"

​

3. Verify connectivity

uv run opensre integrations verify signoz

​

4. Use the tools

• query_signoz_logs — Search logs by service, severity, and time window.
• query_signoz_metrics — Query CPU, memory, and request-rate signals.
• query_signoz_traces — Query error spans, latency percentiles, and dependencies.

​

Webhook Configuration

1. In SigNoz, go to Settings → Notification Channels.
2. Create a Webhook channel pointing at your OpenSRE instance:
   POST https://your-opensre-instance/investigate
   
3. The agent will detect alert_source: signoz from the payload and auto-query logs, metrics, and traces.

​

CLI Setup

opensre integrations setup signoz

​

Supported Metrics (V1)

​

API reference

• Endpoint: POST {SIGNOZ_URL}/api/v5/query_range
• Auth header: SigNoz-Api-Key: <YOUR_API_KEY>
• Validation probe: GET {SIGNOZ_URL}/api/v2/metrics

​

Example Investigation

uv run opensre investigate --input-json '{
  "alert_source": "signoz",
  "alert_name": "HighErrorRate",
  "pipeline_name": "payment-service",
  "severity": "critical",
  "commonLabels": {
    "service_name": "payment-service",
    "severity": "critical"
  },
  "commonAnnotations": {
    "summary": "Error rate exceeded 5%"
  }
}'

​

Troubleshooting