Syslog

As notificações de Syslog são mensagens geradas pelo sistema no formato do protocolo Syslog e que estão na fila para envio a um endpoint Syslog previamente configurado.

Acessando as notificações de Syslog

Para acessar a tela de listagem de entradas da fila de notificações de Syslog, basta seguir os passos:

1. Autentique-se no Admin console

2. Acione o menu Gerenciamento e monitoramento

3. Acione o item de menu Syslog > Fila de notificações > Histórico de notificações

Na página do histórico de notificações, a primeira listagem que aparece são das entradas que ainda não foram enviadas e portanto estão numa fila de envio.

Nota

As notificações são enviadas por um mecanismo interno executando em background que sistematicamente processa o envio de uma fila de notificações que são geradas na plataforma.

Quando as notificações são criadas?

Atualmente as notificações de Syslog são criadas à partir dos alertas de sistema gerados e/ou abertos, os quais estão habilitados e tem-se as configurações adequadas. Nas configurações dos alertas de sistema é possível configurar endpoints Syslog para receberem mensagens de notificações dos alertas.

As configurações de notificação de canais de alertas podem ser acessadas na documentação do Blazon no guia Administrador, a partir desse link.

Histórico das notificações

As notificações da fila de notificações que já foram processadas pelo mecanismo interno podem ser vistas acionando o botão Histórico a partir da página de listagem das entradas de notificações, ver seção Acessando as notificações de Syslog.

A tela de listagem das notificações que já foram processadas, ou seja o histórico de notificações processadas, está segmentada em duas abas: Processado e Falha.

Aba	Entradas da listagem
Processado	Mostra as entradas de notificações que já foram processadas pelo mecanismo interno e foram enviadas ao destinatário configurado.
Falha	Mostra as entradas de notificações que já foram processadas e apresentaram falha no envio ao destinatário configurado.

Notificações enviadas com sucesso

As notificações que foram enviadas com sucesso aparecem na listagem da aba Processado. Juntamente com as informações da mensagem tem-se a data de processamento da notificação que representa a data de envio da mesma.

Nota

Para as mensagens enviadas para os endpoints usando o protocolo UDP não se tem a garantia de entrega e portanto mesmo que a entrada de notificação seja dada como processada sem falha, ainda assim pode ocorrer que o destinatário não receba a mensagem. Esse comportamento é inerente ao protocolo UDP.

Notificações com falha

As entradas de notificações que não foram enviadas por motivo de falha no envio aparecem na listagem na aba Falha. Juntamente com as informações da mensagem tem-se a data de processamento além das informações referentes à falha ocorrida.

Para verificar a falha ocorrida pode-se clicar no ícone que representa a falha (), localizado à direita da linha de cada notificação na listagem de notificações da aba Falha.

Nota

As entradas de mensagens de notificação de Syslog são processadas por um mecanismo interno com uma configuração de até 3 re-tentativas de envio. Caso nenhuma delas tenha sucesso a entrada é colocada no estado com Falha e finalizado o processamento sem o envio.

Troubleshooting

Caso algum problema ocorrer, como uma notificação não ser enviada, tem-se algumas sugestões de análises:

1. No momento do envio da mensagem de notificação, é necessário que o servidor Syslog esteja executando e ouvindo a porta configurada no endpoint Syslog;

2. A configuração feita no endpoint Syslog deve corresponder ao endereço, porta e protocolo corretos do servidor Syslog em execução.

3. O uso do protocolo UDP não possibilita a validação do envio da mensagem de notificação e portanto é possível mesmo para uma entrada dada como processada, o destinatário não receber a notificação. Recomenda-se o uso do protocolo TCP ou TCP+TLS.