用途：通过 Observe CLI（二进制位于 ~/go/bin/observe）与 Observe 租户交互，运行 OPAL 查询、列出数据集、管理对象，适用于日志检索、错误排查、链路分析与业务影响评估。
使用方式与认证：先检查配置 cat ~/.config/observe.yaml；未配置时登录，如 ~/go/bin/observe --customerid <CUSTOMER_ID> --site observeinc.com login <EMAIL> --sso。登录方式含 --sso（推荐，浏览器审批，适合 SSO/SAML）、--read-password（从 stdin 读密码）等。令牌保存到 ~/.config/observe.yaml 的活动 profile，默认 default，可用 --no-save 禁止保存。配置文件支持多 profile，可用 --profile=<name> 或 OBSERVE_PROFILE 选择。
主要能力：查询命令为 ~/go/bin/observe query -q '<OPAL_QUERY>' -i '<INPUT_DATASET>'，支持 -s/-e/-r 时间窗口、-c CSV、-j nd-JSON、-x 扩展输出、-w 列宽、-f 从文件读取、-l 字面控制字符、--format 指定输出格式。输入数据集可用 ID 或 Workspace.Folder/Name，逗号分隔支持 join（如 right=ID）。OPAL 支持 filter、statsby、timechart、pick_col、make_col、case 等。对象管理用 ~/go/bin/observe list <object_type> [substring_filter]，类型含 dataset、workspace、user、document、rbacgroup、rbacgroupmember、rbacstatement。
常见工作流：错误排查按概览、量化、影响范围、时间趋势、详情、与 trace 关联、单 trace 端到端、维度交叉依次进行；业务影响分析可用 span 属性统计成功率、金额、损失与分布，必要时用批量并行查询跨 trace 关联，每批约 2000 个 trace ID。对 span 数据集使用 pick_col 必须包含 start_time 和 end_time，否则查询失败。--json 输出的数值型聚合值（如 count）为字符串，解析时需 int() 或 float() 转换。
限制：OPAL 的 leftjoin 无法预过滤右侧同一数据集，需用批量并行查询变通；具体收费、价格与支持平台资料暂未提供。