Configurar IO notificações de alerta para uma aplicação de terceiros

Configure uma integração básica entre Instance Observer( IO e integrações de terceiros para rotear IO Notificações de alerta para um sistema externo, além de e-mails e SMS.

Antes de Iniciar

Função necessária: administrador

Importante:

As integrações de terceiros não são compatíveis com o Mercado regulamentado.

Por Que e Quando Desempenhar Esta Tarefa

Nota:

Plataformas de suporte de integrações de terceiros, como Slack, Microsoft Teams, AWS, GCP e. Azure.

Para integrações de terceiros, os URLs do webhook podem expirar se uma assinatura não for renovada ou as chaves de API podem ficar inválidas ao longo do tempo. Certifique-se de que suas credenciais de integração sejam mantidas atualizadas para evitar entregas de alertas perdidas.

Procedimento

1. Navegar até Impacto > Integridade da plataforma > Monitor > Vá para Observador de instância.
2. Faça login em Instance Observer e navegue até Alertas > Configurar Notificação.
3. Selecione - Criar integração .
4. No formulário, preencha os campos.
   Para uma integração de terceiros, insira o seguinte:

   Tabela 1. Criar formulário de integração

   Campo	Descrição
   Tipo de integração	Terceiros. ServiceNowé selecionado por padrão.
   Nome da integração	Nome para identificar a integração.
   Tipo de autenticação	Autenticação básica ou uma chave de API para a integração. Para Chave de API, forneça a chave ou o nome de usuário e a senha para a integração.
   Nome de usuário	Nome de usuário associado à integração.
   Senha	Senha da integração.
   Insira o URL	URL do webhook conforme configurado em sua aplicação de terceiros (externa). Para obter mais informações, consulte Create a scripted REST API.

   

5. Selecione Integração de teste para validar sua configuração e verificar se você pode enviar com sucesso a carga para a aplicação configurada.

   Se você não tiver os detalhes corretos do URL em mãos, poderá salvar a integração como Rascunho e retorne para concluir mais tarde.

   • Se o teste for bem-sucedido, você receberá um A resposta HTTP 200 foi bem-sucedida resposta. Agora você pode prosseguir para enviar a integração.
   • Se o teste falhar, uma mensagem de erro será exibida em vermelho. Revise e corrija os detalhes da integração, como URL do webhook, nome de usuário ou senha, e teste novamente.
     Importante:

     Um resultado de teste bem-sucedido é necessário antes que você possa enviar a integração. Se você tentar enviar sem testar, uma mensagem de validação será exibida: Resultados de integração de teste bem-sucedidos necessários para enviar sua integração ou salvar como rascunho se você não tiver um URL funcional.
6. Enviar a integração e salve-a quando o teste for bem-sucedido.
   A integração é criada com um status Habilitado .
7. Verifique o status da integração.
   Em Integrações confirme se o status de integração é exibido como Habilitado .

   Nota:

   Apenas integrações com um Habilitado o status aparece em Regras de notificação para vincular à regra de notificação. As integrações de rascunho não estão disponíveis para seleção até que sejam concluídas e habilitadas.
8. Para configurar uma regra de notificação para a integração de terceiros e enviar alertas para aplicações de terceiros, selecione Regras de notificação .
   1. Selecione para a regra de notificação, e selecione Editar opção.
   2. Insira um nome para a regra no Nome Campo do pop-up Editar regra.
   3. Insira uma descrição para a regra de notificação.
   4. Selecione Integração de terceiros opção como Tipo de notificação e selecione um valor na lista.
   5. Selecione Save (Salvar).
9. Verifique a entrega da carga de alerta no Console de alerta navegando até Alertas > Console de alerta.
   Para confirmar se sua integração está funcionando corretamente depois que um alerta é acionado:
   1. Selecione sua instância e. Obter snapshot em Console de alerta .
   2. Em Gerar alerta de teste selecione o alerta configurado.
      O alerta de teste que você configurou aparece na lista. Por exemplo, Tempo de resposta do banco de dados alerta na sua instância.
   3. Verifique se a carga de alerta foi entregue com sucesso ao endpoint de integração configurado, que é uma instância de terceiros.
      A carga de alerta atinge a instância de terceiros, desde que o URL do webhook aceite as chamadas HTTP.
   4. Verifique se o alerta com a carga especificada atingiu o destino pretendido.
      Se o alerta tiver falhado, você verá que Tipo de alerta está em vermelho, o que significa que falhou. Falha ao selecionar Autoatendimento ícone de alerta você verá a mensagem Integração de terceiros – Falha .
10. Para exibir, editar ou excluir o URL no pop-up Editar integração, navegue de volta para Alertas > Configurar Notificações e selecione para a integração.
    Você pode atualizar as configurações de integração selecionando Editar opção. . Excluir a opção permanecerá inativa se a integração estiver associada a pelo menos uma regra de notificação.
11. Identificar e resolver falhas de integração.
    Se uma integração falhar após ter sido habilitada, por exemplo, devido a um URL de webhook expirado, uma chave de API inválida ou credenciais expiradas, então IO detecta a falha e sinaliza-a para sua atenção. Para identificar e resolver uma integração com falha:

    1. Em Console de alerta , procure alertas exibidos em vermelho em Tipo de alerta coluna. Um indicador vermelho significa que a carga de alerta falhou ao entregar a notificação.
    2. Selecione Falha link para exibir os detalhes completos do erro. Por exemplo, A. 404 Erro indicando que o URL é inválido ou que a chave de API expirou.
    3. Selecione Atualizar integração Para editar a integração com as credenciais corretas ou o URL do webhook, teste-o com sucesso e reenvie para restaurar a integração para Habilitado status.
    4. Como alternativa, você pode navegar até Alertas > Configurar NotificaçãoE selecione a integração com o status Falha no Integração . Editar A configuração de integração, teste a integração e, quando for bem-sucedida, reenvie-a para restaurar a integração para o status Habilitado.

    . Excluir a opção permanecerá inativa se a integração estiver associada a pelo menos uma regra de notificação.

    Importante:

    Até que a integração seja corrigida e rehabilitada, as cargas de alerta não serão entregues ao endpoint com falha.

    Canais de notificação de alerta de E/S.

    Você pode exibir as falhas de integração como alertas em três lugares:

    1. Como Tipo de alerta em Alerta > Console de alerta
    2. Notificações de . Selecione Exibir histórico de notificações e filtrar com Falha na integração .
    3. Como uma notificação por e-mail com o nome da integração, o número do erro e a mensagem.