• 製品
  • 使用を開始する
  • 関連ドキュメント
  • リソース

Datadog と統合する

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

Datadog のロゴ

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

Jira Service ManagementDatadog とのネイティブで強力な双方向統合を備えています。統合を使用して 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 ManagementDatadog 統合を追加する

  • Datadog で統合を設定する

Datadog 統合を追加する

双方向統合は Free プランと Standard プランではサポートされていません。他のすべての統合は FreeStandard でチーム レベルでサポートされています。ただし、送信統合を機能させるには、上位のプランにアップグレードする必要があります。Settings (歯車アイコン) > Products (Jira 設定の下) > OPERATIONS からサイト レベルで統合を追加できるのは、Premium プランと Enterprise プランのみです。

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

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

  1. チームの運用ページに移動します。

  2. 左側のナビゲーション パネルで、[統合]、[統合を追加] の順に選択します。

  3. 検索を実行して「Datadog」を選択します。

  4. 次の画面で、統合の名前を入力します。

  5. オプション: 特定のチームが統合からのアラートを受信するようにする場合は、[Assignee team (担当者チーム)] のチームを選択します。

  6. [続行] を選択します。
    この時点で、統合が保存されます。

  7. 統合設定ページの [Edit (編集)] に移動します。
    [Edit integration settings (統合設定を編集)] ダイアログが開きます。

  8. [Authenticate with a Datadog account (Datadog アカウントで認証)] を選択します。

  9.  Datadog API キーを [Datadog API key (Datadog API キー)] に貼り付けます。

  10. [統合を設定する手順] セクションを展開して、API キーをコピーします。
    このキーは、後ほど Datadog で統合を設定する際に使用します。

  11. [統合をオンにする] を選択します。
    統合のために作成したルールは、統合をオンにした場合にのみ機能します。

Datadog で統合を設定する

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

  1. Datadog で [Integrations (統合)] > [Integrations (統合)] の順に選択します。

  2. [Opsgenie] を選択します。

  3. [Configuration (設定)] タブを開きます。

  4. 以前に Jira Service Management からコピーした API キーを、[Service Key (apiKey) (サービス キー (apiKey))] の下のテキスト フィールドに貼り付けます。

  5. サービス名を入力します。

  6. [Install Integration (統合をインストール)] を選択します。

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

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

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

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

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 [ "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

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 { "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

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 { "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

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

 

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

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