Zabbix + MSTEAMS

Microsoft Teams é uma plataforma da Microsoft que tem como objetivo apoiar sua organização trabalhar em modo colaborativo, entre as milhares de funcionalidades e integrações possíveis o chat em equipe é uma delas e, pode ser utilizado para receber alertas de seu ambiente como já fazemos com telegram por exemplo.

Tentarei demonstrar os passos necessários para integrar seu ambiente e plotar alertas do Zabbix direto na equipe do Teams, com isso é possível acompanhar no celular, desktop ou via console web da ferramenta.

Não acho necessário apresentar o Zabbix, acredito ser uma das maiores plataformas de monitoramento existentes e é de conhecimento popular.

O primeiro passo é habilitar a integração Incomming Webhook na interface do office365 ou MSTeams.

A integração só terá funcionalidade apresentada quando aplicada em uma equipe, nem creio que seja possível integração com chat.

O segundo passo é configurar o canal da equipe que o conector terá permissão para publicar notificações.

No selectbox marquei o grupo Geral, é a EQUIPE reservada para esse tipo de atividade aqui no ambiente, em seguida devemos Configurar o conector, basicamente dando um nome modificando a imagem “avatar” do conector, clicando em criar teremos uma url que será a url única do canal, salve a url que será gerada, pois, iremos utiliza-la no script de integração com o Zabbix.

O processo descrito acima pode ser encontrado no link abaixo.

https://docs.microsoft.com/pt-br/outlook/actionable-messages/send-via-connectors

É muito importante que tenha reservada essa url, com ela será possível enviar texto diretamente no canal que foi configurado, ou seja, caso seja vazada, as informações do canal não vão ser mais confiáveis.

WEBHOOK_URL é a variável que armazeno a url que foi gerada no processo acima, ‘solicite reservar com cuidado da informação’, as demais variáveis não devem ser modificadas.

Observe que o formato do json recomendado pela MS no link tem muitas variáveis, no entanto, verá que para nosso objetivo são necessários apenas duas, o titulo e texto, as demais não são obrigatórios.

Não foi feito tratamento no script para checar se todos os argumentos estão sendo submetidos, vejo que não faz muito sentido, é um script de background e é necessário garantir que entrega da forma como deveria e basta testar.

Bora testar o script:

E ae, está pronto? não, guenta ae, vamos configurar o zabbix agora.

em Administração > Tipos de mídias

Uma vez criado o tipo de mídia, devemos garantir que exista o script dentro do diretório apropriado para execução, o zabbix reserva um diretório para tal atividade e pode ser encontrado no arquivo de configuração do zabbix_server.conf, /usr/lib/zabbix/alertscripts é o padrão e você pode apenas copia o script para o diretório e liberar execução do mesmo.

# chmod +x msteams.bash

A midia está customizada para enviar apenas o subject + message (titulo e texto), pois, assim configuramos o script, para receber apenas dois parâmetros.

entre na configuração do seu usuário.

Selecione a Aba Mídia e vamos em Aadicionar.

não podemos esquecer de cadastrar a mídia para o usuário, no caso, estou falando que minha conta tem a mídia cadastrada e os tipos de severidades que devem ser enviadas, bem como, os horários que o alerta pode ser disponibilizado.

haaaaaaaa, agora sim!!!! não jovem.. temos que configurar as ações a serem enviadas para o tipo de Mídia, ou você gostaria de receber todos os tipos de alerta em todos os meios e a todo momento? mesmo que fosse sim sua resposta, teria que configurar.

Configuração > Ação clique no botão Criar ação

Estou configurando duas S.A.N e um servidor nessa Ação.

É na aba de Operações de definiremos os alerras a serem enviados, o alerta pode ser enviado para uma ou mais mídias que tenha cadastrado, uma dica para economizar alertas, durante o expediente de trabalho receber alertas apenas no email e após o expediente plotar os alertas no celular.

Basta Adicionar e Atualiza, agora sim, você terá seus alertas plotando no Teams “quando eles forem gerados claro”.

pronto….. qualquer duvida me manda um salve que tento ajudar.