View a markdown version of this page

PagerDuty の接続 - AWS DevOps エージェント

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

PagerDuty の接続

PagerDuty の統合により、 AWS DevOps Agent はインシデント調査と自動対応中に PagerDuty アカウントからインシデントデータ、オンコールスケジュール、サービス情報にアクセスして更新できます。この統合では、OAuth 2.0 を使用して安全な認証を行います。

重要

AWS DevOps エージェントは、新しい PagerDuty OAuth 2.0 (スコープ付き OAuth) のみをサポートします。リダイレクト uri を使用するレガシー PagerDuty OAuth はサポートされていません。

PagerDuty の要件

PagerDuty を接続する前に、以下を確認してください。

  • OAuth クライアント ID とクライアントシークレットを持つ PagerDuty アカウント

  • PagerDuty アカウントのサブドメイン (たとえば、PagerDuty URL が の場合https://your-company.pagerduty.com、サブドメインは your-company)

PagerDuty の登録

PagerDuty は AWS アカウントレベルで登録され、そのアカウントのすべてのエージェントスペース間で共有されます。

ステップ 1: PagerDuty でアクセスを設定する

  1. AWS マネジメントコンソールにサインインする

  2. AWS DevOps エージェントコンソールに移動する

  3. 機能プロバイダーページに移動する (サイドナビゲーションからアクセス可能)

  4. 「コミュニケーション」の「利用可能なプロバイダー」セクションで PagerDuty を検索し、「登録」を選択します。

  5. PagerDuty の「アクセスの設定」ページのガイド付きセットアップに従います。

サービスリージョンとサブドメインを確認します。

  • アカウントスコープ – PagerDuty リージョン (米国または欧州) を選択し、PagerDuty サブドメインを入力します。たとえば、PagerDuty URL が の場合https://your-company.pagerduty.com、 と入力しますyour-company

PagerDuty で新しいアプリを作成します。

  • 別のブラウザタブで PagerDuty にログインし、統合 > アプリ登録に移動します。

  • OAuth 2.0 スコープド OAuth を使用して新しいアプリケーションを作成する

  • 「アクセス許可」で、最低限必要なスコープ incidents.readincidents.writeservices.readwebhook_subscriptions.read、 を付与します。 webhook_subscriptions.write

  • イベント統合を有効にして、 AWS DevOps エージェントと PagerDuty 間の双方向通信を許可する

OAuth 認証情報を設定します。

  • アクセス許可の範囲 – 最低限必要な範囲は、incidents.read、、incidents.writeservices.readwebhook_subscriptions.read、 です。 webhook_subscriptions.write

  • クライアント名 – OAuth クライアントのわかりやすい名前を入力します。

  • クライアント ID – PagerDuty アプリ登録から OAuth クライアント ID を入力します。

  • クライアントシークレット – PagerDuty アプリ登録から OAuth クライアントシークレットを入力します。

ステップ 2: PagerDuty 登録を確認して送信する

  1. PagerDuty 設定の詳細をすべて確認する

  2. 送信を選択して登録を完了します

  3. 登録が成功すると、PagerDuty は機能プロバイダーページの現在登録されているセクションに表示されます。

エージェントスペースへの PagerDuty の追加

PagerDuty をアカウントレベルで登録したら、個々のエージェントスペースに接続できます。

  1. AWS DevOps エージェントコンソールで、エージェントスペースを選択します。

  2. 機能タブに移動する

  3. 「コミュニケーション」セクションで、「追加」を選択します。

  4. 利用可能なプロバイダーのリストから PagerDuty を選択する

  5. [保存] を選択します。

PagerDuty 接続の管理

  • 認証情報の更新 – OAuth 認証情報を更新する必要がある場合は、機能プロバイダーページから PagerDuty の登録を解除し、新しい認証情報で再登録します。

  • 接続の表示 – AWS DevOps エージェントコンソールで、エージェントスペースを選択し、機能タブに移動して、接続された通信統合を表示します。

  • PagerDuty の削除 – PagerDuty をエージェントスペースから切断するには、コミュニケーションセクションでそれを選択し、削除を選択します。登録を完全に削除するには、まずすべてのエージェントスペースから削除してから、機能プロバイダーページから登録を解除します。

Webhook のサポート

AWS DevOps エージェントは PagerDuty V3 ウェブフックのみをサポートします。以前のウェブフックバージョンはサポートされていません。

PagerDuty V3 ウェブフックサブスクリプションの詳細については、PagerDuty 開発者ドキュメントの「Webhooks Overview」を参照してください。