Configure um conector personalizado

Autentique seu conector personalizado como uma fonte de dados para habilitar o envio de informações de evento para o. ServiceNowinstâ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 eventoso plug-in conectores (sn_em_connector) está instalado no Now Platforminstância. Para obter mais informações, consulte Configurar Gestão de eventosconectores.
• Certifique-se de que os itens de configuração dos hosts gerenciados pelo conector personalizado existam no Now Platforminstâ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 ITOMprodutos.

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 Now PlatformInstância como 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 obrigatórios e insere o evento no banco de dados.

O URL é gerado pelo código com base em ServiceNowe o conector personalizado. Use esta URL para criar um webhook que permita que seu conector personalizado envie eventos para o. ServiceNowinstâ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 e selecione Personalizado .
   São exibidos somente blocos de conectores personalizados.

   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 deste tipo no Lista expressa.
      Para adicionar marcadores adicionais, selecione o ícone de mais ( ) 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 do 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.
   • Selecione o arquivo de imagem Carregar imagem e, em seguida, escolha o arquivo.
   O tamanho máximo do arquivo carregado é de 1 MB.
7. Determine se você deseja conectar eventos diretamente ao ITOMou por meio de um MID Server.

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

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

     Se for um MID Serverexiste, do Selecione MID Server selecione um disponível MID Serverconectado a um ouvinte de eventos.

     Se você precisar criar um MID Server, em seguida, selecione uma das opções a seguir.

     • Configurar extensão do servidor web MID
     • Configurar o contexto do coletor de eventos do servidor web MID

     Para obter mais informações, consulte Configure o. MID Web Serverextensã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 reais para definir campos	Selecione Reúna eventos de origem reais para definir campos . Nota: Ao coletar eventos de origem real do conector personalizado, você aumenta a precisão de 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 o URL na configuração do webhook do conector personalizado para criar um webhook que permita que o conector personalizado envie eventos para o. ServiceNowinstância. Insira suas credenciais de autenticação básicas 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 procurar após selecionar Próximo .
   Usar uma amostra JSON para mapear campos	Selecione Use uma amostra JSON para mapear campos . Nota: Somente se você tiver um JSON de amostra, selecione esta opção. 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 o URL na configuração do webhook do conector personalizado para criar um webhook que permita que o conector personalizado envie eventos para o. ServiceNowinstância. Insira suas credenciais de autenticação básicas 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 gravidade 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 gravidade 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 do conector personalizado e os tipos de gravidade compatíveis com ele. Os valores de gravidade 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 o. ServiceNowcampos. . 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 personalizado 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 significativa do alerta.
    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 em Tempo Universal Coordenado (UTC) e são exibidas globalmente com base no fuso horário do sistema.
15. Selecione e salve o conector Ativar e, em seguida, 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 .

Resultado

Depois que o conector é ativado, os eventos começam a fluir do console do conector personalizado para o. ServiceNowinstância. O plug-in extrai informações da mensagem de evento do conector personalizado original para preencher os campos de evento obrigatórios e insere o evento no banco de dados. Para ver os eventos em Now Platform, 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 . Se a configuração for bem-sucedida, prossiga para Adicione 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çospara ITOM.