Installation

Install Observability

Install the local Prometheus, Grafana, Tempo, and Loki stack with Docker Compose
View as Markdown

Install Dynamo’s local observability stack to collect metrics, logs, and traces from a CLI deployment. The Docker Compose stack includes Prometheus, Grafana, Tempo, Loki, an OpenTelemetry Collector, and the NATS Prometheus exporter.

Prerequisites

Install the following software:

Run the commands on this page from the root of the Dynamo repository.

Install the Stack

1

Start the Dynamo infrastructure

Start NATS and etcd. The observability stack joins the Docker network created by this command and collects metrics from both services.

$docker compose -f dev/docker-compose.yml up -d
2

Start the observability services

Start Prometheus, Grafana, Tempo, Loki, the OpenTelemetry Collector, and the NATS Prometheus exporter:

$docker compose -f dev/docker-observability.yml up -d

To collect NVIDIA GPU metrics, enable the optional DCGM exporter profile:

$docker compose --profile nvidia -f dev/docker-observability.yml up -d
3

Verify the installation

Check that the containers are running:

$docker compose -f dev/docker-observability.yml ps

Open Grafana at http://localhost:3000 and sign in with username dynamo and password dynamo. Open Prometheus at http://localhost:9090.

The stack is now installed. Continue with Observe a Local Deployment to configure metrics, traces, and exported logs. For service ports and configuration files, see the Local Observability Stack Reference.

Stop the Stack

To stop the observability services without deleting stored data, run:

$docker compose -f dev/docker-observability.yml down

To delete the Grafana, Tempo, and Loki volumes as well, add --volumes.