AppDynamics と Atlassian JIRA の統合Splunk AppDynamics

Splunk AppDynamics™ と Atlassian Jira™ の統合は、インシデントが発生したときに Jira チケットを自動的に作成および更新できる、双方向の統合システムです。Jira の問題に収集された情報は、Splunk AppDynamics と Jira の間で維持され、適切な根本原因分析（RCA）を実施するために役立ちます。継続的なエクスペリエンスのために、Splunk AppDynamics と Jira のインターフェイス間を移動できます。この統合により、特定のイベント/インシデントのデータの検索にかかる時間が短縮され、次のランタイムフローに従うことでチケットを統合することができます。

  1. Splunk AppDynamics イベントが、Jira インシデントをトリガーします。このイベントは、正常性ルール違反です。
  2. Splunk AppDynamics のイベントおよびインシデントデータが、Jira の問題に収集されます。
注: このドキュメントには、Atlassian™ のドキュメントへの参照が含まれています。Splunk AppDynamics™ はいかなる権利も所有しておらず、そのようなサードパーティのドキュメントの正確性または完全性について責任を負いません。

Atlassian Jira 統合の設定

注: Splunk AppDynamics は、SaaS Jira ホストとのみ統合できます。

オープン認証（OAuth 2.0）を使用して、Atlassian Jira 統合を設定できます。OAuth モデルでは、コンシューマキーと公開キーをやり取りし、Atlassian システムにリンクを作成します。これは、URL を入力し、公開キーを作成し、必要な Atlassian リンクを開始するウィザードを介して行います。この設定が完了すると、Jira システムにリンクされた承認について気にする必要がなくなります。

注: OAuth には、Jira の管理者アクセス権が必要です。

Splunk AppDynamics と Jira を統合するには、次の手順を実行します。

  1. 管理者としてコントローラ UI にログインします。
  2. Settings > Administration をクリックします。
  3. [管理（Administration）] ウィンドウで [Integration] タブをクリックし、次に [統合（Integrations）] リストから [Atlassian Jira OAuth] をクリックします。
  4. [Start Jira Integration Wizard] をクリックします。
  5. ウィザードの手順に従います。
    1. Jira ホストの URL を入力し、[Continue] をクリックします。URL が有効な場合は、JIRA URL verified というメッセージが表示されます。
    2. JIRA インスタンスに次の詳細を入力して、Jira にアプリケーションリンクを作成します。

      1. アプリケーション URL としてコントローラ URL を入力します。

      2. 選択したアプリケーション名を入力します。たとえば、AppDynamics コントローラの統合テストなどです。

      3. アプリケーションのタイプを Generic Application として選択します。
      4. コントローラ UI から、コンシューマキー、コンシューマ名、および公開キーを入力します。
      5. Create incoming link チェックボックスを選択します。
    3. 読み取りおよび書き込みアクセスを許可して、Jira で Splunk AppDynamics を承認します。承認後、確認コードを取得します。
  6. Jira から確認コードをコピーして、コントローラ UI の [Verification code from JIRA] フィールドに貼り付けます。
  7. [統合（Integrations）] リストから [Atlassian JIRA OAuth] をクリックして、統合の詳細を表示します。
  8. [Save] をクリックします。
Jira 統合の詳細については、次の記事を参照してください。

Splunk AppDynamics からの Jira の問題の作成

インシデントが発生したときに、Splunk AppDynamics で自動的に Jira の問題を作成することができます。

統合による Jira の問題の作成

トリガーされたときに、Jira の問題を生成するポリシーを定義できます。詳細については、「Jira アクション」を参照してください。イベントタイプに応じてイベントの理由やエラースタックなどの柔軟な情報が挿入され、アクションごとに定義できます。

設定済みの正常性ルールから Jira を作成するには、次の手順を実行します。

  1. 「Jira アクション」の手順に従って、Jira アクションを作成します。
  2. [Alert & Respond] メインページに戻り、正常性ルールを作成します。「正常性ルールの構成」を参照してください。
  3. [Alert & Respond] メインページに戻り、ポリシーを作成します。「ポリシーの設定」を参照してください。
    1. 正常性ルール違反イベントに基づいてポリシートリガーを作成します。
    2. 先ほど作成した Jira アクションがポリシーで実行されるようにします。

CURL コマンドを使用した Jira の問題の作成

次のカスタムイベントを作成し、CURL コマンドを使用して Jira 統合をテストします。

  1. エラー
  2. INFO

シビラティ（重大度）= ERROR のイベントが生成されると、優先順位 MEDIUM のチケットが Jira で開かれます。同じイベントタイプとソースの優先順位を変更し、シビラティ（重大度）=INFO を設定すると、以前に開かれたチケットが更新され、優先順位が LOW に低下します。

シビラティ（重大度）が ERROR のカスタムイベントの作成

