Grafana Alloy — Agente de observabilidad¶

Agente colector único por nodo que recoge métricas y logs de cada servicio y los envía al stack centralizado. Sustituye la proliferación de exporters individuales.

Como usuario¶

Qué podrás hacer¶

No se usa directamente. Sería el agente que recolecta métricas y logs para que Grafana funcione.

Cómo se accederá¶

Solo admin. Se gestiona vía playbook de Ansible en cada LXC (contenedor ligero de Proxmox).

Integración con otros servicios de SmallCountry¶

Servicio	Relación
Victoria Metrics	Destino de métricas
Victoria Logs	Destino de logs
Grafana	Visualización de los datos recolectados
OpenTelemetry	Estándar de instrumentación
Prometheus	Scraper compatible

Servicios que lo hacen posible¶

Ansible — despliegue y configuración

Para el administrador (diseño previsto)

Datos del servicio¶


Ubicación	Desplegado como agente en cada LXC
Configuración	Versionada en Forgejo

Sin ZFS (sistema de archivos con integridad de datos) propio. Se despliega con cada LXC desde el playbook de Ansible.

Healthcheck¶

Verificar que los datos llegan a Grafana en los dashboards correspondientes.

Logs y diagnóstico¶

systemctl status alloy
journalctl -u alloy --since "10 min ago"

Problemas comunes¶

No llegan métricas a Grafana → Verificar conectividad con Victoria Metrics.
Agente caído → systemctl restart alloy y revisar logs.

Para el arquitecto (diseño previsto)

Relaciones con otros servicios¶

flowchart LR
    Alloy -->|Métricas| VictoriaMetrics
    Alloy -->|Logs| VictoriaLogs
    VictoriaMetrics -->|Dashboards| Grafana
    VictoriaLogs -->|Explorador| Grafana

Configuración¶

Se despliega con cada LXC desde el playbook de Ansible. Usa OpenTelemetry como estándar único. Un solo agente, un solo punto de configuración por LXC.

Campos estandarizados¶

trace_id, span_id, service.name, severity, timestamp

Orquestación¶

Integrado en cada deploy-*.yml. La configuración de Alloy por LXC se define en las variables del rol correspondiente.

Secciones relacionadas¶

🌐 Enlaces de interés¶

Grafana Alloy · GitHub