Crie um conector de extração personalizado

Você pode criar um conector de extração personalizado que requer um script, definição do conector e instância do conector para recuperar eventos em nome de uma origem de evento.

Antes de Iniciar

Função necessária: evt_mgmt_admin

Por Que e Quando Desempenhar Esta Tarefa

Um script de conector personalizado pode fazer chamadas de API remotas para uma nova origem de evento para enviar eventos para ServiceNow instância. Você pode criar um script e adicioná-lo como parte de um novo Gestão de eventos definição do conector e instância do conector. Este procedimento cria automaticamente um arquivo de código JavaScript usando o nome que você insere no Nome campo como o nome do arquivo. O código personalizado JavaScript que realiza essas ações deve:

• Conecte-se a uma ferramenta de monitoramento de eventos.
• Recupere eventos de uma ferramenta de monitoramento de eventos.
• Envie eventos para a tabela Evento [em_event] usando uma API de serviço web. Consulte REST API .

Cada definição de conector é específica de um fornecedor de origem de evento. A definição do conector especifica a inclusão de script DO MID Server que extrai eventos da origem de evento externo. Além disso, a definição do conector especifica quais parâmetros de valor da instância do conector são necessários para se conectar ao host de origem do evento externo.

Procedimento

1. Crie uma inclusão de script DO MID Server personalizada.
   Este exemplo usa Groovy (descontinuado). No lugar de uma inclusão de script no Groovy, é recomendável usar JavaScript.
   1. Implemente estes métodos:
      • OperationStatus testConnection()
      • Substituir OperationStatus execute()
   2. Projete a classe para estender o. Terceiro PartyConnector .

      
       public class HypericConnector extends ThirdPartyConnector
      

   3. Importe classes de plataforma para criação de eventos, envio, registro em log e classes de base de conector de terceiros.

      
      package com.service_now.mid.probe.tpcon.test
      
      import com.glide.util.Log
      import com.service_now.mid.MIDServer
      import com.service_now.mid.probe.event.IEventSender
      import com.service_now.mid.probe.event.SNEventSender
      import com.service_now.mid.probe.tpcon.OperationStatus
      import com.service_now.mid.probe.tpcon.OperationStatusType
      import com.service_now.mid.probe.tpcon.ThirdPartyConnector
      import com.snc.commons.eventmgmt.Event
       

   4. Conecte-se ao coletor de dados, como SCOM ou VMware vRealize Hyperic (Hyperic), com a API fornecida pelo coletor.
   5. Use contextparâmetros para definir os valores do campo de evento que vieram de uma instância do conector.

      
      def authString = (context.username + ':'+ context.password).getBytes().encodeBase64().toString()
      def urlStr = 'http://'+context.host + ':' + context.parameters.port + '/' + apiFunction
      

   6. Implemente o. executar função no script.
      Ele lê eventos do conector usando sua API para criar objetos de evento e enviá-los para ServiceNow instância. Por exemplo:

      
      GPathResult alertsResponse1 = readAlerts('hqu/hqapi1/alert/find.hqu?begin=' + lastSignatureStr +
      '&end='+ tillStr +'&count=1000000&severity=1&inEscalation=false&notFixed=false');
      Event event = new Event()
      event.emsSystem = context.name
      event.source = "Hyperic"
      event.description = it.@reason
      event.type = it.@name
      ...
      IEventSender eventSender = MIDServer.getSingleton(SNEventSender.class)
          for (Event event  : list) {
              eventSender.sendEvent(event)
           }
      

2. Navegar até MID Server > Arquivos de script do MID Server e criar um script.
3. Especifique Primário campo como Groovypreencha o formulário conforme apropriado e clique em Enviar .
4. Navegar até Gestão de eventos > Integrações > Definições do Conector e criam uma definição de conector.
5. Em Script do Groovy a ser executado Selecione o arquivo de script DO MID Server e preencha o formulário conforme apropriado.
   Além de nome de usuário ou host , você pode adicionar qualquer outro parâmetro, por exemplo, porta e, em seguida, clique em Enviar .
6. Navegar até Gestão de eventos > Integrações > Instâncias do conector e criam uma instância do conector.
7. Em Definição do conector selecione a definição do conector, preencha o formulário conforme apropriado e clique em Enviar .
8. Para confirmar ou depurar o script, use depurar impressões do Groovy para o log do MID Server.
9. Para monitorar eventos de entrada usando a instância do conector personalizado, navegue até ECC > Fila e filtro ativado ConnectorProbe .
10. Crie uma definição de conector personalizada.
    1. Navegar até Tudo > Gestão de eventos > Integrações > Definições do Conector.
    2. Clique em Nova.
    3. Em Nome digite um nome descritivo para a definição do conector.
    4. Em Tipo de script campo, selecione JavaScript .
    5. Clique com o botão direito no cabeçalho do formulário e selecione Salvar.
    . JavaScript a ser executado O campo é preenchido automaticamente com o nome do arquivo de modelo JavaScript.
11. Para editar o arquivo JavaScript padrão, clique no ícone de informações ( À direita do nome do arquivo JavaScript e siga estas etapas:
    1. Especifique as informações necessárias para TestConnection função.
       Esta função testa a definição do conector para verificar se a conexão com o destino é válida.
    2. Especifique as informações necessárias para executar função.
       Esta função recupera as informações da origem externa.
    3. Especifique as informações necessárias para RecuperaçãoKpi função.
       Esta função recupera os dados de métrica da origem externa.
12. Opcional: Você pode substituir o JavaScript padrão pelo seu código JavaScript.
13. Preencha os campos, se for o caso.

    Tabela 1. Formulário Definição do conector

    Campo	Descrição
    Programação padrão	O número de segundos entre as tentativas de receber eventos.
    Bidirecional	Especifique para habilitar o sistema de monitoramento externo a ser atualizado se o alerta for alterado. Há uma implementação padrão para o SCOM.
    Identificador de campo de alerta	Especifique o campo de alerta que, se alterado manualmente, fará com que o sistema de monitoramento externo seja atualizado. Nota: Este campo aparecerá somente se Bidirecional selecionado.
    Coletar métrica	Selecione para habilitar a coleta de métricas. Nota: As métricas são coletadas somente para origens de eventos externos do SCOM.
    Programação padrão de coleta de métrica (segundos)	Especifique o número de segundos de informações que devem ser coletadas. O padrão é 10 segundos. Nota: Este campo aparecerá somente se Coletar métricas selecionado.
    Parâmetros do conector	Especifique os parâmetros para habilitar a comunicação com um servidor de eventos.
    Definição do conector para MID Server.	. MID Server nome para processar eventos do servidor de eventos. Se não for especificado, um disponível MID Serveré usado.

14. Clique em Enviar.