Integrando Nagios com Asterisk

gnu

Descrição das atividades que desenvolvi para integrar a ferramenta Nagios com o servidor Asterisk, realizando ligações quando um host/serviço estivesse down.

[ Hits: 21.127 ]

Por: Sidney Alexandre Pagel em 01/01/2013


O script



Eis o conteúdo do script "astnagios.sh":

#!/bin/sh

#crio variáveis necessárias

nome=$(date +%m%d%H%M%S)
workdir=/opt/scripts/astnagios
date > $workdir/data
minutodate=$(date +%s)

#Pode acontecer um efeito cascata, ou seja, a queda de um switch, que possui outros ligados nele,
#o que pode ocasionar várias ligações. Detecto e trato isso da seguinte forma:

#insiro a data, em segundos, desde 01 de janeiro de 1970, no arquivo minutocontroler, ou seja, cada
#vez que o script é executado, ele insere a data no arquivo minutocontroler

echo $minutodate >> $workdir/minutocontroler

#capturo as últimas 10 linhas do arquivo minutocontroler, e as insiro no arquivo checkidade

tail -n 10 $workdir/minutocontroler > $workdir/checkidade

#crio as variaveis minuto1 e minuto2, e apago o arquivo checkidade

minuto1=$(head -1 $workdir/checkidade)
minuto2=$(tail -1 $workdir/checkidade)
rm $workdir/checkidade

#pego o momento da ultima execução, subtraio o momento da primeira execução, e insiro o
#resultado no arquivo acompanhacascata

let "idademinuto=(($minuto2 - $minuto1))"
echo $idademinuto >> $workdir/acompanhacascata


#caso o resultado seja menor do que 150 segundos, isso significa que caíram 10 hosts em menos de
#1 minuto e meio, o que, obviamente, é uma cascata
#então, entra o tratamento

