為 VMware Cloud Director 儲存格設定記錄

VMware Cloud Director 具有不同的記錄層級。如果環境比較繁忙，或者要在疑難排解時擷取事件，預設記錄組態可能無法滿足要求。您可能需要變更記錄層級，甚至變更保留的檔案大小和數目。

重要： 在沒有 VMware 全球支援團隊指導的情況下變更記錄組態時，請確認您瞭解這樣做會對 VMware Cloud Director 伺服器群組產生什麼樣的後果。如果將記錄層級變更為更詳細的層級，記錄可能會開始快速擴充，而 VMware Cloud Director 環境可能會耗盡磁碟空間。

VMware Cloud Director 記錄位於 /opt/vmware/vcloud-director/logs/ 目錄中。

VMware Cloud Director 記錄組態檔位於 /opt/vmware/vcloud-director/etc/ 目錄中。記錄組態檔的名稱為 log4j.properties。

如果您要自訂 log4j.properties 記錄組態檔，則必須在 VMware Cloud Director 升級之前建立 log4j.properties 的複本，並在升級後手動插入任何遺失的部分。

若要改進記錄保留並確保 VMware Cloud Director 記錄保留一段時間，請考慮使用 syslog 伺服器。

表 1. 記錄層級

記錄層級	描述
FATAL	此層級會記錄可能導致應用程式失敗的非常嚴重的錯誤事件。
ERROR	此層級會記錄可能仍允許應用程式繼續執行的錯誤事件。
WARN	此層級會記錄可能有害的情況和警告。
INFO	此層級會記錄以粗粒紋反白顯示應用程式進度的資訊訊息。
DEBUG	此層級會記錄最有助於以細粒紋偵錯應用程式的資訊事件。
TRACE	此層級比 DEBUG 層級記錄所記錄的資訊事件粒紋更精細。

必要條件

建立 /opt/vmware/vcloud-director/etc/log4j.properties 檔案的備份複本。

考慮

程序

1. 以 root 身分直接登入或使用 SSH 用戶端登入 VMware Cloud Director 主控台。
2. 在文字編輯器中開啟 /opt/vmware/vcloud-director/etc/log4j.properties 檔案。
3. 找到要更新的記錄檔定義。

   log4j.appender.Feature.File=logs/File_Name

   例如，您可能希望變更 # Component appender for container debug 部分的記錄層級。該部分的最後一行用於設定此檔案擷取的記錄層級。
4. 將記錄層級設定為所需的值。
   重要： 在沒有 VMware 全球支援團隊指導的情況下變更記錄組態時，請確認您瞭解這樣做會對 VMware Cloud Director 伺服器群組產生什麼樣的後果。

   TRACE 層級的詳細程度最高， FATAL 層級的詳細程度最低。以下範例會變更該行以與最詳細層級相符。

   log4j.appender.vcloud.system.debug.threshold=TRACE

5. 如果將記錄變更為更詳細層級，您可能需要增加記錄備份的數目和記錄檔的大小。
   1. 找到 MaxFileSize 和 MaxBackupIndex 行。

      log4j.appender.vcloud.system.debug.MaxFileSize=

      log4j.appender.vcloud.system.debug.MaxBackupIndex=

   2. 變更預設設定。
      例如，如果希望記錄檔在擴充至 50 MB 之後滾翻更新並保留最後 18 個記錄，請按如下所示變更這兩行。

      log4j.appender.vcloud.system.debug.MaxFileSize=50000KB

      log4j.appender.vcloud.system.debug.MaxBackupIndex=18

      當檔案達到所選的 50 MB 大小後， VMware Cloud Director 會繼續將資料寫入一個新檔案中，並保留最多 18 個備份。
   重要： 如果將記錄層級變更為更詳細的層級，記錄可能會開始快速擴充，而 VMware Cloud Director 環境可能會耗盡磁碟空間。
6. 儲存 /opt/vmware/vcloud-director/etc/log4j.properties 檔案。
   VMware Cloud Director 會立即套用所做變更。 Log4J.properties 檔案中沒有明確用於變更 VMware Cloud Director 保留的記錄大小和數量的行。

控制 VMware Cloud Director 中的 API 要求記錄

可以控制在 VMware Cloud Director 中擷取和儲存傳入要求相關資訊的過程。

VMware Cloud Director 將 VMware Cloud Director 儲存格的傳入要求記錄在要求記錄中。這些記錄的名稱格式為 YYYY_MM_DD.request.log。可以在 /opt/vmware/vcloud-director/logs/ 目錄中找到 VMware Cloud Director request.log 檔案，但無法透過 log4j.properties 檔案設定記錄。

可以使用命令列工具的 manage-config 子命令控制 API 要求記錄。manage-config 子命令會變更整個伺服器群組的設定。如需有關 manage-config 子命令選項和引數的詳細資訊，請參閱在 VMware Cloud Director 中更新應用程式組態設定。

記錄輪替最多每天進行一次，並且與各個記錄檔的大小或所有記錄檔的總大小無關。可以透過變更 VMware Cloud Director 保留記錄的天數來控制輪替原則。

程序

1. 以 root 身分直接登入或使用 SSH 用戶端登入 VMware Cloud Director 儲存格的作業系統。
2. 如果要變更要求記錄的保留原則，請使用儲存格管理工具的 manage-config 子命令。
   保留原則值表示 VMware Cloud Director 保留符合國家超級計算應用中心 (NCSA) 要求的要求記錄的天數。預設值為 0，其中 0 表示永久。刪除該值也會永久保留記錄。保留記錄的最短時間為 1 天。

   /opt/vmware/vcloud-director/bin/cell-management-tool manage-config --name "vcloud.http.log.retainDays" --value New_Value

3. 若要使變更生效，必須重新啟動儲存格。
   重新啟動儲存格後，它將開始使用更新的值。可以一次重新啟動部分或全部儲存格。