Guia do desenvolvedor da Estrutura de notificação de evento do produtor

A Estrutura de notificação de eventos do produtor para telecomunicações, mídia e tecnologia permite a distribuição externa de eventos, como tíquetes de problema, usando um message-bus implementado em sua rede.

A Estrutura de notificação de eventos do produtor oferece suporte a dois casos de uso de barramento de mensagem diferentes:

1. Publicando eventos por meio do Serviço de envio de mensagens Hermes: se você planeja publicar eventos usando o Hermes Kafka, deve configurar a Estrutura de notificação de eventos do produtor para o barramento de mensagens do Kafka. Você só pode usar este barramento de mensagem para instâncias baseadas em nuvem. Para obter detalhes, consulte Configure a Estrutura de Notificação de Evento do Produtor para usar o Serviço de envio de mensagens Hermes.

   Para obter informações adicionais sobre como publicar notificações de tíquete de problema usando a Hermes, consulte Producing outbound trouble ticket notifications using Hermes.

   Nota:

   Antes de implementar este caso de uso, você já deve ter o Serviço de envio de mensagens Hermes instalado e configurado em sua instância. Para obter detalhes, consulte Hermes Messaging Service.
2. Publicando eventos por meio do barramento de mensagem aberto: se sua instância usa um barramento de mensagem personalizado, você deve configurar a Estrutura de notificação de evento do produtor para usar o barramento de mensagem aberto para enviar eventos de sua instância ServiceNow para consumidores em sua rede. As instâncias baseadas em nuvem e no local ServiceNow podem publicar eventos por meio do barramento de mensagem aberta. Para obter detalhes, consulte Configurar a Estrutura de Notificação de Evento do Produtor para usar o Abrir Barramento de Mensagens.

   Para obter informações adicionais sobre como publicar notificações de tíquete de problema usando o barramento de mensagem aberta, consulte Producing outbound trouble ticket notifications using the open message bus.

Este documento descreve a configuração do sistema que deve ser realizada, incluindo as inclusões de script que devem ser substituídas para implantar essas implementações de barramento de mensagem no seu ecossistema ServiceNow.

Propriedades do sistema do produtor

A tabela a seguir lista as propriedades em sua instância ServiceNow que controlam a funcionalidade da Estrutura de notificação de evento do produtor. Revise os valores padrão dessas propriedades e, se necessário, modifique-os para sua implementação específica. Para modificar essas propriedades, na IU ServiceNow vá para Todos > Propriedades do sistema > Todas as Propriedades.

Propriedade	Descrição
sn_api_notif_mgmt.event.log	Nível de registro em log gravado nos logs de depuração. Valores válidos: alerta crítico depurar emergir erro informações aviso aviso Padrão: erro
sn_api_notif_mgmt.glide.​mutex.​script.​maxspins	Número máximo de tentativas para adquirir um bloqueio mutex nos registros na fila de entrada. Padrão: 100
sn_api_notif_mgmt.​glide.​mutex.​script.​spinwait	Tempo de espera entre as tentativas de adquirir um bloqueio nos registros na fila de entrada. Unidade: milissegundos Padrão: 100
sn_api_notif_mgmt.​ inboundqueue.​batch.​limit	Número de registros que o programador extrairá e processará da fila de entrada de uma só vez (um lote). Padrão: 200
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. Por exemplo, se o limite do lote estiver definido como 50 e o máximo de registros estiver definido como 200, e 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 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 sn_api_notif_mgmt.schedule.max.runtime de acordo. Padrão: 200
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 de mensagem aberta ou ambos os barramentos de mensagem. Valores válidos: Hermes = Serviço de envio de mensagens Hermes openMessageBus = abrir barramento de mensagem both = o evento/mensagem é enviado em ambos os barramentos de mensagem. Padrão: openMessageBus
sn_api_notif_mgmt.​schedule.​max.​runtime	Tempo máximo que um trabalho programado pode ser executado antes de falhar e relatar um erro. Unidade: milissegundos Padrão: 90.000