帮助?!
可理解和可重现
对问题的清晰描述有助于社区帮助您。以下是一些提示
- 如果您期望的是一件事,但得到的是另一件事,请告诉我们您期望的是什么,这真的有助于我们理解您想要实现的目标。
- 如果您遵循了说明,无论谁写的,请将 URL 链接给我们,以便我们验证您的方法。
- 包括您正在使用的 Elastic Stack 产品版本以及您的操作系统和/或浏览器等信息。
入门的最佳方法是创建一个简单但完整的问题重现脚本。如果您正在使用 Kibana 中的开发工具,请复制您发出的 API 请求以及任何输出。如果您正在使用 cURL 或 CLI,或者有 json 或 yaml 配置文件,也采用相同的方法。
论坛对帖子的大小有限制。您可以将上述输出拆分为多个帖子,或者使用 gist/pastebin/等,然后在您的帖子中链接,以便我们查看详细信息。
请不要发布文本输出的图片,例如 API 请求和响应或配置文件。这些可能难以阅读和复制,无法搜索,并且可能不会显示给所有用户。
您的重现越完整,您提出的问题就越清晰,其他人就越容易帮助您并找到更快的解决方案!
什么是重现?
Kibana 有一个名为 Console 的方便工具,可在 Dev Tools 菜单下找到。它有助于向 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 Console 中运行以重现您的问题的内容。它可以帮助读者理解和重现您的问题并获得更快的响应。
如何创建重现脚本?
打开 Kibana Dev Console 并使用一个非常简单的示例重现您看到的问题。无需使用所有字段重新创建您的完整用例。只需关注实际问题即可。
例如,此脚本对于任何社区成员来说都很容易粘贴并从 Kibana Dev Console 中运行
DELETE index
POST index/_doc
{
"foo": "bar"
}
GET index/_search
{
"query": {
"match": {
"foo": "bar"
}
}
}
将您的脚本复制/粘贴到讨论中,并粘贴您收到的响应,并解释您的预期。
请注意
- 在示例中包含您的映射始终很有帮助。
- 如果您安装了任何插件,共享您正在使用的任何特定 Elasticsearch 设置或所需插件的列表可能会很有用。
- 共享您获得的 JSON 结果以及您的预期结果也可能很有用。如果您使用 curl 而不是 Kibana Dev Console,请确保在您的请求中附加 ?pretty=true,以获得格式良好的 JSON 输出。
用于诊断问题的有用 API
打开 Kibana Dev Console 并使用一个非常简单的示例重现您看到的问题。无需使用所有字段重新创建您的完整用例。只需关注实际问题即可。
例如,此脚本对于任何社区成员来说都很容易粘贴并从 Kibana Dev Console 中运行
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 平台参考 |
Logstash | elastic-stack/logstash | #stack-logstash | Logstash 参考 |
Elastic 解决方案 | |||
搜索 | 搜索 | #search | Elastic 企业搜索文档 |
可观测性 | 可观测性 | #observability | 可观测性指南 |
安全 | 安全 | #security | Elastic 安全解决方案 |
Elastic 编排 | |||
Elastic Cloud | Elastic 云支持 | Elastic 云文档 | |
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 |
提示
当您尝试重现问题时,最好使用最新版本的堆栈,因为您的问题可能在此期间已得到修复。