> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloudthinker.io/llms.txt
> Use this file to discover all available pages before exploring further.

# PagerDuty

> PagerDuty を CloudThinker に接続してオンコール管理、インシデントアラート、エスカレーションポリシーの連携を行う

PagerDuty アカウントを接続して、CloudThinker エージェントがインシデントの管理、オンコールスケジュールの確認、サービスの監視、エスカレーションポリシーの処理を行えるようにします。PagerDuty は作成ユーザーの権限にスコープされた **User API Token** で認証します。

***

## 対応プラットフォーム

| プラットフォーム      | サポート                                                   |
| ------------- | ------------------------------------------------------ |
| **PagerDuty** | すべてのプラン（Free、Professional、Business、Digital Operations） |

***

## 前提条件

* いずれかのプランの **PagerDuty アカウント**。
* **My Profile → User Settings → API Access** から生成した **User API Token**。

<Info>
  **General Access REST API Key** ではなく **User API Token** を使用してください。ユーザートークンはそのユーザーが参照できる範囲にアクセスをスコープするため、セキュリティ境界がより明確になります。
</Info>

***

## セットアップ

<Steps>
  <Step title="PagerDuty を開く">
    [app.pagerduty.com](https://app.pagerduty.com) で PagerDuty アカウントにサインインします。
  </Step>

  <Step title="User API Key を生成する">
    **ユーザーアイコン → My Profile** をクリックし、**User Settings → API Access** までスクロールして **Create API User Token** をクリックします：

    * **Description**: `cloudthinker`
    * **Create Key** をクリック

    キーを直ちにコピーします — 再表示されません。
  </Step>

  <Step title="CloudThinker に接続を追加する">
    **Connections → PagerDuty** に移動し、以下を入力します：

    * **User API Key**: 生成したトークン

    **Connect** をクリックします。CloudThinker が認証情報を検証し、**Connected** ステータスを表示します。
  </Step>
</Steps>

<Warning>
  API トークンは作成直後にコピーしてください。PagerDuty は再表示しないため、紛失した場合は新しいトークンを作成する必要があります。
</Warning>

***

## 接続の詳細

| フィールド                         | 説明                       | 例            |
| ----------------------------- | ------------------------ | ------------ |
| **PAGERDUTY\_USER\_API\_KEY** | PagerDuty User API Token | `u+xxxxx...` |

***

## 必要な権限

### 最小（読み取り専用）

**Observer** または **Responder** ロールのユーザーが提供するもの：

* インシデント、サービス、エスカレーションポリシーの閲覧
* オンコールスケジュールの閲覧
* チームとユーザーの閲覧

### 推奨（全操作）

**Responder** または **Manager** ロールのユーザーが提供するもの：

* すべての読み取り権限
* インシデントの承認と解決
* インシデントとステータス更新の作成
* オンコールオーバーライドの管理

<Tip>
  最小権限の原則に従い、読み取り専用の監視には Observer ロールを割り当ててください。インシデントへの書き込みアクションが必要な場合のみ Responder または Manager に昇格してください。
</Tip>

***

## エージェントの機能

接続後、エージェントは PagerDuty データの照会と操作を行えます。

| 機能               | 説明                              |
| ---------------- | ------------------------------- |
| **インシデントのトリアージ** | トリガーされた・承認済みインシデントの一覧表示、パターンの特定 |
| **オンコールスケジュール**  | 現在のオンコール担当者と今後のローテーションを確認する     |
| **サービスのヘルス**     | サービスのステータスとアクティブなインシデント数を監視する   |
| **エスカレーションポリシー** | エスカレーションチェーンと通知ルールを確認する         |
| **インシデントのアクション** | インシデントの承認、解決、メモの追加              |
| **スケジュール管理**     | スケジュールを確認し、カバレッジのギャップを特定する      |

### 接続を確認する

```text theme={null}
@alex list all triggered PagerDuty incidents and report the current on-call schedule
```

### プロンプト例

```text theme={null}
@alex list all triggered and acknowledged incidents and #report any patterns by service
@alex who is currently on-call for the platform-engineering service?
@alex show next week's on-call schedule and identify any coverage gaps
```

***

## トラブルシューティング

<Accordion title="認証に失敗した">
  トークンが正しくないか、期限切れか、または失効しています。User API Token を確認し、**ユーザートークン**（REST API Key ではない）を使用していることを確認し、必要であれば新しいトークンを生成してください。
</Accordion>

<Accordion title="権限が拒否された">
  ユーザーのロール権限またはチームレベルのアクセス制限が不十分です。書き込み操作には、ユーザーが Responder または Manager ロールを持っていることを確認してください。
</Accordion>

<Accordion title="サービスまたはインシデントが表示されない">
  ユーザーが関連するチームへのアクセス権を持っていません。チームのメンバーシップに監視したいサービスが含まれているか確認してください。
</Accordion>

<Accordion title="トークンが失効した">
  PagerDuty の **My Profile → User Settings** に移動し、新しい API User Token を作成して、CloudThinker の接続設定でトークンを更新してください。
</Accordion>

***

## セキュリティ

* **最小権限** — エージェントがユースケースに必要な権限のみを付与します。まず読み取り専用から始め、後から拡張してください。
* **デフォルトで読み取り専用** — エージェントにこの接続で変更を行わせる場合を除き、読み取り専用の認証情報を使用してください。
* **認証情報のローテーション** — 通常のスケジュールに従ってキーとトークンをローテーションしてください。接続を更新すると、CloudThinker が新しい値を自動的に取得します。
* **オフボーディング時に失効** — 接続を削除するか、チームメンバーが退職する際には、プロバイダー側で認証情報を無効化してください。

- **ユーザートークン** — General Access REST API Key ではなく、専用の PagerDuty ユーザーにスコープされた User API Token を使用してください。
- **チームのスコープ** — 専用ユーザーのチームメンバーシップを、CloudThinker が監視すべきサービスのみに制限してください。

***

## 関連

<CardGroup cols={2}>
  <Card title="ServiceNow 接続" icon="https://mintcdn.com/cloudthinker/aLd-ttc-SCW-aFky/images/icons/servicenow.svg?fit=max&auto=format&n=aLd-ttc-SCW-aFky&q=85&s=3fee0d3d5346b20beb018bcf854e968e" href="/ja/guide/connections/servicenow" width="24" height="24" data-path="images/icons/servicenow.svg">
    ITSM インシデント管理
  </Card>

  <Card title="Datadog 接続" icon="https://mintcdn.com/cloudthinker/aLd-ttc-SCW-aFky/images/icons/datadog.svg?fit=max&auto=format&n=aLd-ttc-SCW-aFky&q=85&s=e8382167f2a1eb1e00971b5f4d703d48" href="/ja/guide/connections/datadog" width="24" height="24" data-path="images/icons/datadog.svg">
    オブザーバビリティと監視
  </Card>
</CardGroup>