用途:系统发现公司技术栈、可观测性栈、基础设施规模、可观测性成本与运维痛点,输出一份自包含 HTML 报告,含高管摘要、按工具可折叠的深入分析,以及将每个测量数字链接到原始 API 响应的溯源附录。
主要能力:检测环境与工具;通过确定性采集脚本计算所有容量与成本数字;生成报告。核心规则是代理不自行计算任何报告数字,不写 PromQL、不做单位换算、不对 API 响应做算术、不编辑报告 HTML。所有数字来自采集器的 summary.json,代理贡献的内容写入 context.json 并标记为定性或“已报告—未验证”。
使用方式:先展示发现计划并获用户批准;检查 uv 与 Python 3.11+ 前置条件;按阶段检测 Kubernetes、云厂商、IaC、CI/CD、Docker、Helm 与 CRD;发现技术栈与可观测性栈;运行采集器测量规模与成本。采集器为 PEP 723 Python 脚本,通过 uv run 本地运行,例如 uv run collectors/k8s/collect.py --all-contexts --output-dir ./discovery-output/k8s。凭据通过环境变量传入,不写入文件。
适用场景:需要盘点多云或多环境基础设施、梳理可观测性工具与成本、为 Oodle 接入做准备时。
限制:仅只读、非破坏性操作;只发现可观测性成本,不查询账户级云账单;无法采集的内容会列入 Coverage & Gaps 并说明原因;部分采集器标记为 planned,尚未提供,需记录为跳过并向用户询问代表性数字;API 调用需限速,采集器自行节流;不确定信息需询问用户并标记为用户报告。