我们推荐你根据你的需求来配置你自己的 Confluence 日志。你可以有下面 2 种方法来修改你的日志： 通过 Confluence 管理员控制台进行配置 – 你的修改仅在本次修改有效，下次重启后将会把所有修改重置。 编辑属性文件 – 你的修改将会在下次重启后生效同时针对所有的会话。 这 2 种方式的修改的方法将在下面的章节中描述。在一些很不常见的情况下，你可能同时还需要修改 logging.properties 文件。 术语：在 log4j 中，一个 'logger' 就是一个命名的实体。日志名是大小写敏感的，这些命名还遵循分段命名的结构。例如一个 logger 被命名为 com.foo，那这个名是 com.foo.Bar 的上级名称。 在 Confluence 管理员控制台中配置日志 你可以通过 Confluence 管理员控制台（Administration Console）来修改 Confluence 的一些日志的表现。任何按照这个方法修改的的内容只会在当前 Confluence 的运行实例阶段有效（重启 Confluence 后，你修改的配置将失效）。这里修改的配置内容将不会写入到 log4j.properties 文件中，同时当你在下一次停止 Confluence 的时候修改的内容将会被丢弃。 Confluence 的管理员控制台不能修改所有的日志表现。如果你不能在下面的描述的内容中找到修改的对象，那么你需要停止 Confluence 后编辑日志属性文件。 Confluence 管理员控制台中的 日志和属性（Logging and Profiling）界面显示了当前定义的所有日志列表。在这个界面中你可以： 打开或者关闭 page profiling。 打开或者关闭 SQL 语句日志。 为一个类或者包添加一个新的日志。 为一个类或者包删除一个新的日志。 为一个类或者包设置日志的级别（INFO, WARN, FATAL, ERROR 或者 DEBUG）。 重置所有的日志级别到 predefined 属性。 修改日志配置 在屏幕的右上角单击 控制台按钮 ，然后选择 General Configuration 链接。 在左侧面板中管理（Administration）的界面下面选择 日志和配置（Logging and Profiling）。 你需要具有 System Administrator 权限才可以进行这个操作。 日志和配置（Logging and Profiling）界面将会显示，如下图显示，使用下面的的指南来记录 Confluence 的日志表现： 性能属性（Performance Profiling） — 请参考页面Troubleshooting Slow Performance Using Page Request Profiling 中的内容 SQL 日志（SQL Logging）' — 单击 启用 SQL 日志（Enable SQL Logging）按钮来启用记录系统运行的 SQL 脚本。 如果你需要启用日志 SQL 参数变量，你需要修改 properties file 文件中的设置。这个配置的修改在管理员控制台界面中不可用。 Log4j 日志（Log4j Logging） — 单击下面的的属性按钮来重置你的日志定义为默认的初始化定义： 'Production' 属性定义了标准的属性，推荐你在生产环境中使用。 'Diagnostic' 属性定义了更多的属性配置，能够为你提供更多的日志信息。这个配置将会降低你系统的性能并且让你日志文件更快的填充满。 'Add New Entry' — 输入类或者包的名字到边上的文本输入框中，然后单击 添加实体（Add Entry）按钮。这个新的日志将会显示 已存在的级别（Existing Levels） 在下面的界面中。 'Existing Levels' - 这个是当前你 Confluence 实例中的操作。 你可以通过选择 New Level 的下拉列表来修改日志级别。请阅读 Apache documentation 页面中的内容来定义每一个级别。 单击 'Remove' 链接来停止日志记录你选择的类和包的名称。 单击 保存（Save）按钮来保存你在 'Existing Levels' 部分所做的任何修改。 屏幕截图：修改日志级别和参数 编辑属性文件 希望配置日志级别和其他基础参数的设置，你需要停止 Confluence 然后修改 log4j.properties 文件的设置，如果上面的描述。 这个属性文件包括了一系列的不同日志并且可以被你取消备注，如果你希望记录一些特定的组件。请参考 Apache log4j documentation 页面中的内容。 请参考 Working with Confluence Logs 页面中的的内容来获得一些配置的指南，你可能会发现这些指南对你对问题的诊断会比较有用。 针对 logging.properties 中的 java.util.logging 配置级别 一些库在 Confluence 中被用来使用 java.util.logging 而不是 log4j 或者 slf4j。这些库包括： com.sun.jersey org.apache.shindig net.sf.ehcache 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 级别。 https://www.cwiki.us/display/CONF6ZH/Configuring+Logging
指定 Confluence 日志选项 这里是一些特定的日志配置，你可能在对问题进行调试的时候需要。 在日志中记录数据库使用的 SQL 查询请求 你可能希望增加日志的中的内容，记录 Confluence 系统向数据库中插入数据的时候使用的 SQL 语句。针对一些特定的问题的诊断，这个配置能够帮你找到你肯能需要的一些信息。 你可以通过下面的 2 种方法启用在你的日志中记录 SQL 的内容： 在系统运行的时候记录 – 请参考上面的指南。 通过日志配置文件 – 请参考这里的Enabling Detailed SQL Logging。 日志用户查看/访问 Confluence 每一个页面的详细信息 你可以配置那些用户访问了你 Confluence 站点的那些页面。只仅仅只能通过修改日志配置文件才能进行配置，请参考下面Enabling Detailed SQL Logging页面中的内容。 搜索日志文件获得已知问题 Atlassian 问题解决和支持工具包括有一个日志分析器。这个日志分析器能够检查你 Confluence 的日志来找到日志中的错误，同时根据日志中的错误来对我们已知知识库和问题跟踪系统中的内容进行对比。 请参考 Troubleshooting Problems and Requesting Technical Support 页面中的内容来找到如何设置按照时间来执行扫描你的日志文件。 .https://www.cwiki.us/display/CONF6ZH/Working+with+Confluence+Logs
修改日志文件的大小和数量 在默认的情况下，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 中的日志配置文件。 https://www.cwiki.us/display/CONF6ZH/Working+with+Confluence+Logs
在 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 页面中的内容。 https://www.cwiki.us/display/CONF6ZH/Working+with+Confluence+Logs
找到 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 页面中的描述。 https://www.cwiki.us/display/CONF6ZH/Working+with+Confluence+Logs
Confluence 使用的是 Apache's log4j 日志服务。能够允许管理员通过编辑配置文件来控制日志的表现和日志输出文件。在系统中有 6 个日志输出级别，请参考 log4j logging levels 页面来获得更多信息。 如果你请求 Atlassian Support 为你提供支持服务，我们总是会要求你能够提供你 Confluence 应用的日志输出。要获得这些日志输出的最简单的方法是进入 > 基本配置（General Configuration） > 问题检查和支持工具（Troubleshooting and support tools） 然后根据弹出的提示，创建一个 Support Zip。 https://www.cwiki.us/display/CONF6ZH/Working+with+Confluence+Logs
Confluence 支持一些可以从 Java 系统属性中配置的配置参数和调试（debugging ）设置。系统属性通常是使用 -D 为参数选项，这个选项是 Confluence 在运行后设置到 JVM 虚拟机中的。请参考：Configuring System Properties 页面中的内容来获得更多的信息。 开始版本 默认值 模块... 作用和影响 atlassian.forceSchemaUpdate 1.0 false atlassian-config 在默认的情况下，Confluence 只会在侦测到数据库更新后才会运行数据库 schema 更新。这个标志位将会强制 Confluence 在启动的时候对 schema 进行更新。 confluence.home 1.0 任何文件系统路径 Confluence and atlassian-config 如果这个属性被设置，Confluence 将会忽略 confluence-init.properties 属性文件中配置的信息，使用你在启动的时候指定的路径为 Confluence Home 目录。 confluence.dev.mode 1.0 false Confluence 针对 Confluence 开发人员，启用更多的 debugging 选项（这个也可能会修改 spring bean 的默认 lazy 初始化方式，将会增加启动时间）。请不要在生产环境中启用这个选项。 confluence.disable.mailpolling 2.4 false Confluence 如果设置为 "true"，将会阻止 Confluence 从已经归档的空间中获得邮件。通过 WEB 界面的 "check for new mail" 进行手动操作依然可用。这个配置将不会影响发送邮件。 confluence.i18n.reloadbundles 1.0 true Confluence 设置这个属性将会导致 Confluence 在每次国际化（internationalized ）字符查找的时候载入 i18n 资源。这个在对翻译进行测试的时候会非常有用，但是会导致 Confluence 实例运行缓慢（insanely slowly）。 confluence.ignore.debug.logging 1.0 true Confluence 当 Confluence 检测到 DEBUG 级别的日志被启用了，Confluence 将会输出服务器的错误信息（DEBUG 级别的日志将会显著的降低服务器性能）。设置这个选项将会输出所有的错误信息。 confluence.jmx.disabled 3.0 false Confluence 如果被设置为 "true"，将会禁用 Confluence 的 JMX 监控。这个与在 WEB-INF/classes/jmxContext.xml 设置 "enabled" 属性是一样的。 confluence.optimize.index.modulo 2.2 20 Confluence 在索引进行优化之前刷新索引的次数。 confluence.plugins.bundled.disable 2.9 false Confluence 启动 Confluence 的时候不绑定插件。在 Confluence 开发环境中进行快速启动会显得很有效，能够加快启动速度，但是启动的时候绑定插件是 Confluence 一些核心功能所需要的。这个属性不应该在 Confluence 生产环境中设置。 atlassian.indexing.contentbody.maxsize 3.0 1048576 atlassian 当文件上传后，文件的内容被解压并且进行索引，这个功能允许用户不但可以对文件名进行搜索还可以对文件内容进行搜索。 如果解压的内容文件大小超过了设定的值（默认为 1 MB），文件的内容还是会被索引和查找，但是文件将不会显示在查找结果中。增加这个限制值，将会是查询结果的显示变得缓慢。请参考 Configuring Attachment Size 页面中的更多信息。 atlassian.mail.fetchdisabled 3.5 false Confluence 为 IMAP 和 POP 禁用邮件过滤服务 atlassian.mail.senddisabled 3.5 false Confluence and atlassian-mail 禁用发送邮件 atlassian.disable.caches 2.4 true atlassian-plugins, atlassian-cache-servlet 设置这个属性将会禁用 conditional get 和 expires：一些 WEB 资源的头部（headers ）。这个将会显著降低用户的使用体验，但是在开发环境中就显得非常有用，如果你经常修改一些静态资源但是你又不想持续的刷新你浏览器的缓存。 confluence.html.encode.automatic 2.9 Confluence 设置这个属性将会强制 antixss 编码打开或关闭，将会覆盖 settings 中的设置。默认的表现针对 Confluence 的版本不同而不同。 org.osgi.framework.bootdelegation 2.10 empty atlassian-plugins Comma-separated 为 OSGi 插件提供包的的列表名。基本上当 Confluence 进行 profiling 的时候是需要的。例如："com.jprofiler.,com.yourkit."。 confluence.diff.pool.size 3.1 20 Confluence 当前最大不同的数量。如果超过了这个值，其他通过 RSS 创建的 diffs 将会忽略和日志（RSS 请求还是会显示成功，但是将会丢失 diffs 信息）。 confluence.diff.timeout 3.1 1000 Confluence 在比较 2 个页面版本的时候，diff 操作王朝等待的时间（毫秒）。在这个时间内完成否则将会显示错误信息。 confluence.html.diff.timeout 4.0 10000 Confluence 在比较 2 个页面版本的时候，diff 操作完成等待的时间（毫秒）。在这个时间内完成否则将会显示取消并显示错误信息。 atlassian.user.experimentalMapping 2.10 false Confluence 设置这个属性将会修改本地用户和本地用户组之间的关系来避免在向本地系统中导入大量用户产生的性能问题。请注意，设置这个选项为启用的话将会降低其他用户管理功能的速度。我们建议仅仅在向系统中大量导入用户和用户组出现性能出现问题的时候才启用这个选项。请参考 CONF-12319，针对这个问题在 Confluence 3.1.1 中我们已经修复了。 confluence.import.use-experimental-importer 3.2 false Confluence 设置这个属性来修改 Confluence 使用 测试 XML 导入器（Experimental XML Importer）。这个被设置为能更稳定的导入数据到 Confluence 中，但是在 Confluence 3.2 发布的时候，这个导入功能未测试大数据量的导入，所以也不提供支持。 atlassian.webresource.disable.minification 3.3 false atlassian-plugins 禁用 Confluence 服务器的 JavaScript 和 CSS 资源自动压缩。 index.queue.thread.count 3.3 See "Effect" Confluence 设置重新索引可以使用的线程数量大小。这个值可以被设置为从…
校验你的设置 查看你 Confluence 当前使用的设置，请参考 Viewing System Properties 页面中的内容。 识别系统属性 请参考 Recognized System Properties 页面中的内容来找到针对你安装 Confluence 版本可以配置的系统属性参数。 https://www.cwiki.us/display/CONF6ZH/Configuring+System+Properties
当你使用 Start Confluence Automatically on Windows as a Service 的方式启动的时候，你有下面 2 种方式来配置你的系统属性：通过 command line 或者 in the Windows Registry 通过命令行方式来为 Windows 服务设置属性 如何通过命令行方式为 Windows 服务器设置属性： 找到 Confluence 在 Windows 中安装的服务名（进入 控制面板（Control Panel）> 管理工具（Administrative Tools）> 服务（Services））： 在上面的示例中，服务名称被命名为 Confluence121213135538。 打开 Windows 的命令行窗口（选择 开始（Start ）> cmd.exe） cd 进入你安装 Confluence 实例的 bin 目录，然后运行下面的命令： tomcat8w //ES//<SERVICENAME> 按照上面的示例，这个命令应该修改为 tomcat8w //ES//Confluence121213135538 针对你使用 Confluence 的版本不同，Tomcat 的版本号也有可能不同。 单击 Java 标签页来查看当前启动的选项列表： 应用新的选线，或者修改选项，通过添加选项配置到已经存在的 Java Options 列表后面。请参考 Recognized System Properties 页面中的内容对属性参数进行配置。 通过 Windows registry 为 Windows services 设置属性 在一些 Window 的版本中，可能没有办法为启动服务添加 Java 变量的。如果你的 Windows 是这种情况的话，你必须添通过查看注册表中的选项列表来添加属性。 进入注册表编辑器（开始（Start） > regedit.exe）。 找到 Services 实体 HKEY_LOCAL_MACHINE >> SOFTWARE >> Apache Software Foundation >> Procrun 2.0 >> Confluence service name 修改已经存在的属性，你可以通过双击来修改变量名。 希望修改其他的属性，双击选项名称。 请参考 Recognized System Properties 页面中的内容对每一行变量进行配置。 部署在 AWS 上的 Confluence 数据中心 如果你使用的是 Quick Start 或者 CloudFormation 模板部署 Confluence 数据中心到 AWS。你需要通过 Cloud Formation Template 传递配置参数，请不要使用上面描述的方法。 在 AWS 控制台中，选择 Update Stack 在 Advanced 中的 Catalina Properties 字段输入你的系统属性： -Xms1024m -Xmx1024m -Dsystemproperty=value 修改将会应用到新的节点中。 https://www.cwiki.us/display/CONF6ZH/Configuring+System+Properties
在这个页面中描述 Confluence 启动时如何设置 Java 属性和其他选项。 请查看 How to fix out of memory errors by increasing available memory 页面中内容来获得如何处理 OutOfMemory 错误。 Linux 在 Linux 安装环境下配置系统属性： 编辑 <installation-directory>/bin/setenv.sh 文件。 找到 CATALINA_OPTS= （针对 Confluence 5.5 及其早期版本，这个参数是 JAVA_OPTS=） 请参考 Configuring System Properties 页面中的内容对属性参数进行配置。 添加所有的参数为空格分离列表，在引号内。 Windows （从 .bat 文件启动） 在 Windows 中当使用 .bat 文件启动的时候配置系统启动参数： 编辑 <installation-directory>/bin/setenv.bat 文件。 找到 set CATALINA_OPTS=%CATALINA_OPTS% 部分 （在 Confluence 5.5 及其早期版本中，这个参数为 JAVA_OPTS=%JAVA_OPTS%） 请参考 Recognized System Properties 页面中的内容对属性参数进行配置。 所有添加的参数都使用的是空格分离列表。请确定不要修改 %CATALINA_OPTS% 字符。 https://www.cwiki.us/display/CONF6ZH/Configuring+System+Properties