Splunk と統合する

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

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

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

統合による機能

Jira Service Management には、Splunk のアラートを Jira Service Management に送信する Splunk 専用のアラート・アプリがあります。Jira Service Management には Splunk 統合用の専用 API もあり、Splunk は Jira Service Management アラート・アプリを介して Jira Service Management にアラートを送信し、Jira Service Management はアラートの自動作成を処理します。

Jira Service Management アラートの Splunk イベントの作成が有効になっている場合、アラート固有のアクション（「アラートの作成」、「アラートの承認」など）が JEC を通じてイベントとして Splunk に送信されます。

統合をセットアップする

Splunk は統合です。設定は次の手順で行います。

• Jira Service Management に Splunk 統合を追加する

• Splunk で統合を設定する

Splunk 統合を追加する

Jira Service Management に Splunk 統合を追加するには、次の手順を実行します (注: Splunk のアラート設定の所有者は、 list_storage_passwords 権限を持っている必要があります)。

1. サイドバーの [オペレーション] の横にある [その他のアクション] () を選択し、次に [一般設定] を選択します。

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

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

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

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

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

7. [統合を設定するステップ] セクションを展開して、API URL と API キーの両方をコピーします。
   これらは、後ほど Splunk で統合を設定する際に使用します。

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

Splunk で統合を設定する

Splunk で統合を設定するには、次の手順を実行します。

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

2. インストール後、「アプリ」に移動し、「セットアップ」を選択して Jira Service Management アプリを設定します。

3. 先ほど Jira Service Management からコピーした API URL と API キーを、それぞれ [JSM Base URL (JSM ベース URL)] と [API キー] に貼り付けます。

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

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

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

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

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

JEC 経由で統合する

JEC（Jira Edge Connector）と Splunk スクリプトを使用して、Splunk のアラートをアップデートします。これによって、独自のスクリプトや機能をデプロイして提供された機能を変更し、カスタマイズしたアクションを Splunk 上で実行できます。Splunk 統合パッケージを使用するには、次のセクションで説明されている手順に従います。

パッケージをダウンロードしてインストールする

1. Splunk パッケージの最新バージョンをダウンロードします。

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

   1. RedHat ベースのディストリビューションの場合

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

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

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

   3. Windows の場合

      JEC パッケージを含む Jira Service Management 統合 zip ファイルをディレクトリ内に解凍します（C:\jsm\jec が推奨パス）。Windows での JEC のインストールに関する詳細をご確認ください。

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

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

JEC 用に統合を設定する

Splunk 統合に JEC ユーティリティを使用するには、統合設定で「JEC 経由で送信」を使用します。JEC 経由での送信を選択する場合、Splunk に関する設定はオプションです。JEC 設定ファイルで設定できます。

Splunk Cloud 用に Splunk 統合を設定する

Splunk Cloud を使用している場合、Jira Service Management はイベントを Splunk Cloud インスタンスに配信できます。「JEC 経由で送信」を選択しないでください。代わりに、Splunk Cloud の URL と Splunk トークンを対応するフィールドに入力します。Splunk Cloud の URL とポートを入力してください。

Splunk で設定する

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

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

3. ページの下部から、「モニター」を選択します。

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

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

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

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

JEC を設定する

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

JEC の実行方法については、こちらをご確認ください。

Splunk から送信されるペイロードの例と Jira Service Management の動的プロパティ

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

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

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

アラートのペイロードを作成する

JSON

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

JSON