帮助?!

如果某个操作不起作用,可能有以下两种情况:

  • 存在错误(我们可以帮忙进行修复),或者
  • 您可能正在执行错误的操作(这也完全不成问题)!

无论是哪种情况,我们都可以帮助您解决,让您恢复快乐的心情。

我们的社区用户能力强且热心肠,他们很乐意在论坛Slack 实例上帮助您解决任何问题。为此,下面提供了我们建议的一些指南。

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

容易理解、可再现

清晰地描述问题有助于社区为您提供帮助。以下是一些建议:

  • 如果您期待的是一种结果,但得到的却是另一种结果,将您的预期告诉我们真的能帮助我们理解您想要实现的目标。
  • 如果您遵循了相关说明,不管是谁编写的,都请将相应的 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 的映射

提示

在尝试再现您的问题时,最好使用最新版本的堆栈,因为您的问题在这段时间内可能已得到解决。

耐心等待!

请耐心等待对您的问题的回复,不要多次发送信息要求提供回复,也不要针对同一个问题开立多个主题。由于这是一个社区论坛,可能需要一些时间才有人回复您的问题。有关更多信息,请参阅社区行为准则,尤其注意“耐心等待”部分。

请不要直接联系任何不在您主题中的人 — 这是一个论坛,任何参与的人都可能为您提供帮助。此外,公开分享答案对后面的读者来说也是一笔巨大的财富。

如果您需要一项带有 SLA(其中涵盖了问题的响应时间)的服务,那么您可能需要考虑与我们讨论订阅相关事宜。

如果您现在没有答案,可以在两三天后(不包括周末)在自己的消息列上回复。