问题排查报告功能

Kibana 擅长作为数据可视化工具。报告功能的存在是为了将数据导出为简单的报告，但是 Kibana 不是数据导出工具。要大规模导出数据，有更好的方法和更好的架构可以从 Elasticsearch 大规模导出数据。

如果您在创建简单报告时遇到问题，以下是一些在您使用报告功能时可能遇到的常见问题的一般解决方案。有关特定类型报告的提示，请参阅 CSV 和 PDF/PNG。

以下是您在报告功能中可能遇到的一些错误消息的常见解决方案。

如果您在集群中运行 Kibana 的多个实例，这些实例会共享运行报告作业的工作，以均匀分配工作负载。每个实例都会在报告索引中搜索用户请求的“待处理”作业。多个实例可能会在这些搜索中找到相同的作业。只有成功将作业状态更新为“正在处理”的实例才会实际运行报告作业。其他尝试进行相同更新但未成功的实例将记录类似如下的内容

StatusCodeError: [version_conflict_engine_exception] [...]: version conflict, required seqNo [6124], primary term [1]. current document has seqNo [6125] and primary term [1], with { ... }
  status: 409,
  displayName: 'Conflict',
  path: '/.reporting-...',
  body: {
    error: {
      type: 'version_conflict_engine_exception',
      reason: '[...]: version conflict, required seqNo [6124], primary term [1]. current document has seqNo [6125] and primary term [1]',
    },
  },
  statusCode: 409
}

这些消息本身并不表示存在问题。它们显示的是在健康系统中发生的正常事件。

“达到最大尝试次数”错误有两个主要原因

创建一个 Markdown 可视化，然后创建一个 PDF 报告。如果成功，则增加 xpack.reporting.queue.timeout 设置。如果 PDF 报告失败并显示“达到最大尝试次数”，请检查您的 Kibana 服务器设置。

Kibana 服务器日志包含大量有用的信息，可用于排查问题和了解工作原理。当您遇到问题时，报告功能的完整日志是一个很好的查找位置。在 kibana.yml 中

logging.root.level: all

有关日志记录的更多信息，请查看 Kibana 配置设置。