Notificações de Telegram - Grupo de Monitoramento de Host
Introdução
O que é monitoramento de host?
O monitoramento de host em concentradores refere-se ao acompanhamento e avaliação do desempenho e integridade desses dispositivos.
As Notificações em Grupo de Monitoramento de Host são alertas para manter a organização informada sobre o status dos hosts monitorados. Este documento descreve o processo de configuração e uso de notificações SMS para monitoramento de hosts no sistema.
Acesso à funcionalidade
Caminho: Sistema > Provedor > Monitoramento de ping > Grupo de monitoramento de host > aba Notificações > seção Telegram
Requisitos de uso
- Necessário ter uma conta cadastrada na plataforma Telegram;
- Utilização do recurso de Bot de Monitoramento no Telegram (BotFather).
Entrega de Valor
- Alertas em tempo real sobre o status dos hosts;
- Redução do tempo de resposta a problemas de rede;
- Melhoria na disponibilidade e qualidade do serviço.
Estrutura da Funcionalidade
Atenção:
É necessário realizar a configuração de Grupos de Monitoramento de Hosts para ativar as notificações de monitoramento SMS para monitoramento de host.
A configuração de envio de mensagens via Telegram está estruturada na aba de Notificações. Esta aba está relacionada ao formulário de Grupos de Monitoramento de Hosts e permite configurar o envio de notificações de alertas sobre o desempenho do grupo de monitoramento configurado.
Configuração da funcionalidade
Passo 1: Configuração do BotFather no Telegram
O BotFather é uma conta especial do Telegram que permite que os usuários criem, configurem e gerenciem alguns bots na plataforma. Tem como objetivo auxiliar desenvolvedores a criar bots na plataforma. Neste caso, este recurso será utilizado como gerenciamento de host.
Dica:
Altere as configurações do seu navegador para facilitar o entendimento do passo a passo descrito no chat do Telegram.
Para realizar a configuração do BotFather, siga os passos a seguir:
- Acesse o Telegram e na barra de pesquisa insira a busca BotFather;
- Selecione o perfil apresentado e abra um chat com o BotFather;
- No chat, envie a mensagem de comando: /newbot;
- Após, informe um nome ao seu bot conforme solicitado pela plataforma;
- Inclua ao nome informado para o bot, o sufixo
_bot. Exemplo:ixchost_bot. - Após definir o nome do Bot, um token será gerado. Guarde-o em um bloco de notas, será utilizado nas próximas configurações.
- Com o bot cadastrado, é necessário cadastrar um grupo no Telegram com o Bot. Este processo visa extrair o ID do chat, dado importante para a comunicação entre as plataformas envolvidas. Clique no ícone de lápis em azul localizado no menu lateral esquerdo do Telegram e selecione a opção New Group/Novo grupo para o cadastro de um grupo;
- Na criação do grupo, adicione como membro o bot cadastrado. Para localizá-lo, insira na barra de consulta o nome do bot (exemplo:
ixchost_bot); - Com o grupo criado, abra o chat de conversa e envie o comando /start no chat, para iniciar o uso do bot;
- Acesse uma nova guia em seu navegador e na barra de consulta, localizada na parte superior da tela, insira a busca: https://api.telegram.org/bot(token)/getUpdates, substituindo o campo (token) pelo token adquirido ao definir um nome para o Bot (passo 6);
- Após aplicar a busca no navegador, será retornada uma página contendo os dados do bot no Telegram. Localize a linha que contém as informações de “
my_chat_member”. Ao lado, será apresentado o Chat ID, na seguinte estrutura:{"id":--123456789, ...}(exemplo ilustrativo). Copie somente a numeração do código e o traço que o antecede (-123456789) e armazene-o.
Passo 2: Cadastro Telegram Bot Marketing no IXC
Após configurar o Bot no Telegram, é necessário cadastrá-lo visando a comunicação do bot com o sistema. Siga os passos a seguir:
- Acesse o formulário **Telegram Bot Marketing através do caminho: Sistema > CRM > Mensagens > Telegram Bot Marketing;
- Clique em Novo;
- Preencha os campos:
- Token Bot: insira o token adquirido no passo 1;
- Mensagem: informe uma mensagem demonstrativa. O sistema envia uma mensagem padrão na notificação enviada ao responsável;
- Chat ID: insira o Chat ID adquirido no passo 1.
- Clique em Salvar para validar as modificações.
Passo 3: Configuração no grupo de monitoramento
Para a notificação ser enviada, é necessário vinculá-la ao grupo de monitoramento para identificação das condições do host.
- Acesse o formulário de Grupos de Monitoramento de Hosts através do caminho: Sistema > Provedor > Monitoramento de ping > Grupo de monitoramento de host;
- Edite um grupo já cadastrado e acesse a aba Notificações;
- Localize a seção Telegram;
- Preencha os campos:
- Token Bot Telegram: clique na lupa e selecione a integração cadastrada;
- Telegram chat ID responsável: insira o Chat ID adquirido no passo 1.
- Clique em Salvar para finalizar as configurações de notificações.
Passo 4: Configuração do Monitoramento de Host
Com as notificações configuradas no Grupo de Monitoramento de Host, é necessário relacionar o Grupo de Monitoramento de Host ao cadastro do host, em Monitoramento de Hosts. Siga os passos abaixo:
- Acesse o formulário de Monitoramento de Hosts através do caminho: Sistema > Provedor > Monitoramento de ping > Monitoramento de host;
- Clique em Novo para cadastrar o host que será monitorado ou clique em Editar para editar configurações já existentes;
- Preencha o campo de Grupo de Monitoramento com o grupo cadastrado no passo anterior. Preencha os demais campos obrigatórios;
- Clique em Salvar para validar as modificações.
Manual:
Confira o manual completo de cadastro de Monitoramento de Host: Monitoramento de Host.
Passo 5: Cadastro da Tarefa - Monitoramento de Host
Com o cadastro de Monitoramento de Host, é necessário realizar o cadastro da tarefa responsável por atualizar o status do host. Para realizar a configuração da tarefa, siga os passos abaixo:
- Acesse o formulário de Agenda de tarefas através do caminho: Ferramentas > Ferramentas > Agenda de tarefas;
- Clique no botão Novo para cadastrar a tarefa;
- No campo Tarefa, selecione a opção Monitoramento de Host;
- Preencha um intervalo de minutos de execução no campo Minuto, conforme a seguinte estrutura:
*/10. Desta forma, a execução ocorrerá a cada 10 minutos, atualizando periodicamente. Identifique o melhor período de execução para monitoramento interno dos dispositivos e insira no campo ao realizar o cadastro da tarefa. - No campo Hora, marque a opção Todos para a tarefa executar em todos os horários;
- Na seção Dia do mês, marque a opção Todos para a tarefa executar todos os dias do mês (irá respeitar o intervalo de semana caso não deva executar todos os dias);
- Na seção Mês, marque a opção Todos para a tarefa executar todos os meses;
- Na seção Dia da semana, marque a opção Todos, para o sistema executar a tarefa todos os dias da semana,
- Após preencher os campos, clique em Salvar para validar a criação da tarefa. Após a configuração da tarefa, ela seguirá executando automaticamente e irá identificar os concentradores configurados e atualizar seus respectivos status.
Fluxo de Trabalho
sequenceDiagram participant Sistema participant Telegram Bot participant Administrador Sistema->>Sistema: Detecta servidor inativo Sistema->>Telegram Bot: Envia requisição de Notificação push Telegram Bot ->>Administrador: Entrega notificação push de alerta Administrador->>Sistema: Verifica e resolve o problema
Considerações Finais
As notificações via Telegram oferecem uma camada adicional de segurança ao monitoramento de hosts, permitindo respostas rápidas a incidentes. Ao implementar esse sistema, a empresa melhora significativamente sua capacidade de manter a infraestrutura estável e responder prontamente a problemas críticos.
Etiquetas
Monitoramento SMS Alertas InfraestruturaDeRede