openobserve-analyst

name	openobserve-analyst
description	通过 API 与 OpenObserve 可观测性平台交互，使 Agent 具备调用 OpenObserve 进行日志分析（Logs）、指标查询（Metrics）、分布式追踪分析（Traces）和告警查看（Alerts）的能力。当用户需要查询日志、分析错误、排查系统问题、查看指标趋势或与 OpenObserve 交互时使用。

OpenObserve 全栈可观测性分析 Skill

本 Skill 覆盖 OpenObserve 三大核心支柱：Logs（日志）、Metrics（指标）、Traces（追踪），以及 Alerts（告警）。

脚本目录：scripts/
API 参考：references/api_reference.md

---

第一步：确认环境变量

执行任何命令前，先确认用户已配置以下变量：

变量	说明	示例
OO_BASE_URL	服务地址	http://localhost:5080
OO_ORG	组织名（默认 default）	default
OO_USER	用户名	[e-mail]
OO_PASSWORD	密码	Complexpass#123

未设置时提示用户执行（PowerShell）：

$env:OO_BASE_URL="http://localhost:5080"
$env:OO_ORG="default"
$env:OO_USER="[e-mail]"
$env:OO_PASSWORD="your-password"

---

任务决策树

用户需求 → 判断数据类型：

  LOGS（日志）
  ├─ "查看/搜索日志"         → search / tail
  ├─ "有没有报错/异常"       → errors
  ├─ "日志量统计"            → summary
  ├─ "有什么常见问题/模式"   → search | oo_analyze.py patterns
  ├─ "日志趋势分布"          → search | oo_analyze.py timeline
  └─ "有哪些数据流/字段"     → streams / schema

  METRICS（指标）
  ├─ "当前 XX 指标是多少"    → metrics-query
  ├─ "XX 指标最近趋势"       → metrics-range
  └─ "有哪些指标"            → metrics-list

  TRACES（追踪）
  ├─ "最近有哪些请求/trace"  → traces-latest
  ├─ "某个 trace 的详情"     → traces-get <trace_id>
  ├─ "哪些请求耗时长/报错"   → traces-search --min-duration-ms / --errors-only
  └─ "某服务的 trace"        → traces-search --service <name>

  ALERTS（告警）
  └─ "看看有哪些告警规则"    → alerts-list