Opsgenie を Solarwinds NPM と統合する

概要

SolarWinds NPM をクイック インストールして、デバイスを検出して監視を開始しましょう。SolarWinds NPM は、ネットワーク デバイスの応答時間、可用性、パフォーマンスを監視して表示します。また、インテリジェントなアラート システムを備えているため、アラートの作成とリセット時にアクション (メールを送信する、Get または Post URL 機能を使用するなど) を実行します。

SolarWinds NPM アラートは、サーバーが応答しないなどのネットワーク イベントが発生したことに関する自動通知です。アラートをトリガーするネットワーク イベントは、アラート設定の際に設定された条件によって決まります。

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

Opsgenie では、SolarWinds NPM の双方向の統合を提供します。この統合は、SolarWinds NPM の [Web サーバーへの Post リクエスト送信] 機能と Opsgenie Edge Connector (OEC) ユーティリティーを活用してアラートを自動で作成し、SolarWinds NPM と Opsgenie の間でアラートのステータスを同期します。

SolarWinds NPM 統合を使用すると Opsgenie はこれらのアラートのディスパッチャーとして機能して、オンコール スケジュールに基づいて通知する適切なユーザーを決定します。メール、テキスト メッセージ (SMS)、電話、iPhone、Android のプッシュ通知によって通知して、アラートが承認されるかクローズされるまでアラートをエスカレートします。

Opsgenie には、SolarWinds NPM 統合で利用可能な特定の API が用意されています。SolarWinds NPM は Opsgenie にアラートを送信して、Opsgenie はアラートの自動作成を処理します。

統合による機能

• SolarWinds NPM は、監視対象オブジェクトがアラートの条件を満たした際にアラートをトリガーします。SolarWinds NPM でアラートが作成されると、統合を通じて Opsgenie でアラートが自動で作成されます。

• Opsgenie でアラートが承認されると、OEC でスクリプトを実行することによって SolarWinds NPM でもアラートが自動で承認されます。

• Opsgenie でアラートにメモが追加されると、OEC でスクリプトを実行することによって SolarWinds NPM でもアラートにメモが追加されます。

統合をセットアップする

SolarWinds NPM は双方向の統合です。設定は次の手順で行います。

• Opsgenie で SolarWinds NPM 統合を追加する

• SolarWinds NPM で統合を設定する

SolarWinds NPM 統合を追加する

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

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

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

3. 検索を実行して [SolarWinds NPM] を選択します。

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

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

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

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

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

SolarWinds NPM で統合を設定する

Opsgenie Edge Connector (OEC) is a prerequisite for configuring the outgoing authentication of Solarwinds Orion NPM integration. Download the latest version of the Solarwinds Orion NPM package from this repository.

1. SolarWinds NPM で、[設定] > [アラートを管理] > [Alert Manager (アラート マネージャー)] の順に移動します。

2. [新しいアラートを追加] を選択します。

3. 必要に応じてアラートのプロパティを設定します。
   名前、重大度、条件を評価する頻度、アカウント制限を使用してアラート全体のアクセスを制限するかどうかなど、アラートに関する情報を指定します。

4. 必要に応じてトリガー条件を設定します。
   トリガー アクションは、トリガー条件が満たされたときに実行されます。SolarWinds NPM には、ユーザーが複雑な条件を構築できる堅牢な条件メカニズムがあります。データベースで利用可能なすべてのフィールドを、これらの条件で使用できます。
   利用できる変数の多様性と柔軟性を考慮して、Opsgenie ではなく SolarWinds で条件を構築することを強くお勧めします。

5. リセット条件を設定します。
   条件が満たされるとリセット アクションが実行されます。

6. アラートがネットワークを監視する時間間隔を設定します (常に有効、または指定した時間に制限)。

7. トリガー アクションの値を入力して、[アクションを追加] を選択します。
   このトリガー アクションを使用すると、SolarWinds NPMはアラート データを Opsgenie に投稿して、Opsgenie でアラートが作成されます。Opsgenie にアラート データを送り返すには、トリガー アクションを [Web サーバーに Get リクエストまたは Post リクエストを送信する] に設定します。

