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) は SolarWinds Orion NPM 統合の送信認証を設定するための必須条件です。SolarWnds Orion NPM パッケージの最新バージョンはこのリポジトリからダウンロードしてください。

1. In SolarWinds NPM, go to Settings > Manage Alerts > Alert Manager.

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

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

4. Set trigger conditions as needed.
   The trigger action is executed when trigger conditions meet. SolarWinds NPM has a robust conditioning mechanism that allows users to build complex conditions. All fields available in the database can be used in these conditions.
   Because of available variable variety and flexibility, building conditions in SolarWinds rather than Opsgenie are highly recommended.

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

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

7. Enter values for the trigger action and select Add Action.
   With this trigger action, SolarWinds NPM posts alert data to Opsgenie, and an alert is created in Opsgenie. To send alert data back to Opsgenie, set the trigger action to Send a Get or Post Request to a Web Server.

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 に送信される動的フィールドを引き続きサポートします。

    Example: To include a NodeID variable in an alert in Opsgenie– It's not one of the integration fields available, so send it from the SolarWinds NPM to dynamically use it in alert configuration. Ensure the variable name used in Opsgenie and SolarWinds NPM is the same.

    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. oec-scripts リポジトリから SolarWinds パッケージ用の OEC の最新バージョンをダウンロードします。

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

Windows の場合

OEC パッケージを含む Opsgenie 統合の zip ファイルを、ディレクトリ内に解凍します (推奨パスは C:\opsgenie\oec です)。Windows への OEC のインストールに関する詳細をご確認ください。

SolarWinds でアクションを実行するために、OEC は設定ファイル (zip ファイルが抽出されたディレクトリにあります) から設定パラメーターを取得します。Windows で推奨されたパスを使用した場合は、C:\opsgenie\oec\config.json です。OEC の実行に関する詳細をご確認ください。

3. Select the Send Alert Actions To SolarWinds checkbox on the SolarWinds integration configuration page in Opsgenie.

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.