变更日志

本项目的所有重要变更将记录在此文件中。本项目遵循 Semantic Versioning（语义化版本控制）。

共享版本控制和变更日志

本变更日志的内容追溯至 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”，“自监控”。

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
• [重大变更] - 官方支持的 Grafana 版本范围现为：>= 10.4.10 < 11 || >= 11.1.0。
  • 已移除对 Grafana Enterprise v8 和 v9 的向后兼容性支持。
• [修复] - 改进了企业许可证故障检测和报告，以帮助更快地识别此问题。
• [修复] - 更新了依赖项以解决安全问题。
• [修复] - 移除了保存插件配置时的 5 秒延迟。

同步变更日志结束

GEM 插件变更（同步前）

以下版本和变更代表了 GEM 插件在所有插件同步到 v5.0.0 之前的版本和变更。

v4.1.2 -- 2024 年 6 月 25 日

• [修复] - 更新了依赖项以解决安全问题。
• [修复] - 更新了基数仪表盘，以兼容基于 Scenes 的仪表盘。

v4.1.1 -- 2024 年 4 月 10 日

• [修复] - 替换已弃用的 GEM 自监控仪表盘面板，使用当前的“时间序列”和“表格”面板类型。

v4.1.0 -- 2024 年 3 月 14 日

• [修复] - Ring 健康：标准化了 Ring 选择器的外观，并移除了难以看清的告警颜色。
• [修复] - Ring 健康：按字母顺序显示“Alertmanager”。
• [修复] - 更新了依赖项以解决安全问题。

v4.0.9 -- 2024 年 1 月 12 日

• [修复] - 检测更多许可证错误和后端错误状态，向用户提供根本原因信息。
• [修复] - 更新了依赖项以解决安全问题。

v4.0.8 -- 2023 年 11 月 28 日

• [修复] - 更新了依赖项以解决安全问题。

v4.0.7 -- 2023 年 11 月 7 日

• [修复] - 更新了依赖项以解决安全问题。
• [修复] - 冻结 GEM 仪表盘并移除仪表盘生成脚本。

v4.0.6 -- 2023 年 9 月 22 日

• [修复] - 更新了依赖项以解决安全问题。

v4.0.5 -- 2023 年 9 月 19 日

• [修复] - 更新了依赖项以解决安全问题。

v4.0.4 -- 2023 年 9 月 7 日

• [改进] - 租户统计信息将每 30 分钟自动重新获取。
• [改进] - 在许可证页面显示 Grafana Enterprise 许可证详情。
• [修复] - 解决了 CVE 漏洞报告。
• [修复] - 更新了数据源代理，使用 uid 代替 id（基数）。

v4.0.3 -- 2023 年 6 月 19 日

• [修复] - 处理没有显示名称的租户和访问策略。

v4.0.1 -- 2023 年 3 月 31 日

• [改进] - 为令牌过期添加了可选的自定义过期日期。
• [改进] - 根据本地数字字符串格式化数字。
• [改进] - 在生成令牌后添加了创建数据源所需的最低访问策略范围要求指示。
• [改进] - 插件概览页面现在显示准确的描述。
• [修复] - 创建数据源时，检查后端 URL 是否已定义。
• [修复] - 在没有剩余激活租户的访问策略中创建令牌时，用户会收到警告且无法创建数据源。

v4.0.0 -- 2023 年 1 月 31 日

• [功能] - 更改了支持的 Grafana 版本范围：>= 8.5.20 < 9 || >= 9.1.0；如果 Grafana 版本不在官方支持范围内，则会显示警告。
• [功能] - 添加了对 Grafana 9.3 的支持，包括Grafana 的新导航更新。
• [功能] - 后端数据库版本现在在插件（和配置页面）上显示。
• [功能] - 添加了新的自监控仪表盘。
  • 概览
  • Alertmanager（需要 GEM v2.5 或更高版本才能使所有面板正常工作）
  • Alertmanager 资源
  • 配置
  • 对象存储
  • 覆盖项
  • 查询
  • Ruler
  • 租户
  • 热门租户
• [改进] - 基数仪表盘具有更完整的即席过滤功能集。
  • 通过即席过滤器深入基数仪表盘时，仪表盘链接会保留现有上下文。
  • 已添加额外的链接（特别是树状图面板），允许用户深入并探索不同范围的基数。
• [改进] - 基数数据源已得到增强。
  • 即席过滤器对于查询编辑器和查询浏览器视图中的各种查询类型都有效，并正确地限定了“pairs”->“details”查询/面板以及“series”->“totals”的范围。
  • 可以使用“选择器”输入进行范围限定。
