帮助?!
容易理解、可再现
清晰地描述问题有助于社区为您提供帮助。以下是一些建议:
- 如果您期待的是一种结果,但得到的却是另一种结果,将您的预期告诉我们真的能帮助我们理解您想要实现的目标。
- 如果您遵循了相关说明,不管是谁编写的,都请将相应的 URL 附在帖子中,方便我们验证您的方法。
- 包括您正在使用的 Elastic Stack 产品的版本、操作系统和/或浏览器等信息。
创建一个简单但完整的问题重建脚本是开始的最好方式。如果您使用的是 Kibana 中的开发工具,可以将您要发出的 API 请求以及任何输出复制下来。如果您使用的是 cURL 或 CLI,或者有 json 或 yaml 配置文件,那么这种方法同样适用。
论坛对帖子的大小有限制。您可以将上面的输出分成多个帖子,或使用 gist/pastebin/ 等代码,然后在帖子中放上链接,这样我们就可以看到详细信息了。
请不要用图片的形式发布文本输出,例如 API 请求和响应或配置文件。因为图片难以阅读和复制,不可搜索,而且可能不是所有用户都能看到。
您的再现越完整,您询问的问题就越清楚,其他人就越容易为您提供帮助,进而更快地解决问题!
什么是再现?
Kibana 中有一个“控制台”工具,使用起来很方便,就在“开发工具”菜单下。可以用它向 Elasticsearch 发送请求。例如,只需发送以下内容即可显示欢迎信息:
GET /
该代码将返回如下内容:
{
"name": "instance-0000000003",
"cluster_name": "b72dca58dc9c4814ab9c68aedee87639",
"cluster_uuid": "3oq0ZLnWTYqunndjR07okQ",
"version": {
"number": "8.8.1",
"build_flavor": "default",
"build_type": "docker",
"build_hash": "f8edfccba429b6477927a7c1ce1bc6729521305e",
"build_date": "2023-06-05T21:32:25.188464208Z",
"build_snapshot": false,
"lucene_version": "9.6.0",
"minimum_wire_compatibility_version": "7.17.0",
"minimum_index_compatibility_version": "7.0.0"
},
"tagline": "You Know, for Search"
}
完整的再现脚本使得任何人都可以复制并粘贴到 Kibana 控制台,通过运行脚本来再现您的问题。再现脚本有助于读者理解和再现您的问题,您也能更快地得到回复。
如何创建再现脚本?
打开 Kibana 开发控制台,用一个非常简单的例子重现您遇到的问题。无需再现包含所有字段的完整用例。将重点放在实际问题上。
例如,任何社区成员都可以很容易地从 Kibana 开发控制台粘贴和运行以下脚本:
DELETE index
POST index/_doc
{
"foo": "bar"
}
GET index/_search
{
"query": {
"match": {
"foo": "bar"
}
}
}
在讨论中复制/粘贴您的脚本以及得到的回复,并阐述您的预期。
请注意:
- 在示例中包含映射总归是有帮助的。
- 分享您正在使用的任何特定的 Elasticsearch 设置或所需插件的列表(如果您安装了任何插件的话)可能会很有用。
- 此外,还可以分享您得到的 JSON 结果以及您的预期结果。如果您使用的是 curl 而不是 Kibana 开发控制台,请确保在请求后附加 ?pretty=true,以获得格式良好的 JSON 输出。
用于诊断问题的实用 API
打开 Kibana 开发控制台,用一个非常简单的例子重现您遇到的问题。无需再现包含所有字段的完整用例。将重点放在实际问题上。
例如,任何社区成员都可以很容易地从 Kibana 开发控制台粘贴和运行以下脚本:
GET / | 集群信息 |
GET /_cat/health?v | 合成形式的集群运行状况 |
GET /_cat/nodes?v | 合成形式的集群节点 |
GET /_cat/indices?v | 合成形式的集群索引 |
GET /_cat/shards?v | 合成形式的集群分片 |
GET /INDEX/_settings | 获取 INDEX 的设置 |
GET /INDEX/_mapping | 获取 INDEX 的映射 |
我需要帮助…
项目 | 讨论 | Slack | 文档 |
---|---|---|---|
Elastic Stack | |||
Elasticsearch | elastic-stack/elasticsearch | #stack-elasticsearch | Elasticsearch 指南 |
Kibana | elastic-stack/kibana | #stack-kibana | Kibana 指南 |
Beats | elastic-stack/beats | #stack-beats | Beats Platform 参考资料 |
Logstash | elastic-stack/logstash | #stack-logstash | Logstash 参考资料 |
Elastic 解决方案 | |||
企业搜索 | enterprise-search | #enterprise-search | Elastic 企业搜索文档 |
可观测性 | observability | #observability | 可观测性指南 |
安全 | security | #security | Elastic 安全解决方案 |
Elastic 编排 | |||
Elastic Cloud | Elastic Cloud 支持 | Elastic Cloud 文档 | |
Elastic Cloud Enterprise (ECE) | orchestration/cloud-enterprise | #orchestration-ece-elastic-cloud-enterprise | Elastic Cloud Enterprise 参考资料 |
Elastic Cloud on Kubernetes (ECK) | orchestration/eck | #orchestration-eck-kubernetes | Elastic Cloud on Kubernetes |
提示
在尝试再现您的问题时,最好使用最新版本的堆栈,因为您的问题在这段时间内可能已得到解决。