Table of Contents
9 Monitorar certificados de sites com o Zabbix agent 2 (passivo)
Introdução
Este guia fornece uma visão geral abrangente de como configurar e monitorar certificados SSL/TLS usando a chave web.certificate.get no Zabbix agent 2. Ele foi projetado para simplificar o monitoramento de certificados para um ou vários sites, garantindo que os administradores possam identificar rapidamente possíveis problemas, como certificados expirados ou inválidos.
Para quem é este guia
Este guia foi desenvolvido para novos usuários do Zabbix e contém o conjunto mínimo de etapas necessárias para habilitar o monitoramento básico de certificados de sites. Se você procura opções de personalização avançadas ou requer uma configuração mais avançada, consulte a seção Configuração do manual do Zabbix.
Pré-requisitos
Antes de prosseguir com este guia, você precisa baixar e instalar o Zabbix server, o Zabbix frontend e o Zabbix agent 2 de acordo com as instruções para o seu sistema operacional. Este tutorial pressupõe que tanto o Zabbix server quanto o agent estão instalados na mesma máquina; portanto, 127.0.0.1 é usado na configuração.
Configurar o Zabbix agent 2
1. Abra o arquivo de configuração do Zabbix agent (caminho padrão: /etc/zabbix/zabbix_agent2.conf):
2. Defina o parâmetro Server como 127.0.0.1, já que o agent e o server estão rodando na mesma máquina:
3. Salve o arquivo e reinicie o serviço do Zabbix agent 2:
4. Após instalar e configurar o Zabbix agent 2, teste sua disponibilidade com:
O Zabbix agent 2 inclui o plugin WebCertificate por padrão, portanto, não é necessária instalação ou configuração separada.
Configurar o frontend do Zabbix
1. Faça login no frontend do Zabbix.
2. Navegue até Monitoramento > Hosts.
3. Clique em um host existente onde deseja monitorar certificados de sites ou crie um host se necessário:
- No campo Nome do host, insira um nome de host (por exemplo, "Monitoramento de Certificado").
- No campo Templates, digite ou selecione o template "Website certificate by Zabbix agent 2" que será vinculado ao host.
- No campo Grupos de hosts, digite ou selecione um grupo de hosts (por exemplo, "Monitoramento SSL/TLS").
- No campo Interfaces, adicione uma interface do tipo "Agent" e especifique um endereço IP. Para este exemplo, "127.0.0.1" é usado.
- Na guia Macros, alterne para Macros herdadas e do host, procure as seguintes macros e clique em Alterar ao lado do valor da macro para atualizá-lo:
{$CERT.WEBSITE.HOSTNAME}- insira o nome DNS do site desejado como valor.
4. Clique em Adicionar para adicionar o host.
Para monitorar vários sites, você pode especificar uma lista separada por vírgulas de seus nomes de host na macro {$CERT.WEBSITE.HOSTNAME}. Opcionalmente, você também pode fornecer uma lista separada por vírgulas de portas na macro {$CERT.WEBSITE.PORT}, onde cada porta corresponde ao respectivo nome de host na ordem. Por exemplo, para monitorar example.com e example.org na porta 8443:
{$CERT.WEBSITE.HOSTNAME}: example.com,example.org{$CERT.WEBSITE.PORT}: 443,8443
Para cada site especificado na macro {$CERT.WEBSITE.HOSTNAME}, o Zabbix criará um conjunto correspondente de items e triggers. Isso permite o monitoramento e alerta individual para o certificado SSL de cada site.
Visualizar métricas coletadas
Parabéns! Neste ponto, o Zabbix já está monitorando o certificado web desejado.
Para visualizar as métricas coletadas, navegue até a seção de menu Monitoramento > Hosts e clique em Últimos dados ao lado do host para ver todas as métricas coletadas mais recentes em uma lista, como data de expiração, emissor e sujeito.
Configure alertas de problemas
O Zabbix pode notificá-lo sobre problemas na infraestrutura. Este guia fornece etapas básicas de configuração para o envio de alertas por e-mail.
1. Acesse Configurações do usuário > Perfil, vá para a aba Mídia e adicione seu e-mail.
2. Siga o guia para Receber uma notificação de problema.
Da próxima vez que o Zabbix detectar um problema, você deverá receber um alerta por e-mail.
Teste sua configuração
Para testar sua configuração, podemos simular um problema real atualizando a configuração do host no frontend do Zabbix.
1. Abra a configuração do seu host "Certificate Monitoring" no Zabbix.
2. Mude para a aba Macros e selecione Macros herdadas e do host.
3. Clique em Alterar ao lado do valor da macro {$CERT.EXPIRY.WARN} configurada anteriormente e defina um número de dias muito alto (mais de 365 dias deve ser suficiente) para receber um aviso antes do certificado expirar.
4. Clique em Atualizar para atualizar a configuração do host.
5. Em alguns instantes, o Zabbix detectará o problema "SSL certificate expires soon", com o número de dias até a expiração. O problema aparecerá em Monitoramento > Problemas.
Se os alertas estiverem configurados, você também receberá a notificação do problema.
6. Altere o valor da macro de volta para o valor anterior para resolver o problema e continuar monitorando os valores do certificado.
Veja também
- Agent Zabbix 2 - lista as chaves de item.
- Template Website certificate by Zabbix agent 2 - informações adicionais sobre o template Website certificate by Zabbix agent 2.
- Template Website certificate by Zabbix agent 2 active - informações adicionais sobre o template Website certificate by Zabbix agent 2 active.
- Monitorar sites com itens Browser - como iniciar o monitoramento básico de sites com itens Browser.