目錄同步、使用者驗證、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 記錄檔 (僅限 Workspace ONE Access 雲端)。該頁面也提供關於啟用 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. 儲存檔案。