PagerDutyをデータパイプラインソースとして設定する ​

PagerDutyをデータパイプラインソースとして設定し、PagerDuty REST APIからインシデント、オンコール、インシデント分析データを抽出して同期先に同期します。

このガイドを使用して、前提条件の確認、PagerDuty APIキーの生成、PagerDutyのデータパイプラインソースとしての接続、パイプラインの設定、サポートされるオブジェクト、同期モード、スキーマとデータ型の処理、機密データの処理、および制限について理解します。

サポートされている機能 ​

PagerDutyをパイプラインソースとして使用する場合、次の機能がサポートされます。

• クラウド接続: https://api.pagerduty.comを介してHTTPS経由でPagerDutyに接続します。オンプレミスエージェントは不要です。
• オブジェクトレベルの選択: 同期先に同期するPagerDutyオブジェクトを選択します。
• 完全同期、増分同期、追加専用同期: オブジェクトごとに設定される完全同期、増分同期、追加専用同期をサポートします。詳細については、同期モードを参照してください。
• スキーマドリフトの検出と処理: 新しいフィールドを自動同期でスキーマの変更を自動的に検出して適用するか、新しいフィールドをブロックでスキーマを固定します。
• フィールドレベルのデータ保護：データがデスティネーションに到達する前に、機密フィールドをハッシュ化するか、そのままレプリケートします。
• 設定可能な同期頻度: 時間ベースの間隔またはcron式を使用して同期をスケジュールします。

前提条件 ​

PagerDutyをデータパイプラインソースとして接続するには、次が必要です。

• PagerDutyアカウント
• 選択した認証方法の認証情報:
  • APIキー: 読み取り専用のPagerDuty GeneralアクセスAPIキー。設定手順については、PagerDuty APIキーを生成するを参照してください。
• 任意。 Audit Records、Analytics Raw Incidents、Analytics Metrics Incidentsを同期するには、Business以上のPagerDutyプランが必要です。 PagerDutyはBusinessおよびEnterpriseプランでIncident Workflowsを提供し、Professionalプランでは限定的に利用できます。詳細については、制限事項を参照してください。

PagerDuty APIキーを生成する ​

PagerDutyアカウントで読み取り専用のPagerDuty GeneralアクセスAPIキーを生成するには、次の手順を実行します。

権限 ​

PagerDutyでAPIキーを作成するには、Admin、Global Admin、またはAccount Ownerロールが必要です。これらのロールのいずれも持っていない場合は、このキーの作成について、組織のAdminまたはAccount Ownerにお問い合わせください。

サポートされるコネクションタイプ ​

PagerDutyデータパイプラインでは、1つの認証方法がサポートされています。

• APIキー: PagerDutyアカウントから生成された読み取り専用のGeneralアクセスAPIキーを指定します。設定手順については、PagerDuty APIキーを生成するを参照してください。

Personal APIキーは、個々のユーザー権限にスコープが設定され、アカウント全体の読み取りアクセスを保証できないため、サポートされていません。 PagerDutyデータパイプラインでは、OAuth 2.0は現在サポートされていません。

PagerDutyに接続する ​

パイプラインの設定 ​

PagerDutyをデータパイプラインソースとして設定するには、次の手順を実行します。

[minute] [hour] [day of month] [month] [day of week]

0 8 * * *

サポートされるオブジェクト ​

PagerDutyデータパイプラインは、PagerDuty REST API v2リソースからデータを同期します。次の表に、サポートされているオブジェクトをカテゴリー別に示します。各オブジェクトは宛先内の個別のテーブルとして同期されます:

インシデントデータ ​

Incident Status Updatesには、ステークホルダー管理を含むPagerDutyプランで利用可能なsubscribers_status_updatesアカウント機能が必要です。この機能がないアカウントでは、Add new objectsパネルにIncident Status Updatesが表示されません。

サービスとチーム ​

teams PagerDutyアカウント機能がないアカウントでは、Add new objectsパネルにTeamsまたはTeam Membersが表示されません。

ユーザー ​

オンコール管理 ​

On Callsは、変更履歴ではなく、オンコール割り当ての日次スナップショットを保存します。詳細については、追加専用同期および合成列を参照してください。

参照データと設定データ ​

Incident Workflowsには、incident_workflowsアカウント機能が必要です。 PagerDutyはBusinessおよびEnterpriseプランでIncident Workflowsを提供し、Professionalプランでは限定的に利用できます。この機能がないアカウントでは、Add new objectsパネルにIncident Workflowsが表示されません。 Incident Workflowsは、PagerDutyの非推奨のResponse Playsオブジェクトを置き換えるものです。

Business Servicesはアカウント機能によって制限されていません。この機能を含まないプランでBusiness Servicesをパイプラインに追加すると、同期は失敗します。パイプラインからオブジェクトを削除するか、PagerDutyプランをアップグレードしてください。

監査と分析 ​

Analytics Raw IncidentsとAnalytics Metrics Incidentsには、それぞれBusiness以上のプランで利用可能なanalytics_recommendationsまたはmobile_analyticsアカウント機能のいずれかが必要です。いずれの機能もないアカウントでは、Add new objectsパネルにこれらのオブジェクトが表示されません。

