SuperAPI AI 工具集

provisioning

通用与其它

查看项目

更新于 10-16 06:16

技能介绍

用途:让 Grafana 资源可复现,按资源类型与团队工作流选择合适工具,并让运行时配置与版本控制保持同步。选错工具不会立刻报错,可能在数月后以配置漂移、脆弱的 CI 或被部分配置覆盖的通知策略暴露。

主要能力:

  • 文件 provisioning:provisioning/ 目录下的 YAML 于 Grafana 启动时读取;支持 $VAR 与 ${VAR} 插值(仅值、非键、非 dashboard JSON,字面 $ 写作 $$)。分包 datasources、dashboards(提供方配置,非 dashboard 本身)、plugins、alerting。支持 prune、updateIntervalSeconds、allowUiUpdates。Grafana Cloud 不可用。
  • HTTP API:新 /apis/<group>.grafana.app/<version>/ 为 Kubernetes 风格资源;旧 /api/ 覆盖数据源、注释、管理与 alerting provisioning。鉴权用服务账号令牌,API keys 已弃用。
  • Terraform:资源覆盖最广,data source、dashboard、folder、alerting、用户/RBAC、Cloud 等;托管资源默认在 UI 只读,可用 disable_provenance 放开。state 不可提交 Git,应用远端 backend。
  • gcx CLI:面向新 Kubernetes 风格 API 与遥测查询,需 Grafana ≥ v12,支持 resources pull/push/serve、contexts 配置及面向 AI 编码智能体的结构化输出与 skills。

用法要点:按资源类型与变动性选工具;同一资源类型只保留一个事实来源;敏感信息放入 secureJsonData 或 secure_json_data_encoded;dashboard 设置稳定 uid;通知策略树整体为单个资源,不可只推送部分。

限制与状态:文件 provisioning 不支持 Grafana Cloud;gcx 需 Grafana ≥ v12,2026 年处于 public preview;grafanactl 已被 gcx 取代,仓库 2026-06-01 归档;Grizzly、Grafonnet 已弃用;API keys 已弃用;旧 /api/dashboards/db 为 legacy。变量插值不适用于 alert rule annotations、relativeTimeRange、query data.model、mute timing 名称/区间、模板名称与正文。

资料未提供的具体收费、价格与平台信息暂未提供。