核心用法
rpe-grafana 是一款专为简化 Grafana 数据访问而设计的工具型技能。它通过三层 API 封装，让用户无需了解底层查询语言即可读取仪表板数据：
1. 仪表板发现 (grafana_list_dashboards)：列出所有可访问的仪表板，返回 UID 和标题
2. 面板枚举 (grafana_list_panels)：获取指定仪表板内的所有面板，返回 ID 和标题
3. 数据读取 (grafana_query_panel)：自动提取面板的查询配置，通过 Grafana 的 datasource API 执行查询，返回最新值和单位
核心设计优势在于查询透明化——工具自动解析面板内嵌的 PromQL、InfluxQL 或其他查询语句，用户仅需知道"哪个仪表板的哪个面板"。
显著优点
- 零学习成本：完全屏蔽查询语言，非技术用户也能获取指标
- 广泛兼容：支持 Prometheus、InfluxDB、MySQL 等任意 Grafana 数据源
- 精准定位：通过 UID（稳定标识符）和面板 ID 精确导航，避免歧义
- 最小权限：仅需 Viewer 角色即可运行，降低权限管理风险
潜在缺点与局限性
- 只读限制：严格禁止写入操作、仪表板编辑或管理功能
- 依赖预配置面板：无法执行任意自定义查询，必须依赖已存在的面板
- 时间范围约束：默认仅查询最近1小时数据，历史深度有限
- 网络依赖：需直接访问 Grafana 实例，无法离线使用
适合人群
- 运维工程师快速核查实时指标
- 产品经理/业务人员自助查看监控数据
- 自动化脚本和告警通知系统
- 任何需要"只看数据、不写查询"的场景
常规风险
| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| 凭证泄露 | 需存储 Grafana 用户名密码或 API Key | 使用环境变量注入，避免硬编码；优先使用只读 API Key |
| 越权访问 | Viewer 权限若配置不当可能看到敏感仪表板 | 遵循 Grafana 本身的 RBAC 管控，定期审计仪表板可见性 |
| 数据误读 | 自动提取的查询可能包含聚合函数，返回的是聚合值而非原始值 | 确认面板配置中的查询逻辑，必要时调整时间范围参数 |