帮助?!

如果出现问题,有两种可能性

  • 存在一个错误,我们可以帮助修复,或者
  • 您可能做错了,这完全没关系!

无论哪种情况,我们都可以帮助您解决问题,让您重新开心。

在我们的社区讨论论坛Slack 实例中,有一个强大且乐于助人的用户社区,他们很乐意帮助您解决任何问题。为此,我们提出以下一些建议。

如果您正在使用 Elastic Cloud 运行服务,请随时联系支持团队

可理解和可重现

对问题的清晰描述有助于社区帮助您。以下是一些提示

  • 如果您期望的是一件事,但得到的是另一件事,请告诉我们您期望的是什么,这真的有助于我们理解您想要实现的目标。
  • 如果您遵循了说明,无论谁写的,请将 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 的映射

提示

当您尝试重现问题时,最好使用最新版本的堆栈,因为您的问题可能在此期间已得到修复。

请耐心等待!

请耐心等待对您的问题的回复,请勿多次 ping 以请求回复,或为同一问题打开多个主题。由于这是一个社区论坛,可能需要一段时间才能有人回复您的问题。有关更多信息,请参阅社区行为准则,特别是“请耐心等待”部分。

请不要 ping 任何尚未直接参与您主题的人员 - 这是一个论坛,任何参与者都可能能够帮助您。此外,公开分享答案将成为下一批读者的宝贵财富。

如果您需要一项针对问题回复时间提供 SLA 的服务,那么您可能需要考虑与我们讨论订阅

如果您在 2 或 3 天后(不包括周末)没有得到答案,则可以在自己的帖子中回答。