Como enviar alertas da HostTracker para o Slack

Como a integração funciona

Quando você adiciona um novo contato na HostTracker e escolhe Slack no seletor de tipo de contato, você não está criando um tipo diferente de contato nos bastidores. Ele é armazenado como um contato HTTP, e a HostTracker o reconhece como um destino Slack porque o endereço que você colou começa com https://hooks.slack.com/. Esse único detalhe é o que troca o formato da mensagem de um payload JSON genérico para uma mensagem compatível com o Slack, e é por isso que a configuração leva só uma URL e nada mais para configurar.

Configurando alertas do Slack passo a passo

1. No Slack, abra api.slack.com/apps e escolha Create New App, depois From scratch. Dê um nome como "HostTracker alerts" e escolha o workspace onde você quer que os alertas cheguem.
2. Nas configurações do app, abra Incoming Webhooks e ative.
3. Clique em Add New Webhook to Workspace, escolha o canal que deve receber os alertas da HostTracker, e clique em Allow.
4. O Slack gera uma URL de webhook começando com https://hooks.slack.com/services/. Copie-a.
5. Na HostTracker, adicione um novo contato e escolha Slack na lista de tipo de contato, depois cole a URL do webhook no campo de endereço.
6. Salve o contato, depois use Enviar teste para confirmar que uma mensagem de teste chega no canal antes de depender disso.

Se você já tem um webhook criado pelo fluxo mais antigo e agora descontinuado do diretório de apps do Slack, a URL dele ainda funciona do jeito que está; cole da mesma forma. Um webhook novo em folha precisa passar pelo fluxo baseado em app acima, já que o Slack aposentou o clássico para configurações novas.

Como um alerta aparece no canal

Cada alerta chega como uma mensagem curta em texto puro, não um cartão formatado. Um alerta de Fora do Ar nomeia o site, o horário, e uma descrição da falha, por exemplo um timeout de conexão ou um código de erro HTTP. Um alerta de No Ar nomeia o site, o horário em que se recuperou, e por quanto tempo esteve fora do ar. Um lembrete de ainda-fora-do-ar repete a duração da indisponibilidade e o erro, para que você veja se algo mudou sem abrir a HostTracker.

Se vários dos seus monitores falharem em uma janela curta, a HostTracker pode combiná-los em uma única mensagem em vez de postar um atrás do outro. Essa é a opção "Agrupar eventos" no contato. Usuários mais avançados também podem substituir a mensagem padrão por um template personalizado, desde que continue sendo um JSON válido de webhook do Slack com um campo text.

Escolhendo quais eventos chegam ao canal

Um contato Slack, como qualquer outro contato, se inscreve em monitores específicos e tipos de evento específicos em vez de em toda a sua conta. Há três eventos para escolher: Fora do Ar (o site acabou de cair), No Ar (o site se recuperou), e Repetir (um lembrete de que ainda está fora do ar). Um padrão comum é rotear Fora do Ar e No Ar para um canal compartilhado da equipe para que todo mundo veja o início e o fim de um incidente, e deixar Repetir desligado se os lembretes seriam ruído, ou ligado para um canal dedicado a um incidente que precisa de atenção constante até ser corrigido.

Solução de problemas

Algumas coisas quebram uma integração do Slack sem nenhum sinal visível, porque o Slack não entrega à HostTracker um erro que ela consiga mostrar para você dentro do aplicativo:

• Um webhook revogado ou apagado. Se o aplicativo do Slack foi removido ou o webhook foi regenerado, a URL antiga para de aceitar postagens. A HostTracker continua enviando para ela e a entrega falha, sem nenhum aviso dentro da HostTracker de que o canal ficou silencioso. Rode Enviar teste de novo sempre que alguém mexer nas configurações do aplicativo Slack, ou periodicamente como um hábito.
• O canal errado. Um Incoming Webhook fica atrelado ao canal que você escolheu quando o criou e não pode ser redirecionado depois. Se os alertas estão chegando no lugar errado, crie um novo webhook para o canal certo no Slack e cole a nova URL no contato.
• Um canal arquivado. O Slack para de aceitar postagens de webhook assim que o canal de destino é arquivado. Desarquive-o, ou crie um novo webhook apontado para um canal diferente e ativo e atualize o contato.
• Sem permissão para adicionar apps. Alguns workspaces do Slack restringem quem pode instalar novos apps ou aprovar acesso de webhook. Se o passo 1 ou o passo 3 acima estiver acinzentado ou bloqueado, peça a um administrador do workspace para criar o webhook para você ou conceder permissão para gerenciar apps.

Nenhuma dessas coisas aparece como um erro dentro da própria HostTracker. O contato ainda parece salvo e ativo, já que a HostTracker não tem como saber que o Slack rejeitou uma entrega do lado dele. Enviar teste depois de qualquer mudança do lado do Slack é o único jeito confiável de confirmar que o canal ainda está recebendo alertas.

Leitura relacionada

O Slack funciona melhor como um canal dentro de uma configuração de notificação mais ampla do que como o único. Veja a lista completa de canais e como construir uma cadeia simples de escalonamento em como receber alertas da HostTracker. Para o que a HostTracker verifica antes de decidir que o seu site está fora do ar, veja recursos da HostTracker e monitoramento de disponibilidade distribuído.

• Todos os guias de monitoramento - o hub para todo tipo de verificação que pode postar no Slack.
• O site está fora do ar para todo mundo ou só para mim - o que fazer primeiro quando uma mensagem de Fora do Ar chega no canal.
• Recursos da HostTracker
• Monitoramento de disponibilidade distribuído
• Como receber alertas da HostTracker