• 製品
  • 使用を開始する
  • 関連ドキュメント
  • リソース

LibreNMS と統合する

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

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 統合を追加する

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

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

Jira Service Management で LibreNMS 統合を追加するには、次の手順に従います。

  1. チームの運用ページに移動します。

  2. 左側のナビゲーション パネルで、[統合]、[統合を追加] の順に選択します。

  3. 検索を実行して「LibreNMS」を選択します。

  4. 次の画面で、統合の名前を入力します。

  5. オプション: 特定のチームが統合からのアラートを受信するようにする場合は、[Assignee team (担当者チーム)] のチームを選択します。

  6. [続行] を選択します。
    この時点で、統合が保存されます。

  7. [統合を設定する手順] セクションを展開して、統合 URL をコピーします。
    この URL は、後ほど LibreNMS で統合を設定する際に使用します。

  8. [統合をオンにする] を選択します。
    統合のために作成したルールは、統合をオンにした場合にのみ機能します。

LibreNMS で統合を設定する

LibreNMS で統合を設定するには、次の手順に従います。

  1. LibreNMS でトップ・メニューの歯車アイコンから [グローバル設定] を開きます。

  2. [アラート設定] タブを選択します。

  3. リストで「Jira Service Management」を検索し、矢印をクリックして展開します。

  4. Webhook の URLを「Jira Service Management URL」フィールドに貼り付けます。

オプション: JEC 経由で統合する

Jira Edge Connector (JEC) と LibreNMS スクリプトを使用して、LibreNMS のアラートをアップデートします。これによって、独自のスクリプトや機能をデプロイして提供された機能を変更し、カスタマイズしたアクションを LibreNMS 上で実行できます。LibreNMS 統合パッケージを使用するには、次のセクションで説明されている手順に従います。

LibreNMS プラグイン・パッケージの最新バージョンをダウンロードします。プラグインのダウンロードとインストールの方法をご確認ください

インストール

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

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

1 rpm -i jsm-librenms-<your_version>.rpm

rpm パッケージのインストール中に、パッケージが廃止されたというエラーが表示された場合は、代わりに rpm -i jsm-librenms-<your_version>.rpm --nodeps をご利用ください。「インストール済みです」というエラーが表示された場合は、代わりに rpm -i jsm-librenms-<your_version>.rpm --force をご利用ください。

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

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

1 dpkg -i jsm-librenms-<your_version>.deb

Windows の場合

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\"" }

 

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

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