Opsgenie を Zenoss と統合する

Opsgenie が Zenoss ユーザーに提供するもの

Opsgenie の Zenoss 統合プラグインは、Opsgenie の全機能を活用して Zenoss との双方向統合を提供します。統合では、Opsgenie の Zenoss 固有の実行可能ファイルと OEC ユーティリティを活用して、アラートを自動で作成して Zenoss と Opsgenie の間でアラート ステータスを同期します。

インストール

以下の手順では、Opsgenie の Zenoss インテグレーション プラグインを使用して、Opsgenie と Zenoss を統合する方法を説明します。ご使用の Linux ディストリビューションと Zenoss の設定によっては、これらの指示に若干の変更が必要になる場合があることに注意してください。

前提条件

提供されるパッケージは、以下のシステムをサポートしています。

• Red Hat ベースの Linux ディストリビューション

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

Opsgenie Zenoss プラグインのインストール

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

• 次のコマンドを実行します。 rpm -i opsgenie-zenoss-<your_version>.rpm

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

• 次のコマンドを実行します。 dpkg -i opsgenie-zenoss-<your_version>.deb

Opsgenie で Zenoss インテグレーションを追加する

1. [設定] > [統合] の順に移動します。Zenoss を検索して [追加] を選択します。

2. [応答者] フィールドによって Sentry アラートの通知先を指定します。入力し始めると、オートコンプリートの候補が表示されます。

3. API キーをコピーします。

4. [Save Integration (統合の保存)] を選択します。

Zenoss での Opsgenie プラグイン設定

プラグインは golang-executable ファイル (send2opsgenie としてプラグインに含まれる) を使用して、Opsgenie でアラートを作成、承認、クローズします。send2opsgenie を動作させるには、いくつかの設定を行う必要があります。以下の表は、パラメーター、パラメーターが配置されている場所、およびそれらが必須であるかどうかを示しています。

golang 実行可能ファイルを設定するには、次の 3 つの方法があります。

1. conf ファイルからの設定: /home/opsgenie/oec/conf/opsgenie-integration.conf ファイルから設定します。conf ファイルから設定すると、スクリプトで行われた設定が上書きされます。

2. Golang フラグを使用して設定: Zenoss で作成された通知のコマンドにフラグを入力して設定します。これについては、「Zenoss でのトリガーの設定」で説明されています。apiKey には -apiKey フラグを使用します。

3. スクリプトからの設定: apiKey send2opsgenie.go スクリプトを設定します。このオプションを使用するには、スクリプトを再構築し、新しい実行可能ファイルを /home/opsgenie/oec/zenoss ディレクトリに配置します。zenoss2opsgenie.go の場所と go スクリプトの構築方法については、「ソース」セクションを参照してください。

Zenoss でのトリガーの設定

通知を作成する前に、次のことを行います。

1. ナビゲーション メニューから [Events (イベント)] > [Triggers (トリガー)] を選択します。

2. Opsgenie という名前のトリガーを作成します。

トリガーを作成したら、次の手順に従います。

1. ナビゲーション メニューから [Events (イベント)] > [Triggers (トリガー)] を選択します。

2. 左側のパネルから [Notifications (通知)] を選択します。

3. 新しい通知を作成します。

4. 以前に作成した通知を選択して、[編集] をクリックします。

5. [通知] タブで、通知を有効にして [Send Clear (送信を選択解除)] をオンにし、トリガー リストから「opsgenie」という名前のトリガーを選択して [追加] をクリックします。

6. [Content (コンテンツ)] タブで、[Command (コマンド)] フィールドと [Clear Command (コマンドをクリア)] フィールドに以下を入力します。オプションの -eventState=close を [Clear Command (コマンドをクリア)] に追加すると、send2opsgenie 実行可能ファイルは Zenoss からイベントの詳細を取得しようとせず、Opsgenie でイベントのアラートを直接クローズします。

/usr/bin/zenoss2opsgenie -evid=${evt/evid}

7. [Subscribers (サブスクライバー)] タブで、サブスクライバーを選択し、[SUBMIT (送信)] をクリックします。

Opsgenie から Zenoss へのインテグレーションを設定する (オプション)

Opsgenie の OEC と Zenoss スクリプトを使用して、Zenoss でアラートをアップデートします。これによって、独自のスクリプトや機能をデプロイして提供された機能を変更し、カスタマイズしたアクションを Zenoss 上で実行できます。

Zenoss でアクションを実行できるようにするには、OEC で設定ファイルから設定パラメーターを取得します。設定ファイルは、/home/opsgenie/oec/conf/config.json にあります。

また、ダウンロードしたパッケージには、/usr/local/bin にある OEC ユーティリティと、/home/opsgenie/oec/scripts にある OEC によって実行する必要があるスクリプトが含まれています。OEC の設定が完了したら、OEC を実行する必要があります。OEC を実行する方法に関する詳細については、OEC の実行のドキュメントをご参照ください。

よくある質問とトラブルシューティング

インテグレーションをうまく機能させることができない場合は、問題が以下に記載されていないかどうかを確認し、当社のアドバイスに従ってください。

1. Zenoss アラートが Opsgenie で作成されません

シェルから次のテスト コマンドを実行します。Opsgenie でアラートが作成されているかどうかを確認します。 

/home/opsgenie/oec/opsgenie-zenoss/send2opsgenie -test

• "Trace/breakpoint trap (トレース/ブレークポイント トラップ)" エラーが発生した場合、send2opsgenie プラグインがサーバー ディストリビューションと互換性がないことを意味します。以下の「send2opsgenie のソースと再コンパイル」セクションに従い、特定のサーバー環境に従って send2opsgenie.go を再構築します。

• Opsgenie でアラートが作成された場合: インテグレーションが正しくインストールされていることを意味します。Zenoss が Opsgenie のアラートの連絡先に通知していないことが問題である可能性があります。Zenoss のアラート通知ログを確認してください。

• そうでない場合: /var/log/opsgenie/send2opsgenie.log のログを確認してください。ログ ファイルで以下のエラーがないか探します。

  • 「RestException[Could not authenticate. (認証できませんでした。)]」がログに表示されたら、Opsgenie が API キーを識別できなかったということです。上記の「Zenoss での Opsgenie プラグイン設定」で説明されているように、API キーが正しく設定されているかを確認します。

  • 問題がはっきりしない場合は、プラグインのログ レベルをデバッグに設定してもう一度お試しいただき、お問い合わせフォームでログを送信してください。

• /var/log/opsgenie/send2opsgenie.log ファイル、またはログがない場合は、以下を確認してください。

  1. まず、Zenoss ユーザーが /var/log/opsgenie ディレクトリへの書き込み権限を持っていることを確認します。インストール パッケージによって自動で実行されます。問題が発生した場合は、chown -R zenoss:opsgenie /var/log/opsgenie を実行します。

  2. 次に、/opt/zenoss/log/zeneventd.log で Zabbix サーバーのログを確認します。zenoss2opsgenie に関するエラー ログがあるかどうかを確認し、それらを添えてお問い合わせください。

zenoss2opsgenie プラグインのログ レベルを DEBUG に設定:
zenoss2opsgenie.logger=warning の行を zenoss2opsgenie.logger=debug に変更します (/etc/opsgenie/conf/opsgenie-integration.conf ファイル内)。

2. Opsgenie でアラートが承認されても Zenoss アラートが承認されません

1. まず、アラート ログを確認します。

• "Posted [Acknowledge] action to Zenoss.." がログにない場合、Opsgenie が承認アクションを Zenoss に送信しなかったことを意味します。インテグレーション設定を確認してください。アラート アクションと一致していない可能性があります。

• "Posted [Acknowledge] action to Zenoss.." のみがログに記録され、それ以降関連ログがない場合、OEC に接続の問題が発生している可能性があります。ログを確認してください。

3. Zenoss RPM パッケージを開けません

rpm パッケージのインストール中にパッケージが廃止されたことを示すエラーが表示された場合は、代わりに "rpm -i opsgenie-zenoss-1.0.4-rpm-x86-64.rpm --nodeps" を使用する必要があります。

"is already installed (インストール済み)" エラーが表示された場合は、代わりに "rpm -i opsgenie-zenoss-1.0.4-rpm-x86-64.rpm --force" を使用してください。

send2opsgenie のソースと再コンパイル

実行可能な send2opsgenie のソースは /usr/bin/ に、send2opsgenie.go は/etc/opsgenie/ にあり、GitHub Opsgenie Integration リポジトリでも利用できます。実行可能ファイルの動作を変更するには、send2opsgenie.go を編集して次を使用して構築します。 

go build send2opsgenie.go

go のインストールについては、http://golang.org/doc/install を参照してください。プラグインの実行ファイルは linux/386 システム用に構築されていることに注意してください。