Logs¶

control.observability.logs

Sapsan escribe logs estructurados en JSON en la salida estándar (stdout). La variable RUST_LOG controla el nivel; el valor predeterminado es info, con filtros específicos para módulos internos.

Inicio manual¶

Indique la ruta a su configuración existente. El segundo ejemplo activa mensajes detallados del módulo hls.

RUST_LOG=info CONFIG_PATH=/etc/sapsan/sapsan.yaml /usr/sbin/sapsan
RUST_LOG=info,hls=trace CONFIG_PATH=/etc/sapsan/sapsan.yaml /usr/sbin/sapsan

Servicio systemd¶

Cuando el paquete se ejecuta como sapsan.service, systemd journal recibe su salida. journalctl permite leer este registro. Un archivo syslog independiente depende de la configuración de reenvío de registros del sistema operativo.

sudo journalctl -u sapsan.service -n 100 --no-pager
sudo journalctl -u sapsan.service -f
sudo journalctl -u sapsan.service --since "1 hour ago" -o cat

Los dos primeros comandos muestran mensajes recientes y siguen los nuevos. Para cambiar el nivel del servicio, ejecute sudo systemctl edit sapsan y añada:

[Service]
Environment="RUST_LOG=info,hls=debug"

Aplique el cambio con sudo systemctl restart sapsan. Consulte los filtros en la documentación de journalctl.

Docker y almacenamiento central¶

Para un contenedor llamado sapsan, utilice:

docker logs --tail 100 sapsan
docker logs --follow sapsan

Docker recibe stdout del proceso; la consulta depende del controlador de logs. Para enviar logs al almacenamiento central, configure la fuente Docker logs de Vector y la salida Loki. Otra opción para Loki es Grafana Alloy con loki.source.docker. Configure la dirección y la retención en el sistema de recopilación de logs.