Guia do desenvolvedor da Estrutura de notificação de evento do produtor
A Estrutura de notificação de evento do produtor para telecomunicações, mídia e tecnologia permite a distribuição externa de eventos, como tíquetes de problemas, usando um message-bus implementado em sua rede.
- Publicação de 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 evento do produtor para o barramento de mensagens Kafka. Você só pode usar este barramento de mensagens para instâncias baseadas em nuvem. Para obter detalhes, consulte Configure a Estrutura de notificação de evento do produtor para usar Serviço de envio de mensagens Hermes.
Para obter informações adicionais sobre como publicar notificações de tíquete de problemas usando Hermes, consulte Producing outbound API 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. - Publicação de eventos por meio do barramento de mensagens em aberto: Se sua instância usar um barramento de mensagens personalizado, você deverá configurar a Estrutura de notificação de evento do produtor para usar o barramento de mensagens em aberto para enviar eventos do ServiceNow instância para consumidores em sua rede. Baseado em nuvem e no local ServiceNow as instâncias podem publicar eventos por meio do barramento de mensagens aberto. Para obter detalhes, consulte Configure a Estrutura de notificação de evento do produtor para usar o Open Message Bus.
Para obter informações adicionais sobre como publicar notificações de tíquete de problemas usando o barramento de mensagens aberto, 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 no seu ServiceNow ecossistema.
Propriedades do sistema do produtor
A tabela a seguir lista as propriedades em seu ServiceNow Instância que controla 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, em ServiceNow IU Ir para .
| Propriedade | Descrição |
|---|---|
| sn_api_notif_mgmt.event.log | Nível de registro em log a ser gravado nos logs de depuração. Valores válidos:
Padrão: err |
| sn_api_notif_mgmt.glide.mutex. script. maxspins | Número máximo de tentativas de adquirir um bloqueio mutex nos registros na fila de entrada. Padrão: 100 |
| sn_api_notif_mgmt. glide. mutex. script. espera | 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. lote. limite | Número de registros que o agendador extrairá e processará da fila de entrada de uma 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 sn_api_notif_mgmt.inboundqueue.batch.limitparâmetro. Por exemplo, se o limite de lote estiver definido como 50 e os 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 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 sn_api_notif_mgmt.schedule.max.runtimevalor de acordo. Padrão: 200 |
| sn_api_notif_mgmt. publisher_message_bus_configuration | Define se as mensagens são publicadas usando Serviço de envio de mensagens Hermes, o barramento de mensagens aberto ou ambos os barramentos de mensagens. Valores válidos:
Padrão: OpenMessageBus |
| sn_api_notif_mgmt. programação. máx 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 |