Guia do desenvolvedor da Estrutura de notificação de eventos 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.
- Publicando eventos por meio do Serviço de envio de mensagens Hermes: se você planeja publicar eventos usando o Hermes Kafka, deverá 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 eventos 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 o Hermes, consulte Producing outbound API notifications using Hermes.
Nota:Antes de poder implementar este caso de uso, você já deve ter Serviço de envio de mensagens Hermes instalado e configurado em sua instância. Para obter detalhes, consulte Hermes Messaging Service. - Publicação de 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 eventos 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 na nuvem e no local ServiceNow podem publicar eventos por meio do barramento de mensagens aberto. Para obter detalhes, consulte Configurar a Estrutura de Notificação de Eventos do Produtor para usar o Barramento de Mensagem Aberto.
Para obter informações adicionais sobre como publicar notificações de tíquete de problema usando o barramento de mensagem aberta, consulte Producing outbound API 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 mensagens em 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 eventos 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 .
| Propriedade | Descrição |
|---|---|
| sn_api_notif_mgmt.event.log | Nível de registro em log para gravado nos logs de depuração. Valores válidos:
Padrão: erro |
| sn_api_notif_mgmt.glide.mutex.script.maxspins | Número máximo de tentativas para adquirir um bloqueio de mutex nos registros na fila de entrada. Padrão: 100 |
| sn_api_notif_mgmt.glide.mutex.script.spinwait | Tempo de espera entre 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 maxrecords estiver definido como 200, e o número de registros que estão na fila de entrada é 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. 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. Valores válidos:
Padrão: openMessageBus |
| sn_api_notif_mgmt.schedule.max.tempo de execução | Tempo máximo que um trabalho programado pode ser executado antes de falhar e relatar um erro. Unidade: Milissegundos Padrão: 90.000 |