A mensagem de evento e seus campos
O syslog é um protocolo para transmitir mensagens de notificação de eventos. O formato definido pela RFC 5424 identifica a origem e a severidade do evento, além de permitir campos estruturados para informações da aplicação. Um coletor usa esses campos para interpretar e encaminhar as mensagens recebidas.
A prioridade combina a categoria da origem, chamada de facility, com a severidade. O cálculo é facility × 8 + severidade. As severidades usam números de 0 a 7, com 0 para emergência e 7 para depuração.
Interpretação de uma linha syslog
Este exemplo didático segue o formato da RFC 5424 e usa uma mensagem de texto com caracteres ASCII:
<165>1 2026-11-16T09:00:00Z app.example.com estoque 123 ID47 - Consulta concluidaO valor 165 combina a facility 20, reservada para uso local, com a severidade 5, chamada de notice. O número 1 indica a versão do formato. A mensagem identifica a aplicação estoque no host app.example.com, com processo 123 e identificador de mensagem ID47. O hífen indica a ausência de campos estruturados nessa linha.
Transporte e retenção no coletor
O formato da mensagem é separado do transporte. A transmissão por UDP admite perdas e não oferece confirmação de recebimento. A transmissão por TLS acrescenta proteção à comunicação, mas essa proteção termina em cada conexão entre participantes.
Você precisa conferir tanto o recebimento quanto a gravação no coletor. Uma mensagem pode chegar pela rede e ser descartada por um filtro local. A política de retenção também pode removê-la depois, por isso uma investigação deve verificar o período disponível para consulta.
Dúvidas frequentes
Perguntas frequentes sobre syslog
- O syslog é o nome de um arquivo de log?
- O termo identifica um protocolo de mensagens de eventos. Um serviço pode gravar essas mensagens em arquivo, encaminhá-las a um coletor ou fazer as duas coisas.
- O syslog usa obrigatoriamente UDP?
- Existem especificações de transporte por UDP e por TLS. Você precisa conferir o transporte aceito pelo coletor e configurado no emissor.
- O syslog garante a conservação das mensagens?
- A retenção depende do coletor e de seu armazenamento. Mesmo uma conexão protegida por TLS não confirma que cada mensagem foi gravada e continuará disponível para consulta.
Para continuar
Recursos relacionados
Documentação
RFC 5424: formato e arquitetura das mensagens syslog
Define o cabeçalho, a prioridade e os campos estruturados das mensagens de eventos.
Abrir recursoSite de referência
DevSide: desenvolvimento colaborativo
Acompanhamento técnico ao vivo para conferir o envio de logs e investigar mensagens ausentes no coletor.
Abrir recursoAplicação na formação
Formação DevOps
A centralização de logs exige interpretar a origem e a severidade das mensagens e conferir o transporte até o coletor.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.