本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
Connect 连接到 GitLab 数据源
GitLab 数据源允许您跟踪详细的 GitLab 统计数据,例如排名靠前的贡献者、每天的提交量或每天的部署量。您也可以使用模板变量(例如项目)为仪表板设置筛选器。您可以将来自 GitLab API 的数据与其他来源的数据合并。
注意
此数据源仅适用于 Grafana 企业版。有关更多信息,请参阅 管理对企业插件的访问权限。
此外,在支持版本 9 或更高版本的工作空间中,此数据源可能需要您安装相应的插件。有关更多信息,请参阅 使用插件扩展您的工作空间。
已知限制条件
此插件尚不支持警报,因为警报查询中不支持转换,转换是从 GitLab API 原始数据中获取有意义的聚合指标的唯一方法。
添加数据源
-
在亚马逊托管 Grafana 工作区中打开 Grafana 控制台,并确保您已登录。
-
在 “配置”(齿轮图标)下的侧面菜单中,选择 “数据源”。
-
选择添加数据来源。
注意
如果您在侧面菜单中看不到数据源链接,则表示您当前的用户没有该
Admin
角色。 -
GitLab从数据源列表中选择。
-
输入以下信息:
-
在名称中,输入该 GitLab数据源的名称。
-
对于 URL,请输入您的 GitLab 实例的根 URL,例如
https://gitlab.com/api/v4
。 -
对于访问令牌,请输入您的 GitLab个人访问令牌。
-
查询 GitLab 数据源
在 GitLab 查询编辑器中,您可以选择不同的资源类型,例如提交、议题或发布。
筛选和查看项目
-
从下拉菜单中选择 “项目”。
-
(可选)按您拥有的项目进行筛选。
-
使用下拉列表并选择 “是” 或 “否” 来筛选结果。
注意
获取所有已拥有 = 否的项目可能需要很长时间。
筛选和查看提交
-
从下拉菜单中选择 “提交”。
-
使用输入字段添加项目 ID。
-
(可选)要按分支/标签进行筛选,请使用输入字段添加分支/标签引用。
筛选和查看问题
-
从下拉菜单中选择 “问题”。
-
使用输入字段添加项目 ID。
-
(可选)要按标题/描述进行筛选,请使用输入字段根据标题和描述搜索问题。
查看新闻稿
-
从下拉菜单中选择 “部署”。
-
使用输入字段添加项目 ID。
-
(可选)要按环境/状态进行筛选,请使用输入字段。状态属性可以是以下值之一:
created
、running
、success
failed
、或canceled
。
查看标签
-
从下拉菜单中选择 “标签”。
-
使用输入字段添加项目 ID。
模板和变量
要添加新的 GitLab 查询变量,请参阅添加查询变量。使用您的 GitLab 数据源作为数据源。选择资源类型:发行版、项目或标签。
要获取项目、标签等的动态列表供您选择,请创建一个 Query 类型变量。查询类型变量使用 GitLab 查询编辑器来查询和返回项目、标签等。以下示例创建了一个 Project 变量来参数化您的查询
创建 Project 变量来参数化查询
-
添加名为 Query 类型的变量
project
。 -
选择您的 GitLab 数据源并刷新 “仪表板加载时”。
-
选择 “项目” 资源类型,“拥有” 为 “是”,为显示字段选择 “名称”,为 “值” 字段选择 ID。
-
选择 “更新” 将变量添加到控制面板。
-
向仪表板添加一个新面板并
$project
用作项目 ID。现在,当从下拉列表中进行选择时,你会得到属于该项目的结果。
使用 Grafana 中的转换来回答常见问题
现在,您可以执行基本 GitLab 查询来查找提交、问题等,您可以使用 Transformations 对数据集进行可视化、聚合、分组和联接,还可以使用许多其他类型的转换将简单的结果转换为复杂问题的答案。以下是一些常见问题以及如何使用变换来回答这些问题。
我的项目每天有多少提交/问题/部署?
-
添加查询。为资源类型选择 “提交”,然后添加项目 ID。
-
添加新的按转换分组:对于分组依据,选择 created_at_date,然后计算(计数)=id
-
选择图表可视化。
我的项目中解决问题的平均时间是多少?
-
添加查询。为资源类型选择 “问题”,然后添加项目 ID。
-
从计算转换中添加一个新的 “添加” 字段 :对于 “模式”,选择 “二元运算”,选择 “操作”,选择 c losed_at = created_at,对于 “别名”,选择 resolution_time。
-
从计算转换中添加一个新的 “添加” 字段 :在 “模式” 中,选择 “二进制运算”,为 “操作” 选择 resolution _time/86400000,在 “别名” 中选择 resolution_time。
对于 “替换所有字段”,选择 True。
-
选择统计可视化。
-
显示 = 计算
-
计算 = 平均值
-
字段 = 分辨率时间
-