连接到 GitLab 数据来源 - Amazon Managed Grafana

连接到 GitLab 数据来源

GitLab 数据来源允许您跟踪 GitLab 的详细统计信息,例如排名靠前的贡献者、每天的提交量或每天的部署量。您也可以使用模板变量(例如项目)为控制面板设置筛选器。您可以将来自 GitLab API 的数据与其他来源的数据相结合。

注意

此数据来源仅适用于 Grafana Enterprise。有关更多信息,请参阅 管理对 Enterprise 插件的访问

此外,在支持版本 9 或更高版本的工作区中,此数据来源可能需要您安装相应的插件。有关更多信息,请参阅 使用插件扩展您的工作区

已知限制条件

此插件尚不支持警报,因为警报查询中不支持转换,转换是从 GitLab API 原始数据中获取有意义的聚合指标的唯一方法。

添加数据来源

  1. 在 Amazon Managed Grafana 工作区中打开 Grafana 控制台,并确保您已登录。

  2. 配置(齿轮图标)下的侧边菜单中,选择数据来源

  3. 选择添加数据来源

    注意

    如果您在侧边菜单中看不到数据来源链接,则表示您当前的用户没有 Admin 角色。

  4. 从数据来源列表中选择 GitLab

  5. 输入以下信息:

    • 对于名称,输入此 GitLab 数据来源的名称。

    • 对于 URL,请输入您的 GitLab 实例的根 URL,例如 https://gitlab.com/api/v4

    • 对于访问令牌,请输入您的 GitLab 个人访问令牌。

查询 GitLab 数据来源

在 GitLab 查询编辑器中,您可以选择不同的资源类型,例如提交、问题或发布。

筛选和查看项目
  1. 从下拉菜单中,选择项目

  2. (可选)按您拥有的项目进行筛选。

  3. 使用下拉列表并选择来筛选结果。

    注意

    获取所有已拥有 = 否的项目可能需要很长时间。

筛选并查看提交
  1. 从下拉菜单中选择提交

  2. 使用输入字段添加项目 ID。

  3. (可选)要按分支/标签进行筛选,请使用输入字段添加分支/标签引用。

筛选和查看问题
  1. 从下拉菜单中,选择问题

  2. 使用输入字段添加项目 ID。

  3. (可选)要按标题/描述进行筛选,请使用输入字段根据标题描述搜索问题。

查看版本
  1. 从下拉菜单中,选择部署

  2. 使用输入字段添加项目 ID。

  3. (可选)要按环境进行筛选,请使用输入字段。状态属性可以是以下任何值:createdrunningsuccessfailedcanceled

查看标签
  1. 从下拉菜单中,选择标签

  2. 使用输入字段添加项目 ID。

模板和变量

要添加新的 GitLab 查询变量,请参阅 添加查询变量。使用您的 GitLab 数据来源作为数据来源。选择资源类型:版本项目标签

要获取项目、标签等对象的动态列表供您选择,请创建一个 Query 类型变量。查询类型变量使用 GitLab 查询编辑器来查询和返回项目、标签等。以下示例创建了一个 Project 变量来参数化您的查询

创建 Project 变量来参数化查询
  1. 添加名为 project 且类型为 Query 的变量。

  2. 选择您的 GitLab 数据来源并刷新位于控制面板负载上

  3. 选择 Project 资源类型,已拥有的值为显示字段的值为名称值字段的值为 ID

  4. 选择更新将变量添加到控制面板。

  5. 向控制面板添加一个新面板并使用 $project 作为项目 ID。

    现在,当从下拉列表中进行选择时,您会得到属于该项目的结果。

使用 Grafana 中的转换来回答常见问题

现在,您可以执行基本的 GitLab 查询来查找提交、问题等,您可以使用转换来可视化、聚合、分组和联接数据集,还可以使用许多其他类型的转换将简单结果转换为复杂问题的答案。以下是一些常见问题以及如何使用转换来回答这些问题。

我的项目每天有多少提交/问题/部署?

  1. 添加查询。选择提交作为资源类型,然后添加项目 ID。

  2. 添加新的分组依据转换:对于分组依据,选择 created_at_date,然后计算 (Count)=id

  3. 选择图形可视化。

我的项目中问题关闭的平均时间是多少?

  1. 添加查询。选择问题作为资源类型,然后添加项目 ID。

  2. 添加新的从计算添加字段转换:对于模式,选择二元操作,对于操作,选择 closed_at = created_ate,对于别名,选择 resolution_time

  3. 添加新的从计算添加字段转换:对于模式,选择二元操作,对于操作,选择 resolution_time / 86400000,对于别名,选择 resolution_time

    对于替换所有字段,选择 True

  4. 选择统计可视化。

    • 显示 = 计算

    • 计算 = 平均值

    • 字段 = resolution_time