Office 365 /Canal de alertas do Microsoft Teams

Para enviar notificações de alerta do Instana para o Office 365 ou para o Microsoft Teams, crie um canal de alerta.

As notificações de alerta são enviadas para o Office 365 ou para o Microsoft Teams em tempo real, utilizando fluxos de trabalho ou webhooks de entrada.

Pré-requisitos

Antes de começar, certifique-se de que possui um fluxo de trabalho ou um webhook URL para se conectar a Office 365 ou Microsoft Teams.

Importante: Descontinuação dos conectores do Office 365 : Com adescontinuação dos conectores do Office 365 no Microsoft Teams, a criação de novos conectores será bloqueada a partir de 15 de agosto de 2024. Os webhooks existentes são compatíveis até que a Microsoft os remova completamente. Consulte as instruções a seguir para migrar para fluxos de trabalho o mais rápido possível.

Passos para a migração para fluxos de trabalho : Para migrar dos canais de alerta existentes que utilizam um webhook URL, substitua o campo Workflow / Webhook URL na interface do usuário por um fluxo de trabalho válido URL. Siga o procedimento “Obter um fluxo de trabalho ou webhook” URL para criar as URLs do fluxo de trabalho para o seu canal.

Observação: há alterações no design dos alertas recebidos por meio de fluxos de trabalho, uma vez que utilizam um modelo d AdaptiveCard. Os canais de alerta existentes que utilizam um webhook de entrada URL seguem o design antigo, utilizando o modelo MessageCard. Para obter mais informações sobre as alterações no design, consulte Exemplos de alertas.

Como obter um fluxo de trabalho ou um webhook URL

Fluxos de trabalho : Siga as instruções da Microsoft para criar um fluxo de trabalho usando o modelo Post to a channel when a webhook request is received.

Verifique as configurações de permissão necessárias para os canais do Microsoft Teams.
  1. Canal público: Se a moderação do canal estiver ativada, certifique-se de selecionar a Allow bots to submit channel messages permissão em Microsoft Teams nas configurações do canal.
  2. Canal privado: Por padrão, os bots de fluxo de trabalho não oferecem suporte à postagem em canais privados. Como solução alternativa, modifique o fluxo de trabalho para postar como um usuário.

Webhooks de entrada : Não será possível criar novos conectores de webhooks de entrada no Microsoft Teams após 15 de agosto de 2024. Para migrar dos webhooks de entrada existentes para os fluxos de trabalho, siga as etapas descritas na seção “Fluxos de trabalho” e atualize o webhook do canal de alertas Instana URL para o fluxo de trabalho URL

Para configurar um Incoming Webhook para a integração do canal de alertas Office 365 ou Microsoft Teams, consulte Enviar solicitações externas para o Teams com o Incoming Webhook.

Criar um canal de alertas no Office 365 ou Microsoft Teams

Use a interface do usuário do Instana para configurar seu canal de alertas:

  1. Na barra de navegação principal, clique em Configurações > Configurações globais.
  2. Na seção Eventos e alertas, clique em Canais de alerta.
  3. Clique em “Adicionar canal de alerta ”.
  4. Na janela “Adicionar um canal de alerta ”, selecione Office 365 / Microsoft Teams na lista de canais unidirecionais disponíveis. Em seguida, clique em “Adicionar canal de alerta ”.
  5. Configure as definições do seu canal de alertas:
    • Nome : Insira um nome exclusivo para identificar o canal.
    • Fluxo de trabalho / Webhook URL : Insira o endereço URL do fluxo de trabalho ou webhook configurado para enviar as notificações de alerta.
    • Você pode clicar em “Testar canal” para verificar se as configurações do canal estão corretas e se é possível receber uma notificação de teste.
    • Equipes : Opcionalmente, você pode marcar o canal para que os membros da equipe ou equipes especificadas possam encontrá-lo mais facilmente na interface do usuário.

    Canal de alerta do Office 365/Microsoft Teams

  6. (Opcional) Expanda a seção “Avançado” para personalizar as notificações:
    • - Adicionar fuso horário : defina um fuso horário específico para garantir que os destinatários vejam as mensagens na hora local, em vez da hora padrão UTC.
      Figura 1. Incluir fuso horário
      Incluir fuso horário

      Para adicionar um fuso horário, clique em “Adicionar fuso horário ”. Em seguida, selecione o fuso horário de sua preferência para as notificações de alerta.

Exemplos de alertas

Depois de criar o canal de alertas, o Instana envia alertas de eventos como um HTTPPOST para o Office 365 ou Microsoft Teams Workflow ou Webhook URL ( HTTP ou HTTPS ) configurado, que é o endereço para o qual os alertas são enviados.