以下是对您提供的博文内容进行深度润色与结构化重构后的专业级技术文章。整体风格更贴近一位资深 Elasticsearch 工程师在技术社区中自然、扎实、有洞见的分享——去AI感、强实操性、逻辑层层递进、语言精炼有力，同时保留全部关键技术细节与工程价值判断。
为什么你的日志写入“成功”了，却没真正创建？——从 Kibana 里亲手抓住那个真实的201 Created
你有没有遇到过这样的情况：
- Filebeat 报告“发送成功”，但 Kibana Discover 里查不到刚产生的错误日志；
- 自研事件采集器批量调用
POST /logs/_doc，监控图表却显示“创建成功率 98%”，剩下 2% 去哪了？ - 前端调用
PUT /events/_doc/evt_123后收到200 OK，以为数据已落库，结果发现是覆盖了旧事件，而非新建； - 在 APM 系统里看到某次“文档创建”耗时突增到 3s，但日志里只写着
status=200，无从判断瓶颈在主分片 commit 还是副本同步……
这些问题背后，往往藏着一个被严重低估、却又极其关键的信号：HTTP 状态码201 Created。
它不是装饰性的状态提示，而是 Elasticsearch 对“资源真正诞生”这一事实的唯一权威确认。而绝大多数人，甚至包括不少生产环境跑了三年的平台，都还没真正看见它、信任它、用好它。
本文不讲 RFC 定义，不堆概念，就用 Kibana Dev Tools —— 你手边最真实、最轻量、也最容易被忽略的调试入口 —— 一步步带你：
✅亲手触发一次真正的201，并看清它和200的毫秒级差异；
✅拆解它出现的三个硬性条件：路径、ID、主分片确认，缺一不可；
✅识别那些你以为在创建、其实只是更新或失败的“伪 201 场景”；
✅把201变成可观测性体系里的一个可度量、可告警、可追踪的 SLO 指标。
我们开始。
你真的理解201 Created是什么吗？
先破一个常见误解：
❌ “只要我用了
POST，就该返回201。”
✅ 正确理解是：只有当 Elasticsearch 明确执行了一次‘新文档实例的首次持久化’，且主分片已成功提交 Lucene segment，才会返回201。
注意关键词：
🔹新文档实例（不是索引、不是模板、不是聚合结果）；
🔹首次持久化（_version == 1是铁证）；
🔹主分片 commit 完成（副本是否同步？不管。搜索是否可见？稍等一秒）。
这意味着：
PUT /my-index
