PagerDuty

Status200 のインシデントを PagerDuty に送信します。1 つ目のワークフローは Status200 のインシデントが宣言されると PagerDuty のインシデントをトリガーし、2 つ目のワークフローは Status200 のインシデントが解決されるとそれを解決します。PagerDuty でチームを呼び出し、Status200 でシステムを監視している場合に使います。

仕組み#

どちらのワークフローも、Status200 のインシデントの ID から作った同じ dedup_key を付けて PagerDuty の Events API v2 を呼び出します。このキーによって、PagerDuty は resolve イベントが trigger イベントで開いたインシデントを閉じるものだと判断します。

前提条件#

• Events API v2 インテグレーションを持つ PagerDuty サービス。PagerDuty でサービスを開き、Integrations を開いて Add an integration をクリックし、Events API V2 を選びます。その Integration Key をコピーします。Events API ではこれをルーティングキーと呼びます。
• Status200 では、ワークフローとグローバル変数を作成する権限。Status200 Cloud では、ワークフローに Growth プラン以上が必要です。

ルーティングキーを保存する#

シークレット変数は実行ログで [REDACTED] に置き換えられるため、キーが実行に表示されることはありません。

インシデントごとに PagerDuty のインシデントをトリガーする#

1. ワークフローを作成する#

   ワークフロー に移動し、ワークフローを作成 をクリックしてから ゼロから作成 をクリックします。名前を Incidents to PagerDuty にして ワークフローを作成 をクリックします。

2. トリガーを追加する#

   点線の このワークフローを開始するものを選択 ブロックをクリックし、On Create Incident を選びます。トリガーをクリックします。その Fields to pass on は タイトル から始まるので、フィールドを追加 をクリックして 説明 を選びます。

3. trigger イベントを送信する#

   コンポーネントを追加 をクリックし、API Post (JSON) ブロックを追加して、トリガーの Success の点をそのブロックに接続します。URL を https://events.pagerduty.com/v2/enqueue に、Request Body を次のように設定します:

   JSON

   {
     "routing_key": "{{global.variables.PAGERDUTY_ROUTING_KEY}}",
     "event_action": "trigger",
     "dedup_key": "oneuptime-{{local.components.incident-on-create-1.returnValues.model._id}}",
     "payload": {
       "summary": "{{local.components.incident-on-create-1.returnValues.model.title}}",
       "source": "Status200",
       "severity": "critical",
       "custom_details": {
         "description": "{{local.components.incident-on-create-1.returnValues.model.description}}"
       }
     }
   }

4. テストしてからオンにする#

   ワークフローを実行 をクリックし、インシデント でテスト用インシデントを選んで実行します。API Post (JSON) ステップに "status": "success" を含む 202 の応答が表示され、PagerDuty でインシデントが開きます。その後、ビルダー の上部で 有効 をオンにします。

ブロックは JSON を送信するため、Content-Type ヘッダーは不要です。PagerDuty の severity は critical、error、warning、info のいずれかです。インシデントごとの重大度を送るには、重大度を対応付ける を参照してください。

PagerDuty のインシデントを解決する#

ワークフローのトリガーは 1 つだけなので、解決には、インシデントの状態が変わったときに開始される 2 つ目のワークフローが必要です。

1. On Update Incident トリガーを追加する#

   Resolve PagerDuty incidents という名前のワークフローを作成し、トリガーに On Update Incident を選びます。Fields to watch で フィールドを追加 をクリックして 現在のインシデントの状態 を選び、状態が変わったときだけ実行されるようにします。Fields to pass on で、新しい状態が解決済みの状態かどうかを要求します。フィールドを追加 をクリックし、現在のインシデントの状態 を開いて 解決済みの状態 を選びます。または JSON として編集 をクリックし、JSON を次の内容に置き換えます:

   JSON

   { "_id": true, "currentIncidentState": { "isResolvedState": true } }

2. インシデントが解決されたことを確認する#

   トリガーの後に If / Else ブロックを追加します。Value to check を {{local.components.incident-on-update-1.returnValues.model.currentIncidentState.isResolvedState}}、Comparison を is true に設定します。

3. resolve イベントを送信する#

   Yes 側の後に、同じ URL と次の Request Body を持つ API Post (JSON) ブロックを追加します:

   JSON

   {
     "routing_key": "{{global.variables.PAGERDUTY_ROUTING_KEY}}",
     "event_action": "resolve",
     "dedup_key": "oneuptime-{{local.components.incident-on-update-1.returnValues.model._id}}"
   }

4. オンにする#

   有効 をオンにし、Status200 でテスト用インシデントを解決します。PagerDuty が自分のインシデントを解決します。

状態の名前ではなく isResolvedState を確認すると、状態の名前を変えても動作し続けます。インシデントの状態と重大度 を参照してください。

重大度を対応付ける#

インシデントごとの重大度を送るには、トリガーと API Post (JSON) ブロックの間に Run Custom JavaScript ブロックを追加し、その応答を本文で読み取ります。

1. トリガーの Fields to pass on で フィールドを追加 をクリックし、インシデントの重大度 を開いて 名前 を選びます。

2. ブロックの Arguments を { "severity": "{{local.components.incident-on-create-1.returnValues.model.incidentSeverity.name}}" } に、JavaScript Code を次のように設定します:

   JavaScript

   // Your incident severities, by name, to PagerDuty's.
   const SEVERITY = {
     "Critical Incident": "critical",
     "Major Incident": "error",
     "Minor Incident": "warning",
   };
   
   return { severity: SEVERITY[args.severity] || "info" };

3. リクエスト本文で、"severity" を "{{local.components.javascript-1.returnValues.returnValue.severity}}" に設定します。

上の名前は、新しいプロジェクトが最初に持つ 3 つの重大度です。名前を変えている場合は、自分の名前を使ってください。

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

次のステップ#