注: 以下の翻訳の正確性は検証されていません。AIPを利用して英語版の原文から機械的に翻訳されたものです。
モニターが発火または解消したとき、Foundry 内でフォローしているユーザーに加え、Foundry 外部のサービスにもアラートを送信できます。監視ビューでは現在、PagerDuty、Slack、Webhook へのアラート送信をサポートしています。
すべての統合は、特定の重大度レベルに対して設定されます。その重大度に一致するアラートのみが統合をトリガーします。たとえば、重大度レベル MEDIUM に設定された PagerDuty 統合は、モニターが重大度 LOW または HIGH で発火してもトリガーされません。
この統合は PagerDuty V2 Events API ↗ を使用し、通常、サービスユーザー、メール、カスタムの許可リスト登録やエグレス設定は必要ありません。1個の統合で、監視ビュー内の特定の重大度のアラートすべてを、PagerDuty サービス内に定義された Events V2 API 統合にマッピングします。また、監視ビュー内に定義された複数の統合を、同じ PagerDuty 統合キーにマッピングできます。
必要なエスカレーションポリシー、緊急度設定、サポート時間を指定して PagerDuty サービスを設定します。サービスの統合タブで、新しい統合を追加します。統合の種類として Events API V2 を選択し、統合を追加します。通常、Events API V2 は最も人気のある統合セクションにあります。統合を追加したら、歯車アイコンを選択すると、監視ビュー用の新しい PagerDuty 統合を作成するために必要な統合キーなどの詳細が表示されます。
監視ビューのサブスクリプションを管理するタブに移動します。PagerDuty 通知セクションで、プラス記号(+)を選択して、新しい PagerDuty 統合を作成します。統合の名前、Events V2 API 統合を作成したときの統合キー、および重大度レベルを指定する必要があります。必要に応じて、対象の重大度レベルごとに繰り返します。
デフォルトでは、監視ビューは、監視ルールのアラートと、その監視ビューにアップグレードまたはリンクされたチェックグループに属するレガシーヘルスチェックに対して、PagerDuty 通知を生成します。ただし、v1.860.0 リリース(2024年2月)より前に作成された監視ビューでは、デフォルトで PagerDuty アラートは生成されないため、手動で有効にする必要があります。
この機能を有効にするには、ヘルスチェック用に PagerDuty を有効化チェックボックスを選択します。次の重大度のマッピングが使用されます。
LOW の統合が使用されます。MEDIUM の統合が使用されます。HIGH の統合が使用されます。この統合は、設定されたチャネルに Slack メッセージを送信できます。
この統合には、Data Connection で Slack ソースを作成する必要があります。このソースには Bearer トークンの設定が必要です。この Bearer トークンには、次のスコープが必要です。
channels:join: Foundry がアプリを要求されたチャネルに自動的に参加させます。channels:read:利用可能なチャネルの一覧表示に使用されます。chat:write:設定されたチャネルへのメッセージ送信に使用されます。groups:read:プライベートチャネルへのメッセージ送信に必要です。Slack でこのようなトークンを生成する方法の例を示します。
詳細については、Slack API ドキュメント ↗ を参照してください。
監視ビューのサブスクリプションを管理するタブに移動し、Slack セクションでプラス記号(+)を使用して、新しい Slack 統合を作成します。設定済みの Slack ソースを選択します。すると、Slack チャネル項目に、アラートを送信できる利用可能なチャネルの一覧が表示されます。
プライベートチャネルとの統合を設定するには、Slack アプリをプライベートチャネルに招待し、groups:read スコープが付与されていることを確認してください。
重大度レベルを設定し、必要に応じて、追加する重大度レベルごとに繰り返します。
監視ビューからの Slack 通知には、リソース識別子(ri.main.dataset.xyz789 のような RID)の代わりに、人が読みやすいリソース名(たとえば「本番売上データセット」)を表示できます。これにより、アラートを理解しやすくなり、緊急度をすばやく判断できます。リソース名は、セキュリティ制御で許可されている場合にのみ表示されます。具体的には、リソース上のすべてのマーキングが、Slack ソースのエクスポート可能なマーキングの設定に含まれている場合です。
Slack 通知の形式が変更され、セキュリティ制御で許可されている場合はリソース名が含まれるようになりました。Slack からの監視ビューの通知を処理するボットや自動パーサーを使用している場合、新しいメッセージ形式に対応するために更新が必要になることがあります。
モニターが発火して Slack にアラートを送信するとき、Foundry はリソース名を安全に共有できるかどうかを確認します。
たとえば、「顧客収益データ」という名前のデータセットに、Sales 組織の Confidential マーキングがある場合は、次のようになります。
ri.foundry.main.dataset.abc123 と表示されます。デフォルトでは、エクスポートを有効にするには、Slack ソースの所有者ロールと、エンロールメントの情報セキュリティ責任者ロールの両方が必要です。エクスポートを有効にした後は、ソースの所有者は、情報セキュリティ責任者ロールがなくてもエクスポート可能なマーキングと組織を追加できます。詳細については、エクスポートのドキュメントを参照してください。
Slack 通知でリソース名を表示できるようにするには、ソースのエクスポート可能なマーキングを設定します。
次のマーキングをエクスポート可能なマーキングとして追加することを検討してください。
制限の少ないマーキングから始めて、必要に応じて制限の厳しいマーキングを追加できます。リソース上のマーキングが1個でもエクスポート可能なリストに含まれていない場合、名前の代わりに RID が表示されることに注意してください。
この統合は、Data Connection で設定された Webhook をトリガーできます。Webhook の設定方法については、Webhook のドキュメントを参照してください。Webhook 統合を使用するには、Webhook に Message パラメーターという文字列型の入力パラメーターが必要です。このパラメーターには、通知の内容が入力されます。現在、内容はカスタマイズできません。
監視ビューのサブスクリプションを管理するタブに移動し、Webhook セクションでプラス記号(+)を使用して、新しい Webhook 統合を作成します。まず Webhook を選択してから、その Webhook の Message パラメーターと重大度レベルを選択する必要があります。必要に応じて、対象の重大度レベルごとに繰り返します。