Opsgenie を Datadog と統合する

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

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

統合の機能性

Datadog は、定義された条件が一致したときにアラートをトリガーします。Datadog でアラートが作成されると、統合によって Opsgenie でもアラートが自動で作成されます。

テキスト内の Opsgenie サービスを@メンションすることで、Datadog UI から Opsgenie にアラートを作成します。

Opsgenie でアラートが承認されると、Datadog でもアラートが自動で承認されます。
Opsgenie でアラートがクローズされると、Datadog でもアラートが自動でクローズされます。
Opsgenie で任意のソース (Datadog 以外) からアラートが作成されると、Opsgenie はアラートを Datadog に投稿できます (オプション)。

コメントで Datadog の @opsgenie-acknowledge コマンドと @opsgenie-close コマンドを使用して、Datadogからのアラートを承認 (またはクローズ) します。

Opsgenie に Datadog インテグレーションを追加する

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

[チーム] に移動して自分のチームを選択します。
左側のナビゲーションで [統合] を選択し、[統合を追加] を選択します。

統合をチームダッシュボードから追加すると、そのチーム統合の所有者になります。Opsgenie では、この統合を通じて受信したアラートはそのチームのみに割り当てられます。このセクションの残りの手順に従って、統合を設定してください。

[設定] > [統合] の順に移動します。Datadog を検索して [追加] を選択します。
[応答者] フィールドによって Datadog アラートの通知先を指定します。入力し始めると、オートコンプリートの候補が表示されます。
Datadog の設定中に取得した Datadog API キーを貼り付けます。
Datadog EU のお客様の場合は、[Datadog EU に送信] ボックスを有効にします。
[Save Integration (統合の保存)] を選択します。

Datadog での設定

Datadog で、左ペインから [統合] > [統合] の順に選択します。
[利用可能] リストから [Opsgenie] を選択します。
[設定] タブを選択します。
統合の名前を入力して、Opsgenie からコピーした API キーを貼り付けます。
[Install Integration (統合をインストール)] をクリックします。

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

Datadog から Opsgenie に送信されるペイロードの例

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

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"
    }

このペイロードは Opsgenie によって次のように解析されます。

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"
    }

Opsgenie から 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"
  }
}

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

正確ではなかった

明確ではなかった

関係なかった

さらにヘルプが必要ですか?

アトラシアンコミュニティをご利用ください。

コミュニティに質問