Datadog と統合する

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

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

Jira Service Management は Datadog とのネイティブで強力な双方向統合を備えています。統合を使用して Datadog アラートと Jira Service Management アラートを自動的に同期すると、Jira Service Management の豊富なアラート通知システム、エスカレーション、オンコールローテーションのメリットが得られます。

統合による機能

Datadog は、定義された条件が一致したときにアラートをトリガーします。Datadog でアラートが作成されると、統合を通じて Jira Service Management でもアラートが自動的に作成されます。
テキスト内の Jira Service Management サービスを @メンションすることで、Datadog UI から Jira Service Management にアラートを作成します。
Jira Service Management でアラートが承認されると、Datadog でもアラートが自動的に承認されます。
Jira Service Management でアラートがクローズされると、Datadog でもアラートが自動的にクローズされます。
Jira Service Management で任意のソース (Datadog 以外) からアラートが作成されると、Jira Service Management はそのアラートを Datadog に投稿できます (オプション)。
コメントで Datadog の @opsgenie-acknowledge コマンドと @opsgenie-close コマンドを使用して、Datadogからのアラートを承認 (またはクローズ) します。

統合をセットアップする

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

Jira Service Management で Datadog 統合を追加する
Datadog で統合を設定する

Datadog 統合を追加する

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

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

Jira Service Management で Datadog 統合を追加するには、次の手順に従います。

チームの運用ページに移動します。
左側のナビゲーションパネルで、[統合]、[統合を追加] の順に選択します。
検索を実行して「Datadog」を選択します。
次の画面で、統合の名前を入力します。
オプション: 特定のチームが統合からのアラートを受信するようにする場合は、[Assignee team (担当者チーム)] のチームを選択します。
[続行] を選択します。
この時点で、統合が保存されます。
統合設定ページの [Edit (編集)] に移動します。
[Edit integration settings (統合設定を編集)] ダイアログが開きます。
[Authenticate with a Datadog account (Datadog アカウントで認証)] を選択します。
Datadog API キーを [Datadog API key (Datadog API キー)] に貼り付けます。
[統合を設定する手順] セクションを展開して、API キーをコピーします。
このキーは、後ほど Datadog で統合を設定する際に使用します。
[統合をオンにする] を選択します。
統合のために作成したルールは、統合をオンにした場合にのみ機能します。

Datadog で統合を設定する

Datadog で統合を設定するには、次の手順に従います。

Datadog で [Integrations (統合)] > [Integrations (統合)] の順に選択します。
[Opsgenie] を選択します。
[Configuration (設定)] タブを開きます。
以前に Jira Service Management からコピーした API キーを、[Service Key (apiKey) (サービスキー (apiKey))] の下のテキストフィールドに貼り付けます。
サービス名を入力します。
[Install Integration (統合をインストール)] を選択します。

統合をテストするには、[イベント] ページで @opsgenie (つまり @opsgenie 宛てにこれはテストアラートだと) と投稿するだけです。これによって Jira Service Management にアラートが作成され、Datadog の [イベント] ページに表示されます。

Datadog から Jira Service Management に送信されたペイロードの例

メトリックアラートペイロード

JSON

{
        "event_url": "",
        "last_updated": 1397628633000,
        "event_type": "metric_alert",
        "snapshot_link": "https://app.datadoghq.com/alert/alert_state?alert_id=51950&to_ts=1397628600000&aggr=avg&scope=host%3Aismet-if&metric=system.disk.free&from_ts=1397627940000",
        "msg_title": "[Triggered] system.disk.free",
        "monitor_data": {
            "snap_url": "https://p.datadoghq.com/snapshot/view/dd-snapshots-prod/org_2305/2014-07-23/6803a21774c63347c032d92a2aff01ababfba231.png",
            "group": "guruop",
            "name": "aws.dynamodb.returned_item_count",
            "type": "metric alert",
            "group_key": "key5",
            "query":"min(last_5m):avg:system.cpu.idle{*} < 99",
            "message": "@opsgenie-service_1",
            "org_id": 2305,
            "id": 59482,
            "metric": "system.cpu.idle"
        },
        "dd_tags": [
            "alert",
            "tag2"
        ],
        "message": "%%%\n@opsgenie-team \n\n[![Metric Graph](https://p.datadoghq.com/snapshot/view/dd-snapshots-prod/org_8283/2014-04-16/7103f56dfa041445fb099f014ca5a3fce0cfcaea.png)](https://app.datadoghq.com/alert/alert_state?alert_id=51950&to_ts=1397628600000&aggr=avg&scope=host%3Aismet-if&metric=system.disk.free&from_ts=1397627940000)\n\n**system.disk.free** over **host:ismet-if** was **> 1** on average during the **last 10m**.\n\n\n%%%",
        "event_id": "2237506288020066106",
        "snapshot_url": "https://p.datadoghq.com/snapshot/view/dd-snapshots-prod/org_8283/2014-04-16/7103f56dfa041445fb099f014ca5a3fce0cfcaea.png",
        "priority": "normal",
        "alias": "ad07c3317c7a1f9a35ea4ac2fdb5d706",
        "msg_text": "%%%\n@opsgenie-team \n\n[![Metric Graph](https://p.datadoghq.com/snapshot/view/dd-snapshots-prod/org_8283/2014-04-16/7103f56dfa041445fb099f014ca5a3fce0cfcaea.png)](https://app.datadoghq.com/alert/alert_state?alert_id=51950&to_ts=1397628600000&aggr=avg&scope=host%3Aismet-if&metric=system.disk.free&from_ts=1397627940000)\n\n**system.disk.free** over **host:ismet-if** was **> 1** on average during the **last 10m**.\n\n\n%%%",
        "action": "create",
        "templated_message": "temp msg",
        "source_type_name": "Monitor Alert"
    }