Audit Recordsはアカウント機能によって制限されていません。監査アクセスを含まないプランでAudit Recordsをパイプラインに追加すると、同期は失敗します。パイプラインからオブジェクトを削除するか、PagerDutyプランをアップグレードしてください。保持と集計の詳細については、制限を参照してください。

同期モード ​

PagerDutyデータパイプラインは、完全同期、増分同期、追加専用同期をサポートします。同期モードは、オブジェクトをパイプラインに追加するときにオブジェクトごとに設定されます。

フル同期 ​

完全同期では、同期のたびにPagerDutyから利用可能なすべてのレコードを読み取り、同期先テーブルを置き換えます。 Services、Users、Escalation PoliciesなどのPagerDuty参照および設定オブジェクトは、PagerDutyが変更カーソルを公開していないため、完全同期で同期されます。

増分同期 ​

増分同期では、各オブジェクトのcreated_atタイムスタンプをカーソルとして使用し、前回の同期後に作成されたレコードのみを抽出します。インシデントは作成後にステータスが変更される可能性があるため、パイプラインはIncidentsとその子オブジェクトの同期ウィンドウも定期的に広げ、古いレコードを再確認します。デフォルトでは、パイプラインはcreated_atカーソルだけでは検出できないステータス変更を取得するため、7日ごとに過去180日を再確認します。 Audit Recordsはexecution_timeタイムスタンプをカーソルとして使用します。 Analytics Raw Incidentsは、created_atを使用してリクエスト本文をフィルタリングします。

増分同期をサポートするオブジェクトについては、サポートされるオブジェクトの表を参照してください。

追加専用同期 ​

On Callsは、変更フィードではなく、オンコール割り当ての特定時点のスナップショットです。各実行では、以前の実行で書き込まれた行を変更または削除することなく、新しいスナップショットを同期先に追加します。

スキーマとデータ型の処理 ​

PagerDutyからデータを同期する場合、スキーマとデータ型には次の考慮事項が適用されます。

ネストされたオブジェクトと配列 ​

PagerDutyは、Incidents.custom_fields、Escalation Policies.escalation_rules、Schedules.schedule_layersなど、複数のフィールドをネストされたJSONオブジェクトまたは配列として返します。 Workatoは、これらのフィールドを個別の列にフラット化するのではなく、同期先のJSON文字列列として保存します。

インシデントカスタムフィールド ​

BusinessまたはEnterpriseプランのPagerDutyアカウントでは、Incidentsにカスタムフィールドを定義できます。 Workatoは各インシデントのカスタムフィールド値を取得し、custom_fields列に設定します。入力されたカスタムフィールド値がないインシデントは、空のcustom_fields値で同期されます。

タイムスタンプ ​

PagerDutyは、2024-01-15T10:30:00Zまたは2024-01-15T02:30:00-08:00など、Zサフィックスまたは数値オフセットを持つISO 8601文字列としてタイムスタンプを返します。 Workatoは、PagerDutyの元のオフセットと値を保持しながら、これらのフィールドをタイムゾーン対応のタイムスタンプ列として同期します。

合成列 ​

Workatoは、On Callsの同期先テーブルに次の合成列を追加します。

機密データの処理 ​

PagerDutyオブジェクトには、重要な個人識別情報（PII）が含まれる場合があります。次のオブジェクトには、一般的に機密フィールドが含まれています。

パイプライン設定中にフィールドレベルのデータ保護でHashオプションを使用し、PIIが宛先に到達する前に保護します。詳細については、パイプラインを構成手順を参照してください。

制限事項 ​

PagerDutyをデータパイプラインソースとして使用する場合、次の制限が適用されます。

プランで制限されるオブジェクト ​

PagerDutyは、プランによって異なるアカウント機能の背後で、Teams、Team Members、Incident Status Updates、Incident Workflows、Analytics Raw Incidents、Analytics Metrics Incidentsを制限します。アカウントに必要な機能がない場合、これらのオブジェクトはAdd new objectsパネルに表示されません。

Audit RecordsとBusiness Servicesはアカウント機能によって制限されていません。それを含むPagerDutyプランがない状態でいずれかのオブジェクトをパイプラインに追加すると、同期は失敗します。パイプラインからオブジェクトを削除するか、PagerDutyプランをアップグレードしてください。

Audit Recordsの保持 ​

PagerDutyは監査レコードを12か月間保持します。一時停止されたパイプラインの最後の正常な同期が12か月より前の場合、古いレコードはAPIから利用できなくなるため、パイプラインはAudit Recordsの同期を過去12か月から再開します。

Analytics Raw Incidentsの保持 ​

PagerDutyは生のインシデント分析を3年間保持します。 3年より前のレコードは同期できません。

Analytics Metrics Incidentsのディメンション ​

Analytics Metrics Incidentsは、servicesおよびteamsディメンション別にのみデータを集計します。 PagerDutyのAPIは、同等のescalation_policies集計を公開していません。

最小同期頻度 ​

サポートされる最小同期間隔は15分です。これより高い頻度で同期をトリガーすることはできません。