• [改进] - 添加了访问策略范围的描述。
• [改进] - 在创建/编辑租户、访问策略和令牌的请求过程中添加了进度指示；请求完成后，屏幕右上角现在会显示一个成功的警报通知。
• [改进] - Ring 健康页面允许选择没有成员的 Ring。
• [改进] - 插件配置页面已移至与其他插件页面（例如，租户、访问策略等）并存；当“topnav”禁用时，它以选项卡形式显示，当“topnav”启用时，它显示在相同的导航菜单树状结构中；
• [改进] - 插件配置页面不再重复禁用或启用插件的功能。
• [改进] - 插件配置页面有一个取消按钮，可以恢复到已保存的状态。
• [修复] - 基数数据源已更改了“labels”->“details”查询的数据帧标题，以显示标签键。
• [修复] - 基数数据源查询类型“series”->“subtotal”现在正确填充了“查询目标”字段的选项。
• [修复] - Ring 健康页面更优雅地处理后端错误（例如，当使用“忘记”按钮的请求失败时）。
• [修复] - Ring 健康页面能够处理表达“不健康”Ring 成员状态的更新实现。
• [修复] - 更好地支持名称非常长的访问策略：现在可以为其创建多个令牌；它们的冗长名称现在可以显示而不会破坏布局。
• [修复] - 租户页面不再发出多个冗余请求（每个租户数量）。
• [修复] - 生成标识符时，管理员资源显示名称现在正确地将所有非字母数字字符转换为破折号。
• [修复] - 对租户限制覆盖的输入字段添加了限制，例如防止无效的负值限制。

v3.6.4 -- 2023 年 1 月 31 日

• [修复] - 在修改仪表盘和数据源时，将自动刷新替换为刷新建议通知。

v3.6.3 -- 2022 年 9 月 23 日

• [修复] - 修正了“系统监控概览”仪表盘上的一些链接到“按租户使用情况”的链接。

v3.6.2 -- 2022 年 9 月 12 日

• [改进] - 添加了在基数仪表盘上使用即席过滤器的功能。
• [修复] - 修复了用户未输入任何限制覆盖项时租户创建表单的保存行为。

v3.6.1 -- 2022 年 8 月 10 日

• [修复] - 丰富了更精确租户统计信息的自监控数据正在从不太精确的值正确更新。

v3.6.0 -- 2022 年 7 月 28 日

• [功能] - 访问策略可以为支持 TSDB 块上传的 GEM 集群设置 metrics:import 范围（预计在 GEM 2.3 中提供）。
• [改进] - 使用集群功能检测以更好地向后和向前兼容后端。
• [修复] - 租户和访问策略的编辑现在使用编辑按钮。
• [修复] - 丰富了更精确租户统计信息的自监控数据已更正，以匹配按租户仪表盘上显示的结果。
• [修复] - 自监控 Compactor 仪表盘的“上次成功运行”面板现在在 Grafana 8.5 及更高版本中正确渲染。
• [修复] - 自监控概览仪表盘的“分数”面板现在在 Grafana 9.0 及更高版本中正确渲染。
• [修复] - 确保在 Grafana 8.4 及更高版本上运行 GEM 2.0 之前的版本时，新创建的访问策略能正确显示。
• [修复] - 在访问策略页面上，显示令牌获取状态，而不是总是默认显示误导性的“无令牌”。
• [修复] - 修复了阻止编辑访问策略范围的问题。
• [修复] - 从 Ring 健康页面移除了查询调度程序，因为它不存在于 GEM 中。

v3.5.3 -- 2022 年 6 月 10 日

• [修复] - 修复了仪表盘更新行为，该行为导致出现误导性错误消息，从而阻止了更新。
• [修复] - 禁用 GEM 插件时移除 GEM 仪表盘文件夹（仍然包含用户定义仪表盘或与告警规则关联的文件夹除外）。
• [修复] - 在运行具有多个目标（例如 -target=all,overrides-exporter）的 GEM 实例时，GEM 自监控仪表盘中的各种面板在其查询中存在错误的选定项。
• [修复] - 澄清了集群配置页面上的语言，以更好地指示显示值的来源。
• [修复] - 基数仪表盘：修复了指向 find unused metrics 的失效链接，使其使用 mimirtool。
• [修复] - 集群配置页面现在能正确提取顶级配置，并对所有其他部分使用字母顺序。

v3.5.2 -- 2022 年 5 月 2 日

