菜单

Grafana Enterprise 许可证

Enterprise 开源

Grafana Enterprise 许可证

成为 Grafana Enterprise 客户后，您将获得 Grafana 的高级可观测性功能，包括 Enterprise 数据源插件、报告和基于角色的访问控制。为了使用这些Grafana Enterprise 的增强功能，您必须购买并激活 Grafana Enterprise 许可证。

要直接从 Grafana Labs 购买许可证，请联系 Grafana Labs 代表。要激活从 Grafana Labs 购买的 Enterprise 许可证，请参阅激活 Enterprise 许可证。

您也可以通过 AWS Marketplace 购买 Grafana Enterprise 许可证。要了解如何激活通过 AWS 购买的许可证，请参阅激活通过 AWS Marketplace 购买的 Grafana Enterprise 许可证。

激活通过 AWS Marketplace 购买的 Grafana Enterprise 许可证

激活 Enterprise 许可证

请按照以下步骤激活您的 Grafana Enterprise 许可证

步骤 1. 下载您的许可证文件

下载您的 Grafana Enterprise 许可证

登录您的Grafana Cloud账户。
前往我的账户，并在页面左上角的下拉菜单中选择一个组织。在每个组织的概览页面上，您可以看到 Grafana Enterprise 许可证部分。点击许可证旁边的详情。
如果许可证显示“许可证未配置”或 URL 列为“-”，则需要更新详情。这需要管理员角色。
1. 点击许可证详情旁边的更新。如果更新按钮不可见，请联系 Grafana 账户团队。
2. 输入 URL。它必须与 Grafana Enterprise 实例的有效root_url配置设置（包括末尾的斜杠）匹配。它应该是用户在浏览器中访问前端时输入的 URL，而不是节点主机名。URL 必须以“https://”开头，且不能是 localhost 或包含通配符。
3. （可选）编辑许可证名称。此名称仅用于显示。
4. 点击保存。
在许可证详情页面底部，选择下载令牌以下载包含您的许可证的 license.jwt 文件。

步骤 2. 将您的许可证添加到 Grafana 实例

您必须安装 Grafana Enterprise 版本才能使用企业功能，您可以下载该版本。

注意
如果您已经在使用 Grafana OSS，可以用相同版本的 Grafana Enterprise 替换它。在继续之前，请务必备份配置和数据库。更多信息，请参阅
备份 Grafana.

将许可证添加到 Grafana 实例有多种方法

通过 Grafana 服务器管理员页面上传许可证文件

这是 Grafana Enterprise 单实例安装的首选选项。

以 Grafana 服务器管理员身份登录。
在侧边导航菜单中，点击管理 > 常规 > 统计信息和许可证。
点击上传新令牌。
选择您的许可证文件，然后上传。

将 `license.jwt` 文件放入 Grafana 的数据目录

在 Linux 系统上，数据目录通常位于 /var/lib/grafana。

您还可以使用 grafana.ini 设置配置许可证文件的自定义位置

[enterprise]
license_path = /company/secrets/license.jwt

此设置也可以通过环境变量设置，如果您使用 Docker 运行 Grafana 并拥有存放许可证文件的自定义卷，这将非常有用。在这种情况下，设置环境变量 GF_ENTERPRISE_LICENSE_PATH 指向您的许可证文件位置。

将许可证文件内容设置为配置选项

您可以将 license.jwt 的内容粘贴到 grafana.ini 配置文件中来添加许可证

[enterprise]
license_text = eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ0aGlzIjoiaXMiLCJub3QiOiJhIiwidmFsaWQiOiJsaWNlbnNlIn0.bxDzxIoJlYMwiEYKYT_l2s42z0Y30tY-6KKoyz9RuLE

此选项可以使用 GF_ENTERPRISE_LICENSE_TEXT 环境变量设置。

步骤 3. 确保许可证文件的 root URL 与 root_url 配置选项匹配

更新配置中的root_url。它应该是用户在浏览器中访问前端时输入的 URL，而不是节点主机名。

这很重要，因为作为启动时验证检查的一部分，Grafana 会将许可证 URL 与配置中的root_url进行比较。

在您的配置文件中

[server]
root_url = https://grafana.example.com/

或使用环境变量

GF_SERVER_ROOT_URL=https://grafana.example.com/

步骤 4. 重启 Grafana

要完成 Grafana Enterprise 的安装，请重启 Grafana 以启用所有 Grafana Enterprise 功能。更多信息，请参阅重启 Grafana。

许可证到期

如果您的许可证已过期，Grafana 的大部分功能将正常工作。部分企业功能会停止或以受限功能运行，Grafana 会显示横幅通知用户正在使用过期许可证运行。您的 Grafana 管理员需要上传新的许可证文件以恢复全部功能。

请尽快更换您的许可证。在许可证过期的情况下运行 Grafana Enterprise 是不受支持的，并可能导致意外后果。

更新您的许可证

找到您当前的 license.jwt 文件。在标准安装中，它通常存储在 Grafana 数据目录中，在典型的 Linux 安装中该目录位于 /var/lib/grafana/data。此位置可以在 ini 文件配置中被覆盖。
ini
```
[enterprise]
license_path = /path/to/your/license.jwt
```
配置文件的位置也可以通过 GF_ENTERPRISE_LICENSE_PATH 环境变量覆盖。
登录您的Grafana Cloud 账户，并确保您位于页面顶部下拉菜单中正确的组织。
在左侧菜单栏的 Grafana Enterprise 部分下，选择许可证并下载您想要运行 Grafana 所使用的当前有效许可证。如果您在 Grafana.com 上看不到有效许可证，请联系 Grafana Labs 的客户经理续订您的订阅。
用您刚刚下载的文件替换当前的 license.jwt 文件。
重启 Grafana.

如果您的许可证到期

如果您的 Grafana Enterprise 许可证到期，您可能会遇到以下功能行为变化。

数据源权限

您当前的数据源权限将按预期继续工作，但在许可证续订之前，您将无法添加新的数据源权限。

LDAP 身份验证

LDAP 同步不受许可证过期影响。
团队同步调试不可用。

SAML 身份验证

SAML 身份验证不受许可证过期影响。

基于角色的访问控制 (RBAC)

无法创建、更新和删除自定义角色。
无法修改自定义角色的权限。

报告

您无法配置新的报告或生成预览。
现有报告将继续发送。

Enterprise 插件

Enterprise 插件可能会停止工作。

白标签

白标签功能将关闭，这意味着任何白标签选项都不会生效。

使用洞察

对于过期超过 7 天的许可证，将使用洞察日志导出到 Loki 的功能将关闭。

许可证一过期，所有其他使用洞察功能都将关闭，这意味着您将无法查看仪表盘使用情况、在线状态指示或使用改进的搜索。Grafana 会继续收集使用数据，您更新许可证后即可访问。

Vault 集成

Vault 集成不受许可证过期影响。

审计

审计不受许可证过期影响。

许可证限制

并发会话限制在到期日期后仍保持活动七天，之后将被关闭。

活动用户限制会立即关闭。

运行时设置更新

运行时设置更新不受许可证过期影响。

外部用户将无法再访问通过电子邮件共享的仪表盘。这些仪表盘现在是私有的，但如果需要，您可以将其设置为公开并供所有人访问。

Grafana 会保留您的共享配置，并在您更新许可证后恢复它们。

Grafana Enterprise 许可证限制

成为 Grafana Enterprise 客户后，您将获得一份管理您使用 Grafana Enterprise 的许可证。

活动用户限制

您的 Grafana 许可证包含最大活动用户数。

活动用户是指在过去 30 天内登录过 Grafana 的用户。这是一个每日更新的滚动窗口。
当达到最大活动用户数时，只有当前活动用户（过去 30 天内登录过的用户）才能登录。当新用户或先前非活动用户尝试登录时，用户会看到一条错误消息，指示 Grafana 已达到许可证限制。
用户的角色、用户可以查看或编辑的仪表盘数量以及他们可以访问的组织数量不影响活动用户计数。
当 Grafana 达到活动用户限制时，管理员会看到许可证限制横幅；编辑者和查看者不会看到该横幅。

确定活动用户数

以系统管理员身份登录 Grafana Enterprise。
在侧边导航菜单中，点击管理。
点击常规。
点击统计信息和许可证。
在利用率面板上查看利用率计数。

分层许可证（已弃用）

分层许可证将仪表盘查看者、仪表盘编辑者和管理员定义为两种不同的用户类型，每种类型都有自己的用户限制。

Grafana 只计数并强制执行 Grafana 实例中的总活动用户数。例如，如果您购买了 150 个活动用户许可证，您可以有 20 个管理员、70 个编辑者和 60 个查看者，或者您可以有 150 个管理员。即使您使用的许可证授予了特定数量的管理员或编辑者以及一定数量的查看者，Grafana 也会强制执行总活动用户数。这比以前的策略更宽松，为您提供了更改用户角色的灵活性。

如果您运行的是 Grafana Enterprise 9.0 版本之前的版本，请参阅该版本的文档以了解当前版本中的许可证强制执行情况。

其他许可证限制

您的许可证受以下规则控制

许可证到期日期：许可证包含一个到期日期，即许可证失效的日期。

随着许可证到期日临近，您将在 Grafana 中看到一个鼓励您续订的横幅。要了解如何续订许可证以及许可证到期后 Grafana 中的变化，请参阅许可证到期。

许可证令牌过期：Grafana Enterprise 需要一个有效令牌，该令牌会自动续订。

许可证令牌是激活您许可证的数字密钥。默认情况下，通过调用 Grafana API，许可证令牌每 24 小时续订一次。短生命周期的许可证令牌可以更频繁地验证许可证是否合规，并允许更频繁的许可证更新 - 例如，添加用户或使已泄露的许可证失效。

要查看您的许可证令牌详情，请以服务器管理员身份登录 Grafana Enterprise，并访问管理 > 常规 > 统计信息和许可证。令牌详情位于许可证详情下的令牌部分。

许可证令牌续订需要互联网访问，并要求 auto_refresh_license 配置设置设置为 true。如果您的 Grafana Enterprise 实例无法连接到互联网，请联系您的 Grafana Labs 客户团队以获取令牌续订和许可证审计的其他选项。

Grafana 许可证 URL：您的许可证不能用于具有不同 root URL 的 Grafana 实例。

许可证 URL 是您的 Grafana 实例的完整 URL，例如 https://grafana.your-company.com/。它在root_url配置设置中定义。

并发会话限制：从 Grafana Enterprise 7.5 开始，用户最多可以发起三个 Grafana 并发会话。

当用户从新设备、不同浏览器或无痕窗口登录 Grafana 时，系统会创建一个会话。如果用户在同一浏览器中的另一个标签页或窗口登录 Grafana，则只使用一个会话。

当用户达到会话限制时，第四个连接将成功，并且最长时间不活动的会话将被注销。

请求更改您的许可证

要增加 Grafana 内的许可用户数、延长许可证或更改您的许可 URL，请联系 Grafana 支持团队或您的 Grafana Labs 客户团队。他们将更新您的许可证，您可以在 Grafana 中激活它。

有关更新许可证后如何激活的说明，请参阅激活 Enterprise 许可证。

按使用量计费

标准的 Grafana Enterprise 许可证包含一定数量的可使用席位，并阻止超过许可数量的用户登录 Grafana。如果您更喜欢可预测的费用，这是合理的。但是，如果您预计使用模式随时间变化不均匀，或者在关键时刻不能因容量限制阻止任何用户登录 Grafana，这可能会成为问题。

对于这些用例，我们支持按使用量计费，您的许可证包含一定数量的包含用户，并每月按超出数量的活动用户计费。

按使用量计费涉及您与 Grafana Labs 之间的合同协议以及您的许可证更新，并且仅在 Grafana Enterprise 10.0.0 或更高版本配置为自动刷新其许可证令牌时可用。

用户去重

如果您的组织有多个启用按使用量计费的 Grafana Enterprise 实例，则每个活动用户在您的许可证中只计数一次，无论该用户登录多少个实例。每个 Grafana Enterprise 实例每天通过 API 向 Grafana Labs 提交一个用户哈希列表。每个用户电子邮件地址或匿名设备 ID 使用单向 sha256 算法进行哈希处理，并提交给 Grafana，在那里对跨实例的哈希用户进行去重。