Icinga と統合する

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

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

Jira Service Management の Icinga プラグインは、Icinga との双方向の統合をサポートしています。この統合は Jira Service Management の Icinga 固有の実行可能ファイルと JEC ユーティリティを活用して、リッチ・アラート (ステータス、アラート・ヒストグラム、トレンドなど) を自動で作成して Icinga と Jira Service Management の間でアラートのステータスを同期します。

統合をセットアップする

Icinga 統合プラグインは、Jira Service Management の全機能を活用して Icinga との双方向の統合を提供します。以下の手順では、Icinga 統合プラグインを使用して、Jira Service Management と Icinga を統合する方法を説明します。ご使用の Linux ディストリビューションと Icinga の設定によっては、これらの手順に若干の変更が必要になる場合があることに注意してください。

インストールの必須条件

インストールパッケージは、以下のシステムをサポートしています。

RedHat ベースの Linux ディストリビューション
Debian ベースの Linux ディストリビューション

Icinga 用 Jira Service Management プラグインをインストールする

Jira Edge Connector (略称 JEC) は Icinga 統合の送信認証を設定するための前提条件です。JEC と Icinga のスクリプトを組み合わせて使用して、Icinga のアラートをアップデートできます。このセットアップにより、Icinga 上で独自のスクリプトをデプロイしたり、提供されたスクリプトを変更したり、カスタマイズしたアクションを実行したりできます。Icinga パッケージの最新バージョンは、このリポジトリからダウンロードしてください。

RedHat ベースのディストリビューションに関する手順

次のコマンドを実行します。

rpm -i jsm-icinga-<your_version>.rpm

rpm をアップグレードする前に、設定ファイルをバックアップします。

rpm パッケージは、アップグレード中に既存の設定を上書きしません。新しい既定の設定ファイルは integration.conf.rpmnew として保存されます。バージョン 201X-XX-XX から 2.X.X にアップグレードするには、--force パラメーターを追加します。例: rpm -U --force jsm-icinga-<your_version>.rpm

rpm アップグレードの設定ファイル処理に関する詳細をご確認ください。

Debian ベースのディストリビューションに関する手順

次のコマンドを実行します。

dpkg -i jsm-icinga-<your_version>.deb

Icinga 統合を追加する

双方向統合は Free プランと Standard プランではサポートされていません。他のすべての統合は Free と Standard でチームレベルでサポートされています。ただし、送信統合を機能させるには、上位のプランにアップグレードする必要があります。Settings (歯車アイコン) > Products (Jira 設定の下) > OPERATIONS からサイトレベルで統合を追加できるのは、Premium プランと Enterprise プランのみです。

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

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

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

Icinga で Jira Service Management プラグインを設定する

プラグインは golang 実行可能ファイル (send2jsm としてプラグインに含まれます) を使用して、Jira Service Management でアラートを作成、承認、クローズします。Jira Service Management でアラートを作成、承認、クローズするために、イベントでこのファイルを実行するように Icinga を設定します。次の表は、パラメーターと、それらが必須かどうかの状態を示しています。

設定パラメー