本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
連線至 Jira 資料來源
透過將 Jira 的問題資料與其他來源的應用程式效能資料結合,取得開發程序的完整樣貌。
注意
此資料來源僅適用於 Grafana Enterprise。如需詳細資訊,請參閱管理企業外掛程式的存取。
此外,在支援第 9 版或更新版本的工作區中,此資料來源可能會要求您安裝適當的外掛程式。如需詳細資訊,請參閱使用外掛程式擴充工作區。
-
根據問題建立或解決來建立註釋,以查看問題與指標之間的關係。
-
追蹤詳細的 Jira 統計資料,例如平均解決時間和問題輸送量。
若要使用 Jira 資料來源,您需要具有 Jira 專案存取權的 Atlassian 帳戶。
已知限制
可能不支援 Jira 附加元件的自訂欄位類型。
新增資料來源
-
在 Amazon Managed Grafana 工作區中開啟 Grafana 主控台,並確保您已登入。
-
在組態 (齒輪圖示) 下的側邊選單中,選擇資料來源。
-
選擇新增資料來源。
注意
如果您在側邊選單中看不到資料來源連結,表示您目前的使用者沒有
Admin
角色。 -
從資料來源清單中選取 Jira。
-
輸入下列資訊:
-
針對名稱,輸入此 Jira 資料來源的名稱。
-
針對 URL,輸入 Atlassian 執行個體的根 URL,例如
https://bletchleypark.atlassian.net
。 -
針對使用者,輸入使用者/服務帳戶的電子郵件地址。
-
對於 API 字符,輸入為使用者產生的 API 字符。
-
查詢 Jira 資料來源
您可以從 Jira 查詢編輯器選取欄位和查詢問題。
Jira 資料來源會查詢 Jira 是否有問題,這些問題可以代表 Jira 中的錯誤、使用者案例、支援票證或其他任務
篩選和檢視問題
-
選擇欄位 選擇下拉式清單,並使用預先輸入,從 Jira 執行個體中的任何欄位進行選取,包括自訂欄位。要嘗試的一些欄位:
-
摘要 — 問題的名稱
-
Epic Name:問題所屬的 epis
-
案例點估算 - 團隊已針對問題預估的案例點數量
-
-
篩選或排序問題。若要執行此操作,請輸入任何有效的 JQL 表達式,根據其任何欄位篩選或排序問題,例如 Project、 Assignee 或 Sprint with Atlassian 查詢語言 JQL。
從這裡,您可以在資料表中顯示資料,或使用 Grafana 轉換來操作該問題資料、執行計算,或將資料轉換為時間序列圖表。如需詳細資訊,請參閱套用轉換。
時間序列查詢
若要顯示時間序列資料,請選擇日期欄位和數值欄位,然後切換到圖形視覺化。例如:Sprint Start Date、Story 點預估。
上述範例本身並不實用。數值欄位可以是 (且最有可能是) 從轉換計算。使用依轉換分組將允許依 Sprint 開始日期分組,並摘要 Story 點估計值,允許每個 Sprint 隨時間顯示故事點。如需轉型的詳細資訊,請參閱套用轉換。
範本和變數
若要新增 Jira 查詢變數,請參閱 新增查詢變數。使用 Jira 資料來源做為資料來源。
您可以在儀表板上定義變數,並在 JQL 表達式中參考它們。例如,您可以建立專案狀態儀表板,並在專案或史詩級狀態儀表板之間進行選擇,然後選擇不同的語意,或任務狀態儀表板,然後選擇不同的受指派者。
若要取得專案、epics、受指派者等的動態清單以供選擇,請建立查詢類型變數。查詢類型變數使用 JQL 來查詢問題,並傳回專案、Epic、受指派者或與問題相關的任何內容。以下是範例:
建立 Assignee 變數,以取得 Assignee 的問題狀態
-
新增名為 的查詢類型的變數
assignee
。 -
選取欄位:受指派者。
-
)選用) 新增 JQL 篩選專案 = '您的專案'。
-
選擇執行以查看受指派者清單。
-
選擇更新,將變數新增至儀表板。
-
將新面板新增至儀表板,並使用新變數指派者 = $assignee 編輯 JQL 進行篩選。
現在,從下拉式清單中選擇時,您只會看到指派給該使用者的問題。
多值變數允許選取多個選項,並可做為 IN 子句的一部分。例如,受指派者 IN ($assignee)。
使用 Grafana 的轉換來回答常見問題
Macros 是參考儀表板時間範圍的變數,因此您只能在儀表板時段的範圍內篩選問題。有 2 個巨集:
-
$__timeFrom
-
$__timeTo。
下列範例 JQL 查詢會篩選在儀表板時段內建立的問題: createdDate >= $__timeFrom AND createdDate <= $__timeTo
充分利用資料來源
使用 Grafana 的轉換和其他內建功能,可協助您從意義上檢視 Jira 資料。
使用轉換來增強 JQL
雖然 Grafana 中有許多轉換可供選擇,但以下提供強大的增強功能,為 JQL 提供 SQL 的一些功能。
依此轉換分組 提供不屬於標準 Jira JQL 語法的金鑰功能:分組。使用分組依據轉換,您可以依 Sprints 或其他問題欄位分組,並依群組彙總,以取得速度和故事點預估等指標,相較於在 Sprint 中實際完成的指標。
外部聯結 與 SQL 聯結類似,您可以透過常用欄位將 2 個或更多查詢聯結在一起。這提供了合併查詢資料集的方法,並使用其他轉換來計算來自多個查詢/資料集的值。
從計算新增欄位 類似於 SQL 表達式,此轉換允許根據其他欄位的計算,將新欄位新增至資料集。計算中使用的欄位可以來自單一查詢,也可以來自您已加入的查詢。您也可以將計算串連在一起,並從計算欄位執行計算。
使用 Grafana 的轉換來回答常見問題
您可以使用轉換視覺化、彙總、分組和聯結資料集,以及許多其他類型的轉換,將簡單的結果轉換為複雜問題的答案。
如何顯示每個衝刺的速度?
-
選取欄位:Sprint Name、Story 點預估。
-
新增 JQL 篩選條件:
project = "Your Project" AND type != epic AND status = done order by created ASC
-
新增依轉換的群組:
-
衝刺名稱 | 群組依據
-
故事點估算 | 計算 | 總計
-
-
選擇長條規視覺化。
如何顯示 Sprint 中已完成與估計的內容?
-
新增查詢。首先,選取欄位:Sprint Name、Sprint Start Date、Story Point 估算。
然後新增 JQL 篩選條件:
project = 'Your Project' AND type != epic
-
新增第二個查詢。首先,選取欄位:Sprint Name、Sprint Start Date、Story Point 估算。
然後新增 JQL 篩選條件:
project = 'Your Project' AND type != epic AND status = done
-
新增依轉換的群組:
-
衝刺名稱 | 群組依據
-
衝刺開始日期 | 分組依據
-
故事點估算 | 計算 | 總計
-
-
選擇圖形視覺化。
完成我的專案問題的平均時間是多久?
-
新增查詢。首先,選取欄位:已建立、狀態類別已變更。
然後新增 JQL 篩選條件:
project = 'Your Project' AND type != epic AND status = done
-
新增轉換:從計算新增欄位
-
模式 = 減少資料列
-
計算 = 差異
-
-
新增轉換:從計算新增欄位
-
模式 = 二進位操作
-
操作 = 差異 / 86000000
-
別名 = 天
-
-
新增轉換:整理欄位
-
隱藏不同的欄位
-
-
新增轉換:依值篩選資料
-
篩選條件類型 = 包含
-
條件 = 符合任何
-
欄位 = 天 | 相符 = 較大 | 值 = 1
-
-
-
新增轉換:減少
-
模式 = 系列到資料列
-
計算 = 平均值
-
-
選擇 Stat 視覺化。