用途：通过 Netdata Cloud API 获取可观测性指标与基础设施监控数据，涵盖空间（spaces）、房间（rooms）、节点（nodes）、上下文（contexts）、告警（alerts）等。
认证：Netdata Cloud 使用 API 令牌而非第三方 OAuth。将 NETDATA_TOKEN 作为 Bearer 令牌使用，例如 curl -s "https://app.netdata.cloud/api/v2/spaces" --header "Authorization: Bearer $NETDATA_TOKEN"。不要打印或回显 NETDATA_TOKEN；该令牌不会自动过期，应视为长期密钥。基础 URL 为 https://app.netdata.cloud。
工作流：若用户未提供空间 ID，先列出空间；确定任务所需的房间、节点与上下文；简单发现与快速指标读取用 v2 端点；需要显式范围、过滤、分组或聚合的指标查询用房间级 v3 POST 端点；报告时说明时间窗口、上下文名称及所用节点或房间过滤条件。
发现：列出空间 GET /api/v2/spaces；列出节点 GET /api/v2/nodes；列出上下文 GET /api/v2/contexts（用于发现 system.cpu、system.ram 等指标名）；全文搜索 GET /api/v2/q 配合 --data-urlencode "q=<search-term>"。
指标：快速 v2 查询 GET /api/v2/data，参数 contexts=system.cpu、after=-600（最近 10 分钟）。房间级 v3 查询 POST /api/v3/spaces/<space-id>/rooms/<room-id>/data，请求体包含 scope、selectors、window、aggregations、format、options、timeout 等字段。aggregations.time.time_group 常用值有 average、min、max、sum、median、stddev、percentile、incremental-sum；除 average、min、max、sum 外的高级分组需在 window 中包含 "tier": 0。
告警：查询房间内配置错误的告警 GET /api/v2/spaces/<space-id>/rooms/<room-id>/alerts:misconfigured。
限制与排障：Netdata Cloud API 令牌认证 app.netdata.cloud，本地 Agent 端点独立，可能使用不同令牌或无需令牌；/api/v1/charts、/api/v1/data 等旧版本地 Agent 端点在 app.netdata.cloud 上返回 404。建议使用较窄时间窗口和明确上下文以避免响应过大。请求失败时可运行 zero doctor check-connector --env-name NETDATA_TOKEN 或 zero doctor check-connector --url https://app.netdata.cloud/api/v2/spaces --method GET。