Atlassian アカウントを使用するために Statuspage を移行する
チームと一緒に Atlassian アカウントに移行するために知っておく必要があることのすべてについて説明します。
PagerDuty mustache タグ
PagerDuty は、mustache タグを介してインシデント テンプレートで使用できるデータを Statuspage に送信します。これによって、PagerDuty からインシデントに追加情報を「引用」できるようになります。
Statuspage 内では、PagerDuty mustache タグのサブセットを使用できます。以下の表に、Statuspage によって承認されているタグを示します。
PagerDuty V1 Webhook API から V3 Webhook API への移行
PagerDuty が V1 Webhook API から V3 Webhook API に移行したため、2021 年 11 月 11 日以前に PagerDuty Webhook を設定した既存の Statuspage のお客様は、次の表の [PagerDuty V3 承認済みタグ] 列に記載されていない mustache タグを使用している可能性があります。これらのタグは非推奨の PagerDuty V1 Webhook API からデータを生成しており、アクティブにサポートされなくなりました (日付と詳細については次をご参照ください)。現在、非推奨の mustache タグを使用している場合は、すべてのインシデント テンプレートを更新し、2021 年 12 月 10 日までに承認済みタグに移行してください。
この移行を支援するため、次の表の [推奨される同等の V1 タグ] 列に、V3 タグとほぼ同等の V1 タグ リストを含めました。PagerDuty V3 Webhook によって返されるペイロードには、V1 では利用できなかった多数の新しいフィールドも含まれているため、これらのタグをインシデント テンプレートに追加することができます。いずれの V3 タグにも直接 (または少なくとも密接に) マッピングされていないように見える V1 タグがいくつか存在します。次の表に記載されていない V1 タグを使用している場合は、V3 に相当するタグがない可能性があります。各社のドキュメントをご参照のうえ、ニーズに合った適切な代替タグがあるかどうかをご確認ください。
2021 年 11 月 11 日、Statuspage は [管理] にリンクされたすべての新しい PagerDuty インスタンスに対して V3 Webhook の配布を開始します。これらの新しいインスタンスのインシデント テンプレートは V3 タグのみをサポートします。
2021 年 12 月 10 日、Statuspage は既存の PagerDuty V1 Webhook (2021 年 11 月 11 日以前に配布されたもの) のサポートを終了します。廃止された V1 タグを使用するインシデント テンプレートは Webhook データによって入力されなくなります。
PagerDuty の承認タグ
PagerDuty V3 承認済みタグ | 推奨される同等の V1 タグ |
|---|---|
pagerduty.event |
|
pagerduty.event.id |
|
pagerduty.event.event_type |
|
pagerduty.event.resource_type |
|
pagerduty.event.occurred_at | pagerduty.incident.created_on |
pagerduty.event.agent |
|
pagerduty.event.agent.html_url |
|
pagerduty.event.agent.id |
|
pagerduty.event.agent.self |
|
pagerduty.event.agent.summary |
|
pagerduty.event.agent.type |
|
pagerduty.event.client.name |
|
pagerduty.event.data | pagerduty.incident |
pagerduty.event.data.id | pagerduty.incident.id |
pagerduty.event.data.type |
|
pagerduty.event.data.self |
|
pagerduty.event.data.html_url | pagerduty.incident.html_url |
pagerduty.event.data.number | pagerduty.incident.incident_number |
pagerduty.event.data.status | pagerduty.incident.status |
pagerduty.event.data.incident_key |
|
pagerduty.event.data.created_at |
|
pagerduty.event.data.title | pagerduty.incident.trigger_summary_data.subject |
pagerduty.event.data.service | pagerduty.incident.service |
pagerduty.event.data.service.html_url | pagerduty.incident.service.html_url |
pagerduty.event.data.service.id | pagerduty.incident.service.id |
pagerduty.event.data.service.self |
|
pagerduty.event.data.service.summary | pagerduty.incident.service.name |
pagerduty.event.data.service.type |
|
pagerduty.event.data.assignees (下記のタグ リスト セクションをご確認ください) |
|
html_url (下記のタグ リスト セクションをご確認ください) |
|
id (下記のタグ リスト セクションをご確認ください) |
|
self (下記のタグ リスト セクションをご確認ください) |
|
summary (下記のタグ リスト セクションをご確認ください) |
|
type (下記のタグ リスト セクションをご確認ください) |
|
pagerduty.event.data.escalation_policy | pagerduty.incident.escalation_policy |
pagerduty.event.data.escalation_policy.html_url |
|
pagerduty.event.data.escalation_policy.id | pagerduty.incident.escalation_policy.id |
pagerduty.event.data.escalation_policy.self |
|
pagerduty.event.data.escalation_policy.summary | pagerduty.incident.escalation_policy.name |
pagerduty.event.data.escalation_policy.type |
|
pagerduty.event.data.teams (下記のタグ リスト セクションをご確認ください) |
|
pagerduty.event.data.priority |
|
pagerduty.event.data.priority.html_url |
|
pagerduty.event.data.priority.id |
|
pagerduty.event.data.priority.self |
|
pagerduty.event.data.priority.summary |
|
pagerduty.event.data.priority.type |
|
pagerduty.event.data.urgency | pagerduty.incident.urgency |
pagerduty.event.data.conference_bridge |
|
pagerduty.event.data.conference_bridge.conference_number |
|
pagerduty.event.data.conference_bridge.conference_url |
|
pagerduty.event.data.resolve_reason |
|
タグのリスト
承認済みのタグ pagerduty.event.data.assignees と pagerduty.event.data.teams は、どちらもリスト形式でデータを返します。両リストには、html_url、id、self、summary、type というキーを持つオブジェクトが含まれています。これらのキーは承認済みのタグとしてリストされますが、pagerduty.event.data.assignees または pagerduty.event.data.teams によって返されるリストのコンテキスト内でのみ有効です。mustache タグを使用してリストをフォーマットする方法の詳細については、「html フォーマットに関する mustache ドキュメント」をご参照ください。
PagerDuty mustache タグを持つ有効なテンプレート要素の例:
1
"Body element: {{#pagerduty.event.data.assignees}} {{html_url}} {{id}} {{self}} {{summary}} {{type}} {{/pagerduty.event.data.assignees}}"1
"Body element: {{#pagerduty.event.data.teams}} {{summary}} {{/pagerduty.event.data.teams}}"PagerDuty mustache タグを持つ無効なテンプレート要素の例:
1
"Body element: {{html_url}} {{id}} {{self}} {{summary}} {{type}}"PagerDuty Webhook サブスクリプションの詳細については、「PagerDuty の V3 Webhook に関する概要」をご参照ください。
この内容はお役に立ちましたか?