目錄同步、使用者驗證和 Kerberos 驗證服務會分別建立可供您疑難排解問題的記錄檔。如果您想要儲存比依預設儲存數量更多的記錄，您可以增加檔案的大小，以及在輪替記錄之前建立的檔案數目。

服務的所有記錄檔都會儲存在 INSTALL_DIR\Workspace ONE Access\servicename\logs 資料夾中。例如，目錄同步服務的記錄檔位於 INSTALL_DIR\Workspace ONE Access\Directory Sync Service\logs 資料夾中。

可能需要增加大小和數目的記錄檔通常是 servicename-service.log 和 servicename-vertx-access.log 檔案。

下列 XML 檔案包含記錄檔的設定：

  • INSTALL_DIR\Workspace ONE Access\servicename\servicename.xml 檔案包含 servicename.err.log 和 servicename.out.log 檔案的設定。
    記錄檔 設定檔案 預設大小 儲存的預設檔案數目
    DirectorySyncService.err.log INSTALL_DIR\Workspace ONE Access\Directory Sync Service\DirectorySyncService.xml 10240 KB 8
    DirectorySyncService.out.log INSTALL_DIR\Workspace ONE Access\Directory Sync Service\DirectorySyncService.xml 10240 KB 8
    UserAuthService.err.log INSTALL_DIR\Workspace ONE Access\User Auth Service\UserAuthService.xml 10240 KB 8
    UserAuthService.out.log INSTALL_DIR\Workspace ONE Access\User Auth Service\UserAuthService.xml 10240 KB 8
    KerberosAuthService.err.log INSTALL_DIR\Workspace ONE Access\Kerberos Auth Service\KerberosAuthService.xml 10240 KB 8
    KerberosAuthService.out.log INSTALL_DIR\Workspace ONE Access\Kerberos Auth Service\KerberosAuthService.xml 10240 KB 8
  • INSTALL_DIR\Workspace ONE Access\servicename\conf\log4j2-override.xml 包含 servicename-service.log 和 servicename-vertx-access.log 檔案的設定。
    記錄檔 設定檔案 預設大小 儲存的預設檔案數目
    eds-service.log INSTALL_DIR\Workspace ONE Access\Directory Sync Service\conf\log4j2-override.xml 50 MB 5
    eds-vertx-access.log INSTALL_DIR\Workspace ONE Access\Directory Sync Service\conf\log4j2-override.xml 50 MB 5
    eas-service.log INSTALL_DIR\Workspace ONE Access\User Auth Service\conf\log4j2-override.xml 50 MB 5
    eas-vertx-access.log INSTALL_DIR\Workspace ONE Access\User Auth Service\conf\log4j2-override.xml 50 MB 5
    eks-service.log INSTALL_DIR\Workspace ONE Access\Kerberos Auth Service\conf\log4j2-override.xml 50 MB 5
    eks-vertx-access.log INSTALL_DIR\Workspace ONE Access\Kerberos Auth Service\conf\log4j2-override.xml 50 MB 5
備註： 如需記錄檔的說明，請參閱 存取 Workspace ONE Access Connector 記錄檔。該頁面也提供關於啟用 DEBUG 模式以及對記錄檔執行 tail 的資訊。

程序

  1. 登入 Workspace ONE Access Connector 伺服器。
  2. 若要修改服務的 servicename.err.log 和 servicename.out.log 檔案的大小或數目，請依照下列步驟操作。
    1. 導覽至 INSTALL_DIR\Workspace ONE Access\servicename 資料夾，然後開啟 servicename.xml 檔案以進行編輯。以目錄同步服務為例，請編輯 INSTALL_DIR\Workspace ONE Access\Directory Sync Service\DirectorySyncService.xml 檔案。
    2. 找出下列項目： 
         <log mode="roll-by-size">
        <sizeThreshold>10240</sizeThreshold>
        <keepFiles>8</keepFiles>
    </log>
    3. 根據您的需求，更新 <sizeThreshold> 項目中的檔案大小，以及要保存在 <keepFiles> 項目中的檔案數目。
    4. 儲存檔案。
  3. 若要增加服務的 servicename-service.log 和 servicename-vertx-access.log 檔案的大小和數目，請依照下列步驟操作。
    1. 導覽至 INSTALL_DIR\Workspace ONE Access\servicename\conf 資料夾，然後編輯 log4j2-override.xml 檔案。以目錄同步服務為例，請編輯 INSTALL_DIR\Workspace ONE Access\Directory Sync Service\conf\log4j2-override.xml 檔案。
    2. 在 <Configuration …> 和 </Configuration> 行中新增下列幾行： 
      <Appenders>
<RollingFile name="fileLogger" fileName="${logFilePathAndNamePrefix}.log"
filePattern="${logFilePathAndNamePrefix}-%i.log">

<PatternLayout pattern="${defaultLayout}" />

<Policies>
<SizeBasedTriggeringPolicy size="50 MB" />
</Policies>
<DefaultRolloverStrategy max="5"/>
</RollingFile>

<!-- Rolling file appender, used by vertx access log -->
<RollingFile name="accessFileLogger" fileName="${accessLogFilePathAndNamePrefix}.log"
filePattern="${accessLogFilePathAndNamePrefix}-%i.log">

<PatternLayout pattern="${accessLogLayout}" />

<Policies>
<SizeBasedTriggeringPolicy size="50 MB" />
</Policies>
<DefaultRolloverStrategy max="5"/>
</RollingFile>
</Appenders>
      備註： <RollingFile name="fileLogger"… 區段適用於 servicename-service.log 檔案，而 <RollingFile name="accessFileLogger"… 區段則適用於 servicename-vertx-access.log 檔案。
    3. 若要指定 servicename-service.log 檔案的大小和數目，請在您新增的 <RollingFile name="fileLogger"… 區段中編輯下列幾行：
      • <SizeBasedTriggeringPolicy size="50 MB" />，用以根據您的需求指定檔案大小
      • <DefaultRolloverStrategy max="5"/>，用以根據您的需求指定要保存的檔案數目
    4. 若要指定 servicename-vertx-access.log 檔案的大小和數目，請在您新增的 <RollingFile name="accessFileLogger"… 區段中編輯下列幾行：
      • <SizeBasedTriggeringPolicy size="50 MB" />，用以根據您的需求指定檔案大小
      • <DefaultRolloverStrategy max="5"/>，用以根據您的需求指定要保存的檔案數目
    5. 儲存檔案。