Producer Event Notification Framework 開発者ガイド

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間：4分

    • Producer Event Notification Framework for Telecommunications, Media, and Technology を使用すると、ネットワークに実装された メッセージバス を使用して、トラブルチケットなどのイベントを外部に配布できます。

    プロデューサーイベント通知フレームワークは、次の 2 つの異なるメッセージバスのユースケースをサポートしています。
    1. Hermes メッセージングサービス を使用したイベントの公開:Hermes Kafka を使用してイベントを公開する場合は、Kafka メッセージバスのプロデューサーイベント通知フレームワークを構成する必要があります。このメッセージバスは、クラウドベースのインスタンスにのみ使用できます。詳細については、「を使用するようにプロデューサーイベント通知フレームワークを構成する Hermes メッセージングサービス」を参照してください。

      Hermes を使用してトラブルチケット通知を公開する方法の詳細については、「 Producing outbound API notifications using Hermes」を参照してください。

      注:
      このユースケースを実装する前に、インスタンスに Hermes メッセージングサービス をインストールして設定しておく必要があります。詳細については、「Hermes Messaging Service」を参照してください。
    2. オープンメッセージバスを介したイベントの公開:インスタンスでカスタムメッセージバスを使用する場合は、オープンメッセージバスを使用して ServiceNow インスタンスからネットワーク上のコンシューマーにイベントを送信するようにプロデューサーイベント通知フレームワークを構成する必要があります。クラウドベースのインスタンスとオンプレミスの ServiceNow インスタンスの両方で、オープンメッセージバスを介してイベントを公開できます。詳細については、「Open Message Bus を使用するようにプロデューサーイベント通知フレームワークを構成する」を参照してください。

      オープンメッセージバスを使用してトラブルチケット通知を公開する方法の詳細については、「 Producing outbound API notifications using the open message bus」を参照してください。

    このドキュメントでは、これらのメッセージバス実装を ServiceNow エコシステムに展開するために上書きする必要があるスクリプトインクルードを含め、実行する必要があるシステム構成について説明します。

    プロデューサーシステムプロパティ

    次の表に、プロデューサーイベント通知フレームワークの機能を制御する ServiceNow インスタンス内のプロパティを示します。これらのプロパティのデフォルト値を確認し、必要に応じて特定の実装に合わせて変更します。これらのプロパティを変更するには、 ServiceNow UI で次の場所に移動します すべて > システムプロパティ > すべてのプロパティ.

    財産 説明
    sn_api_notif_mgmt.event.log デバッグログに書き込まれるログのレベル。
    有効な値：
    • アラート
    • クリティカル
    • debug
    • エマーグ
    • Err
    • 情報
    • 通知
    • 警告

    デフォルト:err
    sn_api_notif_mgmt.glide。ミューテックス。スクリプト。maxspin 受信キュー内のレコードのミューテックスロックを取得する最大試行回数。

    デフォルト：100
    sn_api_notif_mgmt.glide。ミューテックス。スクリプト。スピン待機 受信キューのレコードのロックを取得する試行間の待機時間。

    単位：ミリ秒

    デフォルト：100
    sn_api_notif_mgmt.inboundqueue.batch.limit スケジューラーが受信キューから一度に プルして処理 するレコードの数 (1 つのバッチ)。

    デフォルト:200
    sn_api_notif_mgmt.inboundqueue.maxrecords 1 回のスケジューラー実行に対してスケジューラーが受信キューからプルするレコードの最大数。この値は、 sn_api_notif_mgmt.inboundqueue.batch.limit パラメーターと組み合わせて使用します。

    たとえば、バッチ制限が 50 に設定され、maxrecords が 200, に設定され、 受信キュー内のレコード数が 130 の場合、スケジューラーは 1 回の実行で 3 つの異なるレコードバッチ (2 つは 50 レコード、もう 1 つは 30 レコード) をプルします。受信キューのレコード数が 220 の場合、スケジューラーは 50 レコードの 4 つのバッチをプルし、残りの 20 レコードは次にスケジューラーが実行されるまで処理されません。

    この値を設定するときは、スケジューラーが複数のバッチを処理するのにかかる時間も考慮し、それに応じて sn_api_notif_mgmt.schedule.max.runtime 値を設定する必要があります。

    デフォルト:200
    sn_api_notif_mgmt.publisher_message_bus_configuration Hermes メッセージングサービス、オープンメッセージバス、または両方のメッセージバスを使用してメッセージを公開するかどうかを定義します。
    有効な値：
    • エルメス = Hermes メッセージングサービス
    • openMessageBus = オープンメッセージバス
    • both = イベント/メッセージは両方のメッセージバスで送信されます。

    デフォルト:openMessageBus
    sn_api_notif_mgmt.schedule。max.runtime スケジュールジョブが失敗してエラーを報告するまでに実行できる最大時間。

    単位：ミリ秒

    デフォルト:90,000