amazon-opensearch-service

Amazon OpenSearch Service — 综合指南与技能库

本 Skill 旨在解决与 Amazon OpenSearch Service 及 Serverless 相关的各类问题，覆盖五大核心领域。使用时请先按下面的“步骤 0”将问题分流至其中一项能力，并跳转到对应的入口参考文档。关于具体何时分发、子参考文档、特定能力的技术要点及跨能力联动，均在各能力的入口文档中进行了详细说明。

建议使用 AWS MCP server（但非强制）。 各能力的参考文档优先给出标准的 AWS CLI 命令（例如 aws opensearch describe-domain、aws opensearchserverless create-collection）。在启用了 AWS MCP server 的环境中，其 call_aws 工具可提供更便捷的操作体验 —— 但须保证本 Skill 中的所有操作均能仅凭 AWS CLI 独立完成。针对 AOS / AOSS 的数据平面 HTTP 请求，需统一使用 awscurl 进行 SigV4 签名，该方式在两种环境下均能兼容运行。

步骤 0：首要任务 —— 识别并匹配具体能力

从以下五种能力中挑选一种最契合的。在回答的第一句话中明确说明识别出的能力（例如：“匹配到的能力类别：SEARCH —— 基于 Bedrock 向量嵌入的语义搜索配置。”）。随后读取对应的入口参考文档；该文档将说明分发时机、索引该领域下的所有关联文件，并引导你完成后续步骤。

能力类别	入口参考文档
migration（迁移） — Solr / Elasticsearch / 自建 OpenSearch 迁移至 AOS 或 AOSS。包含 Schema 与查询转换、容量评估及割接方案。	references/assessment-workflow.md
provisioning（资源创建与运维） — AOS 域名与 AOSS 集合的创建和管理。包含生命周期管理、版本升级、存储分层、FGAC 精细化权限控制及监控。	references/provisioning-reference.md
search（搜索） — 向量 / 语义 / 混合 / 稀疏 / 稠密 / RAG 检索。包含 Bedrock 连接器配置、FAISS HNSW 与 Lucene 的对比选取。	references/search-semantic-search-guide.md
log-analytics（日志分析） — 日志检索、可观测性、PPL 查询、OSI 数据接入、异常检测、OpenSearch Dashboards。包含 Splunk/Datadog/ELK 替代方案。	references/log-analytics-guide.md
trace-analytics（链路追踪） — 基于 OpenTelemetry 的分布式链路追踪。包含 Span 查询、服务拓扑图、Data Prepper 配置。	references/trace-analytics-trace-queries.md

如果用户需求跨越了多个能力（例如：“从 Solr 迁移并为新域名配置 RAG”），请选择主导能力进行解答，并在结尾处附上一句话引导跳转至另一能力的入口参考文档。

通用规则（适用于所有能力类别）

以下规则适用于所有解答，与具体能力无关。特定能力的专属规则（容量计算公式、架构形态识别、Migration Assistant for Amazon OpenSearch Service 功能矩阵、k-NN 引擎选型等）均存储在对应的入口参考文档中，不在此罗列。

• 报告页眉（适用于所有多章节回答）： 所有包含多个章节的输出均需在开头加上单行元数据引用块：> Generated: <ISO 8601 时间戳> | Skill: amazon-opensearch-service v<N>。时间戳通过调用 current_time 工具获取（返回 UTC 时间的 ISO 8601 格式）。Skill 版本号读取自本文件 Frontmatter 中的 version: 字段。单行简答（如简短的操作指令、反模式拒绝回复）可省略页眉；但只要是多章节的交付内容，必须包含页眉。请将其置于报告标题正下方、第一个 ## 二级标题之前。
• 禁止预估具体金额（硬性约束）：严禁在回答中给出 $X/月、~$1,500 等任何具体美元金额。遇到任何费用咨询，统一引导至 https://calculator.aws 并直接终止计价推算。若子参考文档中包含金额，仅作为内部参考信息，不得透传给用户。
• 严禁泄露敏感凭据（硬性约束）：生成的输出中绝不能包含主用户名、KMS 密钥 ARN、VPC 终端节点 URL、实例 IP 或 AWS 账号 ID（Account ID）。
• 二选一决断：面对 A 与 B 选型的方案对比时，必须明确给出首选建议，用一句话说明推荐理由。可以在首选建议之后补充“如果……则选择 B”的适用条件，但绝不能以模糊不清的条件式推断开头。
• 重述背景信息：回答的前 2~3 句话必须明确重述上下文背景（已知时的引擎 + 版本 + 规模），或用具体的技术语言重述用户的核心诉求。用户看到的第一段文字切忌出现工具调用说明、元评论、报告标题或简单机械地原字照搬问题。
• 去除市场宣传腔调：严禁使用“无缝”、“健壮”、“同类最佳”、“经过生产检验”、“企业级”、“世界级”、“优雅地”等夸大词汇。不要在一条建议中堆砌 3 个以上的模糊推衍词（如“通常”、“一般而言”、“绝大多数情况下”），必须明确指出该建议具体的适用与不适用场景。
• 跨能力衔接：当用户需求跨越多个能力模块时（例如：“从 Solr 迁移并为新域名配置 RAG”），优先回答主要能力模块，并在结尾处加上单行引导语句：“如需了解<其他能力类别>，请参阅 references/<other-capability>-<entry>.md”。

跨能力通用参考文档（供多个能力共同调用）

这些参考文档未加能力前缀，因为它们通用于多种场景。各能力的入口文档会在需要时进行加载，SKILL.md 本身从不直接加载它们。

• references/sizing.md — 容量计算公式、实例系列详情、OR1 权衡分析、高低水位线限制、JVM 堆内存配置规则。
• references/vector-knn.md — k-NN 引擎选型、内存计算公式、RAG 数据写入模式、ELSER 替代方案。
• references/observability.md — 日志分析模式、ISM 索引状态管理、UltraWarm/Cold 分层存储、Splunk/Datadog 迁移指南。
• references/security.md — FGAC 精细化权限控制、加密配置、VPC 架构模式、审计日志、合规性要求。
• references/personas.md — 针对不同用户角色的沟通风格指南。
• references/assessment-gotchas.md — 生产环境常见踩坑清单（在迁移细节或风险阻塞项表格中按编号引用；每个 gotcha 都带有决定其分类的 Category: 标签）。
• references/assessment-knowledge-retrieval.md — 批量校验时的 主题 → 工具 → URL 映射规则。

静态资源目录（assets/）：用于生成完整评估报告（FULL_ASSESSMENT）的模板（Solr 迁移源、ES 迁移源、高管摘要等）。

本 Skill 的能力边界（不涵盖的操作）

• 预估费用金额：云资源价格每月变动，且预留实例（RI）、Savings Plans 或 EDP 等账号折扣规则过于复杂，超出本 Skill 可靠推算的范畴。请使用 https://calculator.aws。
• 执行实际的数据迁移：数据搬迁请使用 Migration Assistant for Amazon OpenSearch Service（历史数据填充使用 Historical Data Migration，实时割接使用 Live Traffic Migration）。
• 训练或构建向量嵌入模型：模型构建请使用 Amazon Bedrock 或 Amazon SageMaker。
• 对 Splunk SPL 或 Datadog APM 进行 1:1 零修改替换：部分查询语法、检测规则及仪表盘需要重新编写。
• 针对特定的业务数据集调优相关性排序：建议结合 OpenSearch Benchmark 的 big5 测试基准与实际业务标注集进行自主调优。