Opsgenie を Statuspage と統合する
概要
統合でできるようになること
Statuspage によってサービス プロバイダーは、サービスの個別のインフラストラクチャまたは機能部分ごとにコンポーネントを追加できます。Opsgenie は、Statuspage との強力な双方向統合を備えています。統合は次のように使用されます。
Statuspage は、インシデントのアップデート時に Webhook 通知を送信します。Statuspage の統合では、新しいインシデントごとに Opsgenie でアラートが作成され、インシデントのすべてのアップデートが既存のアラートにメモとして追加されます。Opsgenie はこれらのアラートのディスパッチャーとして機能して、オンコール スケジュールに基づいて通知する適切な担当者を決定します。メール、テキスト メッセージ (SMS)、電話、iOS、Android のプッシュ通知によって通知し、アラートが承認されるかクローズされるまでアラートをエスカレートします。
Opsgenie アクションが「インシデントを作成する」または「インシデントを作成し、タグに従ってコンポーネント/インシデントのステータスをアップデートする」Statuspage アクションにマップされている場合、Opsgenie は Statuspage でインシデントを作成します。
Opsgenie アクションが「インシデントを解決する」または「インシデントを解決し、タグに従ってコンポーネントのステータスをアップデートする」Statuspage アクションにマップされている場合、Opsgenie は Statuspage でインシデントを解決します。Opsgenie アクションが「インシデントにメモを追加する」Statuspage アクションにマップされている場合、Opsgenie は Statuspage でインシデントをアップデートします。
統合による機能
インシデントが Statuspage で作成されると、Opsgenie でも自動的にアラートが作成されます。
Statuspage でインシデントがクローズされると、関連するアラートが Opsgenie で自動的にクローズされます。
統合をセットアップする
Statuspage は双方向の統合です。設定は次の手順で行います。
Opsgenie で Statuspage の統合を追加する
アラート アクションをマッピングする
Statuspage で統合を設定する
Statuspage の統合を追加する
Opsgenie の Free プランまたは Essentials プランを使用している、または Jira Service Management の Standard プランで Opsgenie を使用している場合は、チーム ダッシュボードからのみこの統合を追加できます。 このプランでは、[設定] の [統合] ページが利用できません。
[チーム] に移動して自分のチームを選択します。
左側のナビゲーションで [統合] を選択し、[統合を追加] を選択します。
統合をチーム ダッシュボードから追加すると、そのチーム統合の所有者になります。Opsgenie では、この統合を通じて受信したアラートはそのチームのみに割り当てられます。このセクションの残りの手順に従って、統合を設定してください。
Opsgenie で Statuspage の統合を追加するには、次の手順に従います。
[設定] > [統合] の順に移動します。
[統合を追加] を選択します。
検索を実行して「Statuspage」を選択します。
次の画面で、統合の名前を入力します。
オプション: 特定のチームが統合からのアラートを受信するようにする場合は、[Assignee team (担当者チーム)] のチームを選択します。
[Continue] を選択します。
この時点で、統合が保存されます。[統合を設定するステップ] セクションを展開して、URL をコピーします。
この URL は、後ほど Statuspage で統合を設定する際に使用します。[統合をオンにする] を選択します。
統合のために作成したルールは、統合をオンにした場合にのみ機能します。
Statuspage で統合を設定する
[Subscribers (登録者)] インターフェイスで、[Options (オプション)] > [Settings (設定)] と選択します。
[Subscriber Notification Settings (登録者通知設定)] モーダルで、[Delivery types (配信タイプ)] に「Webhook」を選択します。
[変更を保存] を選択します。
ステータス ページに移動し、[Subscribe To Updates (アップデート通知へのサブスクライブ)] をクリックします。
登録のドロップダウンから [Webhook] タブを選択します。
Opsgenie で統合を追加する際にコピーした URL を [URL] に貼り付けます。
API エンドポイントが失敗した場合にメールを受信するためのメール アドレスを入力します。
[Subscribe To Notifications (通知へのサブスクライブ)] を選択します。
Statuspage をアップデートするように統合を設定する
Statuspage の画面の左下にあるアバターを選択します。
メニューから [API Info (API 情報)] を選択します。
インテグレーションを機能させるページのページ ID をコピーします。
Opsgenie に戻り、Statuspage の統合ページに移動します。
必要に応じて、[アラートのアップデートを Statuspage に送信] または [Opsgenie アラートの Statuspage インシデントを作成] のチェックボックスを選択します。
このページ ID を [Statuspage Page Id (Statuspage ページ ID)] フィールドに貼り付けます。
Statuspage で、API キーをコピーし、[Statuspage API Key (Statuspage API キー)] フィールドに貼り付けます。
アラート フィルターを使用して、Statuspage に送信するアラートの種類を制御します。
統合を保存します。
Opsgenie は、保存時に Statuspage を使用して設定を検証しようとします。
アラート アクションをマッピングする
Opsgenie では、Opsgenie のアクションと Statuspage のアクションの間のアクション マッピングを定義できます。
[アラートのアップデートを Statuspage に送信] が選択されている場合、選択したアクションが Opsgenie で実行されると、Statuspage のアクションが Statuspage で実行されます。
[Opsgenie アラートの Statuspage インシデントを作成] が選択されている場合、Statuspage の統合以外のソースを持つアラートに対して選択したアクションが Opsgenie で実行される際に、Statuspage に対するアクションが実行されます。
「追加されたタグに従ってコンポーネント/インシデントのステータスをアップデートする」Statuspage アクションが「アラートにタグが追加される」Opsgenie アクションにマップされている場合、特別にフォーマットされたタグがアラートに追加されると、Statuspage 内のコンポーネント/インシデントのステータスが、指定されたステータスに変更されます。
「インシデントを解決し、タグに従ってコンポーネントのステータスをアップデートする」Statuspage アクションが Opsgenie アクションにマップされている場合、タグで指定されたコンポーネントのステータスは、該当する場合には operational に変更されます。
Statuspage で作成されたアラートの場合
[アラートのアップデートを Statuspage に送信] セクションで、アラートのソースが Statuspage になっている場合 (つまり、アラートが Statuspage の統合によって作成される場合) は、Opsgenie のアクションを Statuspage のアクションにマップします。
Map Opsgenie actions to Statuspage actions. For example, update the Statuspage incident when a note is added to the Opsgenie alert. To do this, define If a note is added to the alert in Opsgenie, add note to the incident to the incident in Statuspage mapping in Send alert updates back to Statuspage section.
Opsgenie のその他のアラートの場合
[Opsgenie アラートの Statuspage インシデントを作成] セクションで、アラートのソースが Statuspage でない場合 (アラートが別の統合によって作成される場合)、Opsgenie アクションを Statuspage アクションにマップします。
1 つの Opsgenie アクションを「インシデントを作成する」または「インシデントを作成し、タグに従ってコンポーネント/インシデントのステータスをアップデートする」Statuspage アクションにマップします。Opsgenie アクションは「アラートが作成される」である必要はなく、他のアクションにもできます。
a tag is added to the alert and a custom action is executed on alert actions differ from the other actions. When either action is selected, an extra field appears to enter which tags or for which custom action this mapping works.
タグをコンマで区切って、複数のタグを入力します。複数のタグを入力した場合、マッピングは、アラートが指定されたタグを 1 つ以上持っている場合に機能します。タグのフィールドを空のままにすると、どのタグでもマッピングが機能します。
カスタム マッピングのカスタム アクションの名前を指定します。空のままにすることはできません。
1 つの Opsgenie アクションが複数の Statuspage アクションにマッピングされている場合、「アラートにタグが追加される」アクションと「アラートでカスタム アクションが実行される」アクションを除いて、エラーが発生します。これらのアクションは、指定されたタグ名やカスタム・アクション名によって異なるため、複数のマッピングを保存します。
アラート タグを使用したコンポーネント/インシデント ステータスの変更
アラートに特別にフォーマットされたタグを追加して、Statuspage でコンポーネント/インシデントのステータスを変更します。
タグは、アラートの作成中または作成後に追加できます。Opsgenie アクションが「インシデントを作成し、タグに従ってコンポーネント/インシデントのステータスをアップデートする」Statuspage アクションにマップされている場合、Opsgenie で特別にフォーマットされたタグを含むアラートが作成されると、Statuspage でインシデントが作成され、コンポーネントおよびインシデントのステータスが特別にフォーマットされたタグに従って変更されます。または、「アラートにタグが追加される」アクションが「追加されたタグに従ってコンポーネント/インシデントのステータスをアップデートする」Statuspage アクションにマップされている場合、Opsgenie で特別にフォーマットされたタグがアラートに追加されると、コンポーネント/インシデントのステータスが追加されたタグに従って変更されます。
To use component name:
Format the tags as cmp_[component name]:[status] where [component name] is the name of the component to have a status change. For example, cmp_API:degraded_performance.To use component id:
Format the tags as cmpid_[component id]:[status] where [component id] is the id of the component to have a status change. For example, cmpid_componentId1:degraded_performance.[ステータス] は、コンポーネントに許可されるステータスの 1 つです。これらの許可されたステータスは、「許可されているコンポーネント ステータス」の下に一覧されています。
許可されているコンポーネントステータス
運用
degraded_performance
partial_outage
major_outage
許可されているインシデントステータス
investigating
identified
監視
resolved
例
cmp_API:degraded_performance
cmp_Database Server:partial_outage
cmp_Management Portal:operational
inc:monitoring
inc:identified
Statuspage から送信されるペイロードのサンプル
JSON
{
"meta":
{
"unsubscribe": "https://opsgenietest.statuspage.io/?unsubscribe=8rx45n6txwh3",
"documentation": "http://doers.statuspage.io/customer-notifications/webhooks/"
},
"page":
{
"id": "1k9dvd5q1qlv",
"status_indicator": "none",
"status_description": "All Systems Operational"
},
"incident":
{
"name": "incident1",
"status": "investigating",
"created_at": "2015-10-08T13:13:53.303Z",
"updated_at": "2015-10-08T13:13:53.558Z",
"monitoring_at": null,
"resolved_at": null,
"impact": "none",
"shortlink": "http://stspg.io/1Z1G",
"postmortem_ignored": false,
"postmortem_body": null,
"postmortem_body_last_updated_at": null,
"postmortem_published_at": null,
"postmortem_notified_subscribers": false,
"postmortem_notified_twitter": false,
"backfilled": false,
"scheduled_for": null,
"scheduled_until": null,
"scheduled_remind_prior": false,
"scheduled_reminded_at": null,
"impact_override": null,
"scheduled_auto_in_progress": false,
"scheduled_auto_completed": false,
"id": "hk801ps7x9x4",
"page_id": "1k9dvd5q1qlv",
"incident_updates":
[
{
"status": "investigating",
"body": "this is a test incident",
"created_at": "2015-10-08T13:13:53.556Z",
"wants_twitter_update": false,
"twitter_updated_at": null,
"updated_at": "2015-10-08T13:13:53.556Z",
"display_at": "2015-10-08T13:13:53.556Z",
"id": "7m0y35xlqh8j",
"incident_id": "hk801ps7x9x4"
}
]
}
}
この内容はお役に立ちましたか?