中文标题【设置 Confluence 日志】
找到 Confluence 的日志文件
这部分内容对 Confluence 的默认日志表现进行描述并且假设你没有对 Confluence 的默认日志配置进行修改。为了统一在不同平台中的日志输出,Confluence 使用 atlassian-confluence.log
为主要日志,而不使用应用服务器日志。
- 当你启动 Confluence 的时候,日志实体将会发送日志直到 Confluence 完全初始化完成。任何在服务器控制台中输出的日志也会同时输出到上面描述的文件中。
- 当启动完成后,所有的日志将会输出到
<confluence-home>/logs/atlassian-confluence.log
。例如:c:/confluence/data/logs/atlassian-confluence.log
。
请注入,默认的位置位于 Confluence 的 home 目录中(home directory)而不是在应用服务器的日志目录中的。home 目录的路径可以在 <confluence-installation>/confluence/WEB-INF/classes/confluence-init.properties
中指定。
找到 Confluence 的日志配置文件
有关 Confluence 和 Synchrony 的日志表现定义在下面的属性文件:<CONFLUENCE-INSTALL>/confluence/WEB-INF/classes/log4j.properties
这个文件是标准的 Logj 配置文件,请参考 Apache log4j documentation 页面中的描述。
修改日志文件的目标位置
在 log4j 中,一个输出被定义为 'appender'。希望修改 log 文件的目标,你需要停止 Confluence 然后修改设置 log4j.properties
日志配置文件的 'Logging Location and Appender' 设置。有关这个文件的路径,请参考上面的说明。
在一个标准的配置文件中,你可以找到下面 2 个 appenders。
com.atlassian.confluence.logging.ConfluenceHomeLogAppender
– 这个是默认的日志输出器(appender )在上面描述得文件中。这个日志输出器有允许下面的设置:- MaxFileSize
- MaxBackupIndex
org.apache.log4j.RollingFileAppender
– 如果你希望记录日志到不同的位置,取消RollingFileAppender
行前面的备注,同时修改下面的日志文件路径。注释掉ConfluenceHomeLogAppender
行的内容。
Synchrony 日志路径也可以通过同样的方式进行修改。
Confluence 绑定了 log4j 提供的所有功能。有关 log4j 日志输出容器的的定义,请参考 log4j documentation 页面中的内容。
修改日志文件的大小和数量
在默认的情况下,Confluence 将会保持 5 个日志文件,每一个日志文件的大小超过 20 MB 的时候将会被重写。
你可以修改默认日志文件的大小和数量,通过编辑 <CONFLUENCE-INSTALL>/confluence/WEB-INF/classes/log4j.properties
文件中的内容。
log4j.appender.confluencelog.MaxFileSize=20480KB log4j.appender.confluencelog.MaxBackupIndex=5
修改日志级别
请参考 Configuring Logging 页面中的内容来修改 Confluence 中的日志配置文件。
指定 Confluence 日志选项
这里是一些特定的日志配置,你可能在对问题进行调试的时候需要。
在日志中记录数据库使用的 SQL 查询请求
你可能希望增加日志的中的内容,记录 Confluence 系统向数据库中插入数据的时候使用的 SQL 语句。针对一些特定的问题的诊断,这个配置能够帮你找到你肯能需要的一些信息。
你可以通过下面的 2 种方法启用在你的日志中记录 SQL 的内容:
- 在系统运行的时候记录 – 请参考上面的指南。
- 通过日志配置文件 – 请参考这里的Enabling Detailed SQL Logging。
日志用户查看/访问 Confluence 每一个页面的详细信息
你可以配置那些用户访问了你 Confluence 站点的那些页面。只仅仅只能通过修改日志配置文件才能进行配置,请参考下面Enabling Detailed SQL Logging页面中的内容。
搜索日志文件获得已知问题
Atlassian 问题解决和支持工具包括有一个日志分析器。这个日志分析器能够检查你 Confluence 的日志来找到日志中的错误,同时根据日志中的错误来对我们已知知识库和问题跟踪系统中的内容进行对比。
请参考 Troubleshooting Problems and Requesting Technical Support 页面中的内容来找到如何设置按照时间来执行扫描你的日志文件。