用途:把 Grafana 当作一组带版本、分别授权的资源来运维。在提出变更前,先发现目标、资源归属与生效路由;服务器健康或仪表盘好看,并不代表供给、查询、告警评估或通知投递正常。
主要能力:覆盖仪表盘与面板、变量、单位、转换、链接、注解、库面板与可访问性;告警规则评估、标签、联系点、策略、分组、静默、静音时序、模板与投递;在文件供给、Terraform、Git Sync、API、Foundation SDK、Operator 之间选择与协调归属;诊断空白面板、查询或认证失败、供给漂移、评估失败、通知缺失、代理与认证问题;处理凭证、用户、服务账号、RBAC、插件、删除与生产变更控制。
使用方式:变更前确认 Grafana 版本与版本类型(OSS、Enterprise、Cloud)、部署模式、组织、文件夹或命名空间、认证模型与当前权限范围;盘点现有文件供给、Terraform 状态、Git Sync、Operator 资源及 API/UI 管理的对象,每个资源 UID 指定唯一权威归属;先只读发现,可运行:grafana server -v;curl --fail --silent --show-error "$GRAFANA_URL/api/health"。容器、软件包、Helm 或 Cloud 用所属平台的只读清单确认镜像、配置路径与边界。API 发现上,Grafana 12 引入新的 /apis 模型,旧 /api 路由自 Grafana 13 起进入弃用且尚无完整一对一替代。
限制与边界:不得打印、提交或保留服务账号令牌、密码、secureJsonData、解密后的接收器设置、OAuth 密钥、签名密钥、SMTP 凭证或 webhook 等秘密。修改前需明确确认目标、范围与回滚路径。重置密码、用户/组织/RBAC 变更、插件安装或移除、删除数据源/仪表盘/文件夹/告警规则/联系点/策略、替换通知策略、实时通知测试、供给重载或重启、密钥轮换、匿名或公开分享变更、直接数据库恢复等,均需明确授权;除非用户明确授权文档化恢复流程且备份与可支持替代方案已用尽,否则不要直接编辑 Grafana 数据库。访问受限时声明的离线限制,不宣称语义正确。SLI/SLO、错误预算、严重级别与升级实践,以及 PromQL、LogQL、TraceQL、Flux、SQL 等数据源专属语法,不在本技能范围内。
适用场景:Grafana 产品的配置、供给协调、权限与变更控制、告警与通知链路验证、以及仪表盘和查询问题的定位。验证时按服务器、供给、数据源、仪表盘、告警评估、通知路由、投递、访问等各平面分别取证;无数据源访问时仅可声明已验证到的最强边界,并列出未行使的更强边界。