用途:为 gcx CLI 增加对尚未在 internal/datasources/providers 注册的数据源类型的支持,属于实现类工作流,分发现、实现、验证三阶段自主推进。
主要能力:从 bin/gcx datasources list -o json 与厂商 API 文档确认插件类型字符串、查询与元数据端点及响应结构;用 bin/gcx api 探测数据源代理 API;按步骤编写查询客户端、命令构造器与 Explore 链接,并运行冒烟测试与接线检查。
使用方式:直接调用时走完三阶段;若由 integrate-with-gcx 进入,则跳过已答问题,从实现阶段开始。实现阶段按步执行 mise run gate,推送前运行 GCX_AGENT_MODE=false mise run all。查询客户端需复用 internal/query/grafanaquery 与 dataframe 共享传输,SQL 场景使用 querysql.BuildRawQueryBody 与 querysql.EnforceLimit;httpClient 用 rest.HTTPClientFor(&cfg.Config) 构建。
适用场景:用户要求“支持某未支持的数据源类型”或任务涉及数据源类型实现。
限制:不适用于创建或配置数据源实例(应使用 gcx datasources create/update),也不适用于已注册类型或 Grafana Cloud 产品(应使用 /add-provider)。若无可达实例,实时检查须标记 UNVERIFIED 并说明原因,不得阻塞或谎报通过。具体端点、认证、分页等细节需从厂商文档或插件源码确认,资料未提供时不得猜测。