目录同步、用户身份验证和 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
  • 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
注: 有关日志文件的描述,请参阅 访问 Workspace ONE Access Connector 日志文件。该页面还提供有关启用 DEBUG 模式和跟踪日志文件的信息。

过程

  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. 保存文件。