Checkmk と統合する

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

This article explains integrating Jira Service Management with Checkmk 1.5.0 and earlier versions. If you're using Checkmk 1.6.0 and above you can use a default Jira Service Management API integration to create this integration. Find out how to create a default API integration.

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

Jira Service Management の Checkmk 統合を使用して、Checkmk の通知を Jira Service Management に転送します。Jira Service Management は、オンコールスケジュールに基づいて通知すべき担当者を決定します。メール、テキストメッセージ（SMS）、電話、iOS や Android のプッシュ通知による通知を行い、アラートが承認またはクローズされるまでアラートをエスカレートします。

統合による機能

Checkmk でホストまたはサービスの状態がダウンすると、Jira Service Management でアラートが作成されます。
Checkmk で問題が承認されると、Jira Service Management でアラートが承認されます。
Checkmk で再度ホストの状態が「UP」になるか、サービスの状態が「OK」になると、Jira Service Management でアラートがクローズされます。

統合をセットアップする

Checkmk は API 統合です。セットアップは次の手順で行います。

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

Checkmk 統合を追加する

Bidirectional integrations aren’t supported in Free and Standard plans. All the other integrations are supported at a team level in Free and Standard; however, for their outgoing part to work, you need to upgrade to a higher plan. To add any integration at a site level through Settings (gear icon) > Products (under JIRA SETTINGS) > OPERATIONS, you need to be either on Premium or Enterprise.

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

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

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

Checkmk プラグインを設定する

Checkmk プラグインを設定するには、次の手順を実行します。

Checkmk 統合プラグインをダウンロードします。
次のコマンドを使用して、スクリプトに必要な権限を付与します。

sudo chmod +x jsm
プラグインを次にコピーします。
1. /omd/sites/[site name]/local/share/check_mk/notifications/（OMD バージョンを使用している場合）
2. /usr/share/check_mk/notifications（スタンドアロンバージョンを使用している場合）

Checkmk で統合を設定する

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

Checkmk で、[WATO Configuration (WATO の設定)] ボックスの左下にある [ユーザー] を選択します。
上部の [新規ユーザー] を選択します。
この新規ユーザーのユーザー名と氏名を入力します。
[認証] 部分を空白のままにして、[このアカウントへのログインを無効にする] をオンにします。
[ロール] の [通常の監視ユーザー] を選択します。
[保存] を選択します。
新しいユーザーを作成すると、「ユーザー」ページに再度リダイレクトされます。
新規作成したユーザーの [アクション] 列の下にある通知ボタンを選択します。
上部にある [新規ルール] を選択します。
[説明] には JSM と入力します。
Select JSM as the Notification Method.
Note: Due to an issue with Checkmk, you'll see two entries. The one which asks for Call with forwarding parameters is the correct one. Avoid using the one which asks for API key.
先ほどコピーした API URL を、[次のパラメーターで呼び出す：combobox] にあるテキストボックスにコピーします。
[保存] を選択します。
保存後、[WATO Configuration (WATO の設定)] ボックスの左下にある [メインメニュー] を選択します。
上部にある「# 変更」というラベルの付いたオレンジ色のボタンを選択します。
新しく開いたページの上部にある [変更をアクティブ化] を選択します。

Checkmk プラグインからの Webhook メッセージの例

JSON

