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

Opsgenie を Zenoss と統合する

Zenoss インテグレーションの図

概要

統合でできるようになること

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

統合をセットアップする

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

インストールの必須条件

インストール パッケージは、以下のシステムをサポートしています。

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

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

ZenossOpsgenie プラグインをインストールする

Opsgenie Edge Connector (OEC) は Zenoss 統合の送信認証を設定するための必須条件です。OEC と Zenoss のスクリプトを組み合わせて使用して、Zenoss のアラートを更新できます。これによって、独自のスクリプトをデプロイしたり、提供されたスクリプトを変更したり、カスタマイズしたアクションを Zenoss 上で実行したりできます。Zenoss パッケージの最新バージョンはこのリポジトリからダウンロードしてください。

RedHat ベースのディストリビューションに関する手順

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

rpm -i opsgenie-zenoss-<your_version>.rpm

rpm をアップグレードする前に、設定ファイルをバックアップします。

rpm パッケージは、アップグレード中に既存の設定を上書きしません。新しい既定の設定ファイルは integration.conf.rpmnew として保存されます。バージョン 201X-XX-XX から 2.X.X にアップグレードするには、--force パラメーターを追加します。例: rpm -U --force opsgenie-zenoss-<your_version>.rpm

rpm アップグレードの設定ファイル処理に関する詳細をご確認ください。

Debian ベースのディストリビューションに関する手順

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

dpkg -i opsgenie-zenoss-<your_version>.deb

Zenoss 統合を追加する

Opsgenie の Free プランまたは Essentials プランを使用している、または Jira Service Management の Standard プランで Opsgenie を使用している場合は、チーム ダッシュボードからのみこの統合を追加できます。このプランでは、[設定] の [統合] ページが利用できません。

  1. [チーム] に移動して自分のチームを選択します。

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

統合をチーム ダッシュボードから追加すると、そのチーム統合の所有者になります。Opsgenie では、この統合を通じて受信したアラートはそのチームのみに割り当てられます。このセクションの残りの手順に従って、統合を設定してください。

Opsgenie に Zenoss 統合を追加するには:

  1. [設定] > [統合] の順に移動します。

  2. [統合を追加] を選択します。

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

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

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

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

  7. [統合を設定する手順] セクションを展開し、API キーをコピーします。
    このキーは、後で Zenoss で統合を設定するときに使用します。

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

Zenoss で Opsgenie プラグインを設定する

プラグインは golang-executable ファイル (send2opsgenie としてプラグインに含まれる) を使用して、Opsgenie でアラートを作成、承認、クローズします。send2opsgenie を動作させるには、いくつかの設定を行う必要があります。次の表は必須のパラメーターとステータスを一覧にしたものです。

設定パラメーター

説明

(必須)

API キー

上記で作成した Zenoss インテグレーションから API キーをコピーします。send2opsgenie はこのキーを使用して Opsgenie への認証を行います。API キーは、アラートの処理に使用する必要がある適切なインテグレーション構成を識別するためにも用いられます。

はい

ベース URL

Opsgenie を別のドメインから使っている場合 (例: EU、サンドボックス) は、この設定をアップデートする必要があります。Opsgenie Zenoss インテグレーション、Zenoss の [詳細設定] ページ。

 

zenoss.command_url

send2opsgenie で Zenoss から詳細なイベントデータを取得する URL。

任意

zenoss.user

Zenoss Web サーバーを認証するための資格情報

任意

zenoss.password

Zenoss Web サーバーを認証するための資格情報

任意

responders

responders フィールドは、Zenoss アラートを通知する必要がある対応者を指定するために使用されます。このフィールドは、既定の対応者フィールド値を設定するために使用されます。Opsgenie Zenoss インテグレーションの [詳細設定] ページで、異なるチームに異なるアラートをルーティングするように変更できます。Opsgenie から通知されるスケジュール。インテグレーションで受信者を設定していない場合、このフィールドは必須です。

任意

tags

[Tags] フィールドは、Opsgenie で作成されたアラートのタグを指定するために使用されます。

任意

logPath

ログ ファイルの完全なパスを指定します (既定値は /var/log/opsgenie/send2opsgenie.log)。

任意

zenoss2opsgenie.http.proxy.enabled

zenoss2opsgenie.http.proxy.enabled フィールドは、外部プロキシの設定を有効または無効にします。既定値は false です。

任意

zenoss2opsgenie.http.proxy.host

これは、プロキシのホストです。

任意

zenoss2opsgenie.http.proxy.port

プロキシのポートです。

任意

zenoss2opsgenie.http.proxy.scheme

これは、プロキシ接続プロトコルです。プロキシ サーバーによって、http または https になる場合があります。既定値は http です。

任意

zenoss2opsgenie.http.proxy.username

プロキシ認証ユーザー名です。

任意

zenoss2opsgenie.http.proxy.password

これは、プロキシ認証パスワードです。

任意

golang 実行可能ファイルを次の 3 つの方法のいずれかで設定します。

方法 1: conf ファイルから設定する

/home/opsgenie/oec/conf/integration.conf ファイルから設定します。これによって、過去にスクリプトで行った設定がすべて上書きされます。

方法 2: Golang フラグで設定する

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

追加のカスタム引数を送信するには、フラグの後に追加します。例: customArgName1 customArgValue1 customArgName2 customArgValue2。入力フィールドの必要な場所に {{_payload.customArgName}} を追加することで、カスタム引数を解析できます。生のパラメーターの使用方法について詳しくは、動的フィールドをご確認ください。

方法 3: スクリプトから設定する

