Confluence 6 配置日誌

咱們推薦你根據你的需求來配置你本身的 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 屬性。

修改日誌配置

1. 在屏幕的右上角單擊 控制檯按鈕 ，而後選擇 General Configuration 連接。
2. 在左側面板中管理（Administration）的界面下面選擇 日誌和配置（Logging and Profiling）。
   你須要具備 System Administrator 權限才能夠進行這個操做。
3. 日誌和配置（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' 連接來中止日誌記錄你選擇的類和包的名稱。
4. 單擊 保存（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