知识库

如何收集 Neo4j 日志

在提出 Neo4j 支持案例时,上传 Neo4j 日志非常重要。

这使 Neo4j 支持工程师能够有效地开始处理支持案例。

如果使用集群,则应从集群中的所有节点收集日志和配置。

以下日志文件通常需要用于排查支持问题

- debug.log.*
- neo4j.conf
- query.log.*

这些日志文件应涵盖观察到问题或错误的时间段。

这些文件默认位于文件夹“$NEO4J_HOME/logs”和“$NEO4J_HOME/conf”中。

这些文件应压缩并添加到支持案例中。

对于超过 25MB 的大型文件,请通知 Neo4j 支持工程师,我们会提供一个安全的存储位置。

在支持案例过程中可能需要其他日志,由于某些文件可能被 Neo4j 轮换,因此最好存储以下文件夹的副本以供进一步分析

- $NEO4J_HOME/data/cluster-state
- $NEO4J_HOME/data/transactions
- $NEO4J_HOME/metrics

Neo4j 支持团队会根据需要请求这些文件。

部署特定的收集

Neo4j 中有许多日志记录配置,以下是根据部署类型查找日志记录配置的一些选项。

Neo4j 独立实例(服务器/容器)

日志的默认位置是 $NEO4J_HOME/logs

Neo4j 嵌入式实例

日志的默认位置是 $NEO4J_HOME/logs,与独立部署相同。

独立部分中提到的日志选项也适用于嵌入式,但 $NEO4J_HOME 的值在您的应用程序源代码中定义,通常是提供给用于处理 Neo4j 实例的 Java 类的主目录(例如 Java 类“DatabaseManagementServiceBuilder”)。

以下是您可以提供的文件列表(实际文件位置取决于应用程序配置)

- Application logs (replacing the standard neo4j.log file)
- debug.log
- query.log