Habilitar integração com um conector personalizado

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 6 min. de leitura

    • Integre o conector personalizado com Gestão de eventos adicionando um webhook padrão no console do conector personalizado. Configure o conector personalizado copiando o valor de URL exibido para a área de transferência e usando-o para configurar o webhook no console do conector personalizado.

    Antes de Iniciar

    Certifique-se de que o plug-in Gestão de eventos connectors (sn_em_connector) esteja instalado na instância Now Platform.

    Certifique-se de que os itens de configuração dos hosts gerenciados pelo conector personalizado existam na instância Now Platform. Esses ICs podem ser físicos ou virtuais e podem ser criados manualmente ou descobertos por meio de descoberta de IP ou Descoberta na nuvem.

    Função necessária: evt_mgmt_admin

    Por Que e Quando Desempenhar Esta Tarefa

    Configure o ambiente Gestão de eventos para a coleção de eventos do seu conector personalizado autenticando o conector personalizado como uma fonte de dados. No console do conector personalizado, defina sua instância Now Platform como o endpoint REST usando um webhook padrão.

    Procedimento

    1. Na guia Procurar integrações, selecione a lista suspensa Todas as integrações e selecione Personalizado.
    2. Selecione um bloco de conector personalizado.
    3. Na página Fornecer detalhes, forneça os detalhes do conector.
      1. No campo Nome do conector, insira um nome de integração significativo exclusivo para o tipo de conector.
      2. Opcional: No campo Descrição, insira informações para ajudar a identificar este tipo de conector.
      3. Opcional: Na lista suspensa Grupo de atribuição, selecione o registro da tabela de grupos de atribuição que contém o grupo de atribuição do conector.
      4. No campo Origem, insira o fornecedor e o protocolo usados para coletar eventos da origem de evento externo.

        Essas informações são usadas como um identificador para reconhecer eventos e para permitir que você reconheça a origem de eventos e alertas facilmente depois que o conector estiver ativo.

    4. Opcional: Defina marcadores a serem adicionados a eventos para marcar e identificar conectores desse tipo e monitorar seus alertas no Lista expressa.
      1. Ao lado do campo Marcadores, selecione o sinal de mais.
      2. No menu pop-up, insira uma chave de marcador e um valor.
      3. Selecione Adicionar.
    5. Opcional: Arraste ou carregue um logotipo do seu sistema para exibir no bloco do conector.
      • Arraste uma imagem para a caixa.
      • Selecione Carregar imagem e selecione a imagem do seu sistema de arquivos.
      O tamanho máximo do arquivo de carregamento é de 1 MB.
    6. Determine se você deseja conectar eventos diretamente à instância do ITOM ou por meio de um MID Server.
      • Para seventos de término para a ITOM instância, selecione Diretamente para a instância do ITOM.
      • Para enviar eventos por meio de um MID Server, que processa a mensagem do evento e, em seguida, passa o evento para a instância, sselecione Via MID Server.

        Se o MID Server existir, selecione-o nos MID Servers disponíveis conectados a um ouvinte de eventos. Se você precisar criar um MID Server, configure a extensão do MID Web Server ou o Contexto do coletor de eventos do serviço Web MID. Para obter mais informações, consulte Configurar a extensão MID Web Server e Configurar o Contexto do coletor de eventos de MID Web Server.

    7. Selecione Avançar.
    8. Selecione um método para coletar dados de evento .
      Se você tiver um sistema dinâmico para transmitir eventos, selecione Reunir eventos de origem real para definir campos. Se você tiver uma amostra JSON, selecione Usar uma amostra JSON para mapear campos.
      MétodoDescrição
      Reúna eventos de origem reais para definir campos
      1. Selecione Reunir eventos de origem reais para definir campos para aumentar os eventos e a precisão do alerta usando vários eventos como referência.
      2. Selecione Copiar para a área de transferência e copie o URL.
      3. Cole o URL na configuração do webhook para criar um webhook que permite que o conector de terceiros envie eventos para a instância ServiceNow. Ao coletar eventos de origem real do conector de terceiros, você aumenta os eventos e a precisão do alerta usando vários eventos como referência para definir os campos.
      4. Selecione Verificar eventos. Arquivos JSON são criados.
      Usar uma amostra JSON para mapear campos
      1. Selecione Usar uma amostra JSON para mapear campos.
      2. Na caixa de diálogo Inserir carga, copie e cole uma carga de amostra JSON para criar e exibir o mapeamento para mapear os campos.
      3. Selecione Carregar JSON.
      4. Selecione Editar ou colar novo JSON para editar o JSON que você carregou ou colar um novo.
    9. Selecione Avançar.
    10. Na página Mapear campos, habilite o sistema para criar eventos corretamente nos dados de entrada mapeando os campos na amostra de código JSON para os campos ServiceNow.
      1. Copie e cole a amostra de código JSON retirada da carga útil JSON do conector personalizado na amostra de código JSON da coluna custom_test.
        As informações de Severidade e Chave da mensagem são preenchidas automaticamente para economizar tempo e esforço. A chave de mensagem fornece o identificador correto dos eventos para que a desduplicação funcione corretamente e alertas redundantes não sejam gerados, por exemplo.
      2. Na coluna de nomes de campo do conector, insira pelo menos um valor que seja mapeado para os valores de severidade listados na coluna ServiceNow do campo Severidade.

        Você pode inserir o valor de severidade da amostra de código JSON. Para definir um valor de severidade, você deve estar familiarizado com a carga do seu conector de terceiros e com os tipos de severidade compatíveis com o conector. Os valores de severidade dos eventos recebidos devem corresponder aos eventos gerados em seu sistema.

    11. Selecione Avançar e salve.
    12. Na tela Configurar conector por push, copie o valor do parâmetro da URL gerado automaticamente para a área de transferência selecionando Copiar para a área de transferência.
    13. Opcional: Na seção Outros campos, na coluna do conector, forneça parâmetros de evento de terceiros que não são obrigatórios, mas fornecem informações adicionais sobre o evento.
      Se você optar por não fornecer as informações opcionais, deixe o campo em branco.
      1. No campo Descrição, insira uma descrição de alerta significativa.
      2. No campo Nome da métrica, insira o nome de uma métrica que permite ques associe eventos às métricas de desempenho ou aos KPIs que acionaram o alerta.
      3. No campo Nó, insira um valor de nó a ser usado para vinculação de IC.
      4. No campo Hora do evento, insira a hora de criação do evento de terceiros.
        Se a hora do evento não estiver mapeada, o sistema usará a hora do evento padrão.
      5. No campo Configurações de hora do evento, selecione o formato de hora e o fuso horário do evento.
        • Formato de hora: um campo GlideDateTime no formato UTC ou GMT com um tamanho máximo de 40 caracteres.
        • Fuso horário: as horas são armazenadas no Tempo Universal Coordenado (UTC) e aparecem globalmente com base no fuso horário do sistema.
    14. Selecione Avançar.
    15. Na tela Configurar conector, no campo Valor do parâmetro da URL, selecione Copiar para a área de transferência para copiar o valor do parâmetro da URL gerado automaticamente para a área de transferência.
    16. Cole o URL na configuração do webhook e insira suas credenciais de autenticação básica na configuração do webhook do sistema de monitoramento (como o nome de usuário e a senha).

      O webhook permite que o conector de terceiros envie eventos para a instância ServiceNow.

    17. Ative e salve o conector selecionando Ativar e, em seguida, selecione OK na janela pop-up de confirmação.
      Você pode exibir os detalhes do conector na guia Detalhes e os mapeamentos de campo na guia Mapeamento de campos.
    18. Opcional: Verifique se o processo foi concluído com sucesso e se os eventos estão fluindo para o sistema, selecionando a guia Eventos relacionados e exibindo os eventos relacionados.

    Resultado

    Depois que o conector é ativado, os eventos começam a fluir do console do conector personalizado para a instância ServiceNow. O plug-in extrai informações da mensagem original do evento do conector personalizado para preencher os campos de evento obrigatórios e insere o evento no banco de dados. Para ver os eventos na sua instância Now Platform, navegue até Todos Eventos. Para obter mais informações, consulte Exibir eventos.

    O que Fazer Depois

    Para criar uma automação de alerta, selecione Adicionar automação. Para obter mais informações, consulte . A origem e o grupo de atribuição são preenchidos automaticamente na automação de alerta.