Opsview と統合する

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

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

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

統合による機能

Opsview でホスト/サービスアラートが作成されると、統合により Jira Service Management でもアラートが自動的に作成されます。
Opsview でアラートがクローズされると、Jira Service Management でも対応するアラートが自動的にクローズされます。
Opsview でアラートが承認されると、Jira Service Management でも対応するアラートが自動的に承認されます。

統合をセットアップする

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

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

Opsview 統合を追加する

Jira Service Management の Free プランまたは Standard プランを使用している場合は、この統合はチームの運用ページからのみ追加できます。Settings (歯車のアイコン) > Products ([Jira 設定] の下) > OPERATIONS からこの機能にアクセスするには、Premium プランまたは Enterprise プランが必要です。

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

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

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

Opsview プラグインをインストールする

Opsview V6 以降

Red Hat ベースのディストリビューションの場合、Opsgenie Opsview プラグインをダウンロードします。
Debian ベースのディストリビューションの場合、Opsgenie Opsview プラグインをダウンロードします。

RedHat ベースのディストリビューションの場合

Opsgenie Opsview プラグインをダウンロードします。
次のコマンドを実行します。

テキスト

sudo rpm -i jsm-opsview-<your_version>.rpm
# for Opsview v6 and above
sudo rpm -i jsm-opsviewv6-<your_version>.rpm

Debian ベースのディストリビューションの場合

Opsgenie Opsview プラグインをダウンロードします。
次のコマンドを実行します。

テキスト

sudo dpkg -i jsm-opsview_<your_version>.deb
# for Opsview v6 and above
sudo dpkg -i jsm-opsviewv6_<your_version>.deb

環境変数 HTTP_PROXY=http://host:port を定義して、HTTP リクエストを送信するプロキシを使用する GO 言語の実行ファイルを設定します

Opsview で統合を設定する

Opsview と Jira Service Management の統合を設定するには、次の手順に従います。

Opsview Manager で、[Settings (設定)] > [Notification Methods (通知方法)] の順に移動します。
jsm という名前の新しい通知方法を定義します。
jsm のコマンドとして次のコマンドを貼り付けます。nagios2jsm -apiKey=d9a3b025-eb6b-4c6f-a043-046f330c00eb -jsmApiUrl=https://api.atlassian.com
[Submit Changes (変更を送信)] を選択します。

Opsview v6以降では、新しい通知方法を作成するときに、コマンドにスラッシュ文字 ("/") を使用できません。このため、Jira Service Management API URL の「https://」部分を削除する必要があります。

nagios2jsm 実行可能ファイルは次のフラグを受け入れます。

apiKey – nagios2jsm はこのキーを使用して Jira Service Management への認証を行います。API キーは、アラートの処理に使用する必要がある適切な統合設定を識別するためにも用いられます。
teams – [チーム] フィールドは、Opsview アラートを通知するチームを指定するために使用されます。
tags – tags フィールドは、Jira Service Management で作成されたアラートのタグを指定するために使用します。
logPath – ログファイルの完全なパスを指定します(既定値は /var/log/jsm/nagios2jsm.log)。
logLevel – 指定できる値は、デバッグ、情報、警告、エラーです。既定値は警告です。
jsmApiUrl – 別のドメインから Jira Service Management を使用している場合 (例: EU、サンドボックス) 、この設定を更新します。

追加のカスタム引数を送信する場合は、customArgName1 customArgValue1 customArgName2 customArgValue2 のようにフラグの後に追加します。入力フィールドの必要な場所に {{_payload.customArgName}} を追加して、カスタム引数を解析します。
動的プロパティに関する詳細はこちらをご確認ください。

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

JSON

