5.2.30. Loki¶

1. Overview¶

Loki is Atlas' disabled by default, Grafana-native log store. In this first slice it provides a local development store and Grafana datasource, but Atlas application log shipping is intentionally not claimed yet.

Loki is internal-only, has no Kong route, and should be queried through Grafana. The default retention is short for local development.

2. Access¶

SOURCE: LOKI_SOURCE=disabled by default.
Internal endpoint: http://loki:3100.
Direct host URL: none in the first slice.
Kong URL: none; no Kong route is generated.
Grafana surface: the Loki datasource is provisioned when Grafana starts.

3. Configuration¶

The service reads ./config/loki.yaml, mounted to /etc/loki/loki.yaml. LOKI_RETENTION_PERIOD defaults to 24h and is used by the compactor retention settings.

4. Architecture & Wiring¶

Grafana queries Loki directly. OpenTelemetry Collector does not export Atlas application logs to Loki yet; that remains a follow-up after trace ingestion is validated.

5. Dependencies & Integrations¶

5.1. Current — Upstream (this service calls)¶

No upstream calls.

5.2. Current — Downstream (services that call this)¶

Service	Category
grafana	infra

5.3. Architecture diagram¶

loki architecture

Open the full-size diagram for a full-screen view.

5.4. Future — Missing pair integrations¶

No high-confidence opportunities identified.

5.5. Future — Candidate new services¶

No high-confidence opportunities identified.

5.6. Future — Unused features in this service¶

No high-confidence opportunities identified.

6. Troubleshooting¶

If Grafana cannot query logs, confirm LOKI_SOURCE=container and LOKI_ENDPOINT=http://loki:3100.
If storage grows unexpectedly, check LOKI_RETENTION_PERIOD and compactor logs.
Roll back by setting LOKI_SOURCE=disabled.