> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mov-eat.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Observabilidad

> Cómo Moveat usa Grafana, Loki y logs estructurados para entender producción.

# Observabilidad

Moveat usa Grafana y Loki para inspeccionar logs y comportamiento de servicios.

## Objetivos

Responder preguntas como:

* ¿Platform está healthy?
* ¿Agent recibe mensajes?
* ¿Qué requests fallan?
* ¿Qué correlation ID corresponde a una acción fallida?
* ¿Hay problemas con DB o Redis?
* ¿Los logs crecen demasiado?

## Flujo de logs

```mermaid theme={null}
graph LR
    Platform --> DockerLogs[Docker logs]
    Agent --> DockerLogs
    DockerLogs --> Alloy
    Alloy --> Loki
    Loki --> Grafana
```

## Correlation IDs

Platform emite correlation IDs para requests HTTP. Operaciones debe usarlos para conectar errores del frontend, logs de Platform y llamadas de Agent.

## Body logging

Platform puede loguear request/response bodies. Campos sensibles como passwords deben redactarse.

## Health checks

Los logs de `/healthz` deben filtrarse de vistas operativas para reducir ruido.

## Investigaciones comunes

| Síntoma                                   | Primeros checks                                             |
| ----------------------------------------- | ----------------------------------------------------------- |
| Login 200 pero `/me` falla                | Cookie domain, CORS, credentials include, session storage.  |
| Agent recibe webhook pero no aparece data | Logs de Platform client, token interno, channel resolution. |
| Platform reinicia                         | Logs, env vars, migrations, DI errors.                      |
| Grafana sin data                          | Alloy, Loki datasource, labels, time range.                 |