ユーザーとして Opsgenie の利用を開始する
プロフィールの設定、Opsgenie からの通知の取得、オンコール スケジュールの表示に関するすべての方法を説明します。
Opsgenie を Statuspage と統合する
Opsgenie が Statuspage ユーザーに提供するもの
Statuspage によってサービス プロバイダーは、サービスの個別のインフラストラクチャまたは機能部分ごとにコンポーネントを追加できます。Opsgenie は、Statuspage との強力な双方向統合を備えています。統合は次のように使用されます。
Statuspage は、インシデントのアップデート時に Webhook 通知を送信します。Atlassian Statuspage インテグレーションでは、新しいインシデントごとに Opsgenie でアラートが作成され、インシデントのすべてのアップデートが既存のアラートにメモとして追加されます。Opsgenie はこれらのアラートのディスパッチャーとして機能して、オンコール スケジュールに基づいて通知する適切な担当者を決定します。メール、テキスト メッセージ (SMS)、電話、iOS、Android のプッシュ通知によって通知し、アラートが承認されるかクローズされるまでアラートをエスカレートします。
Opsgenie アクションが「インシデントを作成する」または「インシデントを作成し、タグに従ってコンポーネント/インシデントのステータスをアップデートする」Atlassian Statuspage アクションにマップされている場合、Opsgenie は Atlassian Statuspage でインシデントを作成します。
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 では、この統合を通じて受信したアラートはそのチームのみに割り当てられます。
そのためには、次の手順に従います。
Teams からチーム ダッシュボードに移動します。
[統合] > [統合を追加] の順に選択します。
残りの手順に従って統合を完了します。
[設定] > [統合] の順に移動します。Statuspage を検索して [追加] を選択します。
[応答者] フィールドを使用して、Statuspage アラートの通知先を指定します。入力し始めると、オート コンプリートの候補が表示されます。
URL をコピーします。
[Save Integration (統合の保存)] を選択します。
Statuspage での設定
Statuspage の左側のサイドバーで [サブスクライバー] をクリックします。
a. 特定の対象者向けページを使用している場合は、[対象者] をクリックします。[オプション] ドロップダウンメニューをクリックします。
b. 特定の対象者向けページを使用している場合は、[Subscriber settings (サブスクライバーの設定)] タブをクリックします。ドロップダウンメニューから [設定] をクリックします。
配信の種類の下に表示される Webhook のチェックボックスを選択します。
変更を保存をクリックします。
ステータス ページに移動し、[Subscribe to updates (アップデート通知へのサブスクライブ)] をクリックします。
サブスクリプション ドロップダウンから [Webhook] タブをクリックします。
Opsgenie からコピーした URL を [URL] フィールドに貼り付けます。
[Subscribe to notifications (通知へのサブスクライブ)] をクリックします。
Opsgenie から Statuspage へのインテグレーション
Statuspage の画面の左下にあるアバターをクリックします。
メニューから [API Info (API 情報)] をクリックします。
インテグレーションを機能させるページのページ ID をコピーします。
Opsgenie の Statuspage インテグレーション ページ ([チーム] > [Relevant Team (関連チーム)] > [Integrations (インテグレーション)] > [Statuspage]) に戻ります。
[Send Alert Updates Back to Statuspage (アラートのアップデートを Statuspage に送信)] と [Create Statuspage Incidents for Opsgenie Alerts (Opsgenie アラートの Statuspage インシデントを作成)] のチェックボックスをオンにします。
このページ ID を [Statuspage Page Id (Statuspage ページ ID)] フィールドに貼り付けます。
Statuspage で、API キーをコピーし、Opsgenie の [Statuspage API Key (Statuspage API キー)] フィールドに貼り付けます。
アラート フィルターを使用して、Statuspage に送信するアラートの種類を制御します。
統合を保存します。
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 アクションは「アラートが作成される」である必要はなく、他のアクションにすることもできます。
「アラートにタグが追加される」アクションと「アラートでカスタム アクションが実行される」アクションは他のアクションと異なります。これらのアクションのいずれかを選択すると、このマッピングが機能するタグまたはカスタム アクションを入力するための追加のフィールドが表示されます。
タグをカンマで区切って、複数のタグを入力します。複数のタグを入力した場合、マッピングは、指定されたタグが 1 つ以上アラートにある場合に機能します。タグのフィールドを空のままにすると、どのタグでもマッピングが機能します。
カスタムマッピングのカスタムアクションの名前を指定します。空のままにすることはできません。
1 つの Opsgenie アクションが複数の 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"
}
]
}
}
この内容はお役に立ちましたか?