Logs¶

control.observability.logs

O Sapsan escreve logs estruturados em JSON na saída padrão (stdout). A variável RUST_LOG controla o nível; o padrão é info, com filtros específicos para módulos internos.

Inicialização manual¶

Indique o caminho da configuração existente. O segundo exemplo ativa mensagens detalhadas do 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

Serviço systemd¶

Quando o pacote é executado como sapsan.service, o systemd journal recebe sua saída. Use journalctl para ler esse registro. Um arquivo syslog separado depende da configuração de encaminhamento de registros do sistema operacional.

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

Os dois primeiros comandos mostram mensagens recentes e acompanham as novas. Para alterar o nível do serviço, execute sudo systemctl edit sapsan e adicione:

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

Aplique a alteração com sudo systemctl restart sapsan. Consulte os filtros na documentação do journalctl.

Docker e armazenamento central¶

Para um contêiner chamado sapsan, use:

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

O Docker recebe stdout do processo; a consulta depende do driver de logs. Para enviar logs ao armazenamento central, configure a fonte Docker logs do Vector e a saída Loki. Outra opção para Loki é o Grafana Alloy com loki.source.docker. Configure o endereço e a retenção no sistema de coleta de logs.