Configure um conector personalizado de evento

Autentique seu conector personalizado de evento como uma fonte de dados para habilitar o envio de informações de evento para seu ServiceNow instância. Defina o conector personalizado fornecendo seus detalhes e campos de mapeamento. Isso permite que as informações extraídas das mensagens de evento do conector personalizado preencham os campos de evento obrigatórios. Por fim, crie e forneça uma URL para o webhook do conector personalizado.

Antes de Iniciar

• Certifique-se de Gestão de eventos o plug-in conectores (sn_em_connector) está instalado no ServiceNow AI Platform instância. Para obter mais informações, consulte Configurar Gestão de eventos conectores.
• Certifique-se de que os itens de configuração dos hosts gerenciados pelo conector personalizado existam no ServiceNow AI Platform instância. Esses ICs podem ser físicos ou virtuais e podem ser criados manualmente ou descobertos por meio da descoberta de IP ou Descoberta na nuvem. Para obter mais informações, consulte Acesso a ambientes de nuvem para ITOM produtos.

Função necessária: evt_mgmt_admin

Por Que e Quando Desempenhar Esta Tarefa

Para começar a enviar informações do evento para seu ServiceNow, você deve definir seu ServiceNow AI Platform Instância como o endpoint REST usando um webhook padrão em seu conector personalizado.

Ao fornecer detalhes do conector e campos de mapeamento, você define o conector personalizado. As informações extraídas das mensagens de evento do conector personalizado preenchem os campos de evento necessários e inserem o evento no banco de dados.

O URL é gerado pelo código com base em ServiceNow e o conector personalizado. Use esta URL para criar um webhook que permita que seu conector personalizado envie eventos para ServiceNow instância.

Procedimento

1. Navegar até Espaços > Espaço de operações de serviços.
2. No painel esquerdo, selecione o ícone do Launchpad de integrações: .
3. Em Procurar Integrações , selecione Todas as integrações lista suspensa e selecione Personalizado .
   Somente blocos de conectores personalizados são exibidos.

   Figura 1. Conectores de push

   

