1. 程式人生 > >Confluence 6 配置日誌

Confluence 6 配置日誌

管理員 log date 操作 general deb 日誌級別 fin 運行

我們推薦你根據你的需求來配置你自己的 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 的日誌表現:

    • 你可以通過選擇 New Level 的下拉列表來修改日誌級別。請閱讀 Apache documentation 頁面中的內容來定義每一個級別。

    • 單擊 'Remove' 鏈接來停止日誌記錄你選擇的類和包的名稱。

    • 'Production' 屬性定義了標準的屬性,推薦你在生產環境中使用。

    • 'Diagnostic' 屬性定義了更多的屬性配置,能夠為你提供更多的日誌信息。這個配置將會降低你系統的性能並且讓你日誌文件更快的填充滿。

    • 性能屬性(Performance Profiling) — 請參考頁面Troubleshooting Slow Performance Using Page Request Profiling 中的內容

    • SQL 日誌(SQL Logging)' — 單擊 啟用 SQL 日誌(Enable SQL Logging)按鈕來啟用記錄系統運行的 SQL 腳本。
      技術分享圖片 如果你需要啟用日誌 SQL 參數變量,你需要修改 properties file 文件中的設置。這個配置的修改在管理員控制臺界面中不可用。

    • Log4j 日誌(Log4j Logging) — 單擊下面的的屬性按鈕來重置你的日誌定義為默認的初始化定義:

    • 'Add New Entry' — 輸入類或者包的名字到邊上的文本輸入框中,然後單擊 添加實體(Add Entry)按鈕。這個新的日誌將會顯示 已存在的級別(Existing Levels) 在下面的界面中。

    • 'Existing Levels' - 這個是當前你 Confluence 實例中的操作。

  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


Confluence 6 配置日誌