PagerDuty エスカレーション ポリシー Microsoft Graph コネクタを使用すると、organizationで PagerDuty エスカレーション ポリシー データにインデックスを付け、Microsoft 365 Copilotおよび Microsoft Search で使用できるようにします。
この記事は、Microsoft 365 管理者、または PagerDuty エスカレーション ポリシー Microsoft Graph コネクタを構成、実行、監視するユーザーを対象とします。
機能
- セマンティック検索の機能を使用して、Copilot の PagerDuty エスカレーション ポリシーにアクセスします。
- organizationによって定義された ACL を保持します。
- クロール頻度をカスタマイズします。
- この接続とプラグインを使用して、Microsoft Copilot Studioからワークフローを作成します。
制限事項
- PagerDuty で高度なアクセス許可が有効になっている場合、特定のエスカレーション ポリシーにリンクされているチームのメンバーのみが、Microsoft Search および Microsoft 365 Copilotでそのエスカレーション ポリシーにアクセスして検索できます。
前提条件
PagerDuty エスカレーション ポリシー Microsoft Graph コネクタを作成する前に、次の手順を実行します。
PagerDuty アプリで管理者権限を持つ PagerDuty アカウントを作成します。
OAuth 2.0 機能が有効になっている PagerDuty に新しいアプリを追加します。 詳細については、「 OAuth 機能 」および「 アプリの登録」を参照してください。
PagerDuty の [新しいアプリ登録設定] ページで [スコープ付き OAuth] を選択します。
PagerDuty の新しいアプリ登録設定ページの [リダイレクト URL] フィールドには、次のリンクを使用します。
M365 Enterprise の場合は、
https://gcs.office.com/v1.0/admin/oauth/callbackM365 Government の場合は、
https://gcsgcc.office.com/v1.0/admin/oauth/callback
PagerDuty の新しいアプリ登録設定ページで、次のスコープを選択します。
- 監査レコード – 読み取りアクセス
- エスカレーション ポリシー – 読み取りアクセス
- Teams – 読み取りアクセス
- ユーザー – 読み取りアクセス
PagerDuty でアプリの登録が正常に完了したら、クライアント ID とクライアント シークレットをコピーします。
作業の開始
1. 表示名を構成する
ユーザーが Copilot 応答で関連付けられているファイルまたは項目を簡単に認識するのに役立つ表示名を選択します。
2. インスタンス REST API URL を追加する
PagerDuty を使用すると、お客様は自分のアカウントをホストする PagerDuty データ センターの地理的サービス リージョンを選択できます。
- 米国のサービス リージョンの場合、REST API URL は https://api.pagerduty.com。
- EU サービス リージョンの場合、REST API URL は https://api.eu.pagerduty.com。
詳細については、「 サービス リージョン」を参照してください。
3. 認証の種類を指定する
PagerDuty アプリの登録設定から取得したクライアント ID とクライアント シークレットを入力します。
4. 限定対象ユーザーにロールアウトする
この接続を限定されたユーザー ベースにデプロイして、Copilot やその他の検索サーフェスで検証してから、より広範な対象ユーザーに展開します。
カスタム セットアップ
カスタム セットアップでは、ユーザー、コンテンツ、同期の既定値を編集できます。
ユーザー
アクセス許可
Copilot または Search サーフェスの各項目にアクセスできるorganization内のユーザーを決定します。 インデックス付きデータをorganizationのすべてのユーザーに表示するか、データ ソースにアクセスできるユーザーにのみ表示するかを選択します。
コンテンツ
プロパティの管理
PagerDuty エスカレーション ポリシー データ ソースから使用可能なプロパティを追加または削除できます。 スキーマを割り当て、セマンティック ラベルを変更し、プロパティにエイリアスを追加します。 既定では、次のプロパティにインデックスが付けられます。
| Source プロパティ | Label | 説明 |
|---|---|---|
| Id | 該当なし | エスカレーション ポリシーの一意の ID。 |
| HtmlUrl | url |
PagerDuty のエスカレーション ポリシーの URL。 |
| CreatedBy | createdBy |
エスカレーション ポリシーを作成したユーザーの名前。 |
| CreatedTime | createdDateTime |
エスカレーション ポリシーが作成された時刻。 |
| LastModifiedBy | lastModifiedBy |
エスカレーション ポリシーを最後に変更したユーザーの名前。 |
| LastModifiedTime | lastModifiedDateTime |
エスカレーション ポリシーが最後に変更された時刻。 |
| 名前 | title |
エスカレーション ポリシーの名前。 |
| 概要 | 該当なし | クライアント内のエンティティのプライマリ ラベル付けに適したオブジェクトに関する簡潔で重要な情報を提供する、PagerDuty による短い形式のサーバー生成文字列。 多くの場合、 nameと同じですが、識別子を意図したものではありません。 |
| 説明 | 該当なし | エスカレーション ポリシーの説明。 |
| RuleDetail | 該当なし | このプロパティは、エスカレーション ポリシー内のエントリの一覧です。これには、未確認のインシデントがこのルールからエスカレートするまでの分数が含まれます。また、ルールに到達したときにインシデントを割り当てる必要があるターゲットも含まれます。 |
| UsedByServices | 該当なし | エスカレーション ポリシーに関連付けられているサービス。 |
同期
PagerDuty エスカレーション ポリシー Microsoft Graph コネクタでは、フル クロールのみがサポートされます。 フル クロールの既定のスケジュールは、毎日に設定されます。 必要に応じて、データ更新のニーズに合わせてこれらのスケジュールを調整できます。
トラブルシューティング
発生する可能性がある一般的なエラーとその解決方法を次に示します。
このセッションのセキュリティ資格情報の有効期限が切れています。 戻り、クライアント ID とクライアント シークレットを使用してもう一度サインインしてください。 資格情報の有効期限が切れます。 PagerDuty アプリ登録設定で新しいアプリ ID を作成し、最新のクライアント ID とクライアント シークレットを 設定 からコピーして認証します。
無効な資格情報が検出されました。 資格情報をチェックし、PagerDuty アプリのアクセス許可スコープをチェックしてください。 一般的な資格情報エラー。 PagerDuty アプリの登録設定に戻るし、クライアント ID とクライアント シークレットに適切なアクセス許可スコープがある場合にチェックします。
次の手順
接続を発行したら、管理センターの [データ ソース] の下の状態を確認できます。 詳細については、「 コネクタの管理」を参照してください。 問題がある場合、またはフィードバックを提供する場合は、 Microsoft Graph サポートにお問い合わせください。