Skip to end of metadata
Go to start of metadata

中文标题【设置 Confluence 日志】


Confluence 使用的是 Apache's log4j 日志服务。能够允许管理员通过编辑配置文件来控制日志的表现和日志输出文件。在系统中有 6 个日志输出级别,请参考 log4j logging levels 页面来获得更多信息。

如果你请求 Atlassian Support 为你提供支持服务,我们总是会要求你能够提供你 Confluence 应用的日志输出。要获得这些日志输出的最简单的方法是进入  > 基本配置(General Configuration) > 问题检查和支持工具(Troubleshooting and support tools 然后根据弹出的提示,创建一个  Support Zip


找到 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 的内容:

日志用户查看/访问 Confluence 每一个页面的详细信息

你可以配置那些用户访问了你 Confluence 站点的那些页面。只仅仅只能通过修改日志配置文件才能进行配置,请参考下面Enabling Detailed SQL Logging页面中的内容。

搜索日志文件获得已知问题

Atlassian 问题解决和支持工具包括有一个日志分析器。这个日志分析器能够检查你 Confluence 的日志来找到日志中的错误,同时根据日志中的错误来对我们已知知识库和问题跟踪系统中的内容进行对比。

请参考 Troubleshooting Problems and Requesting Technical Support 页面中的内容来找到如何设置按照时间来执行扫描你的日志文件。



  • No labels