連線至 Jira 資料來源 - Amazon Managed Grafana

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

連線至 Jira 資料來源

透過將 Jira 的問題資料與其他來源的應用程式效能資料結合,取得開發程序的完整樣貌。

注意

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

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

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

  • 追蹤詳細的 Jira 統計資料,例如平均解決時間和問題輸送量。

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

已知限制

可能不支援 Jira 附加元件的自訂欄位類型。

新增資料來源

  1. 在 Amazon Managed 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 執行個體中的任何欄位進行選取,包括自訂欄位。要嘗試的一些欄位:

    • 摘要 — 問題的名稱

    • Epic Name:問題所屬的 epis

    • 案例點估算 - 團隊已針對問題預估的案例點數量

  2. 篩選或排序問題。若要執行此操作,請輸入任何有效的 JQL 表達式,根據其任何欄位篩選或排序問題,例如 ProjectAssigneeSprint with Atlassian 查詢語言 JQL。

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

時間序列查詢

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

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

範本和變數

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

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

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

建立 Assignee 變數,以取得 Assignee 的問題狀態
  1. 新增名為 的查詢類型的變數assignee

  2. 選取欄位:受指派者

  3. )選用) 新增 JQL 篩選專案 = '您的專案'

  4. 選擇執行以查看受指派者清單。

  5. 選擇更新,將變數新增至儀表板。

  6. 將新面板新增至儀表板,並使用新變數指派者 = $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 的轉換來回答常見問題

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

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

  1. 選取欄位:Sprint NameStory 點預估

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

  3. 新增依轉換的群組

    • 衝刺名稱 | 群組依據

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

  4. 選擇長條規視覺化。

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

  1. 新增查詢。首先,選取欄位:Sprint NameSprint Start Date、Story Point 估算

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

  2. 新增第二個查詢。首先,選取欄位:Sprint NameSprint Start Date、Story Point 估算

    然後新增 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. 新增轉換:從計算新增欄位

    • 模式 = 二進位操作

    • 操作 = 差異 / 86000000

    • 別名 = 天

  4. 新增轉換:整理欄位

    • 隱藏不同的欄位

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

    • 篩選條件類型 = 包含

    • 條件 = 符合任何

      • 欄位 = 天 | 相符 = 較大 | 值 = 1

  6. 新增轉換:減少

    • 模式 = 系列到資料列

    • 計算 = 平均值

  7. 選擇 Stat 視覺化。