我们推荐你根据你的需求来配置你自己的 Confluence 日志。你可以有下面 2 种方法来修改你的日志:
这 2 种方式的修改的方法将在下面的章节中描述。在一些很不常见的情况下,你可能同时还需要修改 logging.properties 文件。
术语:在 log4j 中,一个 'logger' 就是一个命名的实体。日志名是大小写敏感的,这些命名还遵循分段命名的结构。例如一个 logger 被命名为 com.foo
,那这个名是 com.foo.Bar
的上级名称。
你可以通过 Confluence 管理员控制台(Administration Console)来修改 Confluence 的一些日志的表现。任何按照这个方法修改的的内容只会在当前 Confluence 的运行实例阶段有效(重启 Confluence 后,你修改的配置将失效)。这里修改的配置内容将不会写入到 log4j.properties
文件中,同时当你在下一次停止 Confluence 的时候修改的内容将会被丢弃。
Confluence 的管理员控制台不能修改所有的日志表现。如果你不能在下面的描述的内容中找到修改的对象,那么你需要停止 Confluence 后编辑日志属性文件。
Confluence 管理员控制台中的 日志和属性(Logging and Profiling)界面显示了当前定义的所有日志列表。在这个界面中你可以:
修改日志配置
,然后选择 General Configuration 链接。
你需要具有 System Administrator 权限才可以进行这个操作。
如果你需要启用日志 SQL 参数变量,你需要修改 properties file 文件中的设置。这个配置的修改在管理员控制台界面中不可用。
屏幕截图:修改日志级别和参数
希望配置日志级别和其他基础参数的设置,你需要停止 Confluence 然后修改 log4j.properties
文件的设置,如果上面的描述。
这个属性文件包括了一系列的不同日志并且可以被你取消备注,如果你希望记录一些特定的组件。请参考 Apache log4j documentation 页面中的内容。
请参考 Working with Confluence Logs 页面中的的内容来获得一些配置的指南,你可能会发现这些指南对你对问题的诊断会比较有用。
一些库在 Confluence 中被用来使用 java.util.logging 而不是 log4j 或者 slf4j。这些库包括:
Confluence 的 logging.properties
文件设置将 java.util.logging 重定向为 log4j 的特定级别,这个重定向是通过 slf4j 操作的。
为了增加这些库的日志级别,你必须首先配置 logging.properties
文件中的 <CONFLUENCE-INSTALL>/confluence/WEB-INF/classes/
。这些日志级别与 Logj 的级别不同,如这里列出来的。
例如,为了让 shindig 增加在日志中输出的内容信息,需要修改 in the logging.properties
文件:
org.apache.shindig.level = INFO
为
org.apache.shindig.level = FINE
然后需要使用上面提供的 2 中方式中的一种来配置 log4j 级别。