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