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 (担当者チーム)] のチームを選択します。
[Continue] を選択します。
この時点で、統合が保存されます。[統合を設定する手順] セクションを展開して、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't resolve host. The given remote host was not resolved.</li>\n<li>We could not connect to the API.</li>\n<li>Couldn't resolve host 'fhjpvdm2yutb.runscope.net%09'</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
}
この内容はお役に立ちましたか?