• 製品
  • 使用を開始する
  • 関連ドキュメント
  • リソース

Opsgenie を Statuspage と統合する

Opsgenie が Statuspage ユーザーに提供するもの

Statuspage によってサービス プロバイダーは、サービスの個別のインフラストラクチャまたは機能部分ごとにコンポーネントを追加できます。Opsgenie は、Statuspage との強力な双方向統合を備えています。統合は次のように使用されます。

  1. Statuspage は、インシデントのアップデート時に Webhook 通知を送信します。Atlassian Statuspage インテグレーションでは、新しいインシデントごとに Opsgenie でアラートが作成され、インシデントのすべてのアップデートが既存のアラートにメモとして追加されます。Opsgenie はこれらのアラートのディスパッチャーとして機能して、オンコール スケジュールに基づいて通知する適切な担当者を決定します。メール、テキスト メッセージ (SMS)、電話、iOS、Android のプッシュ通知によって通知し、アラートが承認されるかクローズされるまでアラートをエスカレートします。

  2. Opsgenie アクションが「インシデントを作成する」または「インシデントを作成し、タグに従ってコンポーネント/インシデントのステータスをアップデートする」Atlassian Statuspage アクションにマップされている場合、Opsgenie は Atlassian Statuspage でインシデントを作成します。

  3. Opsgenie アクションが「インシデントを解決する」または「インシデントを解決し、タグに従ってコンポーネントのステータスをアップデートする」Atlassian Statuspage アクションにマップされている場合、Opsgenie は Atlassian Statuspage でインシデントを解決します。Opsgenie アクションが「インシデントにメモを追加する」Atlassian Statuspage アクションにマップされている場合、Opsgenie は Atlassian Statuspage でインシデントをアップデートします。

統合の機能性

  • インシデントが Atlassian Statuspage で作成されると、Opsgenie でも自動的にアラートが作成されます。

  • Atlassian Statuspage でインシデントがクローズされると、関連するアラートが Opsgenie で自動的にクローズされます。

アクション マッピング:

  • [Send Alert Updates Back to Atlassian Statuspage (アラートのアップデートを Atlassian Statuspage に送信)] が有効な場合、選択したアクションが Opsgenie で実行されると、Atlassian Statuspage のアクションが Atlassian Statuspage で実行されます。

  • [Create Atlassian Statuspage Incidents for Opsgenie Alerts (Opsgenie アラート用の Atlassian Statuspage インシデントを作成)] が有効になっている場合、Atlassian Statuspage インテグレーション以外のソースを持つアラートに対して Opsgenie で選択したアクションが実行されると、Atlassian Statuspage のアクションが実行されます。

  • 追加されたタグに従ってコンポーネント/インシデントのステータスをアップデートする」Atlassian Statuspage アクションが「アラートにタグが追加される」Opsgenie アクションにマップされている場合、特別にフォーマットされたタグがアラートに追加されると、Atlassian Statuspage 内のコンポーネント/インシデントのステータスが、指定されたステータスに変更されます。

  • インシデントを解決し、タグに従ってコンポーネントのステータスをアップデートする」Atlassian Statuspage アクションが Opsgenie アクションにマップされている場合、タグで指定されたコンポーネントのステータスは、該当する場合には operational に変更されます。

これらのアクション マッピング機能の詳細は、以下の「アクション マッピング機能」セクションで説明します。

Opsgenie で Statuspage インテグレーションを追加する

この統合はチーム ダッシュボードから追加可能

Opsgenie の Free または Essentials の各プランを使用している、または Jira Service Management の Standard プランで Opsgenie を使用している場合、このプランでは [設定] の [統合] ページが利用できないため、この統合はチーム ダッシュボードからのみ追加できます。

統合をチーム ダッシュボードから追加すると、そのチーム統合の所有者になります。Opsgenie では、この統合を通じて受信したアラートはそのチームのみに割り当てられます。

そのためには、次の手順に従います。

  1. Teams からチーム ダッシュボードに移動します。

  2. [統合] > [統合を追加] の順に選択します。

残りの手順に従って統合を完了します。

  1. [設定] > [統合] の順に移動します。Statuspage を検索して [追加] を選択します。

  2. [応答者] フィールドを使用して、Statuspage アラートの通知先を指定します。入力し始めると、オート コンプリートの候補が表示されます。

  3. URL をコピーします。

  4. [Save Integration (統合の保存)] を選択します。

Statuspage での設定

  1. Statuspage の左側のサイドバーで [サブスクライバー] をクリックします。
    a. 特定の対象者向けページを使用している場合は、[対象者] をクリックします。

  2. [オプション] ドロップダウンメニューをクリックします。
    b. 特定の対象者向けページを使用している場合は、[Subscriber settings (サブスクライバーの設定)] タブをクリックします。

  3. ドロップダウンメニューから [設定] をクリックします。

  4. 配信の種類の下に表示される Webhook のチェックボックスを選択します。

  5. 変更を保存をクリックします。

  6. ステータス ページに移動し、[Subscribe to updates (アップデート通知へのサブスクライブ)] をクリックします。

  7. サブスクリプション ドロップダウンから [Webhook] タブをクリックします。

  8. Opsgenie からコピーした URL を [URL] フィールドに貼り付けます。

  9. [Subscribe to notifications (通知へのサブスクライブ)] をクリックします。