• [修复] - 修复了导致 GEM 插件被禁用的仪表盘更新行为。
• [修复] - 当未明确配置管理 API 版本时，将自动检测最新的兼容版本并将其作为默认值。
• [修复] - 访问策略创建表单为“是”按钮（关于创建数据源的范围）提供了信息丰富的工具提示；同时确保默认添加了正确的范围。
• [修复] - 修复了 Ring 健康页面中“上次心跳”列日期解释问题；相对时间偏移量现在将周期性更新，并且工具提示将显示报告的日期和时间。
• [修复] - 澄清了许可证状态，如果许可证已过期或即将过期，则提供警告横幅。
• [修复] - Ring 健康页面上的 Ring 类型按字母顺序排列。
• [修复] - 修复了 Ring 健康页面“忘记”按钮的行为：只有请求成功后，Ring 成员才会从列表中移除。

v3.5.1 -- 2022 年 4 月 25 日

• [修复] - 修复了导致插件被禁用的错误。

v3.5.0 -- 2022 年 4 月 22 日

• [改进] - 改进了访问策略创建流程，包括根据用户创建数据源的意图自动选择适当的范围。
• [改进] - 在检测到不一致时，对自监控数据源添加了纠正措施，包括防止数据源名称重复/相似以及手动用户删除/修改。
• [修复] - 修复了 GEM 旧版本的令牌删除问题。
• [修复] - 修复了自动仪表盘数据源初始化，使其仅限于具有 Admin 角色的用户。
• [修复] - 防止在修改插件配置后禁用插件。

v3.4.1 -- 2022 年 4 月 18 日

• [改进] - 改进了基数管理仪表盘布局，使其更一致，并适用于更窄的窗口尺寸。
• [修复] - 修复了与管理 API 版本 1 和 2 在列出访问策略和令牌时的兼容性问题。
• [修复] - 修复了找不到自监控数据源时显示租户统计信息的问题。
• [修复] - 修复了插件配置验证器在应显示 URL 错误时提供了关于可用版本的误导性错误消息的问题。

v3.4.0 -- 2022 年 4 月 13 日

• [功能] - 在 *自监控 Compactor* 仪表盘中添加了 *上次成功运行* Compactor 面板。
• [功能] - 创建令牌和数据源时允许访问策略租户使用通配符。
• [功能] - 在 *按租户自监控* 和 *概览* 仪表盘中包含 exemplar 面板。
• [功能] - 用户现在可以设置每个租户的 Compactor 块保留和 exemplar 限制。
• [改进] - 在基数仪表盘中添加了 *示例标签值*。
• [改进] - 在标签基数仪表盘中添加了应用了目标标签的 *系列比例*。
• [改进] - 在基数标签仪表盘中添加了 *系列百分比* 面板。
• [改进] - 在指标基数仪表盘中添加了 *示例标签值*。
• [改进] - 向 *Ring 健康* 页面添加了更多 Ring。
• [改进] - 添加了自监控数据以显示更准确的租户统计信息。
• [改进] - 添加了对管理 API 版本 2 和 3 的支持；可在插件配置中选择版本。
• [改进] - 调试导出现在显示，取决于后端支持。
• [改进] - 改进了创建和编辑租户、访问策略和令牌的表单可用性。
• [改进] - 恢复了与 Grafana v7.5 的兼容性。
• [改进] - 令牌创建对话框现在以天为单位定义过期时间。
• [改进] - 安装新版本的 GEM 时，仪表盘会自动刷新。
• [修复] - *按租户自监控使用情况* 仪表盘更好地代表了系列限制。
• [修复] - 修复了 Grafana 较新版本的令牌创建对话框复制到剪贴板功能。
• [修复] - 获取令牌、访问策略和租户集合时解释初始 If-Match ETag。
• [修复] - 降低了基数数据的刷新间隔。
• [修复] - 移除了插件设置和远程写入 URL 中多余的尾部斜杠。
• [修复] - 解决了基数数据源查询编辑器控件的 Bug。
• [修复] - 自监控数据源现在可以处理多个 Grafana 实例访问同一个 GEM 实例的情况。
• [修复] - 令牌创建对话框仅在存在读取范围时才会提供创建数据源的选项。
• [修复] - 禁用 GEM 插件时，不会创建空的仪表盘文件夹。

v3.3.2 -- 2022 年 3 月 14 日

• [修复] - 修复了 Grafana v8.3+ 的复制到剪贴板功能。

v3.3.1 -- 2022 年 2 月 24 日

• [修复] - 添加了与 grafana-enterprise v8.4.2+ 的兼容性。

v3.3.0 -- 2021 年 11 月 16 日

