Configurar o Contexto do coletor de eventos de MID Web Server

Configure o contexto do Coletor de eventos DO MID WebService para fornecer um método de URL para enviar mensagens de evento de uma origem externa para MID Server.

Antes de Iniciar

Certifique-se de que Gestão de eventos O plug-in Conectores (sn_em_connector) está instalado no ServiceNow AI Platform instância.

Função necessária: evt_mgmt_admin

Por Que e Quando Desempenhar Esta Tarefa

O formato padrão da URL para enviar mensagens de evento de uma origem externa para MID Server. http://{MID_Server_IP}:{MID_Web_Server_Port}/api/mid/em/jsonv2 . Este URL fornece um bom desempenho.

De uma origem externa, para enviar mensagens de evento que não estão no formato jsonv2, o formato da URL é: http://{MID_Server_IP}:{MID_Web_Server_Port}/api/mid/em/inbound_event?Transform={Name_of_Transform_Script} , em que (Name_of_Transform_Script) a variável é o nome completo do script e sempre começa com o texto: TransformEvents_ .

Por exemplo, suponha os seguintes valores:

• (MID_Server_IP): 10.118.69.27
• MID_Web_Server_Port: 8097
• Nome do script de transformação: EventsToProcess

O URL a ser usado é, portanto: http://10.118.69.27:8097/api/mid/em/inbound_event/TransformEvents_EventsToProcess

Nota:

• O URL no formato http://{MID_Server_IP}:{MID_Web_Server_Port}/api/mid/em/{transform_script_name} também é compatível.
• O formato de data dos eventos é aaaa-M-d h:mm:ss .

  Se você receber um evento cuja data esteja em um formato diferente, deverá usar um (transform_script_name) apropriado para o formato de data do evento de entrada. Caso contrário, o evento não será processado corretamente.

  Por exemplo, se um evento chegar em 27 de junho de 2019 às 11:25 com uma data listada de 2019/06/27/ 11:25:00 a, use um (transform_script_name) com um formato de data de yyyy/MM/dd/ HH:mm:ss apara corresponder ao formato do evento recebido.

Procedimento

1. Navegar até Tudo > Gestão de eventos > Integrações > Ouvinte de Evento de Serviço Web MID.
2. Na lista Contextos do coletor de eventos do MID WebService, clique em Novo .
3. No formulário, preencha os campos.

   Tabela 1. Formulário de contexto dos coletores de eventos do MID WebService

   Campo	Descrição
   Nome	Um nome exclusivo para este coletor para facilitar a identificação.
   Descrição resumida	Insira uma descrição resumida e significativa deste coletor.
   Extensão do MID Web Server	Especifique e inicie a extensão do MID Web Server. Os métodos de autenticação compatíveis são listados em Tipo de autenticação Campo da extensão do MID Web Server. Para obter informações sobre como configurar uma extensão do MID Web Server, consulte Configure o MID Web Server .
   Status	Este campo é preenchido automaticamente com o status da extensão do MID Web Server. Este campo fica em branco até que a extensão do MID Web Server seja iniciada. Depois de emitir um comando para a extensão do MID Web Server, um dos seguintes valores é exibido: Iniciado: o coletor está em execução. Parado: o coletor não está em execução. Off-line . MID Server está inativo. Erro : O coletor falhou com um erro (a mensagem de erro é exibida em Mensagem de erro ). Aviso Ocorreu Uma exceção de tempo de execução.
   Executar nos(as)	MID Server específico ou Cluster do MID Server específico , Conforme definido na extensão do MID Web Server especificada.
   MID Server	. MID Server específico ou Cluster do MID Server específico , Conforme definido na extensão do MID Web Server especificada.
   Executando no(a)	O nome do MID Server Em que a extensão do MID Web Server está em execução.

4. Clique com o botão direito do mouse no título do formulário e clique em Salvar .
5. Em Links relacionados clique em Iniciar para iniciar o coletor.

   Tabela 2. Comandos no Gestão de eventos Formulário de contexto

   Link relacionado	Descrição
   Início	Se não estiver em execução, inicie o coletor. Esta ação verifica se um endpoint de API de serviço web com Gestão de eventos a aplicação está em execução no MID Server.
   Parar	Interrompe o coletor em execução no configurado MID Server. Se o coletor não estiver em execução, nenhuma ação será realizada.
   Reiniciar	Interrompe e inicia o coletor no configurado MID Server.
   Atualizar parâmetros	Envia parâmetros atualizados para o coletor. Os parâmetros também são atualizados quando Gestão de eventos MID Server a extensão de contexto foi atualizada. Se você clicar neste controle quando o coletor não estiver em execução, nenhuma atualização será feita.