4. Selecione um bloco de tipo de conector personalizado.
5. Em Forneça detalhes , forneça os detalhes do conector.

   Figura 2. Página de detalhes dos conectores personalizados

   

   1. Em Nome do conector insira um nome de integração exclusivo para o conector.
   2. Opcional: Em Marcadores insira marcadores para ajudar a localizar e identificar conectores desse tipo no Lista expressa.
      Para adicionar marcadores adicionais, selecione o ícone de adição ( ao lado de Marcadores campo. A janela Adicionar marcadores é aberta.

      1. Em Chave , insira uma chave de marcador.
      2. Em Valor insira um valor de marcador.
      3. Selecione Adicionar.
   3. Opcional: Em Descrição insira informações resumidas sobre este conector.
   4. Em Origem insira o fornecedor usado para coletar eventos da origem de evento externo.

      . Origem o campo identifica o conector e serve como um identificador para reconhecer a origem de eventos e alertas quando o conector está ativo.

   5. Opcional: Em Grupo de atribuição selecione o grupo ou a equipe responsável por gerenciar e manter o conector.
6. Opcional: Arraste ou carregue uma imagem para exibir no bloco do conector.
   • Arraste uma imagem para a caixa.
   • Navegue até o arquivo de imagem selecionando Carregar imagem e escolha o arquivo.
   O tamanho máximo do arquivo carregado é de 1 MB.
7. Determine se você deseja conectar eventos diretamente ao ITOM instância ou por meio de um MID Server.

   • Para enviar eventos diretamente para ITOM instância, selecione Diretamente para a instância do ITOM .

   • Para enviar eventos por meio de um MID Server, que processa e passa o evento para a instância, selecione Por meio do MID Server .

     Se for um MID Server existe, a partir de Selecione MID server selecione um disponível MID Server conectado a um ouvinte de eventos.

     Se você precisar criar um MID Server e selecione uma das seguintes opções.

     • Configure a extensão do MID Web Server
     • Configure o contexto do coletor de eventos DO MID Web Service

     Para obter mais informações, consulte Configure o. MID Web Server extensão e Configurar o Contexto do coletor de eventos de MID Web Server.
8. Selecione Avançar.

   

9. Em Configure o método de entrada , selecione um método para coletar dados do evento.

   Método	Descrição
   Reúna eventos de origem real para definir campos	Selecione Reúna eventos de origem real para definir campos . Nota: Ao coletar eventos de origem real do conector personalizado, você aumenta a precisão dos eventos e alertas usando vários eventos como referência para definir os campos. Selecione Copiar para a área de transferência E copie o URL. Cole a URL na configuração do webhook do conector personalizado para criar um webhook que permita que o conector personalizado envie eventos para ServiceNow instância. 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 seu conector personalizado envie eventos para a instância. Selecione Verifique se há eventos . O número de eventos é exibido. O evento cria arquivos JSON que você pode navegar após selecionar Próximo .
   Use uma amostra JSON para mapear campos	Selecione Use uma amostra JSON para mapear campos . Nota: Selecione esta opção somente se você tiver um JSON de amostra. Em Insira a carga Copie e cole sua carga de amostra JSON para criar e exibir o mapeamento para mapear os campos. Selecione Carregar JSON . Selecione Edite ou cole o novo JSON Para editar o JSON carregado ou colar um novo. Selecione Copiar para a área de transferência E copie o URL. Cole a URL na configuração do webhook do conector personalizado para criar um webhook que permita que o conector personalizado envie eventos para ServiceNow instância. 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 seu conector personalizado envie eventos para a instância.

10. Selecione Avançar.
    A página é aberta, onde você pode mapear campos.

    

11. Em Mapear campos na coluna nomes de campos do conector, insira pelo menos um valor que mapeie para os valores de severidade listados em ServiceNow Gravidade coluna de campo.
12. Em Mapear campos na coluna nomes de campos do conector, insira pelo menos um valor que mapeie para os valores de severidade listados em ServiceNow Gravidade coluna de campo.

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

    Habilite o sistema para criar eventos corretamente a partir de dados de entrada mapeando os campos em sua amostra de código JSON para ServiceNow campos. . Gravidade e. Chave de mensagem as informações são preenchidas automaticamente para economizar tempo e esforço. . Chave de mensagem fornece o identificador correto para os eventos, garantindo que a desduplicação funcione corretamente e que alertas redundantes não sejam gerados.

13. Opcional: Para exibir vários arquivos JSON, selecione a seta acima da amostra JSON.
14. Opcional: Na seção Outros campos, em seu conector especifique parâmetros de evento personalizados que são opcionais, 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. Em Descrição insira uma descrição de alerta significativa.
    2. Em Nome da métrica Insira um nome de métrica que permita associar eventos às métricas de desempenho ou KPIs que acionaram o alerta.
    3. Em Nó Insira um valor de nó a ser usado para vinculação de IC.
    4. Em Hora do evento insira a hora de criação do evento do conector personalizado.
       Se a hora do evento não estiver mapeada, o sistema usará a hora do evento padrão.
    5. Em 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 comprimento máximo de 40 caracteres.
       • Fuso horário : As horas são armazenadas no Tempo Universal Coordenado (UTC) e são exibidas globalmente com base no fuso horário do sistema.
15. Ative e salve o conector selecionando Ativar e selecione OK na janela pop-up de confirmação.
    Você pode exibir os detalhes do conector no Detalhes e seus mapeamentos de campo no Mapeamento de campos guia.

Resultado

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

O que Fazer Depois

Para verificar se o processo foi concluído com sucesso e se os eventos estão fluindo para o sistema, exiba os eventos relacionados no Eventos relacionados guia. Se a configuração for bem-sucedida, prossiga para Adicionar automação para estabelecer uma automação de alerta. Para obter informações sobre automação de alertas, consulte Automação de alertas em Espaço de operações de serviços para ITOM.