8. POST メソッドを選択します。

9. Opsgenie で統合を追加する際にコピーした URL を貼り付けます。

10. Opsgenie に送信する変数を variable1=val1&variable2=val2 の形式で入力します。
    Opsgenie にトリガー アクションと併せて送信されるすべての変数は、SolarWinds NPM 統合の [アラート アクションを作成] アラート フィールドで使用できます。

11. Specify teams, recipients, and tags by putting them into the content. The default trigger action body can be sent from SolarWinds here.
    The "alias" field in the following example becomes the SolarWinds NPM alerts alias field. To make different alias configurations, change the value of the alias field in post content. Ensure the alias configurations in "Trigger" and "Reset" are the same.

    Opsgenie parses incoming data and creates robust alerts according to the incoming content. Modifying alert fields with incoming data can be done via dynamic fields.

    SolarWinds NPM で、監視対象オブジェクト (ノード、ボリューム、インターフェイスなど) のアラートを作成します。共通フィールドと監視対象オブジェクト固有フィールドを送信するには、[HTTP リクエストを送信] アクションを使用します。SolarWinds NPM 統合では、アラート固有のフィールドをカスタム統合フィールドとして利用できます。また、Opsgenie に送信される動的フィールドを引き続きサポートします。

    例: NodeID 変数は Opsgenie で利用可能な統合フィールドの 1 つではないので、これをアラートに含めるには SolarWinds NPM から送信してアラート設定で動的に使用します。Opsgenie と SolarWinds NPM で使用される変数名が同じであることをご確認ください。

    NodeID=${N=SwisEntity;M=NodeID} によって NodeID 変数を HTTP の Post 本文に追加してから、{{NodeID}} の次の例のように SolarWinds NPM 統合の "アラート アクションを作成" アラート フィールドで使用します。

12. Set the reset action. With a reset action, SolarWinds NPM posts the data that closes the corresponding alert in Opsgenie. Configure the reset action with Send a Get or Post Request to a Web Server option. Find the default reset action body to send from SolarWinds NPM here.

13. アラート設定を確認して、[送信] を選択します。

Opsgenie を設定して SolarWinds 統合を更新する

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

OEC ユーティリティーと SolarWinds スクリプトを使用して、SolarWinds でアラートを更新します。この設定によって、独自のスクリプトをデプロイしたり、提供されたスクリプトを変更したり、カスタマイズしたアクションを SolarWinds 上で実行したりできます。SolarWinds 統合パッケージを使用するには、次の手順に従います。

1. Download the latest version of OEC for the SolarWinds package from the oec-scripts repository.

2. パッケージをインストールします。

Windows の場合

Unzip Opsgenie integration zip file, which contains the OEC package into a directory (C:\opsgenie\oec is the preferred path). Learn about installing OEC on Windows.

To execute actions in SolarWinds, OEC gets the configuration parameters from the configuration file (found under the directory where the zip file is extracted). If you used the preferred path in Windows, it is C:\opsgenie\oec\config.json. Learn about running OEC.

3. Opsgenie の SolarWinds 統合設定ページにある [Send Alert Actions To SolarWinds (SolarWinds にアラート アクションを送信する)] チェックボックスを選択します。

SolarWinds から送信されるサンプル パラメーター

(プレーン テキスト形式)

Opsgenie によって解析されたペイロード

(JSON 形式)

トラブルシューティング

SolarWinds NPM sends the body without making any escapes on data. Hence, if any variables contain any characters that need to be escaped (like &), send the data in advanced mode. Use µ#µ instead of = and §#§ instead of &. Sending the data from SolarWinds NPM to Opsgenie in either format produces the same results in Opsgenie. Refer to a troubleshooting version of the default content for the trigger action body and reset action. Ensure that the Body to Post text matches this to Acknowledge/Close/AddNote actions on the SolarWinds side.