Uso da estrutura do produtor para notificações de saída

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 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 programados.

    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: qualquer aviso
    • aviso: possível ação necessária, mas não essencial.
    • Informações: nenhuma ação necessária.
    • depurar: 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 Hermes Messaging Service, o Open Message Bus ou ambos os barramentos de mensagens. 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 máximo de registros estiver definido como 200 e se o número de registros 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 execução do programador.

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

    		 Inteiro
    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
    		 Inteiro
    sn_api_notif_mgmt.glide.mutex.script.maxspins Número máximo de tentativas para adquirir um bloqueio mutex nos registros da fila de entrada.
    • Tipo: inteiro
    • Valor padrão: 100
    • Outros valores possíveis: conforme necessário
    		 Inteiro
    sn_api_notif_mgmt.schedule.max.runtime O tempo máximo, em milissegundos, que o trabalho programado pode ser executado antes que ele falhe e relate um erro.
    • Tipo: inteiro
    • Valor padrão: 90000
    • Outros valores possíveis: conforme necessário
    		 Inteiro
    sn_api_notif_mgmt.glide.mutex.script.spinwait Tempo máximo, em milissegundos, de espera entre as tentativas de adquirir um bloqueio mutex nos registros na fila de entrada.
    • Tipo: inteiro
    • Valor padrão: 100
    • Outros valores possíveis: conforme necessário
    		 Inteiro

    Fluxo de trabalho da estrutura do produtor

    Quando o sistema envia 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 úteis 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 evento do produtor, consulte Producer Event Notification Framework developer guide.