Jira データソースに接続する - Amazon Managed Grafana
既知の制限事項データソースの追加Jira データソースをクエリする時系列クエリテンプレートと変数Grafana からの変換を使用して一般的な質問に答えるデータソースを最大限に活用する

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Jira データソースに接続する

Jira の問題データと他のソースからのアプリケーションパフォーマンスデータを組み合わせて、開発プロセス全体を把握します。

注記

このデータソースは Grafana Enterprise 専用です。詳細については、「Enterprise プラグインへのアクセスを管理する」を参照してください。

さらに、バージョン 9 以降をサポートするワークスペースでは、このデータソースで適切なプラグインのインストールが必要になる場合があります。詳細については、「プラグインを使用してワークスペースを拡張する」を参照してください。

  • 問題の作成または解決に基づいて注釈を作成し、問題とメトリクスの関係を確認します。

  • 平均解決時間や問題スループットなど、詳細な Jira 統計を追跡します。

Jira データソースを使用するには、Jira プロジェクトにアクセスできるアトラシアンアカウントが必要です。

既知の制限事項

Jira アドオンのカスタムフィールドタイプはサポートされていない場合があります。

データソースの追加

  1. Amazon Managed Grafana ワークスペースで Grafana コンソールを開き、ログインしていることを確認します。

  2. 設定 (歯車アイコン) のサイドメニューで、データソース を選択します。

  3. [データソースを追加する] を選択する。

    注記

    サイドメニューにデータソースリンクが表示されない場合は、現在のユーザーに Adminロールがないことを意味します。

  4. データソースのリストから Jira を選択します。

  5. 次の情報を入力します。

    • 名前 に、この Jira データソースの名前を入力します。

    • URL には、 などのアトラシアンインスタンスのルート URL を入力しますhttps://bletchleypark.atlassian.net。

    • ユーザー には、ユーザー/サービスアカウントの E メールアドレスを入力します。

    • API トークン には、ユーザー用に生成された API トークンを入力します。

Jira データソースをクエリする

Jira クエリエディタからフィールドとクエリの問題を選択できます。

Jira データソースは Jira に問題をクエリします。これは Jira のバグ、ユーザーストーリー、サポートチケット、またはその他のタスクを表す可能性があります。

問題をフィルタリングして表示する

  1. フィールド ドロップダウンを選択し、先行入力を使用して、カスタムフィールドを含む Jira インスタンス内の任意のフィールドから選択します。試すいくつかのフィールド：

    • 概要 — 問題の名前

    • エピック名 — 問題が属するエピック

    • ストーリーポイントの見積もり — チームが問題について推定したストーリーポイントの数

  2. 問題をフィルタリングまたはソートします。これを行うには、有効な JQL 式を入力して、プロジェクト 、担当者 、またはアトラシアンクエリ言語 JQL を使用したスプリントなどのフィールドに基づいて問題をフィルタリングまたはソートします。

ここから、データをテーブルに表示するか、Grafana 変換を使用して、その発行データを操作したり、計算を実行したり、データを時系列グラフに変換したりできます。詳細については、「変換の適用」を参照してください。

時系列クエリ

時系列データを表示するには、日付フィールドと数値フィールドを選択し、グラフの視覚化に切り替えます。例: スプリント開始日 、ストーリーポイントの見積もり 。

前述の例自体はあまり役に立ちません。数値フィールドは、変換から計算できます (おそらく計算されるでしょう）。Group By Transformation を使用すると、スプリント開始日別にグループ化し、ストーリーポイントの見積もりを要約して、スプリントごとにストーリーポイントを経時的に視覚化できます。変換の詳細については、「変換の適用」をご参照ください。

テンプレートと変数

新しい Jira クエリ変数を追加するには、「」を参照してくださいクエリ変数の追加。Jira データソースをデータソースとして使用します。

ダッシュボードで変数を定義し、JQL 式で参照できます。例えば、プロジェクトステータスダッシュボードを作成してプロジェクトを選択するか、エピックステータスダッシュボードを作成して異なるエピックを選択するか、タスクステータスダッシュボードを作成して異なる担当者を選択することができます。

プロジェクト、エピック、担当者などの動的リストを取得するには、クエリタイプ変数を作成します。クエリタイプ変数は JQL を使用して問題をクエリし、プロジェクト、エピック、担当者、または問題に関連するものを返します。以下に例を示します。

担当者変数を作成して、担当者別の問題のステータスを取得します。

  1. という名前の Query 型の変数を追加しますassignee。

  2. フィールド : 担当者 を選択します。

  3. ) オプション) JQL フィルタープロジェクト = '自分のプロジェクト' を追加します。

  4. 実行 を選択して、担当者のリストを表示します。

  5. 更新 を選択して、変数をダッシュボードに追加します。

  6. 新しいパネルをダッシュボードに追加し、JQL を編集して、新しい変数担当者 = $assignee を使用してフィルタリングします。

    ここで、ドロップダウンから選択すると、そのユーザーに割り当てられた問題のみが表示されます。

