Como usar a estrutura do produtor para notificações de saída

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

    • A estrutura do produtor seleciona o evento da instância ServiceNow e envia a notificação de saída para o sistema externo. Você pode consumir os detalhes da notificação do serviço de mensagens que está instalado em seu sistema externo.

    Propriedades do sistema

    Você deve configurar as propriedades do sistema para usar a estrutura do produtor para notificação de saída. A tabela a seguir explica a lista de propriedades do sistema definidas para os trabalhos agendados.

    Tabela 1. Propriedades do sistema da estrutura do produtor
    Propriedade Descrição Tipo
    sn_api_notif_mgmt.event.log
    Nível de registro em log a ser gravado nos logs de depuração. Você pode selecionar os seguintes níveis de registro em log:
    • emerg: falha total.
    • alert: corrupção do sistema de um banco de dados, por exemplo.
    • crit: normalmente usado para erros de hardware, por exemplo.
    • err: quaisquer erros.
    • aviso: quaisquer avisos
    • aviso: possível ação necessária, mas não essencial.
    • Informações: nenhuma ação é necessária.
    • debug: geralmente não é usado, exceto para capturar tudo para detecção de falhas.

    Valor padrão: erro

    		 Cadeia de caracteres
    sn_api_notif_mgmt.publisher_message_bus_configuration Define se as mensagens são publicadas usando o Serviço de envio de mensagens Hermes, o Barramento aberto de mensagens ou ambos. Você pode usar os seguintes valores:
    • openMessageBus
    • Hermes
    • ambos

    Valor padrão: openMessageBus

    		 Cadeia de caracteres
    sn_api_notif_mgmt.inboundqueue.maxrecords Número máximo de registros que o programador extrairá da fila de entrada para uma execução do programador. Este valor é usado em conjunto com o parâmetro sn_api_notif_mgmt.inboundqueue.batch.limit.
    • Valor padrão: 200
    • Outros valores possíveis: conforme necessário

    Por exemplo, se o limite do lote estiver definido como 50 e o maxrecords estiver definido como 200 e se o número de registros que estão na fila de entrada for 130, o programador extrairá três lotes diferentes de registros em uma única execução; dois com 50 registros e um com 30 registros. Se o número de registros na fila de entrada for 220, o programador extrairá quatro lotes de 50 registros e os 20 registros restantes não serão processados até a próxima vez em que o programador for executado.

    Ao definir este valor, você também deve considerar o tempo que levará para o programador processar vários lotes e definir o valor sn_api_notif_mgmt.schedule.max.runtime de acordo.

    		 Números inteiros
    sn_api_notif_mgmt.inboundqueue.batch.limit Número de registros que o programador extrai e processa da fila de entrada em um lote.
    • Valor padrão: 200
    • Outros valores possíveis: conforme necessário
    		 Números inteiros
    sn_api_notif_mgmt.glide.mutex.script.maxspins Número máximo de tentativas para adquirir um bloqueio de mutex nos registros da fila de entrada.
    • Tipo: Número Inteiro
    • Valor padrão: 100
    • Outros valores possíveis: conforme necessário
    		 Números inteiros
    sn_api_notif_mgmt.schedule.max.runtime O tempo máximo, em milissegundos, que o trabalho agendado pode ser executado antes de falhar e relatar um erro.
    • Tipo: Número Inteiro
    • Valor padrão: 90000
    • Outros valores possíveis: conforme necessário
    		 Números inteiros
    sn_api_notif_mgmt.glide.mutex.script.spinwait Tempo máximo, em milissegundos, de espera entre tentativas de adquirir um bloqueio de mutex nos registros na fila de entrada.
    • Tipo: Número Inteiro
    • Valor padrão: 100
    • Outros valores possíveis: conforme necessário
    		 Números inteiros

    Fluxo de trabalho da estrutura do produtor

    Quando o sistema envia por push um evento para a tabela de preparação, as etapas a seguir ocorrem como parte do mecanismo da estrutura do produtor:
    1. O programador seleciona um número de registros em um intervalo pré-configurado e envia snapshots do Glide para o processador de eventos.
    2. O sistema converte o snapshot do Glide em uma carga de evento de reclamação do TMF 688 com base no tipo de evento.

      Para saber mais sobre os métodos usados para definir e gerar as cargas compatíveis com TMF para eventos de tíquete de problema, consulte TopicAPIUtilsOOB - Scoped.

    3. O sistema verifica se a configuração de notificação se destina ao Hermes Kafka ou ao barramento de mensagem aberta.

      Para saber mais sobre como configurar a estrutura de notificação de eventos do produtor, consulte Producer Event Notification Framework developer guide.