Connect 至 Jira 資料來源 - Amazon Managed Grafana

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

Connect 至 Jira 資料來源

將來自 Jira 的問題資料與來自其他來源的應用程式效能資料結合,以取得開發過程的全貌。

注意

此資料來源僅適用於 Grafana 企業版。如需詳細資訊,請參閱 管理企業外掛程式的存取

此外,在支援版本 9 或更新版本的工作區中,此資料來源可能會要求您安裝適當的外掛程式。如需詳細資訊,請參閱 使用外掛程式擴充工作區

  • 根據問題的建立或解決方案建立註釋,以查看問題和指標之間的關係。

  • 跟踪詳細的 Jira 統計信息,例如平均解決時間和發布吞吐量。

若要使用 Jira 資料來源,您需要具有 Jira 專案存取權的 Atlassian 帳戶。

已知限制

可能不支援來自 Jira 外掛程式的自訂欄位類型。

新增資料來源

  1. 在 Amazon 受管的 Grafana 工作區中開啟 Grafana 主控台,並確認您已登入。

  2. 在 [設定] 下方的側邊功能表 (齒輪圖示) 中,選擇 [資料來源]。

  3. 選擇新增資料來源

    注意

    如果您在側邊功能表中沒有看到 [資料來源] 連結,表示您目前的使用者沒有該Admin角色。

  4. 從資料來源清單中選取 Jira

  5. 輸入下列資訊:

    • 名稱中,輸入此 Jira 資料來源的名稱。

    • 針對 URL,請輸入 Atlassian 執行個體的根 URL,例如。https://bletchleypark.atlassian.net

    • 使用者中,輸入使用者/服務帳戶的電子郵件地址。

    • 針對 API 權杖,請輸入為使用者產生的 API 權杖。

查詢 Jira 資料來源

從 Jira 查詢編輯器中,您可以選擇字段和查詢問題。

Jira 資料來源會向 Jira 查詢問題,這些問題可能代表 Jira 中的錯誤、使用者故事、支援票證或其他工作

篩選和檢視問題
  1. 選擇 [欄位] 選擇下拉式清單,然後使用 [預先輸入] 從 Jira 執行個體中的任何欄位中選取,包括自訂欄位。一些字段嘗試:

    • 摘要 — 問題的名稱

    • 史詩名稱-一個問題所屬的 EPIS

    • 故事點估算 — 團隊針對某個問題估計的故事點數

  2. 篩選或排序問題。若要這麼做,請輸入任何有效的 JQL 運算式,根據其任何欄位 (例如使用 Atlassian 查詢語言 JQL) 篩選或排序問題,例如 [專案]、[受指派人] 或 [Sprint]。

在這裡,您可以在表格中顯示資料,或使用 Grafana 轉換來操作問題資料、執行計算,或將資料轉換為時間序列圖表。如需詳細資訊,請參閱 套用轉換

時間序列查詢

若要顯示時間序列資料,請選擇日期欄位以及數值欄位,然後切換至圖形視覺效果。例如:衝刺開始日期故事點估計

前面的例子本身並不是很有用。數字字段可以是(並且很可能)從「轉換」中計算出來的。使用「按轉換分組」將允許按 Sprint 開始日期進行分組,並總結故事點估計值,從而允許每個 Sprint 隨時間推移的故事點進行可視化。如需轉型的詳細資訊,請參閱套用轉換

模板和變量

若要新增 Jira 查詢變數,請參閱新增查詢變數。使用您的 Jira 資料來源做為資料來源。

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

若要取得專案、史詩、工作負責人等的動態清單以供選擇,請建立 Query 類型變數。查詢類型變數使用 JQL 查詢問題,並傳回專案、史詩、工作負責人或任何與問題相關的項目。以下是範例:

建立「工作負責人」變數,以取得受指派人的問題狀態
  1. 添加名為查詢類型的變量assignee

  2. 選取欄位:受指派人

  3. )可選)添加一個 JQL 過濾器項目 =「您的項目」。

  4. 選擇「執行」以查看受指派人清單。

  5. 選擇「更新」以將變數新增至控制面板。

  6. 將新面板新增至控制面板,並編輯 JQL 以使用新的變數受指派人 = $ 受指派人進行篩選。

    現在,從下拉菜單中選擇時,您只會看到分配給該用戶的問題。

多值變量允許選擇多個選項,並且可以用作 IN 子句的一部分。例如,工作負責人 IN ($ 受讓人)。

使用 Grafana 的轉換來回答常見問題

巨集是參考「儀表板」時間視窗的變數,因此您只能篩選「儀表板」視窗範圍內的問題。有 2 個宏:

  • $ __ 時間從

  • $ __ 時間。

下列範例 JQL 查詢會篩選儀表板時間視窗內建立的問題:createdDate >= $__timeFrom AND createdDate <= $__timeTo

充分利用資料來源

使用 Grafana 的轉換和其他內置功能可以幫助您有趣地查看 Jira 數據。

使用轉換來增強 JQL

雖然有許多轉換在 Grafana 可供選擇,下面提供了一個強大的增強給 JQL 的 SQL 的一些功能/功率。

組依據此轉換提供不屬於標準 Jira JQL 語法一部分的主要功能:群組。使用「群組依據」轉換,您可以按「衝刺」或其他「問題」欄位進行分組,並按群組彙總,以取得速度和故事點估計值與 Sprint 中的實際完成度量。

外連接類似於 SQL 連接,您可以通過公共字段將 2 個或多個查詢連接在一起。這提供了一種合併查詢中的數據集並使用其他轉換來計算來自多個查詢/數據集的值的方法。

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

使用 Grafana 的轉換來回答常見問題

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

如何顯示每個衝刺的速度?

  1. 選取欄位:衝刺名稱故事點估計

  2. 添加一個 JQL 過濾器:project = "Your Project" AND type != epic AND status = done order by created ASC

  3. 新增群組依據轉換:

    • 衝刺名稱 | 分組依據

    • 故事點估計 | 計算 | 總計

  4. 選擇酒吧高日可視化

如何在 Sprint 中顯示已完成與估計的內容?

  1. 加入查詢。首先,選取 [欄位:衝刺名稱]、[衝刺開始日期]、 [故事點估算]。

    然後添加一個 JQL 過濾器:project = 'Your Project' AND type != epic

  2. 新增第二個查詢。首先,選取 [欄位:衝刺名稱]、[衝刺開始日期]、 [故事點估算]。

    然後添加一個 JQL 過濾器:project = 'Your Project' AND type != epic AND status = done

  3. 新增群組依據轉換:

    • 衝刺名稱 | 分組依據

    • 衝刺開始日期 | 分組方式

    • 故事點估計 | 計算 | 總計

  4. 選擇圖視覺效果。

在我的專案中完成問題的平均時間是多少?

  1. 加入查詢。首先,選取欄位:已建立狀態類別已變更

    然後添加一個 JQL 過濾器:project = 'Your Project' AND type != epic AND status = done

  2. 新增轉換:從計算新增欄位

    • 模式 = 減少行

    • 計算 = 差異

  3. 新增轉換:從計算新增欄位

    • 模式 = 二進制操作

    • 操作 = 差異

    • 別名 = 天數

  4. 新增轉換:組織欄位

    • 隱藏不同欄位

  5. 新增轉換:依值篩選資料

    • 過濾器類型 = 包括

    • 條件 = 符合任何

      • 欄位 = 天 | 相符項目 = 大於 | 值 = 1

  6. 新增轉換:減少

    • 模式 = 序列到行

    • 計算 = 平均值

  7. 選擇「統計」視覺效果。