Opsgenie を PRTG と統合する

概要

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

Opsgenie は PRTG との強力な双方向の統合を提供します。PRTG でセンサーがダウンすると、詳細な情報を含む、対応する Opsgenie アラートが自動的に作成されます。Opsgenie は、オンコール ローテーション、スケジューリング機能、アラート エスカレーションを含む高度な通知を提供して、PRTG の顧客が最適な監視管理を行えるようにします。ユーザーが承認済みのアラートに対してアクションを実行すると、PRTG 上のセンサー情報がマッピングされているアクションに従って自動的に更新されます。

統合による機能

PRTG to Opsgenie

• "センサーステータスダウン" 通知が PRTG から送信されると、Opsgenie でアラートが作成されます。

• PRTG から "センサーステータスアップ" 通知が送信されると、Opsgenie で関連するアラートが閉じられます。

Opsgenie to PRTG

If Send Alert Updates Back to PRTG is enabled, actions for PRTG are run in PRTG when the chosen action is run in Opsgenie for alerts which are created by the PRTG.

マッピング機能については、この記事の「アラート アクションをマッピングする」で詳しく説明されています。

統合をセットアップする

PRTG は双方向の統合です。次のステップに沿ってセットアップを行います。

• Opsgenie に PRTG 統合を追加する

• アラート アクションをマッピングする

• PRTG で統合を設定する

PRTG 統合を追加する

Opsgenie に PRTG 統合を追加するには、次の手順に従います。

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

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

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

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

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

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

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

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

アラート アクションをマッピングする

Opsgenie アクションと PRTG アクション間 (アラートのソースが PRTG の場合も同様) のマッピングを定義できます。これには PRTG アカウントの追加認証が必要です。

1. 「設定」ページで [編集] を選択して、統合を編集します。

2. [PRTG にアラートの更新を送信するための認証] セクションで、[PRTG アカウントで認証] チェックボックスを選択します。

3. 次の値を入力します。

   • ユーザー名: PRTG アカウント設定のメール アドレス

   • Passhash: The passhash from your PRTG account settings

   • PRTG URL: PRTG ログイン ページの URL

4. [保存] を選択します。

5. [送信] セクションを展開します。

6. [アラートの更新を PRTG に送信] チェックボックスを選択します。

7. PRTG に更新を送信するアラート アクションを選択します。
   選択したアクションが発生するたびに、対応するセンサーが PRTG で承認されます。

PRTG で統合を設定する

1. In PRTG, go to Setup > Account Settings > Notification Templates.

2. [新しい通知を追加] > [HTTP アクションを実行] を選択します。

3. Paste the URL you copied while adding the integration in Opsgenie into URL.

4. [SNI Handling (SNI 処理)] には、[Send SNI (SNI を送信)] を選択します。

5. api.opsgenie.com をコピーして [SNI Name (SNI 名)] に貼り付けます。

6. [HTTP メソッド] には、[POST] を選択します。

7. 次のファイルのいずれかから POST データを (該当する場合は、リンク先のファイルから) コピーして、[ペイロード] に貼り付けます。

   1. For PRTG version 16.x.24. or above, use this post data.

   2. その他のバージョンは、こちらの POST データをご利用ください。

8. 必要に応じて HTTP バージョンを選択します。

9. [保存] を選択します。

OEC 経由で認証する (オンプレミス PRTG 用)

Opsgenie Edge Connector (OEC) は PRTG 統合の送信認証を設定するために必要です。OEC と PRTG の各スクリプトを組み合わせることで、PRTG のアラートを更新できます。このセットアップによって、PRTG 上での独自のスクリプトのデプロイ、提供されたスクリプトの変更、カスタマイズしたアクションの実行を行えます。

STEP 1. Download and install the PRTG package from this repository.

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

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

rpm パッケージが旧バージョンであることが判明した場合は、代わりに次のコマンドを実行します。

rpm パッケージがインストール済みである場合は、代わりに次のコマンドを実行します。

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

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

Windows 用の手順

1. Opsgenie 統合の zip ファイル (OEC パッケージを含む) をディレクトリに解凍します。
   例: C:\opsgenie\oec

2. これらの手順に従って OEC をインストールします。

OEC の実行に関する詳細をご確認ください。

ステップ2: OEC 用の PRTG 統合を設定する

1. Opsgenie で「統合の設定」ページに移動します。

2. [送信] セクションを展開します。

3. [Opsgenie Edge Connector のみで認証する] チェックボックスを選択します。

その他の設定は、「統合の設定」ページまたは OEC 設定ファイル config.json から行えます。「統合の設定」ページで行われた設定は、config.json での設定よりも優先されます。

ステップ 3: OEC を設定する

OEC と PRTG スクリプトによって、PRTG でアラートを更新します。PRTG でアクションを実行するために、OEC は設定ファイルである config.json (/home/opsgenie/oec/conf にあります) から設定パラメーターを取得します。

設定パラメーター

• apiKey – The API key you copied while adding the integration in Opsgenie

• prtgUrl – サブドメインを含む PRTG URL。例: https://opsgenie.my-prtg.com

• username – The PRTG API username under Account Settings in PRTG

• passhash – The PRTG API passhash under Account Settings in PRTG

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

OEC の実行に関する詳細をご確認ください。

課題のトラブルシューティング

• 古いセットアップの統合を双方向に機能させたい場合は、PRTG 統合の設定でアラート プロパティにキーと値のペア sensorId, {{sensorId}} を追加します。

• アクションの実行を Opsgenie に送信できない場合は、[SNI を送信] を有効にします。