Consumidor do MID Server

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 9 min. de leitura

    • Use a Configuração assistida para percorrer a configuração inicial do LES. A Configuração assistida ajuda no planejamento da distribuição do produto e na execução da configuração básica para entrar em operação.

    A Configuração assistida organiza as atividades de configuração em categorias. Cada categoria fornece informações, como orientações para planejamento, etapas de pré-configuração e links para conteúdos de ajuda úteis. As categorias também fornecem um conjunto de links para as páginas da instância em que realiza a configuração. O processo da Configuração assistida acompanha o que foi feito, para que você possa parar e iniciar novamente de onde parou.

    Página inicial da Configuração assistida

    A página inicial da Configuração assistida contém os aspectos gerais dos tipos de configuração. Você pode selecionar seu tipo de Configuração assistida e selecionar Continuar para abrir as etapas e começar a configuração.

    As três configurações dessa página, Início rápido/Melhor experiência/Personalizada, oferecem as mesmas tarefas e funcionalidades. Um MID Server dedicado é necessário para transmitir logs continuamente da instância para o sistema de análise de log. O MID Server precisa de uma configuração única para estabelecer uma conexão segura com o Serviço de envio de mensagens Hermes. Mesmo que você tenha marcado uma tarefa como concluída, é possível voltar e marcá-la como "em andamento". Para fazer isso, primeiro clique na caixa Editar no canto superior direito da categoria. Em seguida, clique na caixa Editar da tarefa que você quer desmarcar. A caixa Marcar como concluída não estará mais marcada.

    Página de categorias da Configuração assistida

    A página de categorias contém os aspectos gerais e as descrições das categorias e tarefas associadas. Clique na seta suspensa para conferir informações sobre a categoria ou clique no botão Iniciar para abrir as etapas da Configuração assistida e começar a configuração.

    Siga as instruções de configuração para concluir as tarefas de cada categoria.

    Configuração assistida para consumidores do MID Server

    Implemente as etapas a seguir para obter uma configuração assistida completa para consumidores do MID Server.

    Antes de Iniciar

    Navegar até Serviço de exportação de log (LES) > Consumidor do MID Server > Configuração assistida. Selecione o tipo de configuração que você quer definir e clique em Continuar.
    Nota:
    Durante a instalação da aplicação Log de serviço de exportação, a ServiceNow provisionará a infraestrutura Serviço de envio de mensagens Hermes subjacente. Observe que a conclusão desse processo pode levar algumas horas desde o momento em que você solicita a instalação da aplicação Log de serviço de exportação.

    Função necessária: administrador

    Procedimento

    1. Analise o diagnóstico do Serviço de envio de mensagens Hermes.

      É recomendável verificar se o Serviço de envio de mensagens Hermes está instalado e funcionando com a ferramenta de diagnóstico Hermes, que é exibida na tela durante essa etapa. Se você vir um erro de "Página não encontrada" nessa página, o Hermes não está instalado e é necessário entrar em contato com o administrador do sistema.

      • Informações de configuração: as informações de inicialização a seguir são usadas para conexão com o Serviço de envio de mensagens Hermes. A “Inicialização do produtor” representa a conexão usada para o envio de mensagens para o Hermes, e “Inicialização do consumidor 1 e 2” são usadas para recuperação de mensagens do Hermes.
        • Inicialização do produtor
        • Inicialização do consumidor 1
        • Inicialização do consumidor 2
      • PKI da instância: o componente de infraestrutura de chave pública (PKI) da instância permite que uma instância da ServiceNow atue como um emissor em uma hierarquia de confiança X.509.
      • Conectividade da inicialização: clique em Executar teste para confirmar que o cliente externo pode se conectar às portas de instância definidas (produtor e consumidor).
      • Conectividade da instância: clique em Executar teste para confirmar que a instância pode enviar e receber mensagens.
      • Exibir tópicos: clique no tópico listado para recuperar o carimbo de data/hora da última mensagem.
      Nota:
      Você pode acessar Hermes Diagnóstico no futuro para solucionar possíveis problemas de conectividade, retornando a esta etapa da configuração assistida ou navegando até Todos > Serviço de envio de mensagens Hermes > Diagnósticos.
    2. Gere certificados para uma conexão segura com o Serviço de envio de mensagens Hermes e extraia eventos de log dele.

      Configure uma conexão segura com o Serviço de envio de mensagens Hermes. Consulte Set up a secure connection to the Hermes Messaging Service para obter mais informações. Você vai precisar desses certificados para autenticação e autorização no cliente que extrairá os logs do Hermes.

      Nota:
      As funções de administrador ou Hermes_admin são necessárias para essa etapa.
    3. Configure o produtor de log: escolha as origens de log para exportar e configurar os filtros.
      Realize as seguintes tarefas para configurar o produtor de log.
      • Configure as origens de log para exportar: crie um registro de origem para cada uma das origens de log que você quer exportar.
        Nota:
        As funções de administrador ou sn_logstoanalytics.admin são necessárias para concluir essa etapa
        1. Clique em Novo no canto superior direito
        2. Selecione um tipo de origem
        3. Selecione os filtros adequados para o tipo de origem selecionado
          Nota:
          Os filtros são diferentes dependendo do tipo de origem selecionado
        4. Clique em "Atualizar"
        Após a criação, será exibido o nome do tópico do Hermes para o qual a origem do log será exportada. Escreva o nome do tópico, porque você vai precisar dele para configurar o sistema do consumidor de log. O campo "Ativo" controla se a origem de log será exportada ou não. Caso encontre erros, volte para a tarefa "Verificar o Diagnóstico do Hermes" e confira o status dele.
      • Validar produtor de log: depois de criar uma origem para produzir logs, você poderá ver os registros de log em tempo real no tópico usando Serviço de envio de mensagens Hermes > Inspetor de tópicos do Hermes.
        1. Selecione "Tópicos externos"
        2. Clique em "Listar tópicos"
        3. Selecione a linha com o tópico da etapa anterior (listado em "Origens")
        4. Ajuste a data de início das mensagens, se necessário
        5. Clique em Exibir para conferir uma mensagem de log que foi exportada para o tópico
    4. Instale o MID Server: instale e configure um MID Server dedicado que execute a versão Vancouver ou posterior.
      Instale o MID Server de acordo com as tarefas a seguir.
      • Instale o MID Server dedicado: o MID Server que o serviço de exportação de log usa deve ser dedicado somente para essa finalidade e não deve executar outros processos. Isso é importante para garantir a entrega oportuna de mensagens de log exportadas para o endpoint REST. Você pode instalar o novo MID Server usando a Use MID Server guided setup ou instalando-o manualmente. Para a instalação manual, confira a documentação Configure MID Server network connectivity e, em seguida, a documentação Installing the MID Server.
      • Valide o MID Server: valide manualmente o MID Server após instalar, para habilitá-lo a executar tarefas de automação. Para validar o MID Server dedicado ao LES, consulte Validate the MID Server
    5. Configure o destino de push de REST do log: configure o MID Server para enviar logs ao sistema de análise de log (como o Splunk).
      Configure o destino de push de REST do log de acordo com as tarefas a seguir.
      • Adicione propriedades do MID: adicione propriedades do MID Server para que ele se conecte ao Hermes. Navegue até MID Server >Propriedades e defina os valores apropriados para cada propriedade listada abaixo.
        Nome Valor
        mid.les.kafka.ssl.truststore.password <password>
        mid.les.kafka.ssl.keystore.password <password>
        mid.les.kafka.ssl.key.password <password>
        mid.les.kafka.ssl.truststore.location <your_path>/<truststore>.p12
        mid.les.kafka.ssl.keystore.location <your_path>/<keystore>.p12
        mid.les.kafka.ssl.truststore.type PKCS12
        mid.les.kafka.ssl.keystore.type PKCS12
        mid.les.kafka.client.id <instance_name>
        mid.les.kafka.group.id snc.<instance_name> .group1
        mid.les.kafka.bootstrap.servers <instance_name>.servicenow.com:4100,<instance_name>.servicenow.com:4101,<instance_name>.servicenow.com:4102,<instance_name>.servicenow.com:4103
        mid.les.kafka.set2.bootstrap.servers <instance_name>.servicenow.com:4200,<instance_name>.servicenow.com:4201,<instance_name>.servicenow.com:4202,<instance_name>.servicenow.com:4203
        Siga estas instruções para saber como obter alguns dos valores acima
        • <password> é a senha que você definiu para o armazenamento de chaves e o armazenamento confiável
        • <your_path> é o caminho do arquivo para o diretório em que você baixou os arquivos de armazenamento de chaves e de armazenamento confiável. Os certificados precisam estar no servidor em que você está executando o MID
        • <instance_name> é o nome da sua instância da ServiceNow. Se você estiver em dúvida, poderá encontrá-lo consultando a tabela sys_properties
        • Você pode obter os valores de mid.les.kafka.bootstrap.servers e mid.les.kafka.set2.bootstrap.servers na Página de diagnóstico do Hermes. Navegar até Serviço de envio de mensagens Hermes > Diagnósticos e copie as cadeias de caracteres em Consumer Bootstrap 1 (Inicialização do consumidor 1) e Consumer Bootstrap 2 (Inicialização do consumidor 2), respectivamente.
      • Configure um destino: crie um novo registro de configuração de destino, que define o endpoint REST para o qual a extensão vai encaminhar os logs.
        Nota:
        As funções de administrador ou sn_logstoanalytics.admin são necessárias para concluir essa etapa.
        1. Navegar até Serviço de exportação de log (LES) > Configurações de destino 
        2. Crie um novo registro de configuração
        3. Especifique o URL do endpoint pretendido para as origens de log exportadas
        4. Pesquise ou crie novas credenciais para conectar ao endpoint. Ao criar credenciais para o endpoint, somente os seguintes tipos de credencial são válidos com o LES: autenticação básica, OAuth e chave de API
        5. Pesquise ou crie um novo script de transformação. Enviamos com o script pré-escrito, SplunkTransform para Splunk
    6. Configure o consumidor de log: configure a extensão do MID Server para o serviço de exportação de log de acordo com estas tarefas.
      • Configure o contexto do consumidor LES: nesta etapa, você vai atualizar o registro do consumidor LES para executar no MID Server dedicado que você acabou de instalar para o serviço de exportação de log. Navegar até MID Server > Extensões > Contexto do consumidor LES e atualize o registro do consumidor LES definindo os seguintes campos:
        • Clique em "Consumidor LES" para abrir o registro de contexto do MID Server
        • Selecione o MID Server específico para o campo "Executar em"
        • Insira o nome do MID validado na etapa anterior no campo "MID Server"
        Clique em Atualizar para salvar.
        Nota:
        Enviamos com um contexto pré-criado. Não crie um segundo contexto. Isso pode ter consequências indesejadas.
      • Configure o consumidor: crie um novo registro de consumidor, que representa o processo que faz parte da extensão do MID Server para o serviço de exportar log. Navegar até Serviço de exportação de log (LES) > Consumidores e crie um novo registro de configuração especificando o tópico do Hermes para recuperar mensagens de log e o destino para retransmiti-las. Quando você seleciona o módulo Consumidores, ele mostra informações sobre o nome do consumidor e a configuração de destino.
        1. Crie um novo registro de consumidor
        2. Escolha um tópico de origem no menu suspenso
        3. Escolha a configuração do destino
        4. Inicie o consumidor
      • Verifique a integração do MID Server: navegue até Serviço de exportação de log (LES) > Status do cliente e exiba os campos Status e Detalhes do status do registro definido. As informações nesses campos relatam o estado atual do processo em execução no MID Server, incluindo quaisquer localizações de erros ao retransmitir mensagens ao endpoint REST. Essa é apenas uma página de exibição de status. Navegar até Serviço de exportação de log (LES) > Consumidores se você quiser criar um novo registro de consumidor. Se o status do consumidor indicar que o processo foi iniciado, você poderá inspecionar o endpoint para exibir os logs que foram retransmitidos para ele. Além disso, você pode exibir os logs no MID Server para ver se há detalhes adicionais sobre quaisquer erros que possam ser encontrados. Você também pode habilitar o registro em log de depuração no MID Server para obter mais informações, se necessário.
        Nota:
        Se você fizer qualquer mudança em um dos registros do Consumidor, ela aparecerá na página de exibição "Status do consumidor". Se você selecionar o nome de registro de um consumidor na lista "Status do consumidor", será aberto o formulário "Consumidor" para o registro selecionado. Em seguida, será possível atualizar a configuração de nome e de destino do registro selecionado.