> This page is for version Latest (v1.5.1) (default).
> For other versions, use one of these documentation indexes:
> - Latest (v1.5.1) (default): https://docs.nvidia.com/dynamo/latest/llms.txt
> - dev: https://docs.nvidia.com/dynamo/dev/llms.txt
> - v1.5.1: https://docs.nvidia.com/dynamo/v1.5.1/llms.txt
> - v1.5.0: https://docs.nvidia.com/dynamo/v1.5.0/llms.txt
> - v1.4.2: https://docs.nvidia.com/dynamo/v1.4.2/llms.txt
> - v1.4.1: https://docs.nvidia.com/dynamo/v1.4.1/llms.txt
> - v1.4.0: https://docs.nvidia.com/dynamo/v1.4.0/llms.txt
> - v1.3.0: https://docs.nvidia.com/dynamo/v1.3.0/llms.txt
> - v1.2.1: https://docs.nvidia.com/dynamo/v1.2.1/llms.txt
> - v1.2.0: https://docs.nvidia.com/dynamo/v1.2.0/llms.txt
> - v1.1.1: https://docs.nvidia.com/dynamo/v1.1.1/llms.txt
> - v1.1.0: https://docs.nvidia.com/dynamo/v1.1.0/llms.txt
> - v1.0.2: https://docs.nvidia.com/dynamo/v1.0.2/llms.txt
> - v1.0.1: https://docs.nvidia.com/dynamo/v1.0.1/llms.txt
> - v1.0.0: https://docs.nvidia.com/dynamo/v1.0.0/llms.txt
> - v0.9.1: https://docs.nvidia.com/dynamo/v-0-9-1/llms.txt
> - v0.9.0: https://docs.nvidia.com/dynamo/v-0-9-0/llms.txt
> - v0.8.1: https://docs.nvidia.com/dynamo/v-0-8-1/llms.txt
> - v0.8.0: https://docs.nvidia.com/dynamo/v-0-8-0/llms.txt
> - v0.7.1: https://docs.nvidia.com/dynamo/v-0-7-1/llms.txt
> - v0.7.0: https://docs.nvidia.com/dynamo/v-0-7-0/llms.txt

> For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://docs.nvidia.com/dynamo/llms.txt. For full content including API reference and SDK examples, see https://docs.nvidia.com/dynamo/llms-full.txt.

# Install Observability

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:

* [Docker](https://docs.docker.com/get-docker/)
* [Docker Compose](https://docs.docker.com/compose/install/)

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

## Install the Stack

#### 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.

```bash
docker compose -f dev/docker-compose.yml up -d
```

#### Start the observability services

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

```bash
docker compose -f dev/docker-observability.yml up -d
```

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

```bash
docker compose --profile nvidia -f dev/docker-observability.yml up -d
```

#### Verify the installation

Check that the containers are running:

```bash
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](/dynamo/cli/operations/observability)
to configure metrics, traces, and exported logs. For service ports and configuration files, see the
[Local Observability Stack Reference](/dynamo/reference/observability/local-stack).

## Stop the Stack

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

```bash
docker compose -f dev/docker-observability.yml down
```

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