Guide du développeur Producer Event Notification Framework

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 3 minutes de lecture
  • Le Producer Event Notification Framework for Telecommunications, Media, and Technology permet la distribution externe d’événements, tels que les tickets d’incident, à l’aide d’un bus de messages mis en œuvre dans votre réseau.

    Producer Event Notification Framework prend en charge deux cas d’utilisation de bus de messages différents :
    1. Publication d’événements par le biais de : Service de messagerie Hermes Si vous envisagez de publier des événements à l’aide d’Hermes Kafka, vous devez configurer l’infrastructure de notification d’événements du producteur pour le bus de messages Kafka. Vous ne pouvez utiliser ce bus de messages que pour les instances basées sur le cloud. Pour plus de détails, voir Configurez le cadre de travail de notification d’événements du producteur pour utiliser le Service de messagerie Hermes.

      Pour plus d’informations sur la publication de notifications de ticket d’incident à l’aide d’Hermes, consultez Producing outbound trouble ticket notifications using Hermes.

      Remarque :
      Avant de pouvoir implémenter ce cas d’utilisation, vous devez déjà l’avoir installé et configuré sur Service de messagerie Hermes votre instance. Pour plus de détails, voir Hermes Messaging Service.
    2. Publication d’événements via le bus de messages ouvert : si votre instance utilise un bus de messages personnalisé, vous devez configurer Producer Event Notification Framework pour utiliser le bus de messages ouvert afin d’envoyer des événements de votre ServiceNow instance aux consommateurs de votre réseau. Les instances basées dans le cloud et sur site ServiceNow peuvent publier des événements via le bus de messages ouvert. Pour plus de détails, voir Configurer le cadre de travail de notification d’événement du producteur pour utiliser le bus de messages ouvert.

      Pour plus d’informations sur la publication de notifications de tickets d’incident à l’aide du bus de messages ouverts, reportez-vous à la section Producing outbound trouble ticket notifications using the open message bus.

    Ce document décrit la configuration système qui doit être effectuée, y compris les script includes qui doivent être remplacés pour déployer ces implémentations de bus de messages dans votre ServiceNow écosystème.

    Propriétés système du créateur

    Le tableau suivant répertorie les propriétés de votre ServiceNow instance qui contrôlent la fonctionnalité du cadre de travail de notification d’événements du producteur. Examinez les valeurs par défaut de ces propriétés et, si nécessaire, modifiez-les pour votre implémentation spécifique. Pour modifier ces propriétés, dans l’interface ServiceNow utilisateur, accédez à Tous > Propriétés système > Toutes les propriétés.

    Propriété Description
    sn_api_notif_mgmt.event.log Niveau de journalisation à écrire dans les journaux de débogage.
    Valeurs valides :
    • alerte
    • Crit
    • déboguer
    • Émergent
    • Err
    • info
    • avis
    • avertissement

    Valeur par défaut : err

    sn_api_notif_mgmt.glide.Mutex.Script.Tours max. Nombre maximal de tentatives d’acquisition d’un verrou mutex sur les enregistrements de la file d’attente entrante.

    Par défaut : 100

    sn_api_notif_mgmt.glide.Mutex.Script.spinwait (en anglais seulement) Temps d’attente entre les tentatives d’acquisition d’un verrou sur les enregistrements de la file d’attente entrante.

    Unité : millisecondes

    Par défaut : 100

    sn_api_notif_mgmt.inboundqueue.batch.limit Nombre d’enregistrements que le planificateur extrait et traite à partir de la file d’attente entrante en une seule fois (un lot).

    Par défaut : 200

    sn_api_notif_mgmt.inboundqueue.maxrecords Nombre maximal d’enregistrements que le planificateur extrait de la file d’attente entrante pour une exécution du planificateur. Cette valeur est utilisée conjointement avec le sn_api_notif_mgmt.inboundqueue.batch.limit paramètre.

    Par exemple, si la limite de lots est fixée à 50, que maxrecords est défini sur 200 et que le nombre d’enregistrements dans la file d’attente entrante est de 130, le planificateur extrait trois lots d’enregistrements différents en une seule exécution ; deux avec 50 enregistrements et un avec 30 enregistrements. Si le nombre d’enregistrements dans la file d’attente entrante est de 220, le planificateur extrait quatre lots de 50 enregistrements et les 20 enregistrements restants ne sont pas traités avant la prochaine exécution du planificateur.

    Lors de la définition de cette valeur, vous devez également tenir compte du temps qu’il faudra au planificateur pour traiter plusieurs lots et définir la sn_api_notif_mgmt.schedule.max.runtime valeur en conséquence.

    Par défaut : 200

    sn_api_notif_mgmt.publisher_message_bus_configuration Définit si les messages sont publiés à l’aide de , du bus de Service de messagerie Hermes messages ouvert ou des deux bus de messages.
    Valeurs valides :
    • Hermès = Service de messagerie Hermes
    • openMessageBus = ouvrir un bus de messages
    • both = L’événement/message est envoyé sur les deux bus de messages.

    Valeur par défaut : openMessageBus

    sn_api_notif_mgmt.Horaire.max. d’exécution Durée maximale pendant laquelle une tâche planifiée peut s’exécuter avant qu’elle n’échoue et ne signale une erreur.

    Unité : millisecondes

    Par défaut : 90 000