複数値変数を使用すると、複数のオプションを選択でき、IN 句の一部として使用できます。例えば、担当者 IN ($assignee) などです。

Grafana からの変換を使用して一般的な質問に答える

マクロは、ダッシュボードの時間枠を参照する変数であり、ダッシュボードウィンドウの範囲内でのみ問題をフィルタリングできます。マクロは 2 つあります。

  • $__timeFrom

  • $__timeTo 。

次の JQL クエリの例では、ダッシュボードの時間枠内に作成された問題をフィルタリングします。 createdDate >= $__timeFrom AND createdDate <= $__timeTo

データソースを最大限に活用する

Grafana の変換やその他の組み込み機能を使用すると、Jira データを表示するのに役立ちます。

変換を使用した JQL の拡張

Grafana には多くの変換から選択できますが、以下は、JQL に SQL の機能や能力の一部を与える強力な拡張を提供します。

この変換によるグループ化は、標準の Jira JQL 構文の一部ではない主要な機能であるグループ化を提供します。Group By 変換を使用すると、スプリントやその他の問題フィールドでグループ化し、グループ別に集計して、スプリントで実際に完了した速度やストーリーポイントの見積もりと実際の完了率などのメトリクスを取得できます。

外部結合 SQL 結合と同様に、共通のフィールドで 2 つ以上のクエリを結合できます。これにより、クエリのデータセットを結合し、他の変換を使用して複数のクエリ/データセットの値を計算することができます。

計算からフィールドを追加 SQL 式と同様に、この変換では、他のフィールドの計算に基づいてデータセットに新しいフィールドを追加できます。計算で使用されるフィールドは、単一のクエリからでも、結合したクエリからでもかまいません。また、計算を連結し、計算フィールドから計算を実行することもできます。

Grafana からの変換を使用して一般的な質問に答える

変換を使用すると、データセットを視覚化、集計、グループ化、結合したり、他の多くのタイプの変換を使用して、単純な結果を複雑な質問に対する回答に変換したりできます。

スプリントあたりの速度を表示するにはどうすればよいですか？

  1. フィールド : スプリント名 、ストーリーポイントの見積り を選択します。

  2. JQL フィルターを追加します。 project = "Your Project" AND type != epic AND status = done order by created ASC

  3. Group By 変換を追加します。

    • スプリント名 | グループ化の基準

    • ストーリーポイントの見積もり | 計算 | 合計

  4. バーゲージの視覚化を選択します。

スプリントで完了と推定された内容を表示する方法

  1. クエリを追加します。まず、フィールド: スプリント名 、スプリント開始日、ストーリーポイントの見積り を選択します。

    次に、JQL フィルターを追加します。 project = 'Your Project' AND type != epic

  2. 2 番目のクエリを追加します。まず、フィールド: スプリント名 、スプリント開始日、ストーリーポイントの見積り を選択します。

    次に、JQL フィルターを追加します。 project = 'Your Project' AND type != epic AND status = done

  3. Group By 変換を追加します。

    • スプリント名 | グループ化の基準

    • スプリント開始日 | グループ化の基準

    • ストーリーポイントの見積もり | 計算 | 合計

  4. グラフの視覚化を選択します。

プロジェクトで問題を完了するまでの平均時間はどのくらいですか？

  1. クエリを追加します。まず、フィールド: 作成済み、ステータスカテゴリ変更済み を選択します。

    次に、JQL フィルターを追加します。 project = 'Your Project' AND type != epic AND status = done

  2. 変換を追加する: 計算からフィールドを追加する

    • モード = 行を減らす

    • 計算 = 差分

  3. 変換を追加する: 計算からフィールドを追加する

    • モード = バイナリオペレーション

    • オペレーション = 差分 / 86000000

    • エイリアス = 日数

  4. 変換を追加する: フィールドを整理する

    • 異なるフィールドを非表示にする

  5. 変換の追加: 値でデータをフィルタリングする

    • フィルタータイプ = 含める

    • 条件 = 任意の に一致

      • フィールド = 日数 | 一致 = より大きい | 値 = 1

  6. 変換の追加: 削減

    • モード = シリーズから行

    • 計算 = 平均

  7. 統計の視覚化を選択します。