ストリームコネクト 警告
ストリームコネクト統合のアラートとアラート通知を受信します。
ストリームコネクトは、アクティブモニタリングとスケジュール済みモニタリングの両方を使用して、複数のストリームコネクトコンポーネントにわたるイベントを検出します。問題が検出されると、システムはアラートを作成し、ストリームコネクトログにメッセージを記録して、アラート通知を送信します。
アラート
-
イベントタイプのアラート (またはリアルタイムアラート) は、ストリームコネクトのコンポーネントにエラーが発生した場合に作成されます。たとえば、プロデューサーがトピックに書き込めない場合や、コンシューマーがトピックから読み取ることができない場合などです。これらのアラートはコードに組み込まれており、アラートプロパティを使用して重大度レベルと通知を送信するタイミングを決定します。イベントタイプのアラートは、さまざまなメカニズムを使用して複数のストリームコネクトコンポーネントにわたってイベントを検出するアクティブモニタリングによって検出されます。システムは設定をキャッシュし、イベントを発生時に検出します。
-
しきい値アラートは、値がしきい値未満からしきい値以上に移行すると作成されます。たとえば、トピックの遅延が特定のメッセージ数を超えた場合や、トピック内のメッセージの処理時間が指定された値を超えた場合などです。しきい値アラートがしきい値以上からしきい値未満に減少すると、アラートのアクティブフラグが false に設定されます。しきい値アラートはスケジュール済みモニタリングによって検出され、スケジュール済みジョブがストリームコネクトの統合に対してスクリプト化されたチェックを実行します。アラートは、アラートプロパティで指定されたアラートコンフィグレーションを満たすしきい値に対して生成されます。
アラートのリストと説明、またはアラートプロパティの構成については、「ストリームコネクト アラートプロパティ」を参照してください。アラートプロパティを表示または変更するには、Kafka アドミンロールが必要です。
アラートテーブル
アラートが初めてトリガーされると、アラート [sys_sc_alert] レコードが ストリームコネクト アラート [sys_sc_alerts] テーブルに追加されます。同じアラートが再度トリガーされ、元のアラートレコードがまだアクティブな場合は、レコードの [前回の検出 [last_detection]] フィールドが更新されます。元のアラートレコードがアクティブでない場合は、新しいレコードがアラートテーブルに追加されます。指定された時間にわたってアラートがトリガーされなかった場合、アラートレコードは非アクティブになります。この時間の間隔はアラートのタイプによって異なり、ストリームコネクト アラートプロパティ UI で変更できます。
- アラートレコードを参照するアラートの番号。各アラートレコードには、影響を受けるコンポーネントの名前、重大度レベル、タイムスタンプなど、アラートに関する詳細情報が含まれています。
- アラートの 影響を受けるエンティティ。アラートのターゲット (Kafka ストリームや Kafka フロートリガーなど) を参照します。
アラートは 30 日間有効です。テーブルクリーナージョブは、ストリームコネクトのアラートテーブルの保持期間を処理します。指定された期間内にアラートが再発しなかった場合、アクティブなアラートは非アクティブ化されます。期間は、ストリームコネクトのアラートプロパティでアラートタイプごとに設定されます。
アラートログ
ストリームコネクトのアラートのログメッセージは、ストリームコネクトログ [sys_consumer_log] に書き込まれます。このログには、関連するストリームコネクトアラートレコードを参照するアラート [sc_alert] フィールドがあります。
ログは 30 日間有効です。ログの保持期間は、ストリームコネクトログのテーブルローテーションスケジュールによって決まります。
通知
アラート通知は、メール、SMS、または ServiceNow® モバイルアプリで受信します。通知には、アラートの番号、レベル、説明などの詳細なアラート情報が含まれています。
アラートがトリガーされると、同じアラートの通知が最近トリガーされていない限り、通知もトリガーされます。各アラートには、検出したものを 2 つの別個のアラートとしてカウントできるようにアラート検出の間隔を秒単位で指定する時間間隔プロパティがあります。通知がトリガーされるのは、前回の通知から経過した時間がその時間間隔よりも長い場合、または、しきい値ベースのアラートではアラートの重大度が前回の検出以降に増加した場合のみです。これにより、同じアラートに対して短時間に複数の通知を受信せずに済みます。各アラートの時間間隔プロパティは、ストリームコネクトアラートプロパティ UI から変更できます。
- ストリームコネクトアラート:INFO
- ストリームコネクトアラート:警告
- ストリームコネクトアラート:重大
通知は、ストリームコネクトアラート通知グループのメンバーであるユーザーに送信されます。ストリームコネクトアラート通知グループのメンバーはストリームコネクトアラート閲覧者ロールを継承するため、通知を受信するすべてのユーザーが通知内のリンクを使用してアラートレコードを表示できます。
ロール
- Kafka アドミン [kafka_admin] ロールは、ストリームコネクトのアラートレコードとログの表示、ストリームコネクトのアラートプロパティの構成、アラート通知設定の構成を行うことができます。
- ストリームコネクトアラート閲覧者 [stream_connect_alert_viewer] ロールは、ストリームコネクトのアラートレコードとログに対する読み取り専用アクセス権を持ちます。
ACL とドメインセパレーション
ストリームコネクトアラートテーブルの ACL を使用すると、ストリームコネクトアラート閲覧者ロールを持つユーザーは、アラートテーブルとそのテーブルのレポートを表示できます。そのロールのないユーザーは、そのテーブルを読み取ったりレポートしたりすることはできません。Kafka アドミンロールを持つユーザーのみが、そのテーブルでレコードを挿入および更新できます。ACL により、Kafka アドミンのみがストリームコネクトのアラートプロパティページを使用できるようになります。
ドメインセパレーションされたインスタンスでは、アラートを管理するプロパティをドメインごとに上書きできます。詳細については、「Domain separation application properties」を参照してください。
プロパティの検索に使用されるドメインは、トピックまたはコンシューマーのドメインです。プロパティを設定するためのストリームコネクトアラートプロパティ UI は、ドメイン固有のオーバーライドではなくグローバルプロパティを設定します。ドメイン固有のオーバーライドを設定するための UI はありません。ストリームコネクトアラートテーブルの sys_domain は、それをトリガーしたコンシューマーのドメイン (コンシューマーアラートの場合) または sys_kafka_topic レコードのドメイン (プロデューサーアラートの場合) と同じである必要があります。コンシューマーまたはトピックが不明なアラートの場合、sys_sc_alert ドメインはグローバルに設定されます。
プラグイン
ストリームコネクトのアラートには、ServiceNow ストリームコネクト Alerting [com.glide.hub.stream_connect.alerting] プラグインが必要です。このプラグインは、ServiceNow ストリームコネクト Installer [com.glide.hub.stream_connect.installer] プラグインが有効になると自動的に有効になります。