Circonus と統合する
この記事では、Jira Service Management Cloud の一部のお客様に段階的に展開されている、Jira Service Management でネイティブに利用できる新しいアラート機能を取り上げています。ご利用のサイトにはまだ表示されていないか、利用できない可能性があります。
統合でできるようになること
Circonus のユーザーは、Jira Service Management を利用して、Circonus からだけでなく他のソースからもアラートを集約して管理できます。Jira Service Management を使用すると、ユーザーはそれぞれ独自の通知情報と設定を維持でき、複数の異なるツールでこの情報を最新かつ正確に保つための負担が排除されます。
この統合により、Circonus ユーザーに完全なアラート ライフサイクル管理機能が提供されます。Jira Service Management を使用して、Circonus によって検出されたクリティカルな問題の通知を受信するだけでなく、アラートを受信する時間や場所を問わず、アラートの承認、アラートの所有権の取得または割り当て、アラートへのコメントの追加などを迅速に行うことができます。Jira Service Management では、すべてのアラート アクティビティがシームレスに追跡されます。アクティビティには、アラートがいつ作成されたか、誰にいつどのような方法で通知されたか、受信者がアラートを認識して承認したかどうか、またいつ承認したか、誰がどのようなアクションを実行したかなどがあります。また、Jira Service Management では、ホスト/サービスが復帰したときにアラートが自動的にクローズされます。
A short text message (SMS) is typically used to notify users often fails to convey sufficient information to enable the recipients to assess the problem and determine the right course of action. Jira Service Management alerts are not limited to couple hundred characters of text, and include many fields, tags, and capability for attached information. Recipients not only see the alert message, but all the supporting information, to figure out what to do next. Attach any information that is relevant to the alert and make it available to the recipients either via the API or the web UI.
統合による機能
Circonus によってアラートがトリガーされると、統合を通じて Jira Service Management でアラートが自動的に作成されます。
アラート条件が無効になると、Circonus は Jira Service Management に別の HTTP POST リクエストを行い、 Jira Service Management は自動的にアラートをクローズします。
Jira Service Management によってアラートが承認 / 承認解除された場合、アラートは Circonus でも自動的に承認 / 承認解除されます (オプション)。
統合をセットアップする
Circonus は双方向の統合です。設定は次の手順で行います。
Jira Service Management で Circonus 統合を追加する
Circonus で統合を設定する
Circonus 統合を追加する
双方向統合は Free プランと Standard プランではサポートされていません。他のすべての統合は Free と Standard でチーム レベルでサポートされています。ただし、送信統合を機能させるには、上位のプランにアップグレードする必要があります。Settings (歯車アイコン) > Products (Jira 設定の下) > OPERATIONS からサイト レベルで統合を追加できるのは、Premium プランと Enterprise プランのみです。
統合をチームの運用ページから追加すると、そのチームが統合の所有者になります。つまり、Jira Service Management は、この統合を通じて受信したアラートをチームにのみ割り当てます。
Jira Service Management で Circonus 統合を追加するには、次の手順を実行します。
チームの運用ページに移動します。
左側のナビゲーション パネルで、[統合] > [統合を追加] の順に選択します。
検索を実行して [Circonus] を選択します。
次の画面で、統合の名前を入力します。
オプション: 特定のチームが統合からのアラートを受信するようにする場合は、[Assignee team (担当者チーム)] のチームを選択します。
[Continue] を選択します。
この時点で、統合が保存されます。[統合を設定する手順] セクションを展開して Webhook URL をコピーします。
この URL は、後ほど Circonus で統合を設定する際に使用します。[統合をオンにする] を選択します。
統合のために作成したルールは、統合をオンにした場合にのみ機能します。
統合をカスタマイズする
Circonus 統合では、可能な限り簡単に統合できるように、適切な設定の既定値が使用されます。ただし、統合は次のようにカスタマイズできます。
異なるアラートについて異なるユーザーに通知するために、異なるルールを定義する
Circonus の Webhook ペイロードを使用してアラートのコンテンツを変更する
Circonus アラート Webhook ペイロードからの以下の変数は、フィルターを定義してアラート フィールドの値を設定する際に利用できます。
アラート タイプ
accountname
重大度
評価基準名
名前の確認
ホスト
エージェント
アラートの値
アラート時間
値をクリア
時間をクリア
アラート URL
メトリックのメモ
Circonus Webhook ペイロードの変数を使用して、フィルターで複数のルールを作成します。各ルールについて、アラートフィールドは異なる値を持つことができるため、通知対象者は異なります。
Jira Service Management を介して Circonus のアラートを承認 / 承認解除する
The Circonus integration provides outgoing actions, too. If chosen, Jira Service Management can acknowledge/unacknowledge alerts in Circonus. Select Send alert Updates Back to Circonus. Available actions are visible. Then choose the actions to send back to Circonus.
Circonus で Webhook を設定する
Circonus と Jira Service Management の統合を設定するには、次の手順に従います。
Circonus のロゴの横にある **メニューに移動します。
[連絡先グループ] をクリックします。
[NEW CONTACT GROUP + (新しい連絡先グループ +)] をクリックします。
連絡先グループの名前を入力します。
[Use Third Party (サードパーティを使用)] ドロップダウン メニューから [Opsgenie] を選択します。
前にコピーした API URL を [Opsgenie API URL] に貼り付けます。
[保存] を選択します。
[Webhook URL] から URL をコピーし、統合設定ページの [Circonus Webhook URL] に貼り付けます。
アラートをトリガーするルールセットを作成し、それに新しい連絡先グループを追加します。
Circonus から Jira Service Management に送信されるペイロードの例
JSON
{
"check_name": "54.214.23.46 http",
"metric_link": null,
"check_id": 81313,
"alert_value": "212.0",
"check_bundle_id": 60426,
"alert_url": "https://circonus.com/account/opsgenie/fault-detection?alert_id=7438967",
"host": "54.214.23.46",
"metric_notes": "METRIC NOT",
"alert_time": "Fri, 24 Jan 2014 18:17:37",
"clear_time": "Fri, 24 Jan 2014 18:23:36",
"metric_name": "duration",
"clear_value": "220.0",
"agent": "Ashburn, VA, US",
"severity": "2",
"alert_id": "7438967",
"account_name": "opsgenie"
}
Jira Service Management ではペイロードは次のように解析されます。
JSON
{
"check_name": "54.214.23.46 http",
"alert_value": "212.0",
"alert_url": "https://circonus.com/account/opsgenie/fault-detection?alert_id=7438967",
"host": "54.214.23.46",
"metric_notes": "METRIC NOT",
"alert_time": "Fri, 24 Jan 2014 18:17:37",
"clear_time": "Fri, 24 Jan 2014 18:23:36",
"metric_name": "duration",
"clear_value": "220.0",
"agent": "Ashburn, VA, US",
"severity": "2",
"alert_id": "7438967",
"account_name": "opsgenie"
}
Jira Service Management から Circonus に送信されるペイロードの例
確認アクションのペイロードの例
JSON
{
"source":{
"name":"",
"type":"web"
},
"alert":{
"updatedAt":1420452224764002246,
"tags": [
"tag1", "tag2"
],
"message":"test alert",
"username":"fili@ifountain.com",
"alertId":"052652ac-5d1c-464a-812a-7dd18bbfba8c",
"source":"fili@ifountain.com",
"alias":"aliastest",
"tinyId":"23",
"createdAt":1420452191104,
"userId":"daed1180-0ce8-438b-8f8e-57e1a5920a2d",
"entity":"",
"alert_id":64657364
},
"action":"Acknowledge",
"integrationId":"37c8f316-17c6-49d7-899b-9c7e540c048d",
"integrationName":"Integration1"
}
承認解除アクションのペイロードの例
JSON
{
"source":{
"name":"",
"type":"web"
},
"alert":{
"updatedAt":1420452224764002246,
"tags": [
"tag1", "tag2"
],
"message":"test alert",
"username":"fili@ifountain.com",
"alertId":"052652ac-5d1c-464a-812a-7dd18bbfba8c",
"source":"fili@ifountain.com",
"alias":"aliastest",
"tinyId":"23",
"createdAt":1420452191104,
"userId":"daed1180-0ce8-438b-8f8e-57e1a5920a2d",
"entity":"",
"alert_id":64657364
},
"action":"UnAcknowledge",
"integrationId":"37c8f316-17c6-49d7-899b-9c7e540c048d",
"integrationName":"Integration1"
}
この内容はお役に立ちましたか?