Consumidor do Kafka

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 6 min. de leitura
  • Use a configuração assistida para percorrer a configuração inicial do LES para consumidores do Kafka.

    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.

    Configuração assistida do LES para consumidores do Kafka

    As três configurações dessa página, Início rápido/Melhor experiência/Personalizada, oferecem as mesmas tarefas e funcionalidades. Elas são necessárias para coordenar a integração entre a instância da ServiceNow e a ferramenta de análise de log de destino com o respectivo administrador. O administrador de análise de log deve configurar a própria ferramenta para se conectar à instância da ServiceNow com segurança. É recomendável compartilhar o documento com o administrador de análise de log com antecedência. Mesmo que você tenha marcado uma tarefa como concluída, é possível voltar e marcá-la como "em andamento". Para fazer isso, clique na caixa Editar no canto superior direito da categoria. Em seguida, clique na caixa Editar da tarefa que você deseja 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 uma visão geral e 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.

    Página de categorias da Configuração assistida do LES

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

    Configuração assistida para consumidores do Kafka

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

    Antes de Iniciar

    Navegar até Serviço de exportação de log (LES) > Consumidor do Kafka > 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 a conexão ao 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é Tudo > Serviço de envio de mensagens Hermes > Diagnóstico.
    2. Gere certificados para uma conexão segura ao Serviço de envio de mensagens Hermes e extraia eventos de log dele.

      Você vai usar esses certificados ao conectar o sistema externo.

      Configure uma conexão segura ao Serviço de envio de mensagens Hermes. Consulte Configurar uma conexão segura com o Serviço de envio de mensagens Hermes para LES 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 aquela 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. Conecte o consumidor do Kafka: conecte o consumidor do Kafka escolhido para extrair eventos de log do Hermes de acordo com estas tarefas.
      • Identifique o consumidor do Kafka: você tem duas opções baseadas na arquitetura de análise de log.
        • Se você tiver seu próprio sistema Kafka e escolhê-lo para agregação de log, poderá se conectar diretamente ao serviço de envio de mensagens Hermes usando o protocolo Kafka nativo.
        • Se você preferir conectar a ferramenta de análise de log diretamente ao serviço de envio de mensagens Hermes, será preciso implantar um conector do Kafka compatível com o sistema de análise de log (ou seja, Splunk Connect para Kafka).
        Nota:
        Nos dois casos, é preciso trabalhar com o administrador desses sistemas para coordenar a conexão com o serviço de envio de mensagens Hermes.
      • Importe os certificados do Hermes para o sistema do consumidor do Kafka: faça login em seu sistema do consumidor do Kafka e verifique se você tem os direitos de administrador apropriados para configurá-lo e conectá-lo a um sistema externo. Importe os certificados gerados na tarefa "Configurar uma conexão segura com o serviço de envio de mensagens Hermes" para o conector ou o servidor do Kafka. Siga as instruções da documentação do consumidor do Kafka escolhido.
      • Configure os processos do Kafka: o serviço de envio de mensagens Hermes foi desenvolvido para oferecer alta disponibilidade. Dois processos são necessários para consumir mensagens do Hermes. Dois processos são necessários porque o Hermes usa alguns clusters do Kafka para fins de failover. Se um cluster ficar inativo, os dados serão produzidos para o outro cluster do Kafka do Hermes.
        Em seu sistema de consumidor do Kafka, será preciso criar dois processos de consumidor separados para se conectar aos dois clusters do Kafka do Hermes. Para os dois processos, especifique o mesmo tópico do Kafka do Hermes, mas configure dois endereços de inicialização separados:
        • <instance_name>.service-now.com:4100,<instance_name>.service-now.com:4101,<instance_name>.service-now.com:4102,<instance_name>.service-now.com:4103
        • <instance_name>.service-now.com:4200,<instance_name>.service-now.com:4201,<instance_name>.service-now.com:4202,<instance_name>.service-now.com:4203
        Observações importantes:
        • Ao acessar o tópico do Kafka em sistemas externos, anexe "snc.<instance name>." ao tópico para o qual os logs são encaminhados.
        • Configure cada consumidor com o mesmo ID de grupo de consumidores do Kafka.
        • Instale os arquivos de repositório de chaves e repositório de confiança em um local em que os consumidores possam acessá-los.
        • Se os consumidores pedirem, especifique as propriedades dos conversores JSON do Kafka para desabilitar esquemas: “key.converter.schemas.enable=false”, “value.converter.schemas.enable=false”
      • Verifique se o consumidor do Kafka extrai logs do Hermes: verifique no consumidor do Kakfa escolhido se é possível extrair eventos de log do serviço de envio de mensagens Hermes.