Dynatrace と Jira を統合して可観測性を向上させる方法

Want to learn more?

Jira におけるスプリントの使用方法に関する詳細については「スプリント チュートリアル」をご確認ください。

ご質問はこちらまで。アトラシアンコミュニティ

概要

このチュートリアルは、相互に作用するいくつかのコンポーネントに依存します。このチュートリアルでは、次のことを行います。

1. Jira 課題に URL を含む Dynatrace 問題カードのコメントを作成するように、Jira Automation を構成します。

2. 問題を Jira にプッシュするように Dynatrace を構成します。

3. サンプル アプリケーションで問題をトリガーして、Dynatrace が問題を検出して Jira 課題を自動作成する方法を確認します。

4. Dynatrace リリース ページ内で、Jira 課題のクエリを構成します。

5. 環境をクリーンアップします。

この図は、このチュートリアルのコンポーネントと、コンポーネント間の基本的な相互作用を示しています。

1. Dynatrace によってアプリケーションを監視 – このチュートリアルでは、Dynatrace は、サンプル アプリケーションを実行するホストにインストールされた Dynatrace エージェントから指標を収集します。すべてのデータは、中央の Dynatrace テナントに一元化されます。Dynatrace テナントには、管理用と AI 搭載問題検出用の Web インターフェイスも用意されています。

2. 詳細なコンテキストによる問題通知 – Dynatrace の AI エンジンである Davis は、統一されたエンティティ モデルにマッピングされた忠実度の高い指標、トレース、ログ、実際のユーザー データを使用します。Davis の決定論的な AI を使用して、問題の正確な根本原因を明らかにします。Davis は正確な根本原因を特定するだけでなく、有用なコンテキストを瞬時に提供します。問題がリソースのボトルネックやデプロイの変更の結果であるかどうかだけに留まらず、その背後にいる人物さえ把握できます。問題を再現して、その発生理由と修正方法を完全に理解できます。

3. Jira 課題の自動作成 – Dynatrace と Jira の統合によって、Dynatrace 環境で自動検出されたすべての新しい問題の課題が自動発行されます。

4. Jira Automation による Dynatrace のアップデート – Jira の Automation はコード不要な機能であり、数回のクリックで簡単にルールを構築できます。Dynatrace API への Web リクエストは、Dynatrace の問題 ID を使用して Dynatrace の問題カードのコメントをアップデートします。

5. 問題を解決して Jira 課題をクローズ

2. Dynatrace 内で、左側のメニューを使用して [Transactions and services (トランザクションとサービス)] オプションをクリックし、実行中のサービスを表示します。フロントエンド サービスと注文サービスを含む、複数のサービスが実行されています。

3. フロントエンド サービスをクリックします。サービス ページで [View dynamic requests (動的リクエストを表示)] ボタンをクリックします。

以下に示すように、サービスへのリクエストが表示されています。

2. 設定サブメニューで、[統合] サブメニューを展開して [Dynatrace API] オプションを選択します。

3. [Dynatrace API] ページで [トークンを生成] ボタンを選択します。

4. Jira チュートリアルなどのトークン名を指定します。

5. [API v1] セクションを展開して [Access problem feed, metrics, and topology (問題のフィード、指標、トポロジにアクセス)] スコープを有効にします。その他のスコープはすべてオフのままにします。

6. [生成] ボタンをクリックします。

7. 重要: 生成されたトークンを安全な場所に保存する必要があります。この値はチュートリアルの後半で必要になり、再表示できません。[コピー] ボタンを使用して、文字列全体を取得するようにします。

8. トークンを安全な場所に保存したら [閉じる] ボタンをクリックします。

3. 重要: Jira プロジェクト キーを書き留めておいてください。この値は Dynatrace の構成で必要になります。上記の例では、キーは「DT」です。

4. 右上の [ルールを作成] ボタンをクリックします。

5. [新しいトリガー] ページで、[課題にコメントが付きました] という名前のトリガー、次のページで [保存] の順に選択します。

6. [コンポーネントを追加] ページ ルールで [新規アクション] オプションをクリックします。

7. [新規アクション] ページで [Send Web Request (Web リクエストを送信)] 通知オプションを選択します。

8. 以下の詳細情報を入力します。完了すると、以下の例のようになります。

• [Webhook URL] – Dynatrace API エンドポイントへの URL です。この文字列の [YOUR-ENVIRONMENT-ID] を、ご使用の環境に置き換える必要があります。この値を取得するには、Dynatrace 環境の URL をご参照ください。
  
  https://[YOUR-ENVIRONMENT]/api/v1/problem/details/{{issue.description.match(".*pid=(.*)")}}/comments
  
  テクニカル ノート: Jira Match スマート値式は、課題の説明に含まれる問題 URL から Dynatrace の問題または PID を抽出します。regex101 などの Web サイトは、これらの式を構築する際に役立ちます。

• [ヘッダー] – 先に作成済みの Dynatrace API トークンの値が含まれます。ヘッダー名には Authorization の値を使用します。ヘッダー値は、この文字列を使用してトークン値 Api-Token [YOUR-DYNATRACE-API-TOKEN] で置き換えます。注: トークン文字列の前にスペースを追加して、Api-Token を含める必要があります。

• [HTTP Method (HTTP メソッド)] – [POST] オプションを選択します。

• [Webhook Body (Webhook 本文)] – ドロップダウン リストから、[Custom Body (カスタム本文)] を選択し、JSON 本文全体に貼り付けます。

  { "message": "Opened Jira Issue: [{{issue.key}}]({{issue.url}})", "context": "Jira" }
  
  *** プロのヒント: スマート値の詳細については、https://support.atlassian.com/ja/jira-software-cloud/docs/smart-values-general/ をご参照ください。

9. [保存] ボタンをクリックします。

10. 次のページで、「課題作成時に Dynatrace にコメントを送信」などの名前を入力して [オンにする] ボタンをクリックします。

11. 保存後に、右上の [Return to list (リストに戻る)] リンクをクリックすると、新しいルールが有効になっています。

1. Dynatrace 内の左側のメニューで [設定] オプションをクリックします。

2. 設定サブメニューで、[統合] サブメニューを展開して [Problem notifications (問題の通知)] オプションを選択します。

3. [Set up notifications (通知を設定)] を選択します。

4. 利用可能な通知タイプから Jira を選択します。

5. 通知を構成します。

• [表示名] – 「Jira チュートリアル」などの値を入力します。

• [Jira エンドポイント URI] – ご利用の Jira アカウントを反映するようにこの値をアップデートします。

  https://[YOUR-JIRA-ACCOUNT].atlassian.net/rest/api/2/

• [ユーザー名] – Atlassian API トークンの作成に使用したユーザー ID。

• [API トークン] – Atlassian API トークンの文字列。

• [プロジェクト キー] – 新しい課題が作成されて追跡される Jira プロジェクトのキー (プロジェクト名ではない)。上記の例で同じものを使用した場合は「DT」になります。

• [要約] – デフォルト値のままにします。

• [Issue description (課題の説明)] – デフォルト値のままにします。
  
  ***プロのヒント -- 構成ページの [Available placeholders (利用可能なプレースホルダー)] セクションには、この統合に使用できるプレースホルダーがリストされます。プレースホルダーは、問題に関連する情報に自動で置き換えられます。

6. [Send test notification (テスト通知を送信)] を選択して、Jira 統合が機能していることを確認します。次のように表示されます。

また、Jira ではテスト課題は次のようになります。

7. [保存] ボタンをクリックします。