PagerDuty利用ガイド - Responder編

この利用ガイドではオンコール担当者(Responder)向けに、具体的なPagerDutyの利用方法を説明します。
インシデント対応前にどのような準備が必要になるのか、インシデント対応中と対応後にどのようなアクションが実行できるのか、網羅したつもりです。目次を一通り見ていただくと、PagerDutyで何ができるのか全体像を理解いただけるかと思います。

# PagerDutyとは
2009年に米国で創業した「インシデント対応ソリューション」という分野を創った会社です。システム障害などの「インシデント」が発生した際に、AIや自動化を駆使して速やかな復旧と運用担当者の負担軽減を実現します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2777160/a7909ce5-3c50-5198-2511-39636dd6f5ea.png)
様々な監視ツールやコミュニケーションツール、チケット管理ツール等が混在していたとしても、PagerDutyと連携させることでインシデントがシステム全体のどこに影響しているのか、リアルタイムで共有することができます。
また、対応履歴やMTTA/MTTRなどの運用指標が可視化されるため、継続的に運用プロセスを見直して改善するサイクルを回せるようになります。

# インシデント対応前
## 自社のインシデント対応プロセスを確認する
重大インシデントの定義・その際の手順、インシデント対応中の体制・役割分担など、自社で決められたプロセスがあれば事前に目を通しておきます。

これからインシデント対応プロセスを整備する場合は、以下のドキュメントを参考にしてください:
- [PagerDuty Ops Guide - Incident Response](https://response.pagerduty.co.jp/)
## PagerDutyユーザー登録
管理者がPagerDutyでユーザー登録を行うと、ユーザーにPagerDutyへのログインを案内するメールが届きます。
![pd_mail_invidation.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2777160/639fc5a6-522a-4459-ae85-4b751c56eb73.png)

案内メール内の「Join Now」もしくはURLをクリックすると、ブラウザが開きパスワードの設定を求められます。パスワード入力後、電話番号やタイムゾーンなどの設定を促されるので、必要に応じて設定してください。
設定した内容は、後から変更可能です。

## 通知があれば、確実に気付けるよう準備する
PagerDutyに自分の連絡先(電話/SMS/Email/アプリ/Chat)を登録し、インシデントの緊急度(High-UrgencyまたはLow-Urgency)に応じて、どの連絡手段で通知を行うか設定します。
- [ユーザー毎の通知先とNotification Rulesの設定](https://qiita.com/ymotomu/items/b67758adf6c55a948386#%E3%83%A6%E3%83%BC%E3%82%B6%E3%83%BC%E6%AF%8E%E3%81%AE%E9%80%9A%E7%9F%A5%E5%85%88%E3%81%A8notification-rules%E3%81%AE%E8%A8%AD%E5%AE%9A)

緊急のインシデントが発生した際に、すぐ気づけるようにしておくことが重要です。
具体的にはNotification Rulesの"When a high-urgency incident is assigned to me..."の箇所で、複数の連絡手段で1分毎に繰り返し通知が来るように設定します。

![NotificationRule_Sample.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2777160/b2ddcc79-6dd0-e5ab-0725-71ea23abccd4.jpeg)

PagerDutyアプリは、スマートフォンのサイレントモード(Do Not Disturb)を無視するよう設定することも可能です。確実に通知音を鳴らしたい場合には、アプリで設定を有効にしてください。
- [モバイルアプリのダウンロード](https://support.pagerduty.com/main/lang-ja/docs/mobile-app)
- [モバイルアプリの設定](https://support.pagerduty.com/main/lang-ja/docs/mobile-app-settings)

モバイルアプリをインストールすると、PagerDuty電話通知の[発信元番号](https://support.pagerduty.com/main/lang-ja/docs/notification-phone-numbers)が自動的にアドレス帳に登録・更新されます。PagerDutyから着信を受けた際、電話に出なくてもPagerDutyからの着信であることが分かるようになります。
なお、モバイルアプリは連絡帳へのアクセス権を要求しますが、これはPagerDutyの発信元番号をアドレス帳に追加する用途にのみ利用します。連絡先リスト内の番号に電話をかけたり、マーケティング等に利用することはありません。

## オンコールスケジュールを確認する
[My On-Call Shifts](https://support.pagerduty.com/main/lang-ja/docs/my-on-call-shifts) を利用すると、自分のオンコールスケジュールを確認できます。
Webアプリでは画面右上のアイコンの、プルダウンメニューから開くことができます。 
![MyOnCallShifts.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2777160/9369815e-e1d9-6125-aa6c-a163b0d2b246.jpeg)

もし変更が必要であれば、チームのメンバーと相談の上、スケジュールを変更します。

参考: [Overrideで一時的なスケジュール変更を行う](https://qiita.com/ymotomu/items/66c7157c2330d23d576f#override%E3%81%A7%E4%B8%80%E6%99%82%E7%9A%84%E3%81%AA%E3%82%B9%E3%82%B1%E3%82%B8%E3%83%A5%E3%83%BC%E3%83%AB%E5%A4%89%E6%9B%B4%E3%82%92%E8%A1%8C%E3%81%86)

## マニュアルでインシデントを起票する方法を確認する
最初にインシデントに気付くのが、監視ツールではなく、ユーザーや社員の場合もあります。何かが起こった場合に備えて、手動でインシデントを起票する方法を覚えておくと、解決までの時間を短縮するのに役立ちます。
PagerDutyでは、Webアプリやモバイルアプリの他、EmailやSlack/MS Teamsからもインシデントをトリガーすることができます。

![Create_Incident_Loop.gif](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2777160/c4020b34-658a-40c5-896d-037b4f55aadc.gif)
参考: [インシデントを起票する](https://support.pagerduty.com/main/lang-ja/docs/incidents#trigger-an-incident)

# インシデント対応中
## インシデント対応に着手する - Acknowledge
PagerDutyから通知があり、自分が対応できる状況にあれば、まず行うことはAck(Acknowledge/確認応答)です。
Ackをしないと、インシデント対応に未着手とみなされ、繰り返し通知を受け取ることになります。一定時間を過ぎてもAckされない場合、バックアップの担当者に通知されます(自動エスカレーション)。

![Ack_Incident.gif](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2777160/9f1c6f2c-3402-d250-4226-304dbab3ab38.gif)
参考: [インシデントをAckする](https://support.pagerduty.com/main/lang-ja/docs/incidents#acknowledge-an-incident)

## バックアップのオンコール担当者に対応を委任する - Escalate
PagerDutyから通知があった際、自分がすぐ対応できない状況であれば、Escalateを行います。Escalateの操作をすることにより、[Escalation Policy](https://qiita.com/ymotomu/items/728461b1a63cf56594a3)に従って、次のオンコール担当者に通知が行われます。

![Escalate_Incident.gif](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2777160/f4e8002d-2f88-becc-0492-f0741b9c4917.gif)
参考: [インシデントをEscalateする](https://support.pagerduty.com/main/lang-ja/docs/reassign-incidents#escalate-an-incident)

## 応援を要請する - Add Responders [^1]
他のメンバーや専門家と一緒にインシデント対応を行う場合は、Add Responders機能で応援を要請することができます。
Add Respondersボタンをクリックし、UserまたはEscalation Policyを選択して、招集するメンバーを指定します。

![Add_Responders_l.gif](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2777160/0347f9c9-6af5-b1d3-b9c2-cfca9462dd6e.gif)
参考: [インシデントにResponderを追加する](https://support.pagerduty.com/main/lang-ja/docs/add-responders#add-responders-to-an-incident)

## 他チームに対応を委任する - Reassign
他のメンバーやチームに対応を任せる場合は、Reassignが利用できます。
Add Respondersは引き続き自分もResponderとして対応を継続しますが、Reassignは自分がResponderから削除され、Reassign先のチームが対応を引き継ぎます。
Reassignを行うと、インシデントの状態がTriggeredに戻ります。

![Reassign.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2777160/4fe34c31-3d3e-ad51-b017-bc649141a318.jpeg)
参考: [インシデントの再割り当て](https://support.pagerduty.com/main/lang-ja/docs/reassign-incidents)

## 対応を一時保留する - Snooze
すぐに対応する必要がなく、後で対応を行う場合は、Snoozeを利用できます。
Snoozeを行う場合は、時間を指定します。指定した時間が経過した後は再度通知が行われるため、インシデントが対応されないまま放置されることを防げます。
Snooze後の通知は、現在のResponderに加えて、その時点のオンコール担当者にも送られます。

![Snooze_Incident.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2777160/99954cf7-b55b-7dc6-bc41-e193273cf11b.jpeg)
参考: [インシデントのSnooze](https://support.pagerduty.com/main/lang-ja/docs/edit-incidents#snooze-an-incident)

## アラートの内容を確認する
インシデントに紐づいているアラートの情報を確認し、どんな事象が発生しているのか調査します。

![Alerts_loop.gif](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2777160/ddb83585-62de-75df-3642-c74ebb4d661e.gif)
参考: 
- [Webアプリでアラートを表示する](https://support.pagerduty.com/main/lang-ja/docs/alerts#view-alerts-in-the-web-app)
- [FAQ: EventとAlertとIncidentの違いについて教えてください](https://qiita.com/ymotomu/items/a6665e9ad75bc2a5c600#event%E3%81%A8alert%E3%81%A8incident%E3%81%AE%E9%81%95%E3%81%84%E3%81%AB%E3%81%A4%E3%81%84%E3%81%A6%E6%95%99%E3%81%88%E3%81%A6%E3%81%8F%E3%81%A0%E3%81%95%E3%81%84)

## インシデントを統合/分割する
異なるアラート(監視項目)であっても、同じ原因により発生したのであれば、1つのインシデントにまとめて管理したい場合があります。その際は、別々のインシデントを1つに統合することができます。

![Merge_Incidents.gif](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2777160/db0c816a-b234-ee01-4ffe-24306ee29825.gif)
参考: [インシデントを統合(マージ)する](https://support.pagerduty.com/main/lang-ja/docs/edit-incidents#merge-incidents)

逆に、同じインシデント配下にあるアラートを他のインシデントに移動させることも可能です。

![Move_to_a_new_incident.gif](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2777160/fd0bb51e-32c9-9c82-c698-eea002e98118.gif)
参考: [アラートを別のインシデントに移動する](https://support.pagerduty.com/main/lang-ja/docs/alerts#move-alerts-to-another-incident)

Intelligent Alert Grouping[^3]を利用している場合は、上記の操作によってAlert Groupingのルールが更新されます。

参考: [AIにフィードバックを行い、Grouping精度を高める](https://qiita.com/ymotomu/items/a6665e9ad75bc2a5c600#ai%E3%81%AB%E3%83%95%E3%82%A3%E3%83%BC%E3%83%89%E3%83%90%E3%83%83%E3%82%AF%E3%82%92%E8%A1%8C%E3%81%84grouping%E7%B2%BE%E5%BA%A6%E3%82%92%E9%AB%98%E3%82%81%E3%82%8B)

## 解決のヒントを得る
### 対応に関する指示や手順を確認する - Incident Notes
インシデントのNotes欄には、対応に関する注意事項や指示、手順書へのリンクなどが記載されている場合があります。
インシデント詳細画面を開き、Notesに指示等の記載があるか確認してください。
![Incident_Notes.gif](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2777160/abf5f2c6-496d-63d2-bc6d-c5e53c2bb209.gif)

### AIアシスタントを活用する - PagerDuty Advance [^1]
[PagerDuty Advance](https://www.pagerduty.co.jp/generative-ai/)を利用すれば、PagerDutyに連携された様々なデータから、インシデント対応に必要な情報を速やかに取得することができます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2777160/d26be17c-bd2c-826a-28c8-5744d31d93cb.png)

PagerDuty Advanceへの問いかけの例
- 「何があったの？」> インシデントの概要、影響を受けている関連サービス、過去の類似インシデントでの復旧手順[^3]等
- 「最近の変更は？」> 最近のコード・構成変更の情報(Recent Changes[^3])
- 「誰がオンコール中？」> 現在のオンコール担当者名

参考: [PagerDuty Advance](https://support.pagerduty.com/main/lang-ja/docs/pagerduty-advance)
### インシデントの発生頻度を知る - Outlier Incident [^3]
類似するインシデントの発生頻度を3つのラベルに分類し、インシデント詳細画面のタイトルの下に表示します:
- **Frequent**: 過去30日間にサービス上で発生したインシデントのうち、20%以上を占めるインシデント
- **Rare**: 過去30日間にサービス上で発生したインシデントのうち、5％以下のインシデント
- **Anomaly**: 過去30日間にサービス上で発生したことのないインシデント

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2777160/ba6392c3-dff8-488b-3d60-e912c2d2602e.png)

参考: [Outlier Incident](https://support.pagerduty.com/main/lang-ja/docs/outlier-incident)
### 過去の類似インシデントから対応のヒントを得る - Past Incidents [^3]
現在調査中のインシデントと類似した過去のインシデント5件と、過去6ヶ月の類似インシデント発生頻度が表示されます。
過去のインシデントのタイトルをクリックすると、その際の対応履歴を確認できます。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2777160/d11a63df-c160-10af-81b7-73f9b020b40a.png)
参考: [Past Incidents](https://support.pagerduty.com/main/lang-ja/docs/past-incidents)
### 依存関係のある他サービスの状態を把握する - Service Graph
他サービスと依存関係がある場合、他サービス側の問題がインシデントの原因になっていることがあります。
関連するサービスの状態や発生している問題を確認することで、必要に応じて他チームとの連携を行い、原因特定を速やかに行うことができます。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2777160/5b968075-5425-3047-c9ab-73e3d7cd61bf.png)

Service Graphを開くには、上部メニューの Services > Service Graph をクリックするか、インシデント詳細画面でTechnical Service Dependencies欄内のView Service Graphボタンをクリックしてください。
![ViewServiceGraph.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2777160/af5c3e51-f2ea-1f53-6759-9705b3be8665.jpeg)

参考: [Service Graph](https://support.pagerduty.com/main/lang-ja/docs/service-graph)
### 関連がありそうな他のインシデントを知る - Related Incidents [^3]
現在進行中の他インシデントのうち、調査中のインシデントに関連がある可能性のあるものを確認できます。
前述のService Graphでも表示される、依存関係のあるサービスで発生しているインシデントに加えて、発生時間が近く・内容が類似したインシデントもリストされます。
![Related_Incidents.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2777160/a66ca79a-3fae-9495-4236-29b7110ea646.jpeg)

参考: [Related Incidents](https://support.pagerduty.com/main/lang-ja/docs/related-incidents)
### どのインシデントから着手すべきか見極める - Probable Origin [^3]
過去6ヶ月のインシデントが連鎖的に発生するパターンを分析し、現在調査中のインシデントの起点となる可能性が高いインシデントやサービスを提案する機能です。
複数のインシデントが同時発生している場合に、提案されたインシデント・サービスから調査を行うことで、速やかに原因に辿り着く可能性が高まります。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2777160/0306dd14-56ce-be32-1e9d-aad3f0c6beed.png)

参考: [Probable Origin](https://support.pagerduty.com/main/lang-ja/docs/probable-origin)
### 最近のコード・構成変更の情報を調べる - Recent Changes [^3]
コードやインフラ構成の変更など、Production環境に対して行った変更がインシデントの原因になる場合があります。(PagerDuty社内の統計では、約50%のインシデントが "変更" に起因しています。)

GithubやAnsible,ServiceNowなどの構成管理ツールを利用している場合、それらのツールをPagerDutyと連携させておくと、最近の構成変更の情報をインシデント詳細画面に表示することができます。
![Recent_Changes.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2777160/c129f0a4-bbfd-d017-617e-b0b31415ea06.jpeg)
インシデント詳細画面には、関連が高いと推測される3つの変更が表示されます。その他の変更についても確認したい場合は、View Allをクリックしてください。

参考: [Change Events](https://support.pagerduty.com/main/lang-ja/docs/change-events)
## 関係者に状況を共有する - Status Updates/Internal Status Page [^1]
インシデントの状況と影響範囲について、関係者に共有することは重要です。適切に状況が共有されると、インシデント対応チームは状況問い合わせへの対応ではなく、解決のための活動に集中することができます。
PagerDutyでは、20〜30分毎にStatus Updateを行うことを推奨しています。

![Status_Updates.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2777160/8ea7870f-9b69-b372-2634-7090187f73d0.jpeg)

**影響範囲を修正する**
Impacted Business Services欄には、依存関係のあるBusiness Serviceが関連付けられています。影響を受けているBusiness Serviceに過不足があれば、追加・削除を行います。

**Subscriberを追加する**
Status Updateを受け取る関係者を追加します。Managed Subscribersボタンをクリックすると、UserもしくはTeamを選択してSubscriberに追加できます。

**Status Updateを作成・送信する**
+New Updateボタンをクリックすると、Status Updateを作成・送信できます。
[Status Updateテンプレート](https://support.pagerduty.com/main/lang-ja/docs/status-update-templates)で事前に雛形を用意しておくと、スムーズに作成・送信が可能です。
![Send_Status_Update.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2777160/1449dc31-a44d-503d-946f-4a180fa388aa.jpeg)

Internal Status Page(上部メニュー Services > Internal Status Page)では、各Business Serviceの状況と、影響を与えているインシデント・最新のStatus Updateを確認することができます。
![InternalStatusPage.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2777160/866cf0b6-6c43-8757-88ca-710377ee5552.jpeg)

参考: [Stakeholderとのコミュニケーション](https://support.pagerduty.com/main/lang-ja/docs/communicate-with-stakeholders)
## 対応履歴を記録に残す - Add Note
インシデント対応の記録を残しておくことは重要です。振り返り(ポストモーテム)の中で運用プロセスの改善に利用したり、類似インシデントが発生した際の迅速な解決に役に立ちます。
[Ops Guide: Incident Response](https://ueokande.github.io/incident-response-docs-ja/training/scribe/)では、インシデント対応の際にScribe(記録係)を任命し、対応履歴を残すことを推奨しています。
Notesは、Webアプリやモバイルアプリの他、SlackやMS Teamsからも追記することができます。また、JIRAやServiceNowと連携していれば、Notesの内容は双方向で同期されます。
![Slack_Add_Note.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2777160/aa35c1eb-f2b5-51a4-6c4b-b0ef00b37051.jpeg)

なお、PagerDutyで行った操作の多くは、Timelineに自動記録されます。
記録係は、インシデントコマンダーが指示した内容や、決断、新たな発見、ToDoなど、重要なアクションを記録するようにしてください。
![Incident_Timeline2.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2777160/741a057a-22da-eb1e-971b-e0fabfce7233.jpeg)

参考: [インシデントにノートを追加する](https://support.pagerduty.com/main/lang-ja/docs/edit-incidents#add-a-note-to-an-incident)
## 自動診断・自動復旧を行う - Run Automation [^1] [^4]
ログの確認やサーバーの再起動など、インシデント対応に必要な作業をAutomation Actionに登録しておけば、担当者が選択して実行させることができます。
Webアプリから実行する場合は、インシデント詳細画面からRun Actionボタンをクリックし、実行するActionを選択します。
![Run_Action.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2777160/99a03e4a-647e-39f4-d582-1776a9e78ce4.jpeg)
SlackやMS Teamsから操作する場合は、Run an Actionボタンをクリックしてください。

参考: [PagerDuty Automation Actions](https://support.pagerduty.com/main/lang-ja/docs/automation-actions)

## ワークフローを呼び出す - Incident Workflow [^1]
Incident Workflowを設定しておくと、インシデントのステータスに応じてワークフローを自動実行したり、担当者が1クリックで実行することができます。
例えば「インシデントのPriorityがP1になった際、War Room(緊急対策本部)を設置」等に利用できます。

![IW_sample.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2777160/cac02dd1-c066-b746-7774-4b60c8699f6b.jpeg)

追加の担当者の招集、Status Updateの送信や、Zoom会議の作成、Slackのインシデント専用チャンネルの作成、AWS Lambdaの実行[^2]、30分毎にSlack Messageでリマインドを送る[^2]等、様々な操作を一括で行うことができます。
Webアプリから実行する場合は、インシデント詳細画面で Run Workflowボタンをクリックします。
![Run_Workflow.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2777160/c29da54d-157a-d169-88c2-65a47528adbb.jpeg)

参考: [Incident Workflows](https://support.pagerduty.com/main/lang-ja/docs/incident-workflows)

## インシデント対応に関わるメンバーの役割と責任を明確にする - Incident Roles [^2]
インシデント・コマンダー、記録係などの[インシデント・ロール](https://support.pagerduty.com/main/lang-ja/docs/incident-roles)を事前に定義しておくと、メンバーにロールを割り当てることができます。メンバーの役割を明確にしておくことで、インシデント対応を効率的に進めることができます。

インシデント・ロールの割り当ては、Webアプリの他、Slackからも行うことが可能です。
![Assign_Roles.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2777160/c0df1d0c-cea2-c274-e750-fb4af873bc0a.jpeg)

参考:
- [Incident Roles](https://support.pagerduty.com/main/lang-ja/docs/incident-roles)
- [Ops Guide: Incident Response - IR Roles](https://ueokande.github.io/incident-response-docs-ja/before/different_roles/)

## メンバーにタスクを割り当てる - Incident Tasks [^2]
インシデント・タスクをメンバーに割り当て、進捗を追跡することで、インシデント管理を強化することができます。
インシデント・タスクの作成・割り当ては、Slackまたは[Incident Workflows](https://support.pagerduty.com/main/lang-ja/docs/incident-workflows)で行います。

参考: [Incident Tasks](https://support.pagerduty.com/main/lang-ja/docs/incident-tasks)

# インシデント対応後
## インシデントのステータスをResolvedに変更する
インシデントが解決したら、インシデントのステータスをResolvedに変更します。
Resolveボタンをクリックするとポップアップ画面が開き、Resolution Noteを記入することができます。"Post resolution note as a status update"にチェックをいれると、記入した内容をStatus Updateとして関係者に共有します。

![Resolve_Incident.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2777160/e79f2689-c167-c93e-4fbd-d60f203489f4.jpeg)

## ポストモーテムレポートを作成する [^1]
インシデント対応から学びを得て、運用プロセスを改善するには、ポストモーテムを行います。
PagerDutyでは、SlackやIncident Notesに残された情報から、簡単にポストモーテムレポートのドラフトを作成する機能があります。

インシデントのステータスをResolvedにした後のポップアップ画面、または上部メニューの Incidents > Postmortems > "+ New Report" から、レポート作成画面を開くことができます。
![Generate_Postmortem_Draft.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2777160/fa074745-de31-bfe2-d645-d8e115a9f957.jpeg)

PagerDuty Copilotが有効になっていれば、生成AIがレポートの草稿を自動生成することもできます。(現在は英語による出力のみ)

ポストモーテムレポートに含める項目は自由に変更できる他、Incident TimelineやNotes、Slackに残された履歴をインポートして、簡単に対応履歴を作成することができます。
![Postmortem_Timeline.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2777160/222bf223-27a5-c167-99de-b0dde1bde01f.jpeg)

参考: 
- [ポストモーテムとJeliポストインシデントレビュー](https://support.pagerduty.com/main/lang-ja/docs/postmortems)
- [Ops Guide: Postmortem](https://postmortems.pagerduty.com/)
## 対応プロセスを改善する
インシデント対応で得た学びを元に、必要に応じて運用プロセスを修正します。
再発防止策に加えて、手順書の修正・Escalation Policy/Notification Rulesの変更・エスカレーションをためらわないようチームに周知する、などの対応が必要かもしれません。

今後も繰り返し発生する可能性のある作業については、自動化することも有効です。
[Event Orchestration](https://qiita.com/ymotomu/items/0d3ac9a83b4a927aee1c)[^3]や[Runbook Automation](https://www.pagerduty.com/platform/automation/runbook/)[^4]等を利用して自動化ができないか、検討してください。

# FAQ
### Q.PagerDutyアプリをスマートフォンにインストールしたのですが、Notification Rulesでアプリが選択肢に出てきません。
PagerDutyアプリを開いて、ログインしてください。
また、アプリの通知が有効になっているか確認してください。PagerDutyアプリの通知がスマートフォンで無効になっていると、Contact MethodsやNotification Rulesにモバイルアプリが表示されません。

参考: [PagerDutyモバイルアプリ](https://support.pagerduty.com/main/lang-ja/docs/mobile-app)
### Q.インシデントのステータスと各種操作の関係を教えてください。
PagerDutyでは、以下3つのステータスでインシデントを管理します。
- **Triggered**: インシデントが起票されたときのステータスで、まだ担当者が確定していない状態です。通知を受けたオンコール担当者がAck(確認応答)をすると、次のAcknowledgedに遷移します。Triggered状態のHigh-Urgencyのインシデントは、Escalation Policyに従って自動エスカレーションされます。
- **Acknowledged**: 担当者が確定し、現在対応中のインシデントです。インシデントが解決すると、Resolvedに遷移します。
- **Resolved**: 問題が修正され、インシデントが解決した状態です。ResolvedになったインシデントをTriggeredやAcknowledgedに戻すことはできません。

ステータスの遷移にはユーザーによる操作の他、アラートのステータスが関係します。
インシデントに紐づくアラートが全てResolvedになれば、インシデントのステータスもResolvedになります。逆に、インシデントのステータスがResolvedになると、そのインシデントに紐づくアラートのステータスもResolvedに変更されます。
![State Transitions of Alerts and Incidents (1).png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2777160/1540ee5f-0d2b-8d5a-cdb8-5348edd57c1f.png)

### Q.誤ってIncidentをResolveしてしまいました。StatusをTriggered等に戻せますか?
一度Resolvedになったインシデントを、TriggeredやAcknowledgedに戻すことはできません。新しくインシデントを起票してください。
### Q.オンコールの度に、オンコールを知らせるメールが送られてきます。止める方法はありますか?
Notification Rules内の Before I go on-call or off-call... で設定が可能です。
Notification Rulesは、Webアプリ右上のユーザーアイコン > My Profile から開くことができます。

![Before_I_go_oncall2.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2777160/31de39ce-1e6d-963f-d9c4-0866d1d4e81f.jpeg)
参考: [ユーザー毎の通知先とNotification Rulesの設定](https://qiita.com/ymotomu/items/b67758adf6c55a948386#%E3%83%A6%E3%83%BC%E3%82%B6%E3%83%BC%E6%AF%8E%E3%81%AE%E9%80%9A%E7%9F%A5%E5%85%88%E3%81%A8notification-rules%E3%81%AE%E8%A8%AD%E5%AE%9A)

### Q.Escalation PolicyのTimeoutを過ぎても、自動エスカレーションされません。
UrgencyがLowのインシデントは自動エスカレーションされません。Escalation Policy内の最初レイヤーのメンバーにのみ通知されます。

### Q.Escalation PolicyのTimeoutが5分、Notification Ruleは10分までの設定がある場合、どのような動きになりますか?
Escalation Timeoutが発生すると、通知先がEscalation Policyの次のレイヤーに移ります。つまり、5分以降のNotification Rulesの通知は行われません。

### Q.アラートを送ったはずですが、PagerDuty上で見つかりません。
SuppressやSuspend(通知の一時停止/Pause)されたアラートは、インシデント一覧画面には出てきません。アラート一覧画面(上部メニュー: Incidents > Alerts)に表示されないか、確認ください。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2777160/db840754-6189-7586-f4bc-a6b1950215a7.png)

監視ツールから複数回Eventを送信しても、同一のアラート(監視項目)の場合は、1つのアラートにまとめられます。Email連携であればメールの件名、Event API連携であればdedup_keyを参照し、値が同じであれば同一のアラートと判断します。

同一のアラートに属するEventは、アラート詳細画面のAlert Logで確認できます。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2777160/b125d910-e5bc-a23a-6acc-1ea5cd2c1c9c.png)

参考:
- [EventとAlertとIncidentの違いについて教えてください](https://qiita.com/ymotomu/items/a6665e9ad75bc2a5c600#event%E3%81%A8alert%E3%81%A8incident%E3%81%AE%E9%81%95%E3%81%84%E3%81%AB%E3%81%A4%E3%81%84%E3%81%A6%E6%95%99%E3%81%88%E3%81%A6%E3%81%8F%E3%81%A0%E3%81%95%E3%81%84)
- [Eventを送りましたが、インシデントが起票されません。アラート一覧にも見つかりません。](https://qiita.com/ymotomu/items/a6665e9ad75bc2a5c600#event%E3%82%92%E9%80%81%E3%82%8A%E3%81%BE%E3%81%97%E3%81%9F%E3%81%8C%E3%82%A4%E3%83%B3%E3%82%B7%E3%83%87%E3%83%B3%E3%83%88%E3%81%8C%E8%B5%B7%E7%A5%A8%E3%81%95%E3%82%8C%E3%81%BE%E3%81%9B%E3%82%93%E3%82%A2%E3%83%A9%E3%83%BC%E3%83%88%E4%B8%80%E8%A6%A7%E3%81%AB%E3%82%82%E8%A6%8B%E3%81%A4%E3%81%8B%E3%82%8A%E3%81%BE%E3%81%9B%E3%82%93)

[^1]: Businessプラン、またはEnterprise Incident Managementプランで利用できます。
[^2]: [Enterprise Incident Management](https://www.pagerduty.co.jp/recommended-plan/)プランで利用できます。
[^3]: 利用には[AIOps Add-on](https://support.pagerduty.com/main/lang-ja/docs/aiops)が必要です。
[^4]: 利用には[Runbook Automation Add-on](https://www.pagerduty.co.jp/platform/automation/)が必要です。
[^5]: [Early Access](https://www.pagerduty.com/early-access/)(ベータ)提供中。
[^6]: 利用には[Customer Service Ops](https://www.pagerduty.co.jp/platform/business-ops/)ライセンスが必要です。