if [ $idademinuto -le 150 ]; then

   #insiro as palavras CASCATA DETECTADA, no arquivo cascata, que possui apenas 1 linha, em #branco
   echo "CASCATA DETECTADA" >> $workdir/cascata

   #conto o número de linhas do arquivo cascata
   linhascascata=$(grep -c "" $workdir/cascata)

   #se o número de linhas for igual a 2, significa que foi detectada uma
   #cascata, por isso o arquivo foi incrementado
   if [ $linhascascata == 2 ]; then
      #nesse caso, envio arquivos .call que executam um arquivo de áudio
      #que diz: "cascata detectada, as #ligações serão interrompidas" para o
      #servidor asterisk (essa é a mensagem de áudio que os responsáveis receberão).
      scp $workdir/cascatafiles/*.cascata 192.168.0.228:/var/spool/asterisk/outgoing

      #se o número de linhas do arquivo de cascata for diferente de 2, maior,
      #obviamente, incrementamos um log, apenas a título de controle posterior.
      datah=$(cat $workdir/data)
      echo $datah  AVISO DE CASCATA >> $workdir/logcascata
   fi

else
   #se nao houver cascata
   #faz o arquivo cascata voltar a ter apenas 1 linha vazia.
   echo > $workdir/cascata

   #crio a variável numcel, contendo a informação do arquivo numcel,
   #que foi criado pelo nagios, inserindo nesse arquivo o conteúdo da variável $CONTACTPAGER
   numcel=$(cat $workdir/numcel)

   #crio a variável canal, contendo o número 1
   canal=1

   #caso exista o arquivo hostiden, trata-se de host, entao....
   if [ -f $workdir/hostiden ];then

      #identifica o nome do host e o status (up ou down)
      hostiden=$(cat $workdir/hostiden);
      hoststate=$(cat $workdir/hoststate);

      #caso host up
      if [ "$hoststate" == UP ]; then
         sed -e s/destinatario/0$numcel/g -e s/i1/g$canal/g  $workdir/calls/template."$hostiden".UP.call > $workdir/calls/"$nome.$hostiden".UP.call
         scp $workdir/calls/"$nome.$hostiden".UP.call IPDOASTERISK:/var/spool/asterisk/outgoing
         rm $workdir/calls/"$nome.$hostiden".UP.call
         datah=$(cat $workdir/data)
         echo $datah LIGACAO $hostiden UP EFETUADA PARA $numcel >> $workdir/logcalls
      else

         #caso host down
         if [ "$hoststate" == DOWN ]; then
            numcel=$(cat $workdir/numcel)
            sed -e s/destinatario/0$numcel/g -e s/i1/g$canal/g  $workdir/calls/template."$hostiden".DOWN.call > $workdir/calls/"$nome.$hostiden".DOWN.call
            scp $workdir/calls/"$nome.$hostiden".DOWN.call IPDOASTERISK:/var/spool/asterisk/outgoing
            rm $workdir/calls/"$nome.$hostiden".DOWN.call
            datah=$(cat $workdir/data)
            echo $datah LIGACAO $hostiden DOWN EFETUADA PARA $numcel >> $workdir/logcalls
         fi
      fi
   fi

else
   #apaga o lixo
   rm $workdir/data
   rm $workdir/hostiden
   rm $workdir/hoststate
   rm $workdir/numcel
fi

Explicações adicionais

Este é, portanto, o script que é executado no fim da linha do arquivo commands.cfg. Tenho, dentro da pasta /opt/scripts/astnagios uma subpasta chamada "calls", que contém, para cada host monitorado, dois arquivos:
  • template.NOMEDOHOSTNONAGIOS.DOWN.call
  • template.NOMEDOHOSTNONAGIOS.UP.call

Estes arquivos são copiados para um novo arquivo cujo nome se inicia com a data e hora em segundos (variável $nome, primeira criada no script,(nome=$(date +%m%d%H%M%S)), seguida do nome do host, estado e extensão ".call". Exemplo: 1112103026.SERVIDOREMAIL.UP.call, e editados via sed quando o script é executado, substituindo a palavra "destinatario" pelo número de celular do destinatário, e o campo "I1" pelo canal desejado.

Este é o conteúdo original do arquivo template.SERVIDOREMAIL.UP.call:

Channel:DAHDI/I1/destinatario
Application: MP3Player
Data: /var/lib/asterisk/sounds/emailup.mp3

Como explicado acima, o arquivo template.SERVIDOREMAIL.UP.call se tornará o arquivo 1112103026.SERVIDOREMAIL.UP.call (supondo que o script tenha sido executado no dia 11 de dezembro, as 10 horas, 30 minutos e 26 segundos), que terá o seguinte conteúdo:

Channel:DAHDI/g1/NUMERODOCELULARDORESPONSÁVEL
Application: MP3Player
Data: /var/lib/asterisk/sounds/emailup.mp3

Em seguida, este arquivo será copiado via SCP para o servidor Asterisk, na pasta /var/spool/asterisk/outgoing, e será executado gerando uma ligação para o número do celular do responsável e executando o arquivo de áudio emailup.mp3.

Todos devem compreender, obviamente, o trabalho braçal enorme que se constituiu criar um arquivo template.NOMEDOHOSTNONAGIOS.UP.call, e um arquivo template.NOMEDOHOSTNONAGIOS.DOWN.call, e em seguida, criar um arquivo de áudio MP3 que falasse o nome do host e se ele se encontrava Down ou Up, correspondendo a cada um dos arquivos ".call". Mas o resultado valeu a pena. :).

Existem ainda outras possibilidades, como inserir o contexto no qual o arquivo será executado no Asterisk, e criar esse contexto, para que se possam fazer mais operações, ou enviar o responsável para uma URA, fazendo com que seja possível, por exemplo, que ele faça o Asterisk ligar para uma terceira pessoa ou algo assim... Enfim, quando falamos de Asterisk, o limite é nossa própria imaginação.

Temo que o presente artigo possa ter ficado um tanto confuso, mas foi a maneira que encontrei de compartilhar com a comunidade esta solução e, como não havia encontrado nada parecido Internet afora, achei que valia a pena postar.

Críticas, desde que construtivas e sugestões, são bem-vindas.

Página anterior    

Páginas do artigo
   1. O início
   2. Atacando o problema
   3. O script
Outros artigos deste autor

Mais sobre terminais leves....

Jogando pesado na segurança de seu SSH

NagVis - Gestor de mapas pra lá de especial

Pequena solução para backup em redes mistas

Configurando um domínio pelo serviço ipturbo empresarial (Brasil Telecom)

Leitura recomendada

Gerador de sources.list para o Debian

BIND DNS Active Directory Windows 2008

Instalado Fedora-DS e integrando com Samba

ProFTPD com autenticação via MySQL

Asterisk - Instalação e configuração no Debian Lenny

  
Comentários
[1] Comentário enviado por fabio em 01/01/2013 - 13:50h

Meus parabéns, ótimo trabalho!

Primeiro artigo do ano no VOL já começa com uma solução super criativa.

[2] Comentário enviado por gnu em 01/01/2013 - 23:43h

Muito Obrigado! Vindo de uma pessoa com o conhecimento que você tem, tenho que imprimir e enquadrar seu elogio.. hehehe

[3] Comentário enviado por danniel-lara em 02/01/2013 - 10:02h

Parabéns pelo Artigo muito bom mesmo

[4] Comentário enviado por Rafael Oliveira em 02/01/2013 - 12:04h

Parabéns gnu!
Realmente muito criativa e eficiente a sua ideia.

[5] Comentário enviado por cesar.info em 03/01/2013 - 20:40h

Imaginando algo mais "mirabolante", daria pra pensar em criar alguns comandos de gerenciamento do servidor através da URA, etc.

Mandou bem, muito bem.

Abs.

[6] Comentário enviado por feimsacuel em 05/01/2013 - 16:28h

Muito bom essa solução, gostaria de saber se vc sabe como monitorar o link R2 das placas khomps pelo snmp, mas valeu pelas dicas.

[7] Comentário enviado por fernandotrilha em 24/03/2014 - 16:56h

Sidney, estou implementando isso aqui na empresa, mas não estou conseguindo fazer o Nagios executar o comando notify-host-by-fone;
Consegue me dar uma força?

[8] Comentário enviado por thla_88 em 10/01/2015 - 17:53h


Sidney ótima postagem, estou estudando a fundo o nagios e o asterisk, paguei duas cadeiras que implementavam essas maravilhosas ferramentas. Gostaria de saber como vc fez o script do envio automático do SCP para que toda vez o nagios podesse alertar o asterisk se um host está DOWN ou UP?

[9] Comentário enviado por gnu em 12/01/2015 - 10:22h


Olá. O script no artigo é o astnagios.sh. Dentro dele, é efetuada a cópia do arquivo .call diretamente para a pasta outgoing no servidor asterisk. No entanto, se fosse implementar a solução novamente hoje, faria de maneira diferente, com um banco de dados registrando as ligações, e forçando o receptor da chamada a registrar o recebimento da mesma através de alguma opção na URA. Na época, eu criei os arquivos up e down de cada host, e hoje também faria diferente, uma vez que é possível utilizar o serviço da google para enviar texto com o nome do servidor e receber o arquivo de áudio. Se tiver interesse em implementar a solução de maneira mais "elegante", me passe seu endereço de email, que lhe enviarei meu skype id. Gostaria de discutir com você a possibilidade de o implantarmos em conjunto, pois queria estabelecer essa solução com a devida documentação para servir de base para um artigo (estou precisando pra faculdade.. hhehehehe). Como aqui deixamos de utilizar por diversas razões, estou em busca de um ambiente para implementação.


Contribuir com comentário




Patrocínio

Site hospedado pelo provedor RedeHost.
Linux banner

Destaques

Artigos

Dicas

Tópicos

Top 10 do mês

Scripts