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

# PagerDuty の接続
<a name="connecting-to-ticketing-and-chat-connecting-pagerduty"></a>

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

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

## PagerDuty の要件
<a name="pagerduty-requirements"></a>

PagerDuty を接続する前に、以下を確認してください。
+ OAuth クライアント ID とクライアントシークレットを持つ PagerDuty アカウント
+ PagerDuty アカウントのサブドメイン (たとえば、PagerDuty URL が の場合`https://your-company.pagerduty.com`、サブドメインは `your-company`)

## PagerDuty の登録
<a name="registering-pagerduty"></a>

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

### ステップ 1: PagerDuty でアクセスを設定する
<a name="step-1-configure-access-in-pagerduty"></a>

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

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

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

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

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

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

**PagerDuty で新しいアプリを作成します。**
+ 別のブラウザタブで PagerDuty にログインし、**統合 > アプリ登録**に移動します。
+ **OAuth 2.0 スコープド OAuth **を使用して新しいアプリケーションを作成する
+ **「アクセス許可**」で、最低限必要なスコープ `incidents.read`、`incidents.write`、および を付与します。 `services.read`
+ **イベント統合**を有効にして、 AWS DevOps Agent と PagerDuty 間の双方向通信を許可する

**OAuth 認証情報を設定します。**
+ アクセス**許可の範囲** – 最低限必要な範囲は、`incidents.read`、`incidents.write`、 です。 `services.read`
+ **クライアント名** – OAuth クライアントのわかりやすい名前を入力します。
+ **クライアント ID** – PagerDuty アプリ登録から OAuth クライアント ID を入力します。
+ **クライアントシークレット** – PagerDuty アプリ登録から OAuth クライアントシークレットを入力します。

### ステップ 2: PagerDuty 登録を確認して送信する
<a name="step-2-review-and-submit-pagerduty-registration"></a>

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

1. **送信**をクリックして登録を完了します

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

## エージェントスペースへの PagerDuty の追加
<a name="adding-pagerduty-to-an-agent-space"></a>

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

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

1. **機能**タブに移動する

1. **「コミュニケーション**」セクションで、**「追加**」をクリックします。

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

1. **保存 **をクリックします。

## PagerDuty 接続の管理
<a name="managing-pagerduty-connections"></a>
+ **認証情報の更新** – OAuth 認証情報を更新する必要がある場合は、機能プロバイダーページから PagerDuty を登録解除し、新しい認証情報で再登録します。
+ **接続の表示** – AWS DevOps エージェントコンソールで、エージェントスペースを選択し、機能タブに移動して、接続された通信統合を表示します。
+ **PagerDuty の削除** – PagerDuty をエージェントスペースから切断するには、コミュニケーションセクションでそれを選択し、**削除**をクリックします。登録を完全に削除するには、まずすべてのエージェントスペースから削除してから、機能プロバイダーページから登録を解除します。

## Webhook のサポート
<a name="webhook-support"></a>

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

PagerDuty V3 ウェブフックサブスクリプションの詳細については、PagerDuty デベロッパードキュメントの[「Webhooks Overview](https://developer.pagerduty.com/docs/webhooks-overview#webhook-subscriptions)」を参照してください。