Exemplo

Mostrando o uso da URL para transformar mensagens de evento formatadas em JSON v2

Suponha que as mensagens de evento formatadas JSON v2 sejam enviadas para MID Server. Ao usar o. jsonv2 URL, não há necessidade de usar uma inclusão de script.

Tabela 3. Dados para o exemplo JSON v2

Campo	Valor
MID_Server_IP	10.218.64.27
MID_Web_Server_Extension_Port	8097
Formato de mensagem de evento	jsonv2

Substitua as variáveis no formato padrão da URL http://<my-instance>.service-now.com/api/global/em/jsonv2 com valores da tabela anterior: http://10.218.64.27:8097/api/global/em/jsonv2

Exemplo que mostra o URL para enviar mensagens que não estão no formato jsonv2

O formato da URL para enviar mensagens de evento de uma origem externa que não estão no formato jsonv2 é http://{MID_Server_IP}:{MID_Web_Server_Port}/api/mid/em/inbound_event/Transform={Name_of_Transform_Script} Em que a variável Name_of_Transform_Script é o nome completo do script e sempre começa com o texto: TransformEvents_. O nome do script deve ser especificado como Transformação parâmetro de cabeçalho e sempre deve começar com o prefixo TransformEvents_ .

Para este exemplo, suponha que o nome do script seja EventsToProcess, portanto, o URL seja: http://10.138.64.27:8097/api/mid/em/inbound_event/TransformEvents_EventsToProcess

Exemplo que mostra mensagens de evento formatadas JSON v2

Nota:

Ao copiar e colar o texto a seguir, caracteres ocultos também podem ser copiados e podem causar resultados inesperados.

curl -v -H "Accept: application/json" -H "Content-Type: application/json" -X POST --data "{
    "records":
    [ {
         \"source\" : \"Simulated\",
        \"node\" : \"nameofnode\",
        \"type\" : \"High Virtual Memory\",
        \"resource\" : \"C:\",
        \"severity\" : \"5\",
        \"description\" : \"Virtual memory usage exceeds 98%\",
        \"ci_type\":\"cmdb_ci_app_server_tomcat\",
        \"additional_info\":\"{\\\"name\\\":\\\"My Airlines\\\"}\"
      },
      {
      \"source\" : \"Simulated\",
      \"node\" : \"01.myairlines.com\",
      \"type\" : \"High CPU Utilization\",
      \"resource\" : \"D:\",
      \"severity\" : \"5\",
      \"description\" : \"CPU on 01.my.com at 60%\"
      }
   ]
}" -u UserName:Password http://{MID_Server_IP}:{MID_Web_Server_Port}/api/mid/em/jsonv2

Exemplo

Exemplo que mostra mensagens de evento formatadas JSON v2 com chave de API do MID Web Server

Nota:

Ao copiar e colar o texto a seguir, caracteres ocultos também podem ser copiados e podem causar resultados inesperados.

curl --location -g --request POST 'http://{MID_Server_IP}:{MID_Web_Server_Port}/api/mid/em/jsonv2' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: key <mid_webserver_api_key>' \
--data-raw '{
   "records":
    [ {
         \"source\" : \"Simulated\",
        \"node\" : \"nameofnode\",
        \"type\" : \"High Virtual Memory\",
        \"resource\" : \"C:\",
        \"severity\" : \"5\",
        \"description\" : \"Virtual memory usage exceeds 98%\",
        \"ci_type\":\"cmdb_ci_app_server_tomcat\",
        \"additional_info\":\"{\\\"name\\\":\\\"My Airlines\\\"}\"
      },
      {
      \"source\" : \"Simulated\",
      \"node\" : \"01.myairlines.com\",
      \"type\" : \"High CPU Utilization\",
      \"resource\" : \"D:\",
      \"severity\" : \"5\",
      \"description\" : \"CPU on 01.my.com at 60%\"
      }
   ]
}'

Tarefas relacionadas

• Configure o. MID Web Server extensão
• Coleção de eventos do BMC TrueSight
• Coleta de eventos do Microsoft Azure Monitor
• Coleta de eventos do Google Cloud Platform