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

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

GitLab 資料來源可讓您追蹤詳細的 GitLab 統計資料，例如最高參與者、每天遞交或每天部署。您也可以使用範本變數，例如專案，為您的儀表板設定篩選條件。您可以將來自 GitLab API 的資料與其他來源的資料合併。

**注意**  
此資料來源僅適用於 Grafana Enterprise。如需詳細資訊，請參閱[管理對企業外掛程式的存取](upgrade-to-enterprise-plugins.md)。  
此外，在支援第 9 版或更新版本的工作區中，此資料來源可能會要求您安裝適當的外掛程式。如需詳細資訊，請參閱[使用外掛程式擴展您的工作區](grafana-plugins.md)。

## 已知限制
<a name="gitlab-known-limitations"></a>

此外掛程式尚未支援警示，因為警示查詢不支援轉換，而轉換是從 GitLab API 原始資料取得有意義的彙總指標的唯一方法。

## 新增資料來源
<a name="gitlab-adding-the-data-source"></a>

1.  在 Amazon Managed Grafana 工作區中開啟 Grafana 主控台，並確保您已登入。

1.  在**組態** （齒輪圖示） 下的側邊選單中，選擇**資料來源**。

1.  選擇**新增資料來源**。
**注意**  
 如果您在側邊選單中看不到**資料來源**連結，這表示您目前的使用者沒有 `Admin`角色。

1.  從資料來源清單中選取 **GitLab**。

1. 輸入下列資訊：
   + 針對**名稱**，輸入此 GitLab 資料來源的名稱。
   + 針對 **URL**，輸入 GitLab 執行個體的根 URL，例如 **https://gitlab.com/api/v4**。
   + 針對**存取字符**，輸入您的 GitLab 個人存取字符。

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

從 GitLab 查詢編輯器中，您可以選取不同的資源類型，例如遞交、問題或版本。

**篩選和檢視專案**

1.  從下拉式選單中，選擇**專案**。

1.  （選用） 依您擁有的專案篩選。

1.  使用下拉式清單，然後選取**是**或**否**來篩選結果。
**注意**  
 擷取所有**專案 擁有 = 否** 可能需要很長的時間。

**篩選和檢視遞交**

1.  從下拉式選單中，選擇**遞交**。

1.  使用輸入欄位來新增專案 ID。

1.  （選用） 若要依分支/標籤篩選，請使用輸入欄位來新增分支/標籤參考。

**篩選和檢視問題**

1.  從下拉式選單中，選擇**問題**。

1.  使用輸入欄位來新增專案 ID。

1.  （選用） 若要依標題/描述篩選，請使用輸入欄位根據**標題**和**描述**搜尋問題。

**檢視版本**

1.  從下拉式選單中，選擇**部署**。

1.  使用輸入欄位來新增專案 ID。

1.  （選用） 若要依環境/狀態篩選，請使用輸入欄位。**狀態**屬性可以是下列其中一個值：`created`、`running`、`failed`、 `success`或 `canceled`。

**檢視標籤**

1.  從下拉式選單中，選擇**標籤**。

1.  使用輸入欄位來新增專案 ID。

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

若要新增新的 GitLab 查詢變數，請參閱 [新增查詢變數](variables-types.md#add-a-query-variable)。使用您的 GitLab 資料來源做為資料來源。選擇資源類型：**版本**、**專案**或**標籤**。

若要取得專案、標籤等的動態清單以供選擇，請建立查詢類型變數。查詢類型變數使用 GitLab 查詢編輯器來查詢和傳回專案、標籤等。下列範例會建立專案變數來參數化您的查詢

**建立專案變數以參數化您的查詢**

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

1.  選取您的 GitLab 資料來源，並在**儀表板載入時**重新整理。

1.  選取**專案**資源類型，**是**表示**擁有**，**顯示欄位****的名稱**和**值欄位 ****的 ID**。

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

1. 將新面板新增至儀表板，並使用 **$project**做為專案 ID。

   現在，從下拉式清單中選擇時，您會取得屬於該專案的結果。

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

現在，您可以執行基本的 GitLab 查詢來尋找遞交、問題等，您可以使用轉換來視覺化、彙總、分組和聯結資料集，以及許多其他類型的轉換，將簡單的結果轉換為複雜問題的答案。以下是一些常見問題，以及如何使用轉換來回答這些問題。

**我的專案中每天commits/issues/deployments？**

1.  新增查詢。針對資源類型選取**遞交**，然後新增專案 ID。

1.  **依**轉換新增群組：針對**群組依據**，選取 **create\_at\_date**，然後計算 **(Count)=id** 

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

**在我的專案中關閉問題的平均時間為何？**

1.  新增查詢。選取資源類型的**問題**，然後新增專案 ID。

1.  **從計算**轉換新增欄位：對於**模式**，選取**二進位操作**，對於**操作**，選取 **closed\_at = created\_at**，對於**別名**，選取 **resolution\_time**。

1.  **從計算**轉換中新增欄位：對於**模式**，選取**二進位操作**，對於**操作**，選取 **resolution\_time / 86400000**，對於**別名**，選取 **resolution\_time**。

   針對**取代所有欄位**，選擇 **True**。

1. 選擇 **Stat** 視覺化。
   + 顯示 = 計算
   + 計算 = 平均值
   + 欄位 = **resolution\_time**