# elk-fetch

按 request id 查 ELK / Elasticsearch 日志的小工具 + Claude Code Skill。

**核心能力**
- 绕开 Kibana CAS 登录，直接走 ES HTTP API
- 多账号 profile（不同业务用不同 ES 账号，支持多 ES 集群）
- 多业务 preset（业务语义 → 索引/字段/过滤条件，一键套用）
- 深度 JSON 字段自动解析（如 `rejectInfo` / `message` / `key_value` / `response_infos` 里的嵌套 JSON）
- 按点号路径（`a.b.0.c`）提取嵌套字段 / 仅输出指定字段

## 快速开始

```bash
git clone git@git.n.xiaomi.com:zhongsiyao/elk-fetch.git
cd elk-fetch

pip install "elasticsearch<8" urllib3

# 默认查主 NLP 日志
python elk_query.py <your_request_id>
```

账号密码（团队共用）已经在仓库里的 `profiles.json` 中，clone 完即可用。想用自己的账号则 `ELK_FETCH_PROFILES=/path/to/profiles.json` 指向别处。

## 完整用法

- **怎么选 preset / Kibana URL 转参数 / 命令模板** → [`SKILL.md`](SKILL.md)
- **每张表的字段 schema / JSON 字符串内部结构 / 新增索引流程** → [`INDEX_CATALOG.md`](INDEX_CATALOG.md)
- **业务深入**（每个主题一份排查 playbook）→ [`business/`](business/)：
  - [`business/keyword-free.md`](business/keyword-free.md) — 免唤醒判决（拒识 / kwfree 两张表三个视角）
  - [`business/intent-arbitrator.md`](business/intent-arbitrator.md) — 中控仲裁
  - [`business/micar-onetrack.md`](business/micar-onetrack.md) — 小米汽车 OneTrack 端侧埋点

## 作为 Claude Code Skill 使用

把本仓库 clone / 软链到 `~/.claude/skills/elk-fetch/`，Claude Code 会根据 `SKILL.md` 的触发条件（给出 Kibana 链接、提到 requestId / 某类业务日志等）自动调用。