プロデューサーイベント通知フレームワーク開発者ガイド

  • リリースバージョン: Washingtondc
  • 更新日 2024年02月01日
  • 読む4読むのに数分

    • 電気通信、メディア、およびテクノロジーのプロデューサーイベント通知フレームワークを使用すると、ネットワークに実装されたメッセージバスを使用して、トラブルチケットなどのイベントを外部に配信できます。

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

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

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

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

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

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

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

    プロパティ 説明
    sn_api_notif_mgmt.event.log デバッグログに書き込むログのレベル。
    有効な値：
    • アラート
    • クリティカル
    • debug
    • Emerg
    • Err
    • 情報
    • 通知
    • 警告

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

    デフォルト: 100
    sn_api_notif_mgmt.glide.ミュー テックス。スクリプト。Spinwait 受信キュー内のレコードのロック取得を試行する間隔。

    単位：ミリ秒

    デフォルト: 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 = Hermes メッセージングサービス
    • openMessageBus = オープンメッセージバス
    • both = イベント/メッセージは両方のメッセージ バスで送信されます。

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

    単位：ミリ秒

    デフォルト:90,000