Statuspage からの通知をサブスクライブする場所を示す画像。

 

Opsgenie から Statuspage へのインテグレーション

  1. Statuspage の画面の左下にあるアバターをクリックします。

  2. メニューから [API Info (API 情報)] をクリックします。

  3. インテグレーションを機能させるページのページ ID をコピーします。

  4. Opsgenie の Statuspage インテグレーション ページ ([チーム] > [Relevant Team (関連チーム)] > [Integrations (インテグレーション)] > [Statuspage]) に戻ります。

  5. [Send Alert Updates Back to Statuspage (アラートのアップデートを Statuspage に送信)] と [Create Statuspage Incidents for Opsgenie Alerts (Opsgenie アラートの Statuspage インシデントを作成)] のチェックボックスをオンにします。

  6. このページ ID を [Statuspage Page Id (Statuspage ページ ID)] フィールドに貼り付けます。

  7. Statuspage で、API キーをコピーし、Opsgenie の [Statuspage API Key (Statuspage API キー)] フィールドに貼り付けます。

  8. アラート フィルターを使用して、Statuspage に送信するアラートの種類を制御します。

  9. 統合を保存します。

Opsgenie は、保存時に Statuspage を使用して設定を検証しようとします。

アクション マッピング機能

Opsgenie では、顧客は Opsgenie のアクションと Atlassian Statuspage のアクションの間のアクション マッピングを定義できます。

For alerts created by Atlassian Statuspage (Atlassian Statuspage で作成されたアラートの場合)

  • このセクションを使用して、アラートのソースが Atlassian Statuspage である場合の、Opsgenie のアクションを Atlassian Statuspage のアクションにマッピングします (つまり、Atlassian Statuspage インテグレーションによってアラートが作成された場合)。

  • さまざまな Opsgenie アクションをさまざまな Atlassian Statuspage アクションにマッピングします。たとえば、Opsgenie アラートにメモが追加されたときに Atlassian Statuspage インシデントをアップデートします。これを行うには、[Send Alert Updates Back to Atlassian Statuspage (アラートのアップデートを Atlassian Statuspage に送信)] セクションで、「Opsgenie でアラートにメモが追加された場合は、Atlassian Statuspage でインシデントにメモを追加する」というマッピングを定義します。

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

  • このセクションを使用して、アラートのソースが Atlassian Statuspage ではない場合の、Opsgenie のアクションを Atlassian Statuspage のアクションにマッピングします (つまり、アラートが別のインテグレーションによって作成された場合)。

  • このために、[Create Atlassian Statuspage Incidents for Opsgenie Alerts (Opsgenie アラート用の Atlassian Statuspage インシデントを作成)] セクションを使用します。この機能を使用するには、1 つの Opsgenie アクションを「インシデントを作成する」または「インシデントを作成し、タグに従ってコンポーネント/インシデントのステータスをアップデートする」Atlassian Statuspage アクションにマップします。Opsgenie アクションは「アラートが作成される」である必要はなく、他のアクションにすることもできます。

Statuspage のアラート ルールを示す画像
  • アラートにタグが追加される」アクションと「アラートでカスタム アクションが実行される」アクションは他のアクションと異なります。これらのアクションのいずれかを選択すると、このマッピングが機能するタグまたはカスタム アクションを入力するための追加のフィールドが表示されます。

  • タグをカンマで区切って、複数のタグを入力します。複数のタグを入力した場合、マッピングは、指定されたタグが 1 つ以上アラートにある場合に機能します。タグのフィールドを空のままにすると、どのタグでもマッピングが機能します。

  • カスタムマッピングのカスタムアクションの名前を指定します。空のままにすることはできません。

  • 1 つの Opsgenie アクションが複数の Statuspage アクションにマッピングされている場合、「アラートにタグが追加される」アクションと「アラートでカスタム アクションが実行される」アクションを除いて、エラーが発生します。マッピングは、特定のタグとカスタム アクション名によって異なるため、これらのアクションに対して複数のマッピングを保存します。

Statuspage インテグレーションの複数のマッピングを示す画像。

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

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

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

コンポーネントを変更するためのルールを示す画像。
  • タグを cmp_[コンポーネント名]:[ステータス] としてフォーマットします。[コンポーネント名] はステータスを変更するコンポーネントの名前で、[ステータス] はコンポーネントに対して許可されているステータスのいずれかです。これらの許可されたステータスは、「許可されているコンポーネントステータス」の下に一覧されています。

  • コンポーネントごとに個別のステータスタグを追加して、複数のコンポーネントのステータスを変更します。以下の例を確認してください。

  • Opsgenie アクションが、「インシデントを解決し、タグに従ってコンポーネントのステータスをアップデートする」Atlassian Statuspage アクションにマップされている場合、タグで指定されたコンポーネントのステータスは、Atlassian Statuspage で operational に変更されます。

許可されているコンポーネントステータス

  • 運用

  • 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

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 { "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" } ] } }



その他のヘルプ