集成
Grafana
将 Castrel 连接到 Grafana，用于面板查询、数据源管理与告警状态获取。
概览
- 连接器名称：
grafana - 支持的 API 版本：Grafana HTTP API v1
- 支持的服务端版本：Grafana 9.0 及以上
- 官方文档：Grafana HTTP API 参考
配置
要使用 Grafana 工具，你需要配置一个包含以下字段的 Connector：
| 字段 | 必填 | 说明 |
|---|---|---|
base_url | 是 | Grafana 服务地址（例如 https://grafana.example.com） |
api_token | 否 | Grafana API Token（Bearer Token，推荐） |
username | 否 | 用户名（与 password 配合使用，用于 Basic Auth） |
password | 否 | 密码（与 username 配合使用） |
timeout | 否 | 请求超时时间，单位秒（默认：30） |
verify_ssl | 否 | 是否校验 SSL 证书（默认：true） |
api_token与username/password二选一。推荐在生产环境使用 API Token，可在 Grafana「Administration → Service Accounts」中创建。
可用工具
该连接器提供一整套用于 Grafana 可观测性平台访问的工具。
- 面板查询：获取 Dashboard 列表与指定面板数据
- 数据源管理：列举与查询 Grafana 数据源配置
- 告警状态：获取告警规则与当前活跃告警列表
- 注释管理：读取与创建 Grafana 时间轴注释
- @ 提及：支持
@grafana快速选择 Dashboard 与数据源