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

Opsgenie を OP5 Monitor と統合する

OP5 Monitor のロゴ

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

OpsgenieOP5 との強力な双方向の統合を提供します。OP5 で新しいアラート (ホストまたはサービス) が作成されると、アラートに関する詳しい情報を含む、対応する Opsgenie アラートが自動的に作成されます。Opsgenie は、オンコール ローテーション、スケジューリング機能、アラート エスカレーションを含む詳細な通知を提供します。ユーザーは Opsgenie のアラート アクションのいずれかを選択し、OP5 の承認アクションにマップします。

統合の機能性

OP5 から Opsgenie:

  • OP5 でホストまたはサービス アラートが作成されると、Opsgenie でアラートが作成されます。

  • OP5 でホストまたはサービス アラートがクローズされると、Opsgenie で対応するアラートがクローズされます。

  • OP5 でホストまたはサービス アラートが承認されると、Opsgenie で対応するアラートが承認されます。

Opsgenie から OP5:

  • [アラート アップデートを OP5 に返信 ] が有効になっている場合、OP5 アラートに対して実行されたアクションは承認アクションとして OP5 に送信されます。

  • このアクション マッピング機能の詳細については、以下の「アクション マッピング機能」セクションで説明します。

Opsgenie OP5 パッケージをインストールする

OEC の最新バージョンをダウンロードする

OP5 パッケージの最新バージョンをダウンロードするには、oec-scripts リポジトリの readme ファイルを使用してください。

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

  • OP5 ファイルをリモートの OP5 Monitor と共有するか、または開始ページのリンクをコピーして次のコマンドを実行します。
    wget https://linkTo.the.OP5Package

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

アップグレード中に、rpm パッケージは既存の設定を上書きしません。これによって、新しい既定の設定ファイルが opsgenie-integration.conf.rpmnew として保存されます。rpm アップグレード設定ファイルの処理の詳細については、こちらをご参照ください。

バージョン 201X-XX-XX から 2.X.X にアップデートするには、--force パラメーターを追加しなくてはいけません。例:

rpm -U --force opsgenie-integration-<your_version>.rpm

アップデートする前に、設定ファイルをバックアップすることをお勧めします。

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

"is already installed" のエラーが表示された場合は、代わりに "rpm -i opsgenie-op5-<your_version>.rpm--force" を使用する必要があります。

Opsgenie で OP5 統合を追加する

この統合はチーム ダッシュボードから追加可能

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

統合をチーム ダッシュボードから追加すると、そのチーム統合の所有者になります。Opsgenie では、この統合を通じて受信したアラートはそのチームのみに割り当てられます。

そのためには、次の手順に従います。

  1. Teams からチーム ダッシュボードに移動します。

  2. [統合] > [統合を追加] の順に選択します。

残りの手順に従って統合を完了します。

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

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

  3. 統合 API をコピーして、OEC 設定に使用します。

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

Opsgenie OP5 Monitor で OP5 パッケージを設定する

プラグインは golang-executable ファイル (send2opsgenie としてプラグインに含まれる) を使用して、Opsgenie でアラートを作成、確認、クローズします。イベント時にこのファイルを実行するように OP5 を設定して、Opsgenie でアラートを作成、承認、クローズします。

apiKey の設定は必須です。その他の設定パラメーターは、OP5 で動作する既定に設定されます。

設定パラメーター

 

場所

API キー

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

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

ベース URL

Opsgenie を別のドメイン (例:EU、サンドボックス) から使用している場合は、[詳細設定] ページでこの configuration.Opsgenie OP5 統合をアップデートする必要があります。

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

responders

responders フィールドは、OP5 アラートを通知する必要があるチームを指定するために使用されます。このフィールドは、既定のチーム フィールド値を設定するために使用されます。Opsgenie OP5 インテグレーションの [詳細設定] ページで、異なるアラートを異なるチームにルーティングするように変更します。

/home/opsgenie/oec/conf/opsgenie-integration.conf

tags

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

/home/opsgenie/oec/conf/opsgenie-integration.conf

logPath

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

/home/opsgenie/oec/conf/opsgenie-integration.conf

nagios2opsgenie.http.proxy.enabled

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

/home/opsgenie/oec/conf/opsgenie-integration.conf

nagios2opsgenie.http.proxy.host

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

/home/opsgenie/oec/conf/opsgenie-integration.conf

nagios2opsgenie.http.proxy.port

プロキシのポートです。

/home/opsgenie/oec/conf/opsgenie-integration.conf

nagios2opsgenie.http.proxy.scheme

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

/home/opsgenie/oec/conf/opsgenie-integration.conf

nagios2opsgenie.http.proxy.username

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

/home/opsgenie/oec/conf/opsgenie-integration.conf

nagios2opsgenie.http.proxy.password

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

/home/opsgenie/oec/conf/opsgenie-integration.conf

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

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

  2. Golang フラグを使用して設定: opsgenie.cfg ファイルでコマンドにフラグを入力して、ファイルで設定できます。apiKey に -apiKey フラグを、nagios_server の名前に -ns フラグをそれぞれ使用します。複数の OP5 サーバーが使用されていない場合は、nagios サーバーを定義する必要はありません。フラグを使用すると、上記の他のすべての設定方法が上書きされます。