{
    "LASTSERVICESTATECHANGE_REL": "0d 00:00:01",
    "LASTSERVICESTATE": "OK",
    "HOSTCHECKCOMMAND": "check-mk-host-smart",
    "HOSTSTATE": "UP",
    "LASTHOSTUP_REL": "0d 00:00:03",
    "HOSTNOTESURL": "",
    "SERVICEDESC": "CPU utilization",
    "SERVICEPERFDATA": "user=88.272;;;; system=11.728;;;; wait=0.000;;;; steal=0;;;; guest=0;;;;",
    "HOSTTAGS": "/wato/ cmk-agent ip-v4 ip-v4-only lan prod site:og tcp wato",
    "HOSTPERFDATA": "",
    "SERVICEATTEMPT": "1",
    "LASTHOSTSHORTSTATE": "UP",
    "NOTIFICATIONCOMMENT": "",
    "SERVICESHORTSTATE": "CRIT",
    "MAXSERVICEATTEMPTS": "1",
    "MAIL_COMMAND": "mail -s '\$SUBJECT\\\$' '\$CONTACTEMAIL\\\$'",
    "HOSTNAME": "localhost",
    "LASTHOSTSTATECHANGE": "1478611924",
    "SERVICESTATE": "CRITICAL",
    "SERVICEGROUPNAMES": "",
    "SERVICENOTESURL": "",
    "SERVICEACKCOMMENT": "",
    "HOST_TAGS": "/wato/ cmk-agent ip-v4 ip-v4-only lan prod site:og tcp wato",
    "SHORTDATETIME": "2016-11-10 13:20:42",
    "CONTACTPAGER": "",
    "LASTSERVICESTATECHANGE": "1478773242",
    "LONGSERVICEOUTPUT": "",
    "HOSTPROBLEMID": "0",
    "CONTACTNAME": "jiraservicemanagement",
    "LONGHOSTOUTPUT": "",
    "MONITORING_HOST": "ubuntu-pc",
    "HOSTATTEMPT": "1",
    "SERVICEFORURL": "CPU%20utilization",
    "WHAT": "SERVICE",
    "HOSTALIAS": "localhost",
    "SERVICE_EC_CONTACT": "",
    "SERVICEACKAUTHOR": "",
    "HOST_FILENAME": "/wato/hosts.mk",
    "SERVICECHECKCOMMAND": "check_mk-kernel.util",
    "LASTSERVICESTATEID": "0",
    "LASTSERVICEOK": "1478773181",
    "HOSTDOWNTIME": "0",
    "SERVICEPROBLEMID": "48",
    "HOST_SL": "",
    "NOTIFICATIONAUTHORALIAS": "",
    "HOST_ADDRESS_4": "127.0.0.1",
    "HOST_ADDRESS_6": "",
    "SERVICEOUTPUT": "CRIT - user: 88.3%, system: 11.7%, wait: 0.0%, steal: 0.0%, guest: 0.0%, total: 100.0% (warn/crit at 40.0%/60.0%)(!!)",
    "CONTACTALIAS": "jiraservicemanagement",
    "HOSTADDRESS": "127.0.0.1",
    "SERVICENOTIFICATIONNUMBER": "1",
    "SERVICEDOWNTIME": "0",
    "NOTIFICATIONAUTHORNAME": "",
    "HOSTGROUPNAMES": "check_mk",
    "HOSTSHORTSTATE": "UP",
    "HOSTNOTIFICATIONNUMBER": "1",
    "OMD_ROOT": "/omd/sites/og",
    "LASTHOSTSTATECHANGE_REL": "1d 20:48:39",
    "PREVIOUSHOSTHARDSTATEID": "0",
    "LASTSERVICESHORTSTATE": "OK",
    "CONTACTEMAIL": "",
    "PREVIOUSSERVICEHARDSHORTSTATE": "OK",
    "HOST_ADDRESS_FAMILY": "4",
    "HOSTACKAUTHOR": "",
    "HOSTURL": "/check_mk/index.py?start_url=view.py%3Fview_name%3Dhoststatus%26host%3Dlocalhost",
    "HOSTSTATEID": "0",
    "MICROTIME": "1478773242189620",
    "LASTSERVICEPROBLEMID": "48",
    "PREVIOUSSERVICEHARDSTATE": "OK",
    "SERVICEDISPLAYNAME": "CPU utilization",
    "NOTIFICATIONTYPE": "PROBLEM",
    "LOGDIR": "/omd/sites/og/var/check_mk/notify",
    "MAXHOSTATTEMPTS": "1",
    "OMD_SITE": "og",
    "HOSTACKCOMMENT": "",
    "PREVIOUSSERVICEHARDSTATEID": "0",
    "SERVICE_SL": "",
    "DATE": "2016-11-10",
    "HOSTOUTPUT": "Packet received via smart PING",
    "NOTIFICATIONAUTHOR": "",
    "HOSTFORURL": "localhost",
    "LASTHOSTSTATEID": "0",
    "SERVICESTATEID": "2",
    "LASTHOSTUP": "1478773240",
    "PREVIOUSHOSTHARDSTATE": "UP",
    "LASTSERVICEOK_REL": "0d 00:01:02",
    "HOSTCONTACTGROUPNAMES": "all",
    "HOST_EC_CONTACT": "",
    "SERVICECONTACTGROUPNAMES": "all",
    "CONTACTS": "jiraservicemanagement",
    "LASTHOSTPROBLEMID": "0",
    "SVC_SL": "",
    "LASTHOSTSTATE": "UP",
    "PREVIOUSHOSTHARDSHORTSTATE": "UP",
    "LONGDATETIME": "Thu Nov 10 13:20:42 +03 2016",
    "SERVICEURL": "/check_mk/index.py?start_url=view.py%3Fview_name%3Dservice%26host%3Dlocalhost%26service%3DCPU%20utilization"
}

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

正確ではなかった明確ではなかった関係なかった

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

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

コミュニティに質問