插件 〉Grafana Enterprise Logs
Grafana Enterprise Logs
Grafana Enterprise Logs
Grafana Enterprise Logs (GEL) 是基于开源项目 Loki 的商业产品。该商业产品允许您在自己的数据中心部署高可扩展、简单且可靠的日志集群。此应用插件为您提供了一种轻松管理日志集群的方式。
特性
- 租户管理: 在一个集群上轻松扩展到数百个 GEL 租户。
- 访问策略和令牌: 完全控制和可视化谁拥有哪些访问权限。
- 环健康状况 概览集群中各种服务环的当前状态。
配置
将插件安装到您的 Grafana 实例后,启用并初始化它
- 导航到 管理 > 插件和数据 > 插件
- 从插件列表中选择 Grafana Enterprise Logs 应用。
- 如果警报指示此应用插件未启用,请单击启用按钮启用插件。警报文本将指示可以在何处找到它。
- 确保使用您的 GEL 的引导令牌和 Grafana 实例可以访问集群的相应 URL 填写连接设置部分。
- 开始使用 Grafana Enterprise Logs 应用插件。
在 Grafana Cloud 上安装 Grafana Enterprise Logs
在 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 Logs
grafana-cli plugins install
插件将安装到您的 grafana 插件目录;默认是 /var/lib/grafana/plugins。更多关于 cli 工具的信息。
2. 启用它
接下来,登录您的 Grafana 实例。导航到 Grafana 主菜单中的“插件”部分。
单击“插件”部分的应用标签页,然后选择新安装的应用。
要启用应用,请单击配置标签页。按照应用提供的说明操作,然后单击启用。应用和任何新的 UI 页面现在可以在主菜单中访问,这由应用创建者设计。
如果应用包含仪表盘,它们将尝试自动安装。要查看仪表盘、重新导入或删除单个仪表盘,请单击应用页面内的仪表盘标签页。
更新日志
此项目的所有重要更改都将在此文件中记录。本项目遵循语义化版本控制。
共享版本控制和更新日志
此更新日志的内容,追溯至 2024 年 10 月 (v5.0.0),由通用“GEx 插件”项目中的多个插件共享。更新日志条目将指明某项更改是否针对特定插件。插件的发布将同步并共享相同的版本号。
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”、“自监控”
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,该版本于 2022 年 4 月引入。
- 支持 v3 API 的 Enterprise Databases 最早版本如下:
- GEM v2.0
- GEL v1.4
- GET v1.3
- 支持 v3 API 的 Enterprise Databases 最早版本如下:
- [重大变更] - 官方支持的 Grafana 版本范围现为:
>= 10.4.10 < 11 || >= 11.1.0
- 已移除对 Grafana Enterprise v8 和 v9 的向后兼容性支持
- [修复] - 改进了企业版许可证故障检测和报告,有助于更快地识别此问题
- [修复] - 更新了依赖项以解决安全问题
- [修复] - 移除了保存插件配置时的 5 秒延迟
同步更新日志结束
GEL 插件更改(同步前)
以下版本和更改代表 GEL 插件在同步所有插件到 v5.0.0 之前的版本和更改。
v3.2.1 -- 2024 年 6 月 25 日
- [修复] - 更新了依赖项以解决安全问题
v3.2.0 -- 2024 年 3 月 14 日
- [修复] - 环健康状况:标准化了环选择器的外观,并移除了难以看清的警报颜色
- [修复] - 更新了依赖项以解决安全问题
v3.1.4 -- 2024 年 1 月 12 日
- [修复] - 检测更多许可证错误和后端错误状态,向用户呈现根本原因信息
- [修复] - 更新了依赖项以解决安全问题
v3.1.3 -- 2023 年 11 月 28 日
- [修复] - 更新了依赖项以解决安全问题
v3.1.2 -- 2023 年 11 月 7 日
- [修复] - 更新了依赖项以解决安全问题
v3.1.1 -- 2023 年 9 月 22 日
- [修复] - 更新了依赖项以解决安全问题
v3.1.0 -- 2023 年 9 月 19 日
- [增强] 租户统计信息将每 30 分钟自动重新获取
- [增强] 在许可证页面显示 Grafana Enterprise 许可证详情
- [修复] 解决了 CVE 漏洞报告
- [修复] 处理没有显示名称的租户和访问策略
v3.0.1 -- 2023 年 3 月 31 日
- [增强] - 为令牌过期时间添加了可选择的自定义过期日期
- [增强] - 根据本地数字字符串格式化数字
- [增强] - 添加了生成令牌后创建数据源所需的最低访问策略范围要求的提示
- [增强] - 插件概览页面现在显示准确的描述
- [修复] - 创建数据源时,我们检查是否定义了后端 URL
- [修复] - 在没有剩余活动租户的访问策略中创建令牌时,用户会收到警告且无法创建数据源
v3.0.0 -- 2023 年 1 月 31 日
- [特性] - 更改了支持的 Grafana 版本范围:
>= 8.5.20 < 9 || >= 9.1.0
;如果 Grafana 版本不在官方支持的范围内,将显示警告 - [特性] - 增加了对 Grafana 9.3 的支持,包括Grafana 的新导航更新
- [特性] - 后端数据库版本现在显示在插件(和配置页面)上
- [增强] - 添加了访问策略范围的描述
- [增强] - 在创建/编辑租户、访问策略和令牌的请求期间添加了进度指示器;请求完成后,屏幕右上角会显示成功警报通知
- [增强] - 环健康页面允许选择没有成员的环
- [增强] - 插件配置页面已移至与其他插件页面(例如租户、访问策略等)并存;当“topnav”禁用时,它会显示为一个标签页;当“topnav”启用时,它会显示在同一导航菜单树结构中;
- [增强] - 插件配置页面不再重复禁用或启用插件的功能
- [增强] - 插件配置页面有一个取消按钮,可以将设置恢复到保存的状态
- [修复] - 环健康页面更优雅地处理后端错误(例如,当使用“忘记”按钮的请求失败时)
- [修复] - 环健康页面能够处理表达“不健康”环成员状态的新实现
- [修复] - 更好地支持名称很长的访问策略:现在可以为它们创建多个令牌;它们的冗长名称现在可以在不破坏布局的情况下显示
- [修复] - 租户页面不再发出多个冗余请求(按租户数量)
- [修复] - 生成管理员资源标识符时,其显示名称现在能正确地将所有非字母数字字符转换为破折号
- [修复] - 对输入字段上的租户限制覆盖添加了限制,例如防止无效的负数限制
v2.6.0 -- 2022 年 7 月 28 日
- [特性] - 对于支持联邦查询的 GEL 集群(预计在 GEL 1.5 中),启用了一键创建包含多个租户的数据源功能
- [增强] - 使用集群特性检测,以实现更好的向后和向前兼容性
- [修复] - 编辑访问策略现在使用编辑按钮
- [修复] - 添加了编辑租户的功能
- [修复] - 澄清了集群配置页面上的措辞,以更好地指示显示值的来源
- [修复] - 集群配置页面现在能正确提取顶级配置,并对所有其他部分使用字母顺序
- [修复] - 在访问策略页面,指示令牌获取状态,而不是总是默认显示误导性的“无令牌。”
- [修复] - 修复了阻止编辑访问策略范围的问题
v2.5.1 -- 2022 年 5 月 2 日
- [修复] - 当未显式配置 admin api 版本时,将自动检测最新的兼容版本并作为默认值
- [修复] - 访问策略创建表单为“是”按钮提供了信息丰富的工具提示(关于创建数据源的范围);同时确保默认添加正确的范围
- [修复] - 修复了环健康页面中“上次心跳”列日期解释不正确的问题;相对时间偏移现在将定期更新,并且工具提示将显示报告的日期和时间
- [修复] - 澄清许可证状态,在许可证过期或即将过期时提供警告横幅
- [修复] - 环健康页面上的环类型按字母顺序排列
- [修复] - 修复了环健康页面“忘记”按钮的行为:现在只有请求成功后,环成员才会被从列表中移除
- [修复] - 移除了访问策略租户标签选择器上不适用于 GEL 的文本
v2.5.0 -- 2022 年 4 月 22 日
- [增强] - 改进了访问策略创建流程,包括根据用户创建数据源的意图自动选择合适的范围
- [修复] - 修复了 GEL 旧版本的令牌删除问题
- [修复] - 防止修改插件配置后插件被禁用
v2.4.1 -- 2022 年 4 月 18 日
- [修复] - 修复了与 admin API 版本 1 和 2 在列出访问策略和令牌方面的兼容性问题
- [修复] - 修复了找不到自监控数据源时租户统计信息显示的问题
- [修复] - 修复了插件配置验证器在应显示 URL 错误时提供关于可用版本的误导性错误消息的问题
v2.4.0 -- 2022 年 4 月 13 日
- [特性] - 添加了环健康页面
- [增强] - 为 GEL 添加了 rules:read rules:write 范围
- [增强] - 添加了对 admin API 版本 2 和 3 的支持;可在插件配置中选择版本
- [增强] - 调试导出功能现在出现,具体取决于后端是否支持
- [增强] - 改进了创建和编辑租户、访问策略和令牌的表单可用性
- [增强] - 恢复了与 Grafana v7.5 的兼容性
- [增强] - 令牌创建对话框现在以天为单位定义过期时间
- [修复] - 修复了 Grafana 新版本中令牌创建对话框的复制到剪贴板功能
- [修复] - 在令牌对话框中,创建数据源的能力被适当地限制为单个租户(以匹配后端服务的实际能力)
- [修复] - 获取令牌、访问策略和租户集合时,解释初始的 If-Match ETag
- [修复] - 移除插件设置和远程写入 URL 中多余的尾部斜杠
- [修复] - 令牌创建对话框仅在存在读取范围时才会提供创建数据源的选项
v2.3.2 -- 2022 年 3 月 14 日
- [修复] - 修复了 Grafana v8.3+ 中的复制到剪贴板功能
- [修复] - 为 GEL 添加 rules:read rules:write
v2.3.1 -- 2022 年 2 月 24 日
- [修复] - 添加了与 grafana-enterprise v8.4.2+ 的兼容性
v2.3.0 -- 2021 年 11 月 12 日
- [特性] - 添加了编辑访问策略的功能
- [修复] - 确保不显示
__system__
访问策略 - [修复] - 术语更改为“租户”(之前是“实例”)
- [修复] - 修复了与保存和更新实例限制相关的问题(If-Match,ETag 稳定性)
v2.2.0 -- 2021 年 8 月 19 日
- [增强] - 在插件配置页面为格式不正确的访问令牌显示更详细的错误消息
- [增强] - 更新了自监控仪表盘,引入了新的“概览仪表盘”
v2.1.0 -- 2021 年 8 月 13 日
- [特性] - 添加了一种在创建新的 logs:read 令牌时自动生成数据源的简单方法
- [特性] - 支持创建应用于集群中所有实例的通配符访问策略
- [修复] - 在自监控不可用时隐藏
__system__
实例
v2.0.1 -- 2021 年 6 月 15 日
- [修复] - 使创建新实例、访问策略或令牌时模态框可滚动(v2.0.0 中引入)
v2.0.0 -- 2021 年 6 月 14 日
- [特性] - 使插件与 Grafana 8 兼容(重大变更! - 此版本不再兼容旧版本 Grafana)
v1.1.0 -- 2021 年 6 月 14 日
- [修复] - 使“admin”、“alerts:read”和“alerts:write”范围可用于新的访问策略
- [特性] - 更新了访问策略列表项的外观
- [特性] - 在插件中启用了 LBAC(基于标签的访问控制)
v1.0.1 -- 2021 年 3 月 17 日
- [修复] - 在应用配置页面为格式不正确的令牌显示提示(并禁用提交)
- [修复] - 使退格键在令牌输入字段中起作用
v1.0.0
初始发布,支持 Grafana Enterprise Logs (GEL) 的基本特性。