次の CURL コマンドを使用して、コントローラでイベントを作成し、シビラティ（重大度）を ERROR に設定します。

curl --request POST --user <Controller Username>@customer1: <Controller Password>'https://appd-controller-nonprod.com:8181/controller/rest/applications/<Application ID>/events?summary=SECUREAPP_OWASP_BREACH&comment=OWASP_breach_detected_by_SecureApp&severity=ERROR&event-type=CUSTOM&custom-event-type=SECUREAPP_OWASP_BREACH'

シビラティ（重大度）が INFO のカスタムイベントの作成

次の CURL コマンドを使用して、コントローラで既存のイベントを更新し、シビラティ（重大度）を INFO に設定します。

curl --request POST --user <Controller Username>@customer1: <Controller Password>'https://appd-controller-nonprod.com:8181/controller/rest/applications/<Application ID>/events?summary=SECUREAPP_OWASP_BREACH&comment=OWASP_breach_detected_by_SecureApp&severity=INFO&event-type=CUSTOM&custom-event-type=SECUREAPP_OWASP_BREACH'

Splunk AppDynamics アプリケーション ダッシュボードの [Events] タブには、2 つの異なるイベントタイプが表示されます。これらのイベントの詳細を表示できます。

Jira チケットの表示

Jira ダッシュボードで、Splunk AppDynamics イベントを処理するために作成された Jira チケットを表示できます。Jira アクションは、サインインしているユーザーにこれらのチケットを割り当てます。

統合による Jira の問題の作成

トリガーされたときに、Jira の問題を生成するポリシーを定義できます。詳細については、「Jira アクション」を参照してください。イベントタイプに応じてイベントの理由やエラースタックなどの柔軟な情報が挿入され、アクションごとに定義できます。

設定済みの正常性ルールから Jira を作成するには、次の手順を実行します。

  1. 「Jira アクション」の手順に従って、Jira アクションを作成します。
  2. [Alert & Respond] メインページに戻り、正常性ルールを作成します。「正常性ルールの構成」を参照してください。
  3. [Alert & Respond] メインページに戻り、ポリシーを作成します。「ポリシーの設定」を参照してください。
    1. 正常性ルール違反イベントに基づいてポリシートリガーを作成します。
    2. 先ほど作成した Jira アクションがポリシーで実行されるようにします。

CURL コマンドを使用した Jira の問題の作成

次のカスタムイベントを作成し、CURL コマンドを使用して Jira 統合をテストします。

  1. エラー
  2. INFO

シビラティ（重大度）= ERROR のイベントが生成されると、優先順位 MEDIUM のチケットが Jira で開かれます。同じイベントタイプとソースの優先順位を変更し、シビラティ（重大度）=INFO を設定すると、以前に開かれたチケットが更新され、優先順位が LOW に低下します。

シビラティ（重大度）が ERROR のカスタムイベントの作成

次の CURL コマンドを使用して、コントローラでイベントを作成し、シビラティ（重大度）を ERROR に設定します。

curl --request POST --user <Controller Username>@customer1: <Controller Password>'https://appd-controller-nonprod.com:8181/controller/rest/applications/<Application ID>/events?summary=SECUREAPP_OWASP_BREACH&comment=OWASP_breach_detected_by_SecureApp&severity=ERROR&event-type=CUSTOM&custom-event-type=SECUREAPP_OWASP_BREACH'

シビラティ（重大度）が INFO のカスタムイベントの作成

次の CURL コマンドを使用して、コントローラで既存のイベントを更新し、シビラティ（重大度）を INFO に設定します。

curl --request POST --user <Controller Username>@customer1: <Controller Password>'https://appd-controller-nonprod.com:8181/controller/rest/applications/<Application ID>/events?summary=SECUREAPP_OWASP_BREACH&comment=OWASP_breach_detected_by_SecureApp&severity=INFO&event-type=CUSTOM&custom-event-type=SECUREAPP_OWASP_BREACH'

Splunk AppDynamics アプリケーション ダッシュボードの [Events] タブには、2 つの異なるイベントタイプが表示されます。これらのイベントの詳細を表示できます。

Jira チケットの表示

Jira ダッシュボードで、Splunk AppDynamics イベントを処理するために作成された Jira チケットを表示できます。Jira アクションは、サインインしているユーザーにこれらのチケットを割り当てます。

Atlassian Jira 統合の無効化

Atlassian Jira 統合を無効にして、すべての Jira 機能を無効にすることができます。Splunk AppDynamics UI の Atlassian Jira 統合機能は、デフォルトでは無効になっています。

管理設定から統合を無効にすると、次の機能が無効になります。

  • Jira アクション
  • 問題の追跡ウィジェット
  • [Health Rule Violations] テーブルの [Jira / War Room] 列

これらの機能を無効にしても、削除はされません。統合を再度有効にすると、機能を使用し、元のビューを復元することができます。

Jira™ は Atlassian の商標です。