用途:为 Observe 的 Kubernetes Explorer 准备后端资源,包括创建 datastreams、安装内容包、生成摄取令牌。不操作 Kubernetes 集群或 helm chart。
前提:需确认客户 URL、集群名称、是否包含 traces。若由 deploy-k8s-explorer 调用则无需重复询问。
主要流程:
- 认证:observe auth status 检查状态;未登录时执行 observe auth login --url <CUSTOMER_URL>,无浏览器环境加 --use-device-code。
- 检测现状:observe datastream list 查询已有 datastreams,识别旧版单流与新版多流;observe content kubernetes view 与 observe content tracing view 查询内容安装情况。
- 创建资源:按顺序创建核心 datastreams(Kubernetes Explorer/OpenTelemetry Logs、Prometheus、Kubernetes Entity,以及 Observe Agent/Events);若包含 traces,再创建 Tracing/Span 与 Metrics/OpenTelemetry。从 JSON 响应提取 datasetId。
- 安装内容:observe content kubernetes install 带 --otel-logs-dataset-id、--prometheus-dataset-id、--entity-dataset-id;有 traces 时执行 observe content tracing install 带相应 dataset-id。
- 创建摄取令牌:observe ingest-token create --name "K8s Explorer - <CLUSTER_NAME>" --description "...",不要传 --datastream-ids;令牌仅显示一次,需用户确认已复制。
- 汇总:输出租户、集群、已创建资源及令牌密文。
限制:CLI 不提供 datastreams、内容包、摄取令牌的删除命令,删除需在 Observe UI 手动操作。任一操作失败时展示错误与已创建资源,并询问重试、跳过或中止。