Saltar a contenido

Grafana

  • Que es: la consola visual de observabilidad.
  • Para que sirve: muestra dashboards y deja leer el estado del VPS sin entrar a Prometheus a mano.
  • Donde corre: stack /opt/stacks/observability en el VPS.
  • Contenedor asociado: obs-grafana.
  • Red Docker: obs-observability-internal.
  • Volumenes asociados: obs_grafana_data, provisioning versionado, dashboards versionados y secreto grafana_admin_password.
  • Puertos: 3000/tcp publicado solo en 127.0.0.1:3000.
  • Depende de: obs-thanos-query.
  • Quien depende de el: operadores humanos y lectura ejecutiva diaria.
  • Que metricas aporta: su endpoint /metrics, que Prometheus scrapea como job=grafana.
  • Que alertas lo protegen: entra bajo PrometheusTargetDown si deja de responder como target.
  • Que dashboards lo usan: es el contenedor que sirve Infrastructure Health, Capacity Planning, Docker Operations, Service Availability y Executive Overview.
  • Como validar que esta bien: confirmar 127.0.0.1:3000, revisar datasource Thanos y verificar que los dashboards provisionados esten visibles.
  • Que hacer si falla: revisar logs de obs-grafana, el secreto de admin, la salud de obs-thanos-query y el volumen obs_grafana_data.

Evidencia real

  • datasource: infra/observability/grafana/provisioning/datasources/prometheus.yml
  • dashboards: infra/observability/grafana/dashboards/
  • runtime auditado: docs/governance/operations/O6.0-REALITY-AUDIT.md

Recovery corto

Si Grafana levanta pero no muestra datos, el problema casi siempre esta en la datasource Thanos o aguas abajo en obs-thanos-query.