{
  "NAGIOS_LASTHOSTPROBLEMID": "32",
  "NAGIOS_LASTSERVICECHECK": "1497942090",
  "NAGIOS_SERVICESTATE": "WARNING",
  "NAGIOS_HOSTALIAS": "Opsview Master S'erver ",
  "NAGIOS_SHORTDATETIME": "2017-06-20 07:01:30",
  "NAGIOS_SERVICESTATETYPE": "HARD",
  "NAGIOS_CONTACTPAGER": "NAGIOS_CONTACTPAGER",
  "NAGIOS_LONGHOSTOUTPUT": "NAGIOS_LONGHOSTOUTPUT",
  "NAGIOS_CONTACTALIAS": "Administrator",
  "NAGIOS_LASTSERVICECRITICAL": "1497942030",
  "NAGIOS_LASTSERVICESTATE": "WARNING",
  "NAGIOS_LASTHOSTSTATECHANGE": "1497889073",
  "NAGIOS_LONGSERVICEOUTPUT": "NAGIOS_LONGSERVICEOUTPUT",
  "NAGIOS_SERVICESTATEID": "1",
  "NAGIOS_LASTSERVICESTATECHANGE": "1497942030",
  "NAGIOS_SERVICENOTES": "Application - Opsview:Monitors how long it has been since housekeeping cronjob was successfully run ",
  "NAGIOS_SERVICENOTIFICATIONNUMBER": "0",
  "NAGIOS_HOSTGROUPNAME": "Monitoring Servers",
  "NAGIOS_HOSTDOWNTIME": "0",
  "NAGIOS_HOSTPROBLEMID": "0",
  "NAGIOS_LASTHOSTUNREACHABLE": "0",
  "NAGIOS_CONTACTGROUPLIST": "k4_opsview-components,hostgroup2_servicegroup3",
  "NAGIOS_SERVICEDURATION": "0d 0h 1m 0s",
  "NAGIOS_NOTIFICATIONCOMMENT": "NAGIOS_NOTIFICATIONCOMMENT",
  "NAGIOS_HOSTADDRESS": "localhost",
  "NAGIOS_LASTHOSTDOWN": "1497889073",
  "NAGIOS_SERVICEACKCOMMENT": "NAGIOS_SERVICEACKCOMMENT",
  "NAGIOS_CONTACTNAME": "admin/01receiveallalertsduringworkhours",
  "NAGIOS_HOSTSTATE": "UP",
  "NAGIOS_HOSTSTATEID": "0",
  "NAGIOS_LASTHOSTCHECK": "1497942030",
  "NAGIOS_NOTIFICATIONNUMBER": "0",
  "NAGIOS_HOSTACKAUTHOR": "NAGIOS_HOSTACKAUTHOR",
  "NAGIOS_LASTSERVICEPROBLEMID": "14",
  "NAGIOS_SERVICEDOWNTIME": "0",
  "NAGIOS_LASTHOSTUP": "1497942030",
  "NAGIOS_HOSTATTEMPT": "1",
  "NAGIOS_HOSTGROUPALIAS": "Monitoring Servers",
  "NAGIOS_LONGDATETIME": "Tue Jun 20 07:01:30 UTC 2017",
  "NAGIOS_HOSTACKCOMMENT": "NAGIOS_HOSTACKCOMMENT",
  "NAGIOS_CONTACTEMAIL": "dummy@localhost",
  "NAGIOS_HOSTDURATION": "0d 14h 43m 37s",
  "NAGIOS_HOSTNOTIFICATIONNUMBER": "0",
  "NAGIOS_HOSTOUTPUT": "OK - localhost: rta 0.016ms, lost 0%",
  "NAGIOS_HOSTSTATETYPE": "HARD",
  "NAGIOS_LASTHOSTSTATE": "UP",
  "NAGIOS_SERVICEACKAUTHOR": "NAGIOS_SERVICEACKAUTHOR",
  "NAGIOS_TIMET": "1497942090",
  "NAGIOS_LASTSERVICEOK": "1497941970",
  "NAGIOS_SERVICEOUTPUT": "CRONJOBS WARNING - Housekeeping cronjob stat file indicates the job has not run yet",
  "NAGIOS_SERVICEPROBLEMID": "78",
  "NAGIOS_NOTIFICATIONAUTHOR": "NAGIOS_NOTIFICATIONAUTHOR",
  "NAGIOS_LASTSERVICEWARNING": "1497942090",
  "NAGIOS_LASTSTATECHANGE": "NAGIOS_LASTSTATECHANGE",
  "NAGIOS_NOTIFICATIONTYPE": "FLAPPINGSTART",
  "NAGIOS_SERVICEATTEMPT": "3",
  "NAGIOS_SERVICEDESC": "Opsview Housekeeping Cronjob Monitor",
  "NAGIOS_HOSTNAME": "opsview",
  "apiKey": "token",
  "teams": "team1, team2",
  "tags": "tag1, tag2"
}

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

正確ではなかった

明確ではなかった

関係なかった

Jira Service Management サポート