Como configurar Torpedo de Voz no Zabbix

Se você quer saber como configurar um script de envio de torpedo de voz no Zabbix através da API da Nvoip, aqui te apresentamos um tutorial com o passo a passo para realizar essa operação.

O que é Zabbix?

Zabbix é uma das ferramentas open source mais conhecidas e mais utilizadas no mundo para monitoramento de redes, servidores e serviços. Ela fornece métricas de monitoramento, histórico e permite também executar ações nos serviços monitorados.

Uma ferramenta de monitoramento é indispensável na vida de qualquer equipe, profissional de TI ou empresa que atua com a tecnologia como base do seu negócio.

Mas ficar monitorando os gráficos do Zabbix dia e noite, pode ser uma tarefa árdua e quase impossível para um ser humano, e por isso, o Zabbix oferece nativamente o que chamamos de Midia, que são os canais em que o usuário pode ser notificado caso algum problema ocorrer.

Quais os tipos de mídia posso usar no Zabbix?

Por padrão, você pode configurar um servidor SMTP e receber e-mails caso algum incidente aconteça. O problema é que, caso você não esteja com o e-mail aberto, provavelmente não irá ver a tempo de resolver o incidente no menor tempo possível.

Também existe a função de usar um gateway GSM no Zabbix mas, hoje em dia, muitos servidores Zabbix são instalados nas nuvens, o que impediria o uso de um Gateway GSM.

Além disso, configurar um gateway GSM é mais demorado que configurar uma API de SMS.

Por que usar torpedo de voz no Zabbix?

O torpedo de voz tem uma grande vantagem sobre o SMS de texto pois ele consegue se comunicar não apenas com o telefone celular mas também com telefones fixos de uma só vez.

O que preciso para configurar envio de torpedo de voz no Zabbix?

Neste tutorial, você vai precisar dos seguintes itens para configurar o Zabbix Torpedo de Voz:

• Servidor Zabbix (Neste tutorial usamos um Servidor Linux CentOS 7 rodando o Zabbix 4.2).
• Conhecimentos básicos em Linux para acessar o seu servidor e inserir o script.
• Token Nvoip (Se ainda não tem conta Nvoip, crie uma conta grátis e ganhe R$5,00 em créditos, acesse o painel da Nvoip)

Instruções

Nível técnico: Básico

Tempo estimado: 10 minutos

Acesse o nosso repositório Zabbix no GitHub para pegar o script send_torpedovoz_nvoip_zabbix.sh atualizado.

Vamos entender o script. O código está comentado para facilitar.

As variáveis $1 e $2 serão passadas pelo Zabbix, sendo que a variável $1 obrigatoriamente deverá ser o telefone que irá receber a ligação. A variável $2 é o áudio que será tocado.

O script irá ser executado pelo Zabbix toda vez que um incidente for acionado, disparando os dados para a nossa API.

Atenção: Você só precisa alterar a variável token_auth com seu token da Nvoip.

#!/bin/bash

#Nvoip - Torpedo de Voz

#Copyright (C) 2020 Nvoip Plataforma Telefonia Ltda
#Leandro Campos <https://www.linkedin.com/in/leandro-campos/>
#License https://www.gnu.org/licenses/gpl-3.0.html

#This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by #the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

#This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Affero General Public License for more details.

#You should have received a copy of the GNU General Public License along with this program.  If not, see <https://www.gnu.org/licenses/>.

###Inicio do Script###
# Seu Token da Nvoip. Acesse https://www.nvoip.com.br, crie sua para ter acesso ao seu Token.
# English: Your Nvoip Token. Visit https://www.nvoip.com.br, create yours to have access to your Token.

token_auth="TOKEN NVOIP"

# O número do seu usuário(ramal) na Nvoip. O mesmo não precisa estar online.
# English: Your Nvoip username (extension). It does not have to be online.
caller="USUÁRIO NVOIP"

#$1 e $2 são os parâmetros, em ordem, que você define no seu Servidor Zabbix. O $1 é o número que irá receber a chamada. Você pode reduzir, alterar a ordem ou acrescentar mais parâmetros.
#English: $1 and $2 are the parameters, in order, that you set in your Zabbix Server. $ 1 is the number that will receive the call. You can reduce, change the order or add more parameters.

curl --include \
     --request POST \
     --header "Content-Type: application/json" \
     --header "token_auth: $token_auth" \
     --data-binary "{
    \"caller\":\"$caller\",
    \"called\":\"$1\",
    \"audio\":\"$2\"
}" \
'https://api.nvoip.com.br/v1/torpedovoz'

Consulte o caminho da sua instalação do Zabbix onde deve ser colocados os scripts no arquivo zabbix_server.conf. Geralmente este arquivo está em /etc/zabbix/zabbix_server.conf.

Copie o arquivo send_torpedovoz_nvoip_zabbix.sh para dentro do diretório de scripts. (No nosso caso, o diretório de script é o /usr/lib/zabbix/alertscripts).

Defina as permissões do arquivo:

chown zabbix:zabbix send_torpedovoz_nvoip_zabbix.sh (Verifique qual usuário você usou no se Zabbix)
chmod 777 send_sms_nvoip_zabbix.sh

Acesse seu Zabbix e vá em Administração > Tipo de Mìdia e clique em criar tipo de Mídia. Use as informações abaixo:

Nome: SMS Nvoip
Tipo: Script
Nome Script: send_torpedovoz_nvoip_zabbix.sh
Parâmetro:
{ALERT.SENDTO} - Não altere aqui. Ele vai pegar a variável do telefone da configuração do usuário.
{ALERT.SUBJECT} - Aqui você pode por um aúdio personalizado também com extensão MP3. Lembre-se de colocar um áudio que possa ser acessível pela internet e que não seja maior que 500Kb para evitar problemas na reprodução.
Ativo: Sim  

Observação: Veja na imagem que marquei os campos que são as variáveis que o Zabbix envia pro Script de Envio de Torpedo de Voz. Com exceção da variável $1 que fica no primeiro campo, você pode enviar outras variáveis, consulte a documentação da sua versão do Zabbix para saber as variáveis possíveis.

Vá em Administração > Usuários e selecione o usuário que irá receber o SMS. Clique em mídia e depois em adicionar. Configure com os dados abaixo:

Tipo: Torpedo de Voz Nvoip
Enviar para: (Coloque aqui o telefone que irá receber a ligação. Se atente que deve colocar aqui do mesmo modo que você faz ligações pelo softphone da Nvoip. Se alterar as configurações padrões de discagem, deve alterar aqui também. O Padrão é DDD+Telefone.
Ativo quando: 1-7,00:00-24:00 (Ou de acordo com a sua preferência)  
Usar se severidade: Marque as opções de severidade da trigger que irá disparar a ligação.
Ativo: Sim  

Pronto. Para testar você pode voltar em Administração > Tipos de Mídia e fazer um disparo ou acionar um incidente.

Se preferir, acesse o vídeo deste tutorial no nosso Canal no YouTube ou veja abaixo:

Gostou? Compartilhe. Incentive para que possamos colocar mais conteúdos como este nas nossas redes sociais.