Opsgenie を Splunk と統合する

Splunk アラートは、特定のイベントの監視と応答に使用できます。アラートは、保存された検索を使用して、リアルタイムまたはスケジュールに従ってイベントを検索します。検索結果が特定の条件を満たすと、アラートがトリガーされます。アラート アクションは、アラートがトリガーされたときに応答するために使用できます。

Opsgenie は Splunk ユーザーに何を提供しますか?

Opsgenie は Splunk との双方向のインテグレーションを提供します。Splunk の検索およびレポート アプリでは、ユーザーはデータの検索、データ モデルとピボットの作成、検索およびピボットのレポートとしての保存、アラートの設定、ダッシュボードの作成を行えます。Opsgenie アラート アプリを通じて、Splunk アラートを Opsgenie に転送します。Splunk インテグレーションにおいて、Opsgenie はこれらのアラートのディスパッチャーとして機能して、オンコール スケジュールに基づいて通知する適切な担当者を決定します。メール、テキスト メッセージ (SMS)、電話、iOS と Android のプッシュ通知によって通知し、アラートが確認されるかクローズされるまでアラートをエスカレートします。OEC (Opsgenie Edge Connector) を通じて、Opsgenie アラートを Splunk に追加のインデックス作成および検索イベントとして転送できます。

統合の機能性

• Opsgenie には Splunk 固有のアラート アプリがあり、Splunk アラートを Opsgenie に送信します。Opsgenie には、Splunk インテグレーション固有の API もあり、Splunk は Opsgenie アラート アプリを介してアラートを Opsgenie に送信し、Opsgenie はアラートの自動作成を処理します。

• Opsgenie アラートの Splunk イベントの作成が有効になっている場合、アラート固有のアクション ([アラートの作成]、[アラートの承認] など) が OECを通じてイベントとして Splunk に送信されます。

Opsgenie で Splunk インテグレーションを追加する

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

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

3. API キーをコピーします。

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

Splunk での設定

1. Splunk で、Splunkbase から Opsgenie アプリをインストールします。

2. インストール後、[アプリ] に移動し、[セットアップ] をクリックして Opsgenie アプリを設定します。

3. 「Opsgenie での Splunk インテグレーションを追加する」の章で以前コピーした API キーを貼り付けます。

4. Splunk で検索を実行して、アラートを作成します。

5. [ 名前を付けて保存 ] をクリックし、ドロップダウン リストから [アラート] を選択します。

6. アラートのタイトルを入力し、条件を指定します。

7. [+ アクションを追加] ボタンをクリックしてドロップダウン リストにアクセスし、[Opsgenie] を選択します。

8. [保存] をクリックします。

OEC を介した統合

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

Splunk インテグレーション パッケージを使用するには、以下のセクションのステップを最後まで実行します。

インストール

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

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

Debian ベースのディストリビューションの場合

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

Windows の場合

• OEC パッケージを含む Opsgenie インテグレーションの zip ファイルをディレクトリ内に解凍します (C:\opsgenie\oec は優先パスです)。Windows に OEC をインストールするには、こちらの指示に従います。

• OEC の実行方法について詳しくは、OEC の実行のドキュメントを参照してください。

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

OEC 用の Splunk インテグレーションの設定

• Splunk インテグレーションに OEC ユーティリティを使用するには、統合設定で [OEC 経由で送信] を使用します。

• Splunk に関する設定はオプションです。[OEC 経由で送信] を選択した場合、OEC 設定ファイルで設定できます。

Splunk Cloud 用の Splunk インテグレーションの設定

• Splunk Cloud を使用している場合、Opsgenie が Splunk Cloud インスタンスにイベントを配信できるようになりました。

• [OEC 経由で送信] を選択せず、対応するフィールドに Splunk Cloud URL と Splunk トークンを入力してください。Splunk Cloud URL とポートを入力してください 。

Splunk での設定

1. Splunk に管理者としてログインします。

2. ホーム ページから、[Add Data (データの追加)] を選択します。

3. 下から [監視] を選択します。

4. データ入力オプションから、[HTTP Event Collector (HTTP イベント コレクター)] を選択して新しいイベント コレクターに名前を付けます。

5. 必要な場合を除いて、残りの手順を変更せずに完了します。最後の手順で、Splunk によって提供されたトークン値を書き留めます。

6. HTTP 経由のデータ入力を有効にするには、上部バーから [ 設定 ] > [データ入力] の順に選択し、[HTTP イベント コレクター] に移動します。その後、[グローバル設定] メニューで [すべてのトークン] が有効に設定されていることを確認します。

これでコレクターが設定されました。Opsgenie がアラート関連のアクションを発行するたびに、Splunk がイベントを作成します。

OEC 設定

• OEC の実行方法について詳しくは、OEC の実行のドキュメントを参照してください。

Splunk でイベントを作成できるように、OEC は統合設定から設定パラメーターを取得します。

Opsgenie の Splunk フィールドとドラッグ可能なフィールドから送信されるペイロードのサンプル

以下の内容の結果フィールドは、検索条件に一致する行のフィールドによって異なります。そのため、Opsgenie では利用可能なフィールドに結果オブジェクトの一般的なフィールドを提供します。一般的なフィールドの例には、Raw、Index、Serial、Source Type などがあります。

また、結果オブジェクトからカスタム フィールドを抽出できるようにするために、使用可能なフィールドに [結果オブジェクト] も追加しました。

たとえば、結果オブジェクトの date_month フィールドをアラートに配置するには、{{result.date_month}} で問題が解決されます。

アラートのペイロードを作成します。

JSON

Splunk から送信されるペイロードのサンプル

JSON