Status.io と統合する

この記事では、Jira Service Management Cloud の一部のお客様に段階的に展開されている、Jira Service Management でネイティブに利用できる新しいアラート機能を取り上げています。ご利用のサイトにはまだ表示されていないか、利用できない可能性があります。

統合でできるようになること

Status.io 統合を使用して、Status.io アラートを Jira Service Management に、Jira Service Management アラートを Status.io に転送します。Jira Service Management は、オンコール・スケジュールに基づいて通知する適切な担当者を決定します。メール、テキスト・メッセージ（SMS）、電話、iPhone と Android のプッシュ通知によって通知し、アラートが承認されるかクローズされるまでアラートをエスカレートします。

統合による機能

Status.io でインシデントが作成されると、統合によって Jira Service Management でアラートが自動で作成されます。
Status.io でインシデントが解決されると、統合により Jira Service Management のアラートが自動で閉じます。
Jira Service Management でアラートが作成されると、統合によって Status.io でインシデントが自動で作成されます。
Jira Service Management でインシデントがクローズされると、統合によって Status.io でインシデントが自動で解決されます。

統合をセットアップする

Status.io は双方向の統合です。設定は次の手順で行います。

Jira Service Management に Status.io 統合を追加します。
アラートアクションをマッピングする
Status.io で統合を設定する

Status.io 統合を追加する

Jira Service Management の Free プランまたは Standard プランを使用している場合は、この統合はチームの運用ページからのみ追加できます。Settings (歯車のアイコン) > Products ([Jira 設定] の下) > OPERATIONS からこの機能にアクセスするには、Premium プランまたは Enterprise プランが必要です。

統合をチームの運用ページから追加すると、そのチームが統合の所有者になります。つまり、Jira Service Management は、この統合を通じて受信したアラートをチームにのみ割り当てます。

Jira Service Management で Status.io 統合を追加するには、次の手順を実行します。

チームのオペレーションページに移動します。
左側のナビゲーションパネルで、[統合]、[統合を追加] の順に選択します。
検索を実行して [Status.io] を選択します。
次の画面で、統合の名前を入力します。
オプション: 特定のチームが統合からのアラートを受信するようにする場合は、[Assignee team (担当者チーム)] のチームを選択します。
[続行] を選択します。
この時点で、統合が保存されます。
Status.io のステータスページ ID を「ステータスページ ID」に貼り付けます。
Status.io の API ID を「Status.io API ID」に貼り付けます。
Status.io の API キーを「Status.io API キー」に貼り付けます。
ステータスページ ID、API ID、API キーの情報は Status.io の左側のメニューの「API」タブに移動し、「Display API Credentials（API 認証情報を表示）」を選択して確認します。
「アラートアクション」オプションによって、Status.io 側で実行するアクションを選択します。
[作成]、[クローズ]、または両方のアクションを選択します。
アラート・フィルターを選択して、Status.io に転送するアラートを指定します。
「統合を設定する手順」セクションを展開し、Webhook URL をコピーします。
この URL は、後ほど Status.io で統合を設定する際に使用します。
Jira Service Management でアラートが作成/クローズされた際に Status.io でインシデントを作成/解決するには、「Send Alerts To Status.io（Status.io にアラートを送信）」オプションを選択します。
[統合をオンにする] を選択します。
統合のために作成したルールは、統合をオンにした場合にのみ機能します。

Status.io で統合を設定する

Status.io で統合を設定するには、次の手順を実行します。

Status.io で、まだ有効になっていない場合は、Webhook 通知を有効にします。
左側のメニューで [通知] タブを開き、[Webhook] セクションに移動して [オン/オフ] を選択します。
ステータスページで [登録] を選択します。
上部のメニューから [Webhook] タブを開きます。
Jira Service Management で統合を追加する際にコピーした URL を最初のフィールドに貼り付けます。
2 番目のフィールドにメールアドレスを入力します。
[登録] を選択します。

オプション：コンテナー、コンポーネント、状態、ステータス情報を設定する

インシデントの影響を受けるコンテナーやコンポーネントを Status.io に通知するための追加プロパティをアラートに設定します。これらの追加プロパティは、アラートの「追加プロパティ」フィールドに追加されます。「コンテナー」と「コンポーネント」が追加プロパティとして設定されている場合、Status.io 側では、これらのコンテナーとコンポーネントに対してのみインシデントが作成されます。コンテナーもコンポーネントも選択されていない場合、インシデントはすべてのコンテナーとコンポーネントに対して作成されます。

Status.io に送信される情報を変更するために設定できる追加プロパティのリストを次に示します。

コンテナー (インシデントの影響を受けるコンテナー)
コンポーネント (インシデントの影響を受けるコンポーネント)
現在のステータス (インシデントの現在のステータス)
現在の状態 (インシデントの現在の状態)

[コンテナー] と [コンポーネント] の各プロパティを ID として入力します。これらのコンテナーやコンポーネントの ID を検索するには、次の手順に従います。

Status.io で、左側のメニューから「インフラストラクチャ」を選択します。
[Components (コンポーネント)] リストの最初のアイテムである [Modify (変更)] ボタン (>) を選択します。
[Automatic Status Updates (ステータスの自動アップデート)] セクションの [API] タブを選択します。
そのタブで、コンポーネントの ID と、そのコンポーネントを含むコンテナーの ID を確認します。
[Components (コンポーネント)] リストの使用する各コンポーネントについて、上記の手順を繰り返します。

[Current Status (現在のステータス)] と [Current State (現在の状態)] の追加プロパティを設定して、インシデントのステータスと状態を設定します。[Current Status (現在のステータス)] と [Current State (現在の状態)] の追加のプロパティが設定されていない場合、インシデントは [Current Status (現在のステータス)] と [Current State (現在の状態)] の既定値 (100) で作成されます。[Current Status (現在のステータス)] と [Current State (現在の状態)] の追加プロパティをステータスコードとして入力します。

インシデントステータスコード:

100 - 運用可能
300 - パフォーマンスの低下
400 - 部分的なサービスの中断
500 - サービスの中断
600 - セキュリティイベント

インシデント状態コード:

100 - 調査中
200 - 識別済み
300 - 監視

Status.io から送信されるペイロードのサンプル

(JSON 形式)

{
  "id": "57ca879d96a04686040000cc",
  "datetime": "2016-09-03T08:19:41.459Z",
  "current_status": "Degraded Performance",
  "current_state": "Investigating",
  "previous_status": "Security Issue",
  "previous_state": "Monitoring",
  "components": [
    {
      "name": "WebSite2",
      "_id": "57ca82dca530225c6d000085"
    },
    {
      "name": "Website",
      "_id": "57c987f72d8d333607002c3d"
    }
  ],
  "containers":[
    {
      "name": "Container1",
      "_id": "57ca82d0db69d71f40000083"
    },
    {
      "name": "Primary Data Center",
      "_id": "57c987f72d8d333607002c3c"
    }
  ],
  "details": "Details",
  "status_page_url": " https://jsm.status.io",
  "incident_url": "https://jsm.status.io/pages/incident/57c987f72d8d333607002c2d/57ca879d96a04686040000cc"
}

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

正確ではなかった

明確ではなかった

関係なかった

Jira Service Management サポート