• [功能] - 基数管理仪表盘。
• [修复] - 术语更改为“租户”（之前是“实例”）。
• [修复] - 编辑租户的限制设置时仅显示可定制的限制。
• [修复] - 删除租户的自定义限制可以通过在保存更改之前移除所有自定义限制条目来完成。
• [修复] - 修复了与保存和更新实例限制相关的 issue (If-Match, ETag 稳定性)。
• [修复] - 仪表盘初始化例程刷新逻辑。

v3.2.1 -- 2021 年 8 月 23 日

• [修复] - 自监控仪表盘：将部分图表按降序排序。

v3.2.0 -- 2021 年 8 月 19 日

• [改进] - 在插件配置页面上显示未正确格式化的访问令牌的更详细错误消息。
• [改进] - 更新自监控仪表盘，引入新的“概览仪表盘”。

v3.1.0 -- 2021 年 8 月 9 日

• [功能] - 添加一个按钮用于导出关于网关/管理 API 目标的调试信息。
• [功能] - 可以创建适用于集群中所有实例的通配符访问策略。
• [修复] - GEM 自监控数据源：在初始化过程中处理 backendUrl 中多余的斜杠。
• [修复] - GEM 自监控数据源：使其在代理环境中也能进行存在检测。
• [修复] - Ring 健康表：按成员 ID 排序时使用自然排序（解释字符串中的数字）。
• [修复] - 在访问策略表单中，实例选择器不再显示 __system__ 实例。
• [修复] - 为适用于多个实例的访问策略创建令牌时，现在有一个按钮可以创建一个数据源以包含所有这些实例；用户现在可以一键创建一个数据源来执行跨租户查询。

v3.0.4 -- 2021 年 6 月 28 日

• [修复] - 在“创建 / 更新访问策略”中防止回车键触发标签删除。

v3.0.3 -- 2021 年 6 月 17 日

• [修复] - 更新了范围名称：rules:read 和 rules:write，以兼容最近的后端更改。
• [修复] - 更新了 GEM 自监控仪表盘的文本内容（v2.1.0 中引入）。

v3.0.2 -- 2021 年 6 月 15 日

• [修复] - 将自监控仪表盘移至单独文件夹（v2.1.0 中引入）。
• [修复] - 提高了 GEM 自监控仪表盘初始化的灵活性（v2.1.0 中引入）。

v3.0.1 -- 2021 年 6 月 15 日

• [修复] - 创建新实例、访问策略或令牌时，使模态框可滚动（v3.0.0 中引入）。
• [修复] - 通过传递正确的 If-Match 头，使更新再次工作（v3.0.0 中引入）。

v3.0.0 -- 2021 年 6 月 14 日

• [功能] - 使插件与 Grafana 8 兼容（**重大变更！** - 此版本不再兼容早期版本的 Grafana）。

v2.1.1 - 2021 年 6 月 17 日

• [修复] - 更新了范围名称：rules:read 和 rules:write，以兼容最近的后端更改。
• [修复] - 更新了 GEM 自监控仪表盘的文本内容（v2.1.0 中引入）。

v2.1.0 - 2021 年 6 月 14 日

• [功能] - 使访问策略可编辑。
• [功能] - 更新访问策略列表项的外观。
• [功能] - 包含 GEM 自监控仪表盘。

v2.0.1 - 2021 年 4 月 29 日

• [修复] - 使数组类型的实例限制可编辑。
• [修复] - 为令牌创建数据源后，使数据源链接遵循基本 URL。
• [修复] - 使“admin”、“alerts:read”和“alerts:write”范围可用于新的访问策略。
• [修复] - 暂时移除“Ring 健康”页面下的集群选择器。

v2.0.0 - 2021 年 4 月 20 日

• [修复] - 使实例统计信息一致显示。
• [功能] - 使实例可编辑。
• [功能] - 在实例列表中可视化实例限制。
• [功能] - 添加一种在创建新实例时设置实例特定限制的方法。
• [功能] - 通用 Ring 健康页面取代了 Ingester Ring 页面。
  • 现在可以监控和修复所有五个 Ring。
  • 用户可以指定刷新间隔。

v1.9.3 -- 2021 年 3 月 17 日

• [修复] - 在应用配置页面上显示格式不正确令牌的提示（并禁用提交）。
• [修复] - 使退格键在令牌输入字段中起作用。

v1.9.2 -- 2021 年 2 月 18 日

• [修复] - 更新 README。

v1.9.1 -- 2021 年 2 月 3 日

• [修复] - 将后端插件添加到构建中。

v1.9.0 -- 2021 年 2 月 1 日

• [功能] - 更新没有实例/访问策略时的设计。
• [功能] - 在实例/访问策略列表上方显示当前 UTC 时间。
• [功能] - 添加一种简单的方法，用于在创建新的 metrics:read 令牌时自动生成数据源。

v1.8.0 -- 2021 年 1 月 22 日

• [功能] - 可以为新令牌设置过期日期。
• [功能] - 更新成功创建令牌模态框的外观。
• [修复] - 创建访问策略时仅在有意义的情况下显示标签选择器。

v1.7.0 -- 2021 年 1 月 22 日

• [功能] - 创建新的访问策略时，引入后端支持的所有范围。
• [修复] - 修复创建新的访问策略时自动生成名称的稳定性问题。
• [修复] - 自动生成实例和访问策略的名称时，不要更改连字符“-”。

v1.6.0 -- 2021 年 1 月 20 日

• [功能] - 为具有写入权限的访问策略创建新令牌时，显示可复制的远程写入配置片段。

v1.5.0 -- 2021 年 1 月 12 日

• [功能] - 可以手动设置新实例的“名称”。

v1.4.2 -- 2021 年 1 月 7 日

• [修复] - 修复侧边栏导航。

v1.4.1 -- 2020 年 12 月 16 日

• [修复] - 如果实例未定义标签选择器，则不显示其占位符。
• [修复] - 修复详细访问策略页面上实例名称的宽度。

v1.4.0 -- 2020 年 12 月 16 日

• [功能] - 创建访问策略时可以为实例定义标签选择器。
• [功能] - 添加具有语法高亮标签策略的访问策略详细页面。

v1.3.0 -- 2020 年 11 月 19 日

• [功能] - 在 Cortex 配置下显示可折叠部分并使其可搜索
• [功能] - 标记默认访问策略并移除其删除按钮。同时添加如何删除它的提示。

v1.2.0 -- November 2 2020

• [功能] - 添加一个显示许可信息的标签页
• [功能] - 为访问策略添加新设计
• [功能] - 如果可用，显示实例统计信息

v1.1.1 -- September 24 2020

• [修复] - 使插件导航链接即使在 Grafana 安装在基本 URL 下也能正常工作
• [修复] - 使来自 API 的错误消息对用户可见

v1.1.0 -- September 16 2020

• [功能] - 更新标志

v1.0.0 -- September 16 2020

• [功能] - 引入访问策略
• [功能] - 将密钥替换为访问策略和令牌
• [功能] - 限制插件和管理员 API 仅管理员用户可访问
• [功能] - 移除数据源插件并将所有配置移至应用程序插件下
• [功能] - 将令牌移至访问策略标签下以便用户流程更便捷
• [杂项] - 添加可选的模拟服务器以便开发

v0.9.1 -- August 13 2020

• [修复] 默认启用 Ingester Ring 标签页

v0.9.0 -- August 13 2020

• [功能] 添加 Ingester Rings 标签页，显示包含可用 ingester 的基本表格
• [功能] 更新插件标志
• [杂项] 在插件配置页面添加插件描述

v0.8.0 -- July 31 2020

• [功能] 为新建实例和新建密钥表单添加错误处理

v0.7.0 -- July 24 2020

• [杂项] 将插件重命名为 "Grafana Metrics Enterprise"。
• [功能] 在创建新实例时以选择框显示可用集群。

v0.6.0 -- July 23 2020

• [功能] 默认隐藏 UI 中的某些标签页。

v0.5.5 -- July 22 2020

• [功能] 支持设置/读取功能标志。

v0.5.4 -- July 21 2020

• [功能] 在创建新密钥后一次性显示令牌。

v0.5.2 -- July 14 2020

• [修复] 在创建新实例时添加缺失的集群字段

v0.5.1 -- July 13 2020

• [修复] 修复点击标签页切换问题 (由 v0.5.0 引入)

v0.5.0 -- July 9 2020

• [功能] 自动生成密钥和实例的名称

v0.4.0 -- July 8 2020

• [功能] 显示实例的集群和创建时间
• [功能] 显示密钥的过期时间、连接的实例和作用域

v0.3.0 -- July 6 2020

• [功能] 更新实例标签页的 UI
• [功能] 更新密钥标签页的 UI
• [功能] 可以删除实例和密钥
• [功能] 在模态框中打开创建密钥和创建实例表单

v0.2.0 -- June 26 2020

• [功能] 添加对密钥“领域”(Realms)的支持

v0.1.0 -- June 3 2020

• [功能] 添加对管理员信息端点的初步支持

v0.0.1 -- May 20 2020

• [功能] 存在性。#90
• [功能] 添加对管理员实例管理认证的支持。#94