LibreNMS と統合する
統合でできるようになること
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 統合を追加する
The following capabilities are available in Jira Service Management Premium and Enterprise:
双方向の統合
Outgoing integrations at the team level
Integrations at a site level through Settings (icon) > Products (under Jira settings) > Operations
To access Jira Service Management Premium features, you must subscribe to a Service Collection Premium or Enterprise plan.
Adding an integration from your team’s operations page makes your team the owner of the integration. This means Jira Service Management only assigns the alerts received through this integration to your team.
Jira Service Management で LibreNMS 統合を追加するには、次の手順に従います。
Next to Operations in the sidebar, select More actions (), then General configuration.
Select Integrations and then Add integration.
検索を実行して「LibreNMS」を選択します。
次の画面で、統合の名前を入力します。
オプション: 特定のチームが統合からのアラートを受信するようにする場合は、[Assignee team (担当者チーム)] のチームを選択します。
[Continue] を選択します。
この時点で、統合が保存されます。「統合を設定する手順」セクションを展開して、統合 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 ベースのディストリビューションの場合
次のコマンドを実行します。
rpm -i jsm-librenms-<your_version>.rpmrpm パッケージのインストール中に、パッケージが廃止されたというエラーが表示された場合は、代わりに rpm -i jsm-librenms-<your_version>.rpm --nodeps をご利用ください。「インストール済みです」というエラーが表示された場合は、代わりに rpm -i jsm-librenms-<your_version>.rpm --force をご利用ください。
Debian ベースのディストリビューションの場合
次のコマンドを実行します。
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 に関するその他の設定は、統合ページ、または OEC 構成ファイルの 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
{
"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\""
}
この内容はお役に立ちましたか?