cfg ファイルから apiKey を次のように設定します。

テキスト

1 2 3 4 define command { command_name notify-service-by-opsgenie command_line /home/opsgenie/oec/opsgenie-op5/send2opsgenie -apiKey="apiKey1" -entityType=service ... }

apiKey を cfg ファイルに追加すると、config.json ファイル内の apiKey が上書きされます。

追加のカスタム引数を送信するには、フラグの後に、customArgName1 customArgValue1 customArgName2 customArgValue2 を追加します。
 

{{_payload.customArgName}}

 を入力フィールドの必要な場所に追加することで、カスタム引数を解析します。
生のパラメーターの使用に関する詳細については、動的フィールドのドキュメントをご確認ください。

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

Opsgenie を連絡先として定義する

  1. OP5 Monitor にログインします。

  2. nagios.cfg がある /opt/monitor/etc ディレクトリに移動します。
    cd /opt/monitor/etc)

  3. メインの Nagios 設定ファイル (nagios.cfg) に次の行を追加します。

テキスト

1 2 3 ... cfg_file=opsgenie.cfg ...

4. Monitor を再起動して、「opsgenie 」連絡先が連絡先リストにあることを確認します。

5. 連絡先「opsgenie」を、OP5 Monitor の主要連絡先グループに追加します。

すべて問題がない場合は、OP5 で作成されたすべての通知について Opsgenie にアラートが作成されます。

OP5 Monitor アラートの詳細

Opsgenie から OP5 統合を設定する (オプション)

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

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

設定パラメーター

  • url – OEC は、この URL を使用して構築されたエンドポイントにアラート アクションを投稿します。

  • username – OEC は、OP5 アカウントのユーザー名を使用して認証を行います。

  • password – OEC は、OP5 アカウントのパスワードを使用して認証を行います。

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

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

統合が機能しない場合、発生している問題が以下に記載されているかどうかを確認し、アドバイスに従ってください。

1- OP5 アラートが Opsgenie で作成されません:

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

/home/opsgenie/oec/opsgenie-op5/send2opsgenie -entityType=host -t=PROBLEM -hs=DOWN -hn=test_host

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

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

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

  • "RestException[Could not authenticate.]"エラーがログに表示された場合、OpsgenieAPI キーを識別できなかったことを意味します。上記の「OP5 Monitor での Opsgenie OP5 パッケージ設定」で説明されているように、API キーが正しく設定されているかを確認します。

  • 「[OP5] 統合の apiKey でこのアクションを実行できませんでした」エラーがログに表示された場合、間違った統合パッケージをダウンロードしている可能性があります。OP5 統合パッケージをダウンロードしていることを確認してください。

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

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

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

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

/etc/opsgenie/conf/opsgenie-integration.conf ファイルの send2opsgenie.logger=warning の行を nagios2opsgenie.logger=debug に変更します。

2- Opsgenie でアラートが承認されても OP5 アラートが承認されません:

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

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

  • "Executed [Acknowledge] action via OEC with errors."エラーがログに表示された場合、OEC の op5ActionExecutor.Groovyスクリプトでエラーが発生したことを意味します。/var/log/opsgenie/ の下のログファイルをチェックして、エラーログを確認します。

  • "Posted [Acknowledge] action to OP5.." エラーのみがログに表示されており、それ以降関連ログがない場合、OEC の接続に問題が発生している可能性があります。/var/log/opsgenie/ の下のログ ファイルをチェックして、エラー ログを確認します。

ログが存在しない場合は、OEC を再起動し、承認アクションをもう一度送信してみてください。

2. 問題がはっきりしない場合は、OEC のスクリプトのログ レベルをデバッグに設定してもう一度お試しいただき、お問い合わせフォームで /var/log/opsgenie/ の下にあるログを送信してください。

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

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

go build send2opsgenie.go

http://golang.org/doc/install/source を参照してください。send2opsgenie は linux/amd64 システム向けに構築されていることに注意してください。

アクション マッピング機能

Opsgenie では、ユーザーは OpsgenieOP5 の各アクション間のアクション マッピングを定義できます。

アクション マッピング機能を使用するには、統合に次の情報を入力します。

  • ユーザー名: OP5 アカウントのユーザー名。

  • パスワード: OP5 アカウントのパスワード。

  • OP5 モニター URL: これが各自の OP5 モニターのドメイン名です。例: https://19.167.1.143

OP5 によって作成されたアラートの場合

  • このセクションを使用して、アラートのソースが OP5 の場合に Opsgenie アクションを OP5 アクションにマップします (つまり、OP5 統合によってアラートが作成されている場合)。

  • 異なる Opsgenie アクションを別々の OP5 アクションにマップします。たとえば、OP5 からのアラートが承認されたときに、OP5 でアラートを承認するとします。これを行うには、「Opsgenie でアラートが承認された場合、OP5 で承認する」マッピングを「アラート アップデートを OP5 に送信する」セクションに定義します。

Opsgenie から OP5

 

その他のヘルプ