插件 〉Grafana Enterprise Traces
Grafana Enterprise Traces
Grafana Enterprise Traces
Grafana Enterprise Traces (GET) 是基于开源项目 Tempo 的商业产品。该商业产品允许您在自己的数据中心部署高度可扩展、简单且可靠的追踪集群。该应用插件为您提供了一种轻松管理追踪集群的方式。
功能
- 租户管理:轻松在一个集群上扩展到数百个 GET 租户。
- 访问策略和令牌:完全控制并可视化谁拥有哪些访问权限。
- 环健康:提供集群中各种服务环的当前状态概览。
配置
插件在您的 Grafana 实例中安装完成后,请启用并初始化它
- 导航至 Administration > Plugins and data > Plugins
- 从插件列表中选择 Grafana Enterprise Traces 应用。
- 如果出现警报,提示此应用插件未启用,请点击 Enable 按钮启用插件。警报文本将指示其所在位置。
- 确保使用您的 GET 的引导令牌以及 Grafana 实例可访问集群的相应 URL 填写 连接设置 部分。
- 开始使用 Grafana Enterprise Traces 应用插件。
在 Grafana Cloud 上安装 Grafana Enterprise Traces
在 Grafana Cloud 实例上安装插件只需一步;更新也一样。很棒,对吧?
请注意,插件可能需要最多 1 分钟才会显示在您的 Grafana 中。
在 Grafana Cloud 实例上安装插件只需一步;更新也一样。很棒,对吧?
请注意,插件可能需要最多 1 分钟才会显示在您的 Grafana 中。
在 Grafana Cloud 实例上安装插件只需一步;更新也一样。很棒,对吧?
请注意,插件可能需要最多 1 分钟才会显示在您的 Grafana 中。
在 Grafana Cloud 实例上安装插件只需一步;更新也一样。很棒,对吧?
请注意,插件可能需要最多 1 分钟才会显示在您的 Grafana 中。
在 Grafana Cloud 实例上安装插件只需一步;更新也一样。很棒,对吧?
请注意,插件可能需要最多 1 分钟才会显示在您的 Grafana 中。
在 Grafana Cloud 实例上安装插件只需一步;更新也一样。很棒,对吧?
请注意,插件可能需要最多 1 分钟才会显示在您的 Grafana 中。
在 Grafana Cloud 实例上安装插件只需一步;更新也一样。很棒,对吧?
请注意,插件可能需要最多 1 分钟才会显示在您的 Grafana 中。
欲了解更多信息,请访问关于插件安装的文档。
在本地 Grafana 上安装
对于本地实例,插件通过简单的 CLI 命令进行安装和更新。插件不会自动更新,但当有可用更新时,您将在 Grafana 中直接收到通知。
1. 安装应用
使用 grafana-cli 工具通过命令行安装 Grafana Enterprise Traces
grafana-cli plugins install
插件将安装到您的 grafana 插件目录;默认目录为 /var/lib/grafana/plugins。更多关于 CLI 工具的信息。
2. 启用它
接下来,登录您的 Grafana 实例。导航到插件部分,该部分位于 Grafana 主菜单中。
在插件部分的 应用 选项卡中,点击并选择新安装的应用。
要启用应用,点击 配置 选项卡。按照应用提供的说明操作,然后点击 启用。应用和所有新的 UI 页面现在都可以从主菜单中访问,这是由应用创建者设计的。
如果应用包含仪表盘,系统将尝试自动安装它们。要查看仪表盘、重新导入或删除单个仪表盘,请点击应用页面内的 仪表盘 选项卡。
更新日志
此项目的所有重要变更将记录在此文件中。此项目遵循 语义化版本控制。
共享版本和更新日志
自 2024 年 10 月 (v5.0.0) 起,此更新日志的内容由共同的“GEx Plugins”项目中的多个插件共享。更新日志条目将指明变更是否特定于单个插件。插件的版本发布将同步并共享相同的版本号。
v6.0.0 -- 2025 年 4 月 30 日
- [特性] - 添加
policiesOnly
jsonData 字段。将其设置为true
可实现更精简的界面,仅显示“访问策略”页面- 此配置要求至少已创建一个租户。
- [特性] - 添加更简单的
accessToken
安全字段,它将取代旧的base64EncodedAccessToken
安全字段accessToken
不需要额外的编码步骤,而base64EncodedAccessToken
需要
- [修复] - 当访问令牌不正确时,显示更具信息性的错误消息
- [修复] - 简化连接设置的验证,减少对后端的重复调用
- [修复] - 允许 GEx 插件在集群配置端点不工作时仍能运行(在因配置缺失导致功能受限的情况下显示警告)
v5.2.0 -- 2025 年 3 月 14 日
- [增强] - 为生成的数据源使用 GEM、GEL、GET 作为前缀而非 GE,以避免唯一的名称冲突
- [增强] - GEM 插件:“仪表盘”GEM 插件管理页面允许手动安装和更新仪表盘
- 仪表盘及其对应的数据源和文件夹不再默认安装或更新
- 特权用户必须导航到 GEM 插件管理页面,进入“仪表盘”选项卡,并使用“安装...”按钮
- [修复] - GEM 插件:顶部租户仪表盘缺少标签:“GEM”、“self-monitoring”
v5.1.3 -- 2025 年 1 月 22 日
- [修复] - 更新了依赖项
v5.1.2 -- 2024 年 12 月 10 日
- [修复] - 为每个主要页面提供页内导航链接
v5.1.1 -- 2024 年 12 月 9 日
- [修复] - 如果插件尚未配置或设置,配置页面会崩溃
v5.1.0 -- 2024 年 12 月 7 日
- [特性] - 在连接配置中添加了对 TLS 证书的支持
v5.0.2 -- 2024 年 10 月 11 日
- [修复] - 修正了未配置连接设置的错误消息处理
v5.0.0 -- 2024 年 10 月 10 日
- [重大变更] - 已弃用对 Admin API v1 和 v2 的支持。仅使用 Admin API v3,该 API 于 2022 年 4 月引入。
- 支持 v3 API 的最早企业版数据库版本如下
- GEM v2.0
- GEL v1.4
- GET v1.3
- 支持 v3 API 的最早企业版数据库版本如下
- [重大变更] - 官方支持的 Grafana 版本范围现在是:
>= 10.4.10 < 11
||>= 11.1.0
- 已移除对 Grafana Enterprise v8 和 v9 的向后兼容性支持
- [修复] - 改进了企业版许可故障检测和报告,以帮助更快地识别此问题
- [修复] - 更新了依赖项以解决安全问题
- [修复] - 移除保存插件配置时的 5 秒延迟
同步更新日志结束
GET 插件变更(同步前)
以下版本和变更代表 GET 插件在所有插件同步到 v5.0.0 之前的版本和变更。
v2.3.1 -- 2024 年 6 月 25 日
- [修复] - 更新了依赖项以解决安全问题
v2.3.0 -- 2024 年 3 月 14 日
- [修复] - 环健康:标准化了环选择器的外观,并移除了难以辨认的告警颜色
- [修复] - 更新了依赖项以解决安全问题
v2.2.2 -- 2024 年 1 月 12 日
- [修复] - 检测更多许可错误和后端错误状态,向用户呈现根本原因信息
- [修复] - 更新了依赖项以解决安全问题
v2.2.1 -- 2023 年 11 月 28 日
- [修复] - 更新了依赖项以解决安全问题
v2.2.0 -- 2023 年 11 月 7 日
- [修复] - 更新了依赖项以解决安全问题
- [增强] - 在 GET 环健康页面包含 compactor、distributor 和 metrics-generator 环
v2.1.1 -- 2023 年 9 月 22 日
- [修复] - 更新了依赖项以解决安全问题
v2.1.0 -- 2023 年 9 月 19 日
- [增强] - 租户统计数据将每 30 分钟自动重新获取
- [增强] - 在许可证页面显示 Grafana Enterprise 许可证的详细信息
- [修复] - 解决了 CVE 漏洞报告
- [修复] - 处理没有显示名称的租户和访问策略
v2.0.0 -- 2023 年 3 月 31 日
- [特性] - 更改了支持的 Grafana 版本范围:
>= 8.5.20 < 9
||>= 9.1.0
;如果 Grafana 版本不在官方支持范围内,将显示警告 - [特性] - 添加了对 Grafana 9.3 的支持,包括Grafana 的新导航更新
- [特性] - 后端数据库版本现在显示在插件页面(和配置页面)上
- [增强] - 添加了访问策略范围的描述
- [增强] - 在创建/编辑租户、访问策略和令牌的请求期间添加了进度指示器;请求完成后,屏幕右上角将显示成功的告警通知
- [增强] - 环健康页面允许选择没有成员的环
- [增强] - 插件配置页面已移至与其他插件页面(例如,租户、访问策略等)并存;当禁用“topnav”时,它会显示为一个选项卡,或者在启用“topnav”时显示在相同的导航菜单树结构中;
- [增强] - 插件配置页面不再重复禁用或启用插件的功能
- [增强] - 插件配置页面有一个取消按钮,用于恢复到保存的状态
- [增强] 使用集群功能检测以获得更好的与后端的向后和向前兼容性
- [增强] - 为令牌过期添加了可选的自定义过期日期
- [增强] - 根据本地数字字符串格式化数字
- [增强] - 添加了关于生成令牌后创建数据源所需的最低访问策略范围要求的指示
- [增强] - 插件概览页面现在显示准确的描述
- [修复] - 创建数据源时,检查是否已定义后端 URL
- [修复] - 在没有剩余激活租户的访问策略中创建令牌时,用户会收到警告且无法创建数据源
- [修复] - 环健康页面更优雅地处理后端错误(例如,使用 forget 按钮的请求失败时)
- [修复] - 环健康页面能够处理表达“不健康”环成员状态的新实现
- [修复] - 更好地支持名称很长的访问策略:现在可以为它们创建多个令牌;它们的名称很长也能正确显示而不会破坏布局
- [修复] - 租户页面不再发出多个冗余请求(根据租户数量)
- [修复] - 生成标识符时,管理资源显示名称现在能正确地将所有非字母数字字符转换为短划线
- [修复] - 在输入字段上添加了对租户限制覆盖的限制,例如阻止无效的负数限制
- [修复] - 编辑访问策略现在使用编辑按钮
- [修复] - 启用了编辑租户的功能
- [修复] - 澄清了集群配置页面上的语言,以更好地指示显示值的来源
- [修复] - 集群配置页面现在能正确提取顶级配置,并对所有其他部分使用字母顺序
- [修复] - 在访问策略页面上,指示令牌获取状态,而不是总是默认为具有误导性的“没有令牌”。
- [修复] - 修复了阻止编辑访问策略范围的问题
v1.1.0 -- 2022 年 5 月 2 日
- [增强] - 改进了访问策略的创建流程,包括根据用户创建数据源的意图自动选择适当的范围
- [增强] - 添加了对 admin API 版本 2 和 3 的支持;版本可在插件配置中选择
- [增强] - 调试导出现在显示,取决于后端支持情况
- [增强] - 改进了创建和编辑租户、访问策略和令牌的表单可用性
- [增强] - 恢复了与 Grafana v7.5 的兼容性
- [增强] - 令牌创建对话框现在以天为单位定义过期时间
- [特性] - 添加了环健康页面
- [修复] - 修复了在较新版本的 Grafana 中令牌创建对话框的复制到剪贴板功能
- [修复] - 在令牌对话框中,创建数据源的功能已适当地限制为单个租户(以匹配后端服务的实际能力)
- [修复] - 在获取令牌、访问策略和租户集合时解析初始 If-Match ETag
- [修复] - 删除插件设置和远程写入 URL 中的额外尾部斜杠
- [修复] - 令牌创建对话框仅在存在读取范围时才会提供创建数据源的选项
- [修复] - 修复了环健康页面中“最后一次心跳”列的日期解释;相对时间偏移现在会定期更新,并且工具提示将显示报告的日期和时间
- [修复] - 澄清了许可证状态,如果许可证已过期或接近过期,将提供警告横幅
- [修复] - 修复了环健康页面“忘记”按钮的行为:环成员现在仅在请求成功后才会从列表中移除
v1.0.2 -- 2022 年 3 月 14 日
- [修复] - 修复了适用于 Grafana v8.3+ 的复制到剪贴板功能
v1.0.1 -- 2022 年 2 月 24 日
- [修复] - 添加了与 grafana-enterprise v8.4.2+ 的兼容性
v1.0.0 -- 2021 年 11 月 9 日
- 初始版本,包含 Grafana Enterprise Traces (GET) 的基本功能。