連線至 Jira 資料來源 - Amazon Managed Grafana
已知限制新增資料來源查詢 Jira 資料來源時間序列查詢範本和變數使用 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 表達式，根據其任何欄位篩選或排序問題，例如 Project、 Assignee 或 Sprint with Atlassian 查詢語言 JQL。

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

時間序列查詢

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

上述範例本身並不實用。數值欄位可以是 （且最有可能是） 從轉換計算。使用依轉換分組將允許依 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 Name、Story 點預估。

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

  3. 新增依轉換的群組：

    • 衝刺名稱 | 群組依據

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

  4. 選擇長條規視覺化。

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

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

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

  2. 新增第二個查詢。首先，選取欄位：Sprint Name、Sprint 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 視覺化。