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

# Jira データソースへの接続
<a name="jira-AMG-datasource"></a>

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

**注記**  
このデータソースは、Grafana Enterprise 専用です。詳細については、「[Enterprise プラグインへのアクセス許可の管理](upgrade-to-enterprise-plugins.md)」を参照してください。  
さらに、バージョン 9 以降をサポートするワークスペースでは、このデータソースに適切なプラグインをインストール必要がある可能性があります。詳細については、「[プラグインを使用したワークスペースの拡張](grafana-plugins.md)」を参照してください。
+ 問題の作成または解決に基づき注釈を作成し、問題とメトリクスの関係を確認します。
+ 平均解決時間や問題スループットなどの、詳細な Jira 統計を追跡します。

Jira データソースを使用するには、Jira プロジェクトへのアクセス許可を持つ Atlassian アカウントが必要です。

## 既知の制限事項
<a name="jira-known-limitations"></a>

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

## データソースの追加
<a name="jira-adding-the-data-source"></a>

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

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

1.  **[データソースの追加]** を選択します。
**注記**  
 サイドメニューに **[データソース]** リンクが表示されていない場合は、現在のユーザーに `Admin` ロールが付与されていないことを意味します。

1.  データソースのリストから **[Jira]** を選択します。

1. 次の情報を入力します。
   + **[名前]** に、この Jira データソースの名前を入力します。
   + **[URL]** に、**https://bletchleypark.atlassian.net** などの Atlassian インスタンスのルート URL を入力します。
   + **[E メール]** に、ユーザー/サービスアカウントの E メールアドレスを入力します。
   + **[API トークン]** に、ユーザー用に生成された API トークンを入力します。

## Jira データソースのクエリ
<a name="jira-query"></a>

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

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

**問題点のフィルタリングおよび表示**

1.  **[フィールド]** を選択してドロップダウンを選択し、先行入力を使用し、カスタムフィールドを含む Jira インスタンス内の任意のフィールドから選択します。一部の試すフィールド: 
   + **[概要]** — 問題の名前
   + **[エピック名]** — 問題が属するエピック
   + **[ストーリーポイントの推定]** — チームが問題に関して推定したストーリーポイント数

1.  問題をフィルタリングまたはソートします。これを実行するには、有効な JQL 式を入力して、Atlanssian クエリ言語 JQL で **[プロジェクト]** 、**[担当者]** 、**[スプリント]** などのフィールドに基づき問題をフィルタリングまたはソートします。

ここから、テーブルにデータを表示、または Grafana 変換を使用してその問題データを操作し、計算を実行し、データを時系列グラフに変換できます。詳細については、「[変換の適用](panel-transformations.md#apply-a-transformation)」を参照してください。

## 時系列クエリ
<a name="jira-timeseries-query"></a>

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

上記の例は、それだけではあまり役に立ちません。数値フィールドは、(多くの場合) 変換から計算されます。**[グループ化の条件]** に変換を使用すると、**[スプリント開始日]** 別にグループ化し、**[ストーリーポイントの見積り]** を要約し、スプリントごとにストーリーポイントを経時的に視覚化できます。変換の詳細については、「[変換の適用](panel-transformations.md#apply-a-transformation)」をご参照ください。

## テンプレートおよび変数
<a name="jira-templates"></a>

新しい Jira クエリ変数を追加するには、「[クエリ変数の追加](variables-types.md#add-a-query-variable)」を参照してください。ご使用の Jira データソースをデータソースとして使用します。

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

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

**担当者変数を作成して担当者ごとの問題ステータスを取得**

1.  **assignee** という名前の **[クエリ]** タイプの変数を追加します。

1.  **[フィールド: 担当者]** を選択します。

1.  (オプション) JQL フィルター **[project = 'your project']** を追加します。

1.  **[実行]** を選択して担当者のリストを表示します。

1. **[更新]** を選択してダッシュボードに変数を追加します。

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

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

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

## Grafana からの変換を使用して一般的な質問に答える
<a name="jira-macros"></a>

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

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

## データソースの最大限の活用
<a name="jira-getmost"></a>

Grafana の変換やその他の組み込み機能を使用すると、Jira データの表示に便利です。

### 変換を使用した JQL の拡大
<a name="gitlab-transformations-JQL"></a>

Grafana では多くの変換を選択できますが、以下のような、一部の SQL の機能/能力を JQL に提供する強力な拡張が用意されています。

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

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

**[計算からフィールドを追加]** SQL 式と同様に、この変換を使用すると、他のフィールドの計算に基づいてデータセットに新しいフィールドを追加できます。計算で使用するフィールドは、単一のクエリから、または結合したクエリからのフィールドである可能性があります。また、計算を連結して、計算フィールドから計算を実行できます。

### Grafana からの変換を使用して一般的な質問に答える
<a name="gitlab-transformations-common"></a>

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

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

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

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

1.  **[グループ化の条件]** 変換を追加します: 
   + スプリント名 \$1 グループ化の条件
   + ストーリーポイントの見積り \$1 計算 \$1 合計

1. **[棒ゲージ]** 視覚化を選択します。

**スプリントでの完了済み対推定の内容を表示するにはどうすればよいですか?**

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

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

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

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

1.  **[グループ化の条件]** 変換を追加します: 
   + スプリント名 \$1 グループ化の条件
   + スプリント開始日 \$1 グループ化の条件
   + ストーリーポイントの見積り \$1 計算 \$1 合計

1. **[グラフ]** の視覚化を選択します。

**プロジェクトで問題点を閉じるまでの平均時間はどのくらいですか?**

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

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

1.  変換を追加: **[計算からフィールドを追加]**
   + モード = 行を減らす
   + 計算 = 差分

1.  変換を追加: **[計算からフィールドを追加]**
   + モード = バイナリオペレーション
   + オペレーション = 差/86000000
   + エイリアス = 日数

1.  変換の追加: **[フィールドの整理]**
   + 異なるフィールドを非表示

1.  変換の追加: **[値によるデータのフィルタリング]**
   + フィルタータイプ = 含める
   + 条件 = いずれかに一致
     + フィールド = 日数 \$1 一致 = より大きい \$1 値 = 1

1.  変換の追加: **[削減]**
   + モード = シリーズから行
   + 計算 = 平均

1. **[統計]** 視覚化を選択します。