Jira Service Management ではペイロードは次のように解析されます。

JSON

[
          "last_updated": 1397628633000,
          "message_title": "[Triggered] system.disk.free",
          "query": "min(last_5m):avg:system.cpu.idle{*} < 99",
          "snapshot_url": "https://p.datadoghq.com/snapshot/view/dd-snapshots-prod/org_2305/2014-07-23/6803a21774c63347c032d92a2aff01ababfba231.png",
          "message": "@opsgenie-service_1",
          "priority": "normal",
          "event_url": "",
          "monitor_name": "aws.dynamodb.returned_item_count",
          "snapshot_link": "https://app.datadoghq.com/alert/alert_state?alert_id=51950&to_ts=1397628600000&aggr=avg&scope=host%3Aismet-if&metric=system.disk.free&from_ts=1397627940000",
          "templated_message": "temp msg",
          "event_type": "metric_alert",
          "event_id": "2237506288020066106",
          "metric": "system.cpu.idle",
          "alias": "ad07c3317c7a1f9a35ea4ac2fdb5d706",
          "action": "create",
          "dd_tags": [
            "alert",
            "tag2"
          ],
          "group": "guruop",
          "group_key": "key5",
          "source_type_name": "Monitor Alert"
    ]

@opsgenie-acknowledge コマンドペイロード

JSON

{
      "last_updated": "1456994681000",
      "msg_title": "null",
      "user_name": "halit okumus",
      "user_handle": "halit.okumus@ifountain.com",
      "snapshot_url": "null",
      "source": "null",
      "msg_text": "@opsgenie-acknowledge I am on it",
      "priority": "normal",
      "message": "@opsgenie-acknowledge I am on it",
      "event_url": "",
      "snapshot_link": "null",
      "dd_tags": [
            "alert",
            "tag2"
        ],
      "event_type": "api",
      "event_id": "3233503302758961154",
      "monitor_data": "null",
      "alias": "f769ea8a-1e8c-48c1-943f-b51792e14de8",
      "action": "acknowledge",
      "alertId": "f769ea8a-1e8c-48c1-943f-b51792e14de8"
    }

@opsgenie-close コマンドペイロード

JSON

{
      "last_updated": "1456998760000",
      "msg_title": "null",
      "user_name": "halit okumus",
      "user_handle": "halit.okumus@ifountain.com",
      "snapshot_url": "null",
      "source": "null",
      "msg_text": "@opsgenie-close closing this one",
      "priority": "normal",
      "message": "@opsgenie-close closing this one",
      "event_url": "",
      "snapshot_link": "null",
      "dd_tags": [
            "alert",
            "tag2"
        ],
      "event_type": "api",
      "event_id": "3233571736653926401",
      "monitor_data": "null",
      "alias": "f769ea8a-1e8c-48c1-943f-b51792e14de8",
      "action": "close",
      "alertId": "f769ea8a-1e8c-48c1-943f-b51792e14de8"
    }

Jira Service Management から Datadog に送信されたペイロードの例

JSON

{
  "apiKey": "2980d945-18b7-4371-9299-7ff60c21082c",
  "alert": {
    "createdAt": 1456756398904,
    "tinyId": "48",
    "alias": "alertAlias",
    "alertId": "5c1173aa-bbdb-4e32-b393-968b803b43d3",
    "source": "halit@opsgenie.com",
    "message": "OpsGenie test alert",
    "entity": "alertEntity",
    "updatedAt": 1456756398904000500,
    "username": "halit@opsgenie.com",
    "insertedAt": 1456756398904000500,
    "description": "test alert description",
    "tag": [
      "tag1",
      "tag2"
    ],
    "note": "test comment"      //only on AddNote action, note is put here as an example
  },
  "integrationName": "Datadog",
  "action": "Create",       //action can be Create, Close, AddNote or Acknowledge
  "integrationId": "2da74f28-3288-49e9-bad5-c97775e8b247",
  "source": {
    "name": "web",
    "type": "API"
  }
}

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

正確ではなかった

明確ではなかった

関係なかった

Jira Service Management サポート

Datadog と統合する

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

統合による機能

統合をセットアップする

Datadog 統合を追加する

Datadog で統合を設定する

Datadog から Jira Service Management に送信されたペイロードの例

Jira Service Management から Datadog に送信されたペイロードの例

その他のヘルプ