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 (担当者チーム)] のチームを選択します。
[続行] を選択します。
この時点で、統合が保存されます。
[統合を設定する手順] セクションを展開し、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 のアクションにマップします。
Opsgenie のアクションを Statuspage のアクションにマップします。たとえば、Opsgenie アラートにメモが追加されたときに Statuspage インシデントをアップデートします。これを行うには、[アラートのアップデートを Statuspage に送信] セクションで、「Opsgenie でアラートにメモが追加された場合は、Statuspage でインシデントにメモを追加する」というマッピングを定義します。

Opsgenie のその他のアラートの場合

[Opsgenie アラートの Statuspage インシデントを作成] セクションで、アラートのソースが Statuspage でない場合 (アラートが別の統合によって作成される場合)、Opsgenie アクションを Statuspage アクションにマップします。
1 つの Opsgenie アクションを「インシデントを作成する」または「インシデントを作成し、タグに従ってコンポーネント/インシデントのステータスをアップデートする」Statuspage アクションにマップします。Opsgenie アクションは「アラートが作成される」である必要はなく、他のアクションにもできます。
「アラートにタグが追加される」アクションと「アラートでカスタムアクションが実行される」アクションは他のアクションと異なります。これらのアクションのいずれかを選択すると、このマッピングが機能するタグまたはカスタムアクションを入力するための追加のフィールドが表示されます。
タグをコンマで区切って、複数のタグを入力します。複数のタグを入力した場合、マッピングは、アラートが指定されたタグを 1 つ以上持っている場合に機能します。タグのフィールドを空のままにすると、どのタグでもマッピングが機能します。
カスタムマッピングのカスタムアクションの名前を指定します。空のままにすることはできません。
1 つの Opsgenie アクションが複数の Statuspage アクションにマッピングされている場合、「アラートにタグが追加される」アクションと「アラートでカスタムアクションが実行される」アクションを除いて、エラーが発生します。これらのアクションは、指定されたタグ名やカスタムアクション名によって異なるため、複数のマッピングを保存します。

アラートタグを使用したコンポーネント/インシデントステータスの変更

アラートに特別にフォーマットされたタグを追加して、Statuspage でコンポーネント/インシデントのステータスを変更します。

タグは、アラートの作成中または作成後に追加できます。Opsgenie アクションが「インシデントを作成し、タグに従ってコンポーネント/インシデントのステータスをアップデートする」Statuspage アクションにマップされている場合、Opsgenie で特別にフォーマットされたタグを含むアラートが作成されると、Statuspage でインシデントが作成され、コンポーネントおよびインシデントのステータスが特別にフォーマットされたタグに従って変更されます。または、「アラートにタグが追加される」アクションが「追加されたタグに従ってコンポーネント/インシデントのステータスをアップデートする」Statuspage アクションにマップされている場合、Opsgenie で特別にフォーマットされたタグがアラートに追加されると、コンポーネント/インシデントのステータスが追加されたタグに従って変更されます。

コンポーネント名を使用するには:
タグの書式を cmp_ [コンポーネント名]:[ステータス] のようにします。[コンポーネント名] は、ステータスを変更するコンポーネントの名前です。例: cmp_API:degraded_performance。
コンポーネント ID を使用するには:
タグの書式を cmpid_ [コンポーネント ID]:[ステータス] のようにします。[コンポーネント ID] は、ステータスを変更するコンポーネントの ID です。例:, 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"
      }
    ]
  }
}

この内容はお役に立ちましたか?

正確ではなかった

明確ではなかった

関係なかった

さらにヘルプが必要ですか?

アトラシアンコミュニティをご利用ください。

コミュニティに質問