PagerDuty インテグレーションを設定する

Statuspage は、PagerDuty インシデントがトリガー、承認、解決、アップデートなどされたときに送信される Webhook を解析することで、PagerDuty と統合されます。

この統合の仕組み

この統合によって、次を行えます。

  • PagerDuty インシデントがトリガーされたときに、1 つ以上のコンポーネントを低下させる

  • PagerDuty インシデントがトリガーされたときに、インシデント テンプレートから Statuspage インシデントを作成する

  • Statuspage 内でインシデントを作成する前に、PagerDuty からの承認シグナルを待つ

  • PagerDuty インシデントがアップデート/解決されたときに、Statuspage インシデントをアップデート/解決する (それぞれ異なるインシデント テンプレートがサポートされています)。

  • 複数の PagerDuty インシデントを 1 つの Statuspage インシデントにまとめる

  • アクティブな Statuspage のスケジュールされた保守期間中に PagerDuty インシデントを無視する

PagerDuty インテグレーションを設定する

1. Statuspage 管理インターフェイスの左側のナビゲーションで [アプリ] を選択します。

2. 利用可能なアプリのリストで PagerDuty を見つけます。

3. [追加] を選択します。

4. [Link your PagerDuty account (PagerDuty アカウントをリンクする)] を選択します。

a. PagerDuty サブドメインとフル アクセスの v2 最新 API キーを入力します (読み取り専用では機能しません)。

b. PagerDuty にログインしている間、サブドメインは PagerDuty の URL で確認できます。

5. PagerDuty の [Configurations (設定)] > [API Access (API アクセス)] の順に移動して、PagerDuty API キーを見つけるか作成します。

[PagerDuty API Access Keys (PagerDuty API アクセス キー)] 画面が表示されて API キーがリストされ、新規のキーを作成できます。

6. PagerDuty 情報を入力したら [Link account (アカウントをリンク)] を選択します。PagerDuty サービスのリストが Statuspage にプルされて、PagerDuty 設定画面に表示されます。

7. この統合を機能させるサービスのルールを追加します。コンポーネント ルールとインシデント ルールを設定できます。

a. たとえば、下の図では、PagerDuty API サービスがインシデントをオープンしたときに、2 つの Statuspage コンポーネント (API と管理ポータル) が大規模な停止に設定されることがわかります。

b. また、ここではいくつかのインシデント ルールを設定して、PagerDuty サービスがインシデントをトリガーするときに Statuspage テンプレートを使用してインシデントをオープンできます。

イベントが Pagerduty で発生してコンポーネントが Statuspage で変更されるようにする、Pagerduty インテグレーションのルール

8. [Save rules (ルールを保存)] を選択します。

これで統合は、Pagerduty サービスに関連する Statuspage コンポーネントに設定したコンポーネントとインシデントのルールに従って機能するようになります。

 

公開ステータス ページ

公開ステータス ページでは、控えめなコミュニケーションを取るのに越したことはないでしょう。PagerDuty 関連のインシデントは、実際の課題として承認されて確認された後で一度に 1 つだけオープンにすることをお勧めします。

非公開ステータス ページ

非公開ステータス ページのユーザーは、インシデント ワークフローに自分の PagerDuty ストリームが含まれて、エスカレーション、再割り当て、承認などのアクションに対するアップデートを得ることに、より大きな関心が持っているかもしれません。さまざまなインシデント テンプレートを構成して、インシデント ライフサイクルのさまざまなステージに対応したり、Webhook からのデータをメッセージ アップデート本文に直接埋め込んだりできます。

PagerDuty Webhook 情報の埋め込み

インシデント テンプレートを使用する場合は、Mustache テンプレート構文とインシデント名およびメッセージ本文に PagerDuty Webhook 情報を直接使用することをサポートしています。

以下では、pagerduty 最上位レベルのキーで利用できるデータのレベルを確認できます。

PagerDuty Webhook

たとえば、インシデントに割り当てられたユーザーのメールを挿入するには、インシデント テンプレートで {{pagerduty.incident.assigned_to_user.email}} を使用します。

 

PagerDuty インテグレーションに関する FAQ

統合を使用して自動化できるものは正確には何ですか?

コンポーネント ステータスの変更のみ、インシデントの作成/アップデートのみ、またはコンポーネントとインシデントの変更の両方を自動化できます。統合を使用して公開ステータス ページのコンポーネントのみを自動化するのが一般的ですが、通常、インシデントの自動化はより広範な社内の関係者や会社全体に警告するために使用されます。

PagerDuty サービスの大きなリストがあります。統合にはどのサービスを使用するべきですか?

通常、サービスのサブセットが Statuspage と統合されます。出発点として、高い重大度でマークされたサービスを統合するか、顧客向けのインシデントを示すことをお勧めします。

私のサービスは広範囲に及びます。一例として、API とダッシュボード アラートはすべて PagerDuty 内の 1 つの「Pingdom」サービスに取り込まれています。これを Statuspage にマッピングするにはどうしたらいいですか?

Statuspage では PagerDuty サービスを Statuspage コンポーネントにマッピングできるため、PagerDuty サービスをより細かく設定する必要がある場合があります。例として、「Pingdom」サービスを「Pingdom - API」と「Pingdom - ダッシュボード」に分割できます。これによって Statuspage の自動化をより詳細に制御することが可能になり、PagerDuty 内のレポート作成と分析も向上します。

統合を使用して、組織内のより幅広い従業員に通知したいと思います。価格設定はどのようになりますか?

Statuspage には、非公開の内部ページに固有の価格設定があります。こちらをご覧ください。詳細をご希望の場合は、サポート チームにお問い合わせください

コンポーネントは、PagerDuty/インシデント テンプレートを使用するインシデントとどのように関連付けられますか?

PagerDuty ルールからのコンポーネント変更に基づいては、コンポーネントがインシデントと関連付けられません。コンポーネントは、インシデント テンプレートの [alert users subscribed to (ユーザーがサブスクライブしているアラート)] で行われた選択に基づいてのみ、インシデントに関連付けられます。

さらにヘルプが必要ですか?

アトラシアン コミュニティをご利用ください。