用途:Observe CLI(observe)是 Observe 平台的类型化、可脚本化接口,适合调查生产系统并拉取遥测数据,包括搜索或跟踪日志、按名称/标签/过滤条件发现数据集、指标与告警、检查资源架构与元数据、运行 OPAL 查询取回数据行、检索知识图谱中的标签键与标签值,以及查看 Observe 中存储的 AI 智能体技能。
使用方式:统一以 observe <command> [flags] 调用,绝大多数命令建议加 --json,使输出可解析、自动静默状态行且返回完整资源结构;需要 CSV 时改用 --format csv。认证信息存于 ~/.observe/config.json(权限 600),相关命令不带 --json,如 observe auth login、observe auth login --useDeviceCode --url 123456.observeinc.com、observe auth status、observe auth logout,手动配置可用 observe configure --domain observeinc --customerId 123456 --token YOUR_API_KEY。
主要能力:dataset 子命令支持 list 与 view(如 observe dataset view <dataset-id> --json),可用 --label 模糊匹配、--filter 传 CEL 表达式,--correlation-tag-key 与 --correlation-tag-value 需成对使用;metric 子命令支持 list(--match 必填)与 view;alert 支持 list 与 view,可按级别或 --active 筛选;monitor 支持 list、view、create、update、enable、disable、delete;skill 支持 list 与 view,--content 输出原始 Markdown 且与 --json 互斥;query 执行 OPAL,支持 --input、--pipeline、--start/--end 或 --interval,时间窗口优先显式 ISO-8601,其次 --interval,默认最近 1h。调查一般先以 tag-value list 和 tag-key list 解析实体,再查数据集与指标,写 OPAL 前需阅读 generate-opal 技能文档。结果可用 jq 后处理。
限制:这些为公开资料描述,未提供价格、部署平台与效果数据;--sort 的降序前缀说明与实现不一致,建议升序后客户端反转。