Opsgenie を Lamp ベース Nagios XI と統合する
インストールされ、適切に設定されると、Nagios XI通知が送信されたときに Opsgenieアラートが作成され、関連するホストまたはサービスに関係する追加情報 (ステータス、アラート ヒストグラム、トレンドなど) を添付します。この追加情報はアラートとともに、Opsgenie アプリで直接確認できます。
インストール
以下の手順では、Opsgenie の Nagios 統合プラグインを使用して、Opsgenie と Nagios XI を統合する方法を説明します。ご使用の Linux ディストリビューションと Nagios XI 設定によっては、これらの指示に若干の変更が必要になる場合があることにご注意ください。
This document contains only specific instructions for deprecated Nagios integration. For other steps please refer to the new Nagios Integration's document.
前提条件
パッケージは Red Hat および Debian ベースの Linux ディストリビューション用に提供されます。Opsgenie Nagios XI プラグインは Java アプリケーションであるため、Java Runtime バージョン 1.6 以上が必要ですオープン JDK と Oracle JVM の両方を使用できます。あなたの環境で定義された JAVA_HOME 環境変数が必要です。
JAVA_HOME 環境変数が設定されていることを確認します。そうでない場合は、/etc/opsgenie/profile ファイルの次の行の先頭にあるコメントを削除して設定し、JAVA_HOME を JRE インストール ディレクトリに設定します。
#JAVA_HOME=<path/to/JDK or JRE/install>
Opsgenie で Nagios XI 統合を追加する
To add Nagios XI integration in Opsgenie, go to Settings > Integrations. Search for Nagios XI, then select Add.
Edit the integration detail, then select Save integration. We’ll generate an API key for this integration. This key will be used by Nagios XI to authenticate with Opsgenie and specify the integration that should be used to process Nagios XI alerts.
Opsgenie Nagios プラグインの設定
プラグインは、Opsgenie でアラートを作成、確認、クローズするために lamp (プラグインに含まれる) を使用します。lamp は、HTTPS 経由で Opsgenie サービスと連動するコマンド ライン ユーティリティです。lamp は、アラートを操作したり、ポリシーや統合を有効/無効にしたりするために使用できます。Nagios XI は、Opsgenie でアラートを作成、確認、クローズするために lamp を使用するように設定されています。
Lamp 設定パラメーターは、/etc/opsgenie/conf/opsgenie-integration.conf ファイルにあります。
設定パラメーター |
| 入力必須 |
|---|---|---|
API キー | 上記で作成した Nagios XI 統合から API キーをコピーします。Lamp はこのキーを使用して Opsgenie への認証を行います。API キーは、lamp によって転送されたアラートの処理に使用する必要がある適切な統合構成を識別するためにも用いられます。 | はい |
nagios.nagiosServer | "nagiosServer" フィールドは Opsgenie で Nagios XI サーバーを識別するために使用されます。複数の Nagios XI サーバーがある場合にのみ必要です。このフィールドは、ユーザーによって実行されたアクション (承認、クローズなど) を Opsgenie が Nagios XI サーバーに送り返すときに使用されます。 | 任意 |
nagios.attachFiles | アラートへのヒストグラムとトレンド画像の添付を有効/無効にします。 | 任意 |
nagios.alert_histogram_image_url | Nagios ヒストグラム画像を取得するためのURL。localhost をあなたの Nagios サーバーのアドレスに置き換える必要があります。 | 任意 |
nagios.trends_image_url | Nagiosトレンド画像を取得するためのURL。localhost をあなたの Nagios サーバーのアドレスに置き換える必要があります。 | 任意 |
nagios.command_url | アラートが承認されたとき、コメントを受け取ったときなどに Nagios XI アラートをアップデートするための URL | 任意 |
nagios.user | Nagios ヒストグラムとトレンド画像を取得するために、Nagios web サーバーを認証する資格情報。資格情報を取得するには、以下の手順に従ってください。 | 任意 |
nagios.http.timeout | Nagios ヒストグラムとトレンド画像を取得するためのタイムアウト時間 (ミリ秒)。 | 任意 |
シェル スクリプトですべてのロジックを実装する代わりに、統合パッケージはスクリプト (/var/opsgenie/lamp/scripts/ogCreateAlert.groovy) を提供します。groovy で書かれ、強力な JAVA ベースのスクリプト言語を lamp で実行することができます。要するに、スクリプトは Opsgenie アラートを作成し、Nagios XI PHPを介して、アラート ヒストグラムと関連するホストまたはサービスのトレンドを取得し、通知が発生したときにエンティティのステータスを表示する HTML ファイルを作成し、アラートに添付します。スクリプトはそのまま動作しますが、必要に応じてさらにカスタマイズできます。
トラブルシューティング ガイド
統合が期待通りに機能する場合、Nagios XIでホストまたはサービスの状態がダウンすると、Opsgenie でアラートが作成されます。ホストやサービスが復帰すると、Opsgenie のアラートも自動的にクローズします。
lamp が Opsgenie にアクセスできることを確認する
Opsgenie でシェルから lamp を使用してテスト アラートを作成します。
テキスト
lamp createAlert --message "nagios test alert" --recipients nobody
Check whether the alert is created in Opsgenie. If not, check the logs for lamp utility in the /var/log/opsgenie/lamp directory for any error messages. If you see "JAVA_HOME not defined" error in opsgeniescripter or opsgeniescriptout logs, you should define it in /etc/opsgenie/profile shell script.
Verify Nagios XI is able to create alerts in Opsgenie
Check whether there are alert from Nagios XI in Opsgenie. If Nagios XI is generating alerts, but alerts are not being created in Opsgenie, check the logs for lamp utility in the /var/log/opsgenie/lamp directory for any error messages.
ログがない場合は、Nagios ユーザーが /var/log/opsgenie/lamp ディレクトリへの書き込み権限を持っていることを確認してください。
Verify graphs are attached to the alerts
Plugin retrieves relevant graphs from the Nagios XI server via HTTP(S) and attaches them to the alert. If the alerts in Opsgenie do not include these graphs as attached files, it may be due to the plugin not able to access to the Nagios XI server. Check whether the specified URLs in the configuration file are correct. Check whether these files can be retrieved using curl, etc.
/var/log/opsgenie/lamp ディレクトリにある lamp ユーティリティのログをチェックして、エラー メッセージがないかどうかを確認します。
この内容はお役に立ちましたか?