ユーザーとして Opsgenie の利用を開始する
プロフィールの設定、Opsgenie からの通知の取得、オンコール スケジュールの表示に関するすべての方法を説明します。
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
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"
}
]
}
}
この内容はお役に立ちましたか?