Jira Service Management の管理者向けの利用開始ガイド
最初に、Jira Service Management の使用を開始する方法を確認します。
LibreNMS と統合する
この記事では、Jira Service Management Cloud の一部のお客様に段階的に展開されている、Jira Service Management でネイティブに利用できる新しいアラート機能を取り上げています。ご利用のサイトにはまだ表示されていないか、利用できない可能性があります。
統合でできるようになること
Jira Service Management の LibreNMS 統合を使用して、LibreNMS は詳細情報と共にアラートを Jira Service Management に転送します。Jira Service Management は LibreNMS アラートのディスパッチャーとして機能し、オンコール スケジュールに基づいて通知すべき担当者を決定します。メール、テキスト・メッセージ (SMS)、電話、iOS や Android のプッシュ通知による通知を行い、アラートが承認またはクローズされるまでアラートをエスカレーションします。
統合による機能
LibreNMS でアラートがトリガーされると、Jira Service Management でアラートが作成されます。
LibreNMS でアラートが承認されると、Jira Service Management でアラートが承認されます。
アラートが LibreNMS でクローズされると、Jira Service Management アラートもクローズされます。
[Send Alert Updates Back to LibreNMS (アラートのアップデートを LibreNMS に返送する)] が有効になっている場合は、LibreNMS 統合によって作成されたアラートに対して選択したアクションが Jira Service Management で実行される際に、LibreNMS のアクションが LibreNMS で実行されます。(オプション)
統合をセットアップする
LibreNMS は双方向の統合です。設定は次の手順で行います。
Jira Service Management で LibreNMS 統合を追加する
LibreNMS で統合を設定する
LibreNMS 統合を追加する
Jira Service Management の Free プランまたは Standard プランを使用している場合は、この統合はチームの運用ページからのみ追加できます。Settings (歯車のアイコン) > Products ([Jira 設定] の下) > OPERATIONS からこの機能にアクセスするには、Premium プランまたは Enterprise プランが必要です。
統合をチームの運用ページから追加すると、そのチームが統合の所有者になります。つまり、Jira Service Management は、この統合を通じて受信したアラートをチームにのみ割り当てます。
Jira Service Management で LibreNMS 統合を追加するには、次の手順に従います。
チームの運用ページに移動します。
左側のナビゲーション パネルで、[統合]、[統合を追加] の順に選択します。
検索を実行して「LibreNMS」を選択します。
次の画面で、統合の名前を入力します。
オプション: 特定のチームが統合からのアラートを受信するようにする場合は、[Assignee team (担当者チーム)] のチームを選択します。
[続行] を選択します。
この時点で、統合が保存されます。[統合を設定する手順] セクションを展開して、統合 URL をコピーします。
この URL は、後ほど LibreNMS で統合を設定する際に使用します。[統合をオンにする] を選択します。
統合のために作成したルールは、統合をオンにした場合にのみ機能します。
LibreNMS で統合を設定する
LibreNMS で統合を設定するには、次の手順に従います。
LibreNMS でトップ・メニューの歯車アイコンから [グローバル設定] を開きます。
[アラート設定] タブを選択します。
リストで「Jira Service Management」を検索し、矢印をクリックして展開します。
Webhook の URLを「Jira Service Management URL」フィールドに貼り付けます。
オプション: JEC 経由で統合する
Jira Edge Connector (JEC) と LibreNMS スクリプトを使用して、LibreNMS のアラートをアップデートします。これによって、独自のスクリプトや機能をデプロイして提供された機能を変更し、カスタマイズしたアクションを LibreNMS 上で実行できます。LibreNMS 統合パッケージを使用するには、次のセクションで説明されている手順に従います。
LibreNMS プラグイン・パッケージの最新バージョンをダウンロードします。プラグインのダウンロードとインストールの方法をご確認ください。
インストール
RedHat ベースのディストリビューションの場合
次のコマンドを実行します。
1
rpm -i jsm-librenms-<your_version>.rpmrpm パッケージのインストール中に、パッケージが廃止されたというエラーが表示された場合は、代わりに rpm -i jsm-librenms-<your_version>.rpm --nodeps をご利用ください。「インストール済みです」というエラーが表示された場合は、代わりに rpm -i jsm-librenms-<your_version>.rpm --force をご利用ください。
Debian ベースのディストリビューションの場合
次のコマンドを実行します。
1
dpkg -i jsm-librenms-<your_version>.debWindows の場合
JEC パッケージを含む統合 zip ファイルをディレクトリ内に解凍します (C:\jsm\jec が推奨パス)。JEC の実行に関する詳細をご確認ください。
JEC 用に統合を設定する
JEC ユーティリティを使用するには、[Authenticate with Jira Edge Connector only (Jira Edge Connector のみで認証)] を選択します。LibreNMS に関するその他の設定は、統合ページ、または JEC 構成ファイル config.json を介して行うことができます。統合ページを介した設定は、設定ファイルより優先されます。
設定パラメーター
次のフィールドはすべて入力が必須です。
apiKey: 以前にコピーした LibreNMS 統合 URL から API キーをコピーします。
url: LibreNMS サーバーの URL。
apiToken: LibreNMS サーバーの API トークン。
ダウンロードしたパッケージには、/usr/local/bin にある JEC ユーティリティと、/home/jsm/jec/scripts にある JEC によって実行する必要があるスクリプトも含まれています。JEC の設定が完了したら、JEC を実行する必要があります。JECの実行に関する詳細をご確認ください。
JEC に送信されるパラメーターの例
JSON
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
{
"type": "libreNMS",
"alertId": "f3b3475f-3859-4bd1-b472-ab339ea1e61d",
"customerId": "4a644594-240d-4a51-ab88-0171ed29c0ce",
"action": "Acknowledge",
"mappedActionV2": {
"name": "ackAlert",
"extraField": ""
},
"integrationId": "1334572c-f412-428c-9ab1-607f8313fba3",
"integrationName": "LibreNMS",
"integrationType": "LibreNMS",
"sendViaJEC": true,
"alertFlowContext": {
"requestId": "9eb36837-e601-12da-92ba-8fe3224230ad",
"traceId": "9eb36837-e601-12da-92ba-8fe3224230ad",
"content": {
"alertId": "f3b3475f-3859-4bd1-b472-ab339ea1e61d"
}
},
"url": "",
"apiToken": "",
"rule": "%macros.device_up = \"1\" && %processors.processor_usage >= \"1\""
}
この内容はお役に立ちましたか?