O app do Slack é uma funcionalidade em beta do AppSignal Labs. Se você configurou um notificador do Slack antes do lançamento dele, veja Migrando um notificador existente.
Instalação
- Vá em Notifications na sua organização AppSignal e selecione Add new notifier.
- Escolha Slack na lista de notificadores.
- Em Configure this integration, selecione Install Slack notifier para iniciar o fluxo de autorização do Slack.
- No Slack, autorize o app do AppSignal para seu workspace e selecione o canal para onde postar.
- Você é redirecionado de volta ao AppSignal, onde o notificador aparece em Active notifiers.
- Selecione Manage ao lado do notificador para concluir a configuração.
Abra suas configurações de notificação
Configuração
Selecione Manage ao lado de um notificador na página Notifications para configurá-lo. A página tem quatro seções:- Settings for this notifier — o nome do notificador, como “Erros críticos” ou “Alertas operacionais”. Edit configuration on Slack abre as configurações do notificador no Slack.
- Scope notifier to the following apps — os apps e ambientes cobertos por este notificador.
- Enable notifier for new applications — quando habilitado, todo app e ambiente que você adicionar depois usa este notificador por padrão.
- Send notifications for the following events — deploys, erros e traces de desempenho. Erros e desempenho podem ser filtrados por namespace: selecione os namespaces desejados, ou desmarque todos para cobrir todos os namespaces.
Como as notificações aparecem
Cada notificação no Slack inclui detalhes contextuais sobre o evento:- Erros incluem o nome da exceção, a mensagem, as primeiras linhas do backtrace, a action e o caminho da requisição.
- Performance traces incluem o nome da action, duração, método da requisição e caminho.
- Deploy markers incluem a revisão (com um link para comparar as alterações quando disponível), o namespace e o usuário que fez o deploy.
- Alertas de métrica incluem o nome do trigger, o valor atual, as tags e um link para o alerta no AppSignal.
- Alertas de heartbeat e de Process Monitoring incluem o identificador e o tempo esperado de conclusão.
- Alertas de log incluem o nome do trigger, a severidade e a mensagem de log correspondente.
O que você pode fazer a partir de uma notificação
Notificações de incidentes de erro e desempenho trazem controles. Deploy markers e alertas são publicados sem controles.- Close incident — fecha o incidente. A mensagem passa a mostrar “Closed by” e o seu nome, e o botão se torna Reopen incident.
- Reopen incident — reabre um incidente fechado.
- Change assignees — abre uma caixa de diálogo listando os membros daquele app. Pesquise por nome e selecione quantos precisar.
- Change severity — abre uma caixa de diálogo para definir a severidade do incidente: não triada, crítica, alta, baixa ou informativa.
As mensagens permanecem atualizadas
O AppSignal edita uma mensagem do Slack quando o incidente que ela descreve muda de estado, severidade ou responsáveis. Mudanças feitas por você no AppSignal também contam. Um canal passa então a refletir o estado atual dos seus apps, e não uma lista de alertas que você já tratou.Vinculando sua conta do Slack
O AppSignal precisa saber qual usuário do AppSignal está por trás de uma ação no Slack. Na primeira vez que você usar uma, o AppSignal pede que você vincule sua conta do Slack e, em seguida, aplica a ação selecionada. Suas ações seguintes são aplicadas imediatamente. As ações disponíveis são limitadas às permissões do usuário vinculado. Se o usuário não tiver acesso ao app, uma ação solicitada será negada.Permissões que o AppSignal solicita
Durante a autorização, o app do AppSignal para Slack solicita:incoming-webhook— acesso ao canal que você seleciona durante a autorização.chat:write— publicar mensagens e editá-las depois.chat:write.public— publicar em um canal público sem precisar adicionar o app antes.
Migrando um notificador existente
Notificadores do Slack configurados antes do lançamento do app atual do Slack continuam enviando notificações. Eles estão descontinuados, e você precisa migrá-los para obter controles de incidente e atualizações de mensagem.Se você ainda precisa migrar o app do Slack, um banner fica visível enquanto você estiver na página Notifications. Se o banner não aparecer e você já tiver notificadores do Slack ativados, você está na versão correta.
- Na página Notifications, selecione Manage ao lado do notificador do Slack.
- No banner de descontinuação, selecione Migrate to Modern Slack e confirme.
- O Slack abre. Reautorize o app do AppSignal por lá.
- O nome do notificador, os apps, os tipos de notificação, os filtros de namespace e a configuração “enable for new apps” são mantidos.
- Todo alerta de métrica, uptime monitor, heartbeat e process monitor, e alerta de log que usava o notificador passa a apontar para o novo.
- O notificador anterior é removido.