# Nereus observability

Start the application and its local observability overlay with one command:

```bash
docker compose -f compose.yaml -f observability/compose.yaml up -d
```

The local endpoints are:

- Grafana: `http://127.0.0.1:13000`
- Prometheus: `http://127.0.0.1:19090`
- API: `http://127.0.0.1:18080`

Grafana uses anonymous administrator access only in this local overlay. No
password or credential is stored in the repository. Stop the complete stack
with the same two Compose files and `down`.

`otel-collector/local.yaml` handles local API traces. `otel-collector/config.yaml`
is the cluster configuration: it receives traces and tails only pod logs under
the `nereus` namespace path, then exports traces to Tempo and logs to Loki. Log
collection and trace-to-log links therefore require the real Kubernetes
environment and are not simulated in local Compose.
