如何收集 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_HOME/logs

日志存储在属性 "dbms.directories.logs" 指定的路径下。根据此配置属性的值，您的日志文件夹位置可能会有所不同，详情请查阅我们的文档：/docs/operations-manual/current/reference/configuration-settings/#config_dbms.directories.logs
也可以为不同的日志文件指定单独的文件夹。方法是更改相应的配置属性，具体请参见以下链接中的表 2：/docs/operations-manual/current/monitoring/logging/#general-logging
对于容器部署（例如 Docker），同样适用此规则。我们建议始终将日志文件夹映射到外部卷，以防容器终止后丢失文件。

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

在独立部署章节中提到的日志选项同样适用于嵌入式部署，但 $NEO4J_HOME 的值是在您的应用程序源码中定义的，通常是提供给用于管理 Neo4j 实例的 Java 类（例如 Java 类 “DatabaseManagementServiceBuilder”）的主目录。

以下是您可以提供的文件列表（实际文件位置取决于应用配置）

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

此页面有帮助吗？