SigNoz Local

What this is

This repo integrates open-source self-hosted SigNoz (SigNoz/signoz) for local observability.

How to start (local)

Run MBPanel + SigNoz together using Compose layering:

docker compose -f docker-compose.yml -f docker-compose.signoz.yml up -d

Key endpoints

• SigNoz UI/API: http://localhost:8080
• OTLP gRPC receiver (collector): localhost:4317
• OTLP HTTP receiver (collector): localhost:4318

How MBPanel connects

docker-compose.signoz.yml overrides the backend service to export OTLP to the SigNoz collector:

• ENABLE_OPENTELEMETRY=true
• OTEL_EXPORTER_OTLP_ENDPOINT=http://signoz-otel-collector:4317
• OTEL_EXPORTER_OTLP_INSECURE=true (local dev)
• OTEL_METRICS_ENABLED=true
• OTEL_LOGS_ENABLED=true (structlog/stdlib logs flow through the OpenTelemetry logging pipeline)

Smoke verification

See: SigNoz Smoke Verification (Local)

Data that lands in SigNoz

• Traces & Metrics: Exported via OTLP gRPC, with TLS disabled only in this local overlay.
• Logs: Structlog emits JSON to stdout and the OpenTelemetry LoggingHandler mirrors each record to SigNoz. This follows the SigNoz “Using OpenTelemetry SDK” log path and the upstream OpenTelemetry Logs SDK reference example.