Local Observability Stack Reference

Services, ports, signal flow, and configuration files for the Docker Compose stack
View as Markdown

The local observability stack combines metrics, logs, and traces from CLI deployments. Install it with the Observability installation guide, then use Observe a Local Deployment to configure Dynamo processes.

Services and Ports

ServiceHost endpointPurpose
Grafanahttp://localhost:3000Dashboards and signal exploration
Prometheushttp://localhost:9090Metrics collection and PromQL queries
Tempohttp://localhost:3200Trace storage and query API
Lokihttp://localhost:3100Log storage and query API
OpenTelemetry Collectorlocalhost:4317 (gRPC), localhost:4318 (HTTP)OTLP ingestion for traces and logs
NATS Prometheus exporterhttp://localhost:7777/metricsNATS metrics
DCGM exporterhttp://localhost:9401/metricsOptional NVIDIA GPU metrics

Grafana uses dynamo for both the default username and password. The DCGM exporter uses port 9401 instead of its default port 9400 to avoid conflicts with another exporter on the host.

Signal Flow

Prometheus scrapes Dynamo metrics directly. Dynamo sends traces and exported logs to the OpenTelemetry Collector, which routes them to Tempo and Loki. Grafana queries all three backends.

Configuration Files

FilePurpose
dev/docker-observability.ymlDefines the local observability services, network, volumes, and optional profiles
dev/observability/prometheus.ymlDefines Prometheus scrape targets and intervals
dev/observability/grafana-datasources.ymlProvisions the Prometheus data source
dev/observability/tempo-datasource.ymlProvisions the Tempo data source
dev/observability/loki-datasource.ymlProvisions the Loki data source and trace links
dev/observability/otel-collector.yamlRoutes OTLP traces to Tempo and logs to Loki
dev/observability/loki.yamlConfigures local Loki storage
dev/observability/grafana_dashboards/Contains the provisioned Dynamo, GPU, and KVBM dashboards

Optional Profiles

The nvidia profile starts the DCGM exporter for NVIDIA GPU metrics. The resource-monitor profile starts a second Prometheus instance on port 9091 for high-frequency local resource monitoring. See the Local Resource Monitor Reference for its configuration and usage.