配置资源并同步仪表板

注意
配置（Provisioning）是 Grafana v12 开源版和 Enterprise 版引入的实验性功能。不提供工程和 On-call 支持。文档有限或仅在代码注释中提供。不提供 SLA。Grafana Cloud 中不提供此功能。

使用配置（Provisioning），您可以配置如何将仪表板 JSON 文件存储在 GitHub 仓库中（使用 Git Sync）或本地路径中。

在这两种实验性选项中，Git Sync 是配置（Provisioning）仪表板的推荐方法。您可以将任何新仪表板和对现有仪表板的更改同步到您配置的 GitHub 仓库。如果在仓库中推送更改，这些更改将反映在您的 Grafana 实例中。有关配置 Git Sync 的更多信息，请参阅设置 Git 同步。

请参阅设置文件供应以了解更多关于 Grafana 12 中本地文件配置（provisioning）版本的信息。

已供应的文件夹和连接

保存到本地路径的仪表板和文件夹被称为“已供应”资源，并在 Grafana UI 中以此标记。

保存在您的 GitHub 仓库或配置的本地文件夹中的仪表板会出现在 Grafana 的一个已供应文件夹中。

您可以设置单个文件夹，或将多个文件夹设置为不同的仓库，最多支持 10 个连接。或者，您的整个 Grafana 实例可以作为已供应文件夹。

工作原理

用户决定更新一个已供应的仪表板，该仪表板存储在 GitHub 仓库中（Git Sync 工作流程）或本地文件中（本地文件工作流程）。

Git Sync 工作流程

通过 Git Sync 供应的资源可以在 Grafana UI 内或 GitHub 仓库内修改。在仓库或 Grafana UI 中所做的更改是双向的。

例如，当用户在 Grafana UI 中更新仪表板时，他们选择保存来保留更改。Grafana 会通知他们该仪表板是在 GitHub 仓库中供应的。他们选择如何保留更改：可以直接保存到分支，或使用 GitHub 中的拉取请求推送到新分支。如果他们选择了新分支，他们就会打开拉取请求并遵循其正常的工作流程。

Grafana 会定期轮询 GitHub。连接是使用个人访问令牌进行授权建立的。如果启用 webhooks 功能，仓库通知会几乎立即显示。如果没有 webhooks，Grafana 会按指定间隔轮询更改。默认轮询间隔是 60 秒。

对存储在 GitHub 仓库中的已供应文件进行的任何更改都会反映在 Grafana 数据库中。Grafana UI 读取数据库并更新 UI 以反映这些更改。