Configurar entradas de dados de REST API

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 2 min. de leitura

    • Configure uma entrada de dados de REST API para transmitir dados de log para sua instância ServiceNow no formato JSON.

    Antes de Iniciar

    • Certifique-se de que um MID Server esteja instalado e configurado com a capacidade de ingestão de log habilitada.

      Configuração do MID Server com capacidade de ingestão de log habilitada.

      Importante:
      Análise de logs de integridade não é compatível com IPv6. Para trabalhar com a aplicação, configure o MID Server para IPv4.
    • Certifique-se de que um MID Web Server esteja configurado para o MID Server.

      Para obter mais informações, consulte Configurar a extensão MID Web Server.

      No formulário Contexto do MID Web Server, no campo Executar em, selecione MID Server específico e não a opção de cluster. No campo MID Server, selecione o MID Server específico para o qual os dados de log são enviados.

    • Se o endereço IP do MID Server for exposto pela tradução de endereço de rede (NAT), um balanceador de carga ou um dispositivo semelhante, ele deverá ter um endereço IP público. Nas propriedades MID Server, adicione uma propriedade chamada mid.public_ip com o endereço IP público como o valor. Para obter mais informações, consulte Criar uma propriedade do MID Server.

    Função necessária: evt_mgmt_admin

    Por Que e Quando Desempenhar Esta Tarefa

    A extensão lida com mensagens de log que são enviadas para MID Server por uma origem de log externa. O MID Server processa as mensagens e as passa para sua instância.

    Para transmitir mensagens de log para o MID Server, o URL deve ter o formato http://{MID_SERVER_IP}:{MID_WEB_SERVER_PORT}/api/mid/hla/raw, em que /api/mid/hla/raw é o endpoint.

    Procedimento

    1. Navegar até Tudo > Análise de logs de integridade > Entrada de dados > Entradas de dados.
    2. Na página Entradas de dados, selecione Novo.
    3. Escolha a entrada de dados da REST API.
    4. No formulário, preencha os campos.
      Para obter uma descrição dos campos, consulte Campos de configuração de entrada de dados da REST API.
    5. Selecione Enviar.

    Resultado

    O processo de configuração de entrada de dados está concluído. Análise de logs de integridade adiciona o registro de entrada de dados à tabela Entradas de dados e anexa o arquivo de configuração ao registro de entrada de dados. A entrada de dados começa a transmitir dados de log no formato JSON para sua instância ServiceNow.
    Nota:
    Se o Análise de logs de integridade mecanismo de IA estiver inativo e o fluxo de dados tiver sido interrompido, uma notificação será exibida na parte superior da página de configuração de entrada de dados. Quando isso acontecer, entre em contato com o suporte ServiceNow.

    O que Fazer Depois

    Certifique-se de que a entrada de dados seja de fluxo de dados.