APImetrics と統合する

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

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

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

統合による機能

API 呼び出しエラーまたは警告が APImetrics でキャプチャされると、Jira Service Management でアラートが作成されます。

統合をセットアップする

APImetrics は API 統合です。設定は次の手順で行います。

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

APImetrics 統合を追加する

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

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

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

チームの運用ページに移動します。
左側のナビゲーションパネルで、[統合]、[統合を追加] の順に選択します。
検索を実行して [APImetrics] を選択します。
次の画面で、統合の名前を入力します。
オプション: 特定のチームが統合からのアラートを受信するようにする場合は、[Assignee team (担当者チーム)] のチームを選択します。
[続行] を選択します。
この時点で、統合が保存されます。
[統合を設定するステップ] セクションを展開して、API URL をコピーします。
この URL は、後ほど APImetrics で統合を設定する際に使用します。
[統合をオンにする] を選択します。
統合のために作成したルールは、統合をオンにした場合にのみ機能します。

APImetrics で統合を設定する

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

APImetrics で、[Alerts & Webhooks (アラートと Webhook)] に移動します。
[タイプ] として [一般] を選択します。
[有効] を選択したままにします。
[Trigger alerts (アラートのトリガー)] で [All selected (すべて選択)] を選択したままにします。
以前に Jira Service Management からコピーした統合 URL を [API URL] に貼り付けます。
[保存] を選択します。

APImetrics からの Webhook メッセージの例

JSON

{
  "response_size": 0,
  "location_id": "public_googleuscentral1",
  "result_class": "WARNING",
  "call_id": "agpzfnZpYXRlc3RzchcLEgpUZXN0U2V0dXAyGICAsJ7Bl7UKDA",
  "result_url": "http://client.apimetrics.io/tests/result/agpzfnZpYXRlc3RzchgLEgtUZXN0UmVzdWx0MxiAgLCe1LCjCQw/",
  "result": "DOWNLOAD_ERROR",
  "context": {
    "_result_category": "WARNING",
    "_result_streak": 1,
    "_notification": {
      "category": "WARNING",
      "owners": [
        "agpzfnZpYXRlc3RzchELEgRVc2VyGICAsO6ThqAKDA"
      ],
      "viewed_by": [],
      "title": "[WARNING]: APImetrics: All Failures: Test 2018-05-11 13:46:46.075200",
      "created": "2018-05-11T13:47:06.393630Z",
      "last_update": "2018-05-11T13:47:06.484100Z",
      "references": [
        "agpzfnZpYXRlc3RzchcLEgpUZXN0U2V0dXAyGICAsJ7Bl7UKDA",
        "agpzfnZpYXRlc3RzchgLEgtUZXN0UmVzdWx0MxiAgLCe1LCjCQw"
      ],
      "description": "\n<p>\nAPI Call <a href=\"http://client.apimetrics.io/tests/test/agpzfnZpYXRlc3RzchcLEgpUZXN0U2V0dXAyGICAsJ7Bl7UKDA/\">\"Test 2018-05-11 13:46:46.075200\"</a> has failed :\n<ul>\n<li><b>We could not connect to the API.</b></li>\n\n<li>Calling GET https://fhjpvdm2yutb.runscope.net%09</li>\n<li>Checking for connection issue...</li>\n<li>... no problem found.</li>\n<li>Couldn&#39;t resolve host. The given remote host was not resolved.</li>\n<li>We could not connect to the API.</li>\n<li>Couldn&#39;t resolve host &#39;fhjpvdm2yutb.runscope.net%09&#39;</li>\n\n</ul>\n</p>\n\n\n</p>\n\n<p>\nView details here:\n<a href=\"http://client.apimetrics.io/tests/result/agpzfnZpYXRlc3RzchgLEgtUZXN0UmVzdWx0MxiAgLCe1LCjCQw/\">http://client.apimetrics.io/tests/result/agpzfnZpYXRlc3RzchgLEgtUZXN0UmVzdWx0MxiAgLCe1LCjCQw/</a>\n</p>\n\n<p>Sincerely,<br>\nAPImetrics Team\n</p>\n"
    }
  },
  "result_id": "agpzfnZpYXRlc3RzchgLEgtUZXN0UmVzdWx0MxiAgLCe1LCjCQw",
  "call_url": "http://client.apimetrics.io/tests/test/agpzfnZpYXRlc3RzchcLEgpUZXN0U2V0dXAyGICAsJ7Bl7UKDA/",
  "response_time": 0
}

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

正確ではなかった

明確ではなかった

関係なかった

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

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

コミュニティに質問