本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 連線至 Jira 資料來源
<a name="jira-AMG-datasource"></a>

結合來自 Jira 的問題資料和其他來源的應用程式效能資料，取得開發程序的完整樣貌。

**注意**  
此資料來源僅適用於 Grafana 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**，輸入 Atlassian 執行個體的根 URL，例如 **https://bletchleypark.atlassian.net**。
   + 針對**使用者**，輸入使用者/服務帳戶的電子郵件地址。
   + 針對 **API 字符**，輸入為使用者產生的 API 字符。

## 查詢 Jira 資料來源
<a name="jira-query"></a>

從 Jira 查詢編輯器中，您可以選取欄位和查詢問題。

Jira 資料來源會查詢 Jira 是否有問題，這可能代表 Jira 中的錯誤、使用者案例、支援票證或其他任務

**篩選和檢視問題**

1.  選擇**欄位** 選擇下拉式清單，並使用預先類型從 Jira 執行個體中的任何欄位中選取，包括自訂欄位。要嘗試的一些欄位：
   + **摘要** - 問題的名稱
   + **Epic 名稱** - 問題所屬的 epis
   + **案例點估算** - 團隊針對問題估計的案例點數量

1.  篩選或排序問題。若要這樣做，請輸入任何有效的 JQL 表達式，根據其任何欄位篩選或排序問題，例如 **Project**、**Designee** 或 **Sprint** with Atlassian 查詢語言 JQL。

從這裡，您可以在資料表中顯示資料，或使用 Grafana 轉換來操作該問題資料、執行計算，或將資料轉換為時間序列圖表。如需詳細資訊，請參閱[套用轉換](panel-transformations.md#apply-a-transformation)。

## 時間序列查詢
<a name="jira-timeseries-query"></a>

若要顯示時間序列資料，請選擇**日期**欄位和數值欄位，然後切換到圖形視覺化。例如：**Sprint Start Date**、**Story 點預估**。

上述範例本身並不實用。數值欄位可以是 （且最有可能是） 從轉換計算。使用**依轉換分組**將允許依 **Sprint 開始日期**分組，並摘要 **Story 點估計值**，以允許每個 Sprint 隨時間顯示故事點。如需轉型的詳細資訊，請參閱[套用轉換](panel-transformations.md#apply-a-transformation)。

## 範本和變數
<a name="jira-templates"></a>

若要新增 Jira 查詢變數，請參閱 [新增查詢變數](variables-types.md#add-a-query-variable)。使用您的 Jira 資料來源做為資料來源。

您可以在儀表板上定義變數，並在 JQL 表達式中參考它們。例如，您可以建立專案狀態儀表板，並在專案或史詩狀態儀表板之間進行選擇，然後選擇不同的語意，或任務狀態儀表板，然後選擇不同的受指派者。

若要取得專案、epics、受指派者等的動態清單，請建立查詢類型變數。查詢類型變數使用 JQL 來查詢問題，並傳回專案、Epic、承授者或與問題相關的任何內容。以下是範例：

**建立被指派者變數，以取得被指派者的問題狀態**

1.  新增名為 的**查詢**類型的變數**assignee**。

1.  選取**欄位：被指派者**。

1.  )選用） 新增 JQL 篩選**專案 = '您的專案'**。

1.  選擇**執行**以查看被指派者清單。

1. 選擇**更新**，將變數新增至儀表板。

1. 將新面板新增至儀表板，並編輯 JQL 以使用您的新變數**指派者 = $assignee** 進行篩選。

   現在，從下拉式清單中選擇時，您只會看到指派給該使用者的問題。

多值變數允許選取多個選項，並可用作 IN 子句的一部分。例如，受**指派者 IN ($assignee)**。

## 使用 Grafana 的轉換來回答常見問題
<a name="jira-macros"></a>

巨集是參考儀表板時段的變數，因此您只能在儀表板時段的範圍內篩選問題。有 2 個巨集：
+ **$\_\_timeFrom**
+ **$\_\_timeTo。**

下列範例 JQL 查詢會篩選在儀表板時段內建立的問題： `createdDate >= $__timeFrom AND createdDate <= $__timeTo`

## 充分利用資料來源
<a name="jira-getmost"></a>

使用 Grafana 的轉換和其他內建功能可協助您從意義上檢視 Jira 資料。

### 使用轉換來增強 JQL
<a name="gitlab-transformations-JQL"></a>

雖然 Grafana 中有許多轉換可供選擇，但以下提供強大的增強功能，為 JQL 提供 SQL 的一些功能/能力。

**依此轉換分組** 提供不屬於標準 Jira JQL 語法的金鑰功能：分組。使用**分組依據**轉換，您可以依衝刺或其他問題欄位分組，並依群組彙總以取得指標，例如速度和故事點估計值與衝刺中實際完成的指標。

**外部聯結** 類似於 SQL 聯結，您可以透過常用欄位將 2 個或更多查詢聯結在一起。這樣可以結合查詢中的資料集，並使用其他轉換來計算來自多個查詢/資料集的值。

**從計算新增欄位** 類似於 SQL 表達式，此轉換允許根據其他欄位的計算，將新欄位新增至資料集。計算中使用的欄位可以來自單一查詢或您聯結在一起的查詢。您也可以將計算鏈結在一起，並從計算欄位執行計算。

### 使用 Grafana 的轉換來回答常見問題
<a name="gitlab-transformations-common"></a>

您可以使用轉換視覺化、彙總、分組和聯結資料集，以及許多其他類型的轉換，將簡單的結果轉換為複雜問題的答案。

**如何顯示每個衝刺的速度？**

1.  選取欄位：**Sprint Name**、**Story 點預估**。

1.  新增 JQL 篩選條件： `project = "Your Project" AND type != epic AND status = done order by created ASC`

1.  新增依轉換的**群組**：
   + 衝刺名稱 \| 分組依據
   + 案例點估算 \| 計算 \| 總計

1. 選擇**長條測量器**視覺效果。

**如何顯示 Sprint 中已完成與預估的內容？**

1.  新增查詢。首先，選取欄位：**Sprint Name**、**Sprint Start Date、****Story Point 預估**。

   然後新增 JQL 篩選條件： `project = 'Your Project' AND type != epic`

1.  新增第二個查詢。首先，選取欄位：**Sprint Name**、**Sprint Start Date、****Story Point 預估**。

   然後新增 JQL 篩選條件： `project = 'Your Project' AND type != epic AND status = done`

1.  新增依轉換的**群組**：
   + 衝刺名稱 \| 分組依據
   + 衝刺開始日期 \| 分組依據
   + 案例點估算 \| 計算 \| 總計

1. 選擇**圖形**視覺化。

**完成我的專案問題的平均時間是幾點？**

1.  新增查詢。首先，選取欄位：**已建立**、**狀態類別已變更**。

   然後新增 JQL 篩選條件： `project = 'Your Project' AND type != epic AND status = done`

1.  新增轉換：**從計算新增欄位**
   + 模式 = 減少資料列
   + 計算 = 差異

1.  新增轉換：**從計算新增欄位**
   + 模式 = 二進位操作
   + 操作 = 差異 / 86000000
   + 別名 = 天

1.  新增轉換：**整理欄位**
   + 隱藏不同的欄位

1.  新增轉換：**依值篩選資料**
   + 篩選條件類型 = 包含
   + 條件 = 符合任何
     + 欄位 = 天 \| 相符 = 較大 \| 值 = 1

1.  新增轉換：**減少**
   + 模式 = 序列到資料列
   + 計算 = 平均值

1. 選擇 **Stat** 視覺化。