DORA Metrics のための PagerDuty の構成

DORA Metrics は公開ベータ版です。

概要

PagerDuty は、IT チームにインシデントの即時可視性を提供し、運用上の安定性と回復力を維持するための積極的かつ効果的な対応を可能にするインシデント管理プラットフォームです。

PagerDuty のインシデントは、DORA Metrics の障害データソースとして構成できます。

PagerDuty アカウントを DORA Metrics に統合するには、PagerDuty の Integrations > Developer Tools に移動し、Generic Webhook (v3) をクリックします。

+ New Webhook をクリックし、以下の詳細を入力します。

変数	説明
Webhook URL	`https://webhook-intake./api/v2/webhook/` を追加します。
Scope Type	アカウント内のすべての PagerDuty サービスにインシデントを送信するには、Account を選択します。または、異なるスコープタイプを選択することで、特定のサービスやチームにインシデントを送信することもできます。
Description	説明を追加することで、Webhook を区別しやすくなります。`Datadog DORA Metrics integration` のような内容を追加します。
Event Subscription	以下のイベントを選択します。 -`incident.acknowledged` -`incident.annotated` -`incident.custom_field_values.updated` -`incident.delegated` -`incident.escalated` -`incident.priority_updated` -`incident.reassigned` -`incident.reopened` -`incident.resolved` -`incident.triggered` -`incident.unacknowledged`
Custom Headers	Add custom header をクリックし、名前に `DD-API-KEY` と入力し、値に Datadog API キーを入力します。オプションとして、Webhook から送信されたすべての PagerDuty インシデントに環境を追加するには、`dd_env` という名前の追加のカスタムヘッダーを作成し、希望する環境を値として指定します。

DORA Metrics 製品におけるインシデントの重大度は、PagerDuty のインシデント優先度に基づきます。

注: Webhook の作成時に新しいシークレットが作成され、すべての Webhook ペイロードの署名に使用されますが、インテグレーションの動作には API キーを使用して認証が行われるため、そのシークレットは必要ありません。

特定の PagerDuty サービスに対してインシデントイベントが受信されると、Datadog はサービスカタログから関連する Datadog サービスとチームを取得しようと試みます。

一致するアルゴリズムは、以下のシナリオで機能します。

インシデントサービスの URL が、サービスカタログで 1 つ以上のサービスに対して構成された PagerDuty サービス URL と一致する場合:
- インシデントサービス URL が単一の Datadog サービスと一致する場合、インシデントメトリクスとイベントは、サービスカタログから取得した Datadog サービス名とチームで発行されます。
- インシデントサービス URL が複数の Datadog サービスと一致する場合、インシデントメトリクスとイベントは Datadog チーム名で発行されます。

Datadog サービス用の PagerDuty サービス URL の設定に関する詳細は、サービスカタログとのインテグレーションを利用するを参照してください。

インシデントの PagerDuty サービス名がサービスカタログ内の Datadog サービス名と一致する場合、インシデントメトリクスとイベントは、サービスカタログから取得した Datadog サービス名とチームで発行されます。
インシデントの PagerDuty チーム名がサービスカタログ内の Datadog チーム名と一致する場合、インシデントメトリクスとイベントは対応する Datadog チーム名で発行されます。
インシデントの PagerDuty サービス名がサービスカタログ内の Datadog チーム名と一致する場合、インシデントメトリクスとイベントは Datadog チーム名で発行されます。