apiKey send2opsgenie.go スクリプトを設定します。スクリプトを再度ビルドし、新しい実行可能ファイルを /home/opgenie/oec/scripts ディレクトリに配置します。send2opsgenie.go の場所と go スクリプトのビルド方法の詳細については、この記事の「send2opsgenie のソースと再コンパイル」セクションを参照してください。

Zenoss でのトリガーの設定

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

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

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

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

5. 通知を作成します。

6. 以前に作成した通知を選択し、[編集] を選択します。

7. [通知] タブで通知を有効にし、[Send Clear (送信を選択解除)] チェックボックスを選択します。

8. 以前に作成したトリガーをリストから選択し、[追加] を選択します。

通知の編集

9. [コンテンツ] タブで:
10. オプションの -eventState=close を [Clear Command (コマンドをクリア)] に追加します。send2opsgenie 実行可能ファイルは、Zenoss からイベントの詳細を取得しようとせず、Opsgenie でイベントのアラートを直接クローズします。/home/opsgenie/oec/scripts/send2opsgenie -evid=${evt/evid}

通知内容の編集

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

Opsgenie を設定して Zenoss をアップデートする

このステップはオプションです。

Opsgenie の OEC と Zenoss スクリプトを使用して、Zenoss でアラートをアップデートします。これによって、独自のスクリプトや機能をデプロイして提供された機能を変更し、カスタマイズしたアクションを Zenoss 上で実行できます。Zenoss でアクションを実行するために、OEC は設定ファイル (/home/opsgenie/oec/conf/config.json にあります) から設定パラメーターを取得します。

設定パラメーター

 

場所

command_url

アラートが承認されたときやクローズされたときなどに Zenoss イベントをアップデートするための URL。

/home/opsgenie/oec/conf/config.json

ユーザー

Zenoss Web サーバーを認証するための資格情報。

/home/opsgenie/oec/conf/config.json

パスワード

Zenoss Web サーバーを認証するための資格情報。

/home/opsgenie/oec/conf/config.json

ダウンロードしたパッケージには、OEC ユーティリティ (/usr/local/bin にあります) と、OEC が実行する必要のあるスクリプト (/home/opsgenie/oec/scripts にあります) が含まれています。OEC の設定後、OEC を必ず実行してください。OEC の実行に関する詳細をご確認ください。

Zenoss 統合パッケージは SSL v1.0 をサポートしていません。Zenoss サーバーで SSL v1.0 を使用している場合は、SSL サーバーをアップグレードしてください。

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

send2opsgenie 実行可能ファイルのソースは /usr/bin/ にあります。send2opsgenie.go 実行可能ファイルのソースは /home/opsgenie/oec/scripts にあります。なお、こちらのリポジトリでも入手できます。実行可能ファイルの動作を変更するには、send2opsgenie.go を編集して、go build send2opsgenie.go コマンドでビルドします。

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

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

統合が機能しない場合は、このセクションを確認して、規定のガイドラインに従ってください。

Zenoss アラートが Opsgenie で作成されない

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

/home/opsgenie/oec/scripts/send2opsgenie -test

  • 「Trace/breakpoint trap (トレース/ブレークポイント トラップ)」エラーが発生した場合は、send2opsgenie プラグインがサーバー ディストリビューションと互換性を持ちません。この記事の「send2opsgenie のソースと再コンパイル」セクションでの説明のとおり、特定のサーバー環境に従って send2opsgenie.go を再構築してください。

  • アラートが Opsgenie で作成されている場合は、統合が正しく設定されています。この場合、Zenoss が Opsgenie の連絡先にアラートを通知していないことが考えられます。Zenoss のアラート通知ログを確認してください。

  • アラートが Opsgenie で作成されていない場合は、/var/log/oec/send2opsgenie.log にあるログをご確認ください。
    ログ ファイルで次のエラーがないか、お探しください。

    • 「RestException[Could not authenticate.]」がログにある場合は、Opsgenie が API キーを識別できなかったことを意味します。この記事の「Zenoss で Opsgenie プラグインを設定する」セクションに記載されているステップに従って、API キーが正しく設定されているか確認してください。

    • 問題がわからない場合は、プラグインのログ レベルをデバッグに設定して、もう一度お試しください。アトラシアンにお問い合わせのうえ、ログを共有してください。

  • /var/log/oec/send2opsgenie.log ファイル、またはログがない場合は、次をご確認ください。

    • Zenoss ユーザーが /var/log/oec ディレクトリに書き込む権限を持っているかどうか確認してください。インストール パッケージによって自動で実行されます。問題が発生した場合は、次のコマンドを実行してください。
      chown -R zenoss:opsgenie /var/log/oec

    • 次に、/opt/zenoss/log/zeneventd.log で Zenoss サーバーのログを確認します。send2opsgenie に関するエラー ログがあるかどうか確認してください。必要に応じてログを添えて、アトラシアンにお問い合わせください

send2opsgenie プラグインのログ レベルをデバッグに設定

send2opsgenie プラグインのログ レベルをデバッグに設定しましょう。/home/opsgenie/oec/conf/integration.conf ファイルを開いて、send2opsgenie.logger=warning 行を zenoss2opsgenie.logger=debug に変更します。

Opsgenie でアラートが承認されても Zenoss アラートが承認されない

アラート ログを確認します。

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

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

Zenoss RPM パッケージを開けない

  • rpm パッケージのインストール時に、そのパッケージが旧バージョンであることが判明した場合は、代わりに rpm -i opsgenie-zenoss-1.0.4-rpm-x86-64.rpm --nodeps をご利用ください。

  • 「インストール済みです」というエラーが表示された場合は、代わりに rpm -i opsgenie-zenoss-1.0.4-rpm-x86-64.rpm --force をご利用ください。

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

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