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

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

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

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

  • INSTALL_DIR\Workspace ONE Access\servicename\servicename.xml 檔案包含 servicename.err.logservicename.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
    VirtualAppService.err.log INSTALL_DIR\Workspace ONE Access\Virtual App Service\VirtualAppService.xml 10240 KB 8
    VirtualAppService.out.log INSTALL_DIR\Workspace ONE Access\Virtual App Service\VirtualAppService.xml 10240 KB 8
  • INSTALL_DIR\Workspace ONE Access\servicename\conf\log4j2-override.xml 包含 servicename-service.logservicename-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
    eis-service.log INSTALL_DIR\Workspace ONE Access\Virtual App Service\conf\log4j2-override.xml 50 MB 5
    eis-vertx-access.log INSTALL_DIR\Workspace ONE Access\Virtual App Service\conf\log4j2-override.xml 50 MB 5
備註: 如需記錄檔的說明,請參閱 存取 Workspace ONE Access Connector 紀錄檔。該頁面也提供關於啟用 DEBUG 模式以及對記錄檔執行 tail 的資訊。

程序

  1. 登入 Workspace ONE Access Connector 伺服器。
  2. 若要修改服務的 servicename.err.logservicename.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.logservicename-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. 儲存檔案。