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 では、ホスト/サービスが復帰したときにアラートが自動的にクローズされます。

通常、ユーザーに通知するために使用されるショートテキストメッセージ (SMS) は、多くの場合、受信者が問題を評価して適切なアクションを決定するための十分な情報を伝達できません。Jira Service Management アラートは数百文字という文字数の制限を受けることなく、多くのフィールド、タグ、添付情報に利用できる機能を含められます。受信者はアラートメッセージだけでなく、すべてのサポート情報を確認して次に何をすべきかを把握できます。アラートに関連する情報をすべて添付して、API または 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 (担当者チーム)] のチームを選択します。
[続行] を選択します。
この時点で、統合が保存されます。
[統合を設定する手順] セクションを展開し、Webhook URL をコピーします。
この URL は、後ほど Circonus で統合を設定する際に使用します。
[統合をオンにする] を選択します。
統合のために作成したルールは、統合をオンにした場合にのみ機能します。

統合をカスタマイズする

Circonus 統合では、可能な限り簡単に統合できるように、適切な設定の既定値が使用されます。ただし、統合は次のようにカスタマイズできます。

異なるアラートについて異なるユーザーに通知するために、異なるルールを定義する
Circonus の Webhook ペイロードを使用してアラートのコンテンツを変更する

Circonus アラート Webhook ペイロードからの以下の変数は、フィルターを定義してアラートフィールドの値を設定する際に利用できます。

アラートタイプ
accountname
重大度
評価基準名
名前の確認
ホスト
エージェント
アラートの値
アラート時間
値をクリア
時間をクリア
アラート URL
メトリックのメモ

Circonus Webhook ペイロードの変数を使用して、フィルターで複数のルールを作成します。各ルールについて、アラートフィールドは異なる値を持つことができるため、通知対象者は異なります。

Jira Service Management を介して Circonus のアラートを承認 / 承認解除する

Circonus 統合は発信アクションにも対応しています。選択した場合、Jira Service Management で Circonus のアラートを承認 / 承認解除できるようになります。[Send alert Updates Back to Circonus (アラートの更新を Circonus に送り返す)] を選択します。使用可能なアクションが表示されます。次に、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"
}

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

正確ではなかった

明確ではなかった

関係なかった

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

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

コミュニティに質問