用途:为 CoreWeave 支持工单收集最小化、已脱敏的集群、工作负载与限流证据,用于故障定性。它是诊断证据包,不是凭证、提示词、模型权重、数据集、kubeconfig 或原始密钥值的归档处。
前置条件:对受影响命名空间或集群具备授权的只读 Kubernetes 访问权限;需定义事件标识、保留目标与事件负责人;使用具备足够空间的本地加密工作区,不要在共享或不受管的机器上收集。
主要能力:采集 GPU 节点健康状况、Kubernetes Pod 状态、事件日志与 API 连通性;记录集群资源分配、失败 Pod 日志、GPU 设备插件状态与网络可达性,使支持工程师无需再索取额外信息即可定位基础设施问题。适用于 GPU Pod 卡在 Pending、推理负载 OOM、节点自动扩缩异常等情况。
使用方式:脚本创建带时间戳的 bundle 目录,输出 summary.txt(环境与 API 状态)、nodes.txt、pods.txt、events.txt、gpu-allocation.txt、gpu-plugin.txt 及失败 Pod 的日志尾部,并保存限流响应头,最终打包为 tar.gz。分析时可解压后查看 summary.txt,用 grep 检索 events.txt 中的错误、失败或 OOM,并查看 gpu-allocation.txt 判断 GPU 资源压力。
常见问题排查:GPU Pod 卡 Pending 时检查 gpu-allocation.txt 是否显示 0 可分配 GPU;OOMKilled 查 events.txt 并提高内存限制;Node NotReady 查 nodes.txt 状态列与 kubelet 事件;API 返回 401 时在 CoreWeave 面板重新生成密钥并确认 COREWEAVE_API_KEY 已设置;NVIDIA 设备插件缺失时检查 gpu-plugin.txt 与 kube-system 中的 DaemonSet。
限制与安全:收集前应设置严格的文件权限;打包前移除含凭证的头部或值;打包后在本地检查是否含密钥与客户数据,仅按要求保留期上传至批准的工单记录,验证上传后按事件策略删除本地副本。若归档包含密钥或客户数据,应停止分发、删除本地归档、轮换暴露凭证并加强脱敏后重新收集。收集命令被拒时申请临时只读权限,不要使用他人 kubeconfig。归档过大时限制到受影响命名空间并缩短日志尾部,不要省略事件或安全审查。API 探测失败时只记录状态与请求 ID,不要将授权头发送进包内。此工具为社区贡献,与 CoreWeave, Inc. 无关联、未获其认可或赞助;CoreWeave 是其注册商标。