Os serviços de Sincronização de Diretório, Autenticação de Usuário e Autenticação Kerberos criam arquivos de log que podem ser usados para solucionar problemas. Se você quiser salvar mais logs do que os salvos por padrão, poderá aumentar o tamanho dos arquivos, bem como o número de arquivos criados antes que os logs sejam girados.

Todos os arquivos de log para um serviço são salvos na pasta INSTALL_DIR\Workspace ONE Accessservicename\logs. Por exemplo, os arquivos de log para o Serviço de Sincronização de Diretório estão na pasta INSTALL_DIR\Workspace ONE Access\Directory Sync Service\logs.

Normalmente, os arquivos de log para os quais você pode precisar aumentar o tamanho e o número são os arquivos servicename-service.log e servicename-vertx-access.log.

Os seguintes arquivos XML contêm as configurações de arquivos de log:

  • O arquivo INSTALL_DIR\Workspace ONE Access\servicename\servicename.xml contém as configurações para os arquivos servicename.err.log e servicename.out.log.
    Arquivo de log Arquivo de configurações Tamanho padrão Número padrão de arquivos salvos
    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
  • O INSTALL_DIR\Workspace ONE Access\servicename\conf\log4j2-override.xml contém as configurações para os arquivos servicename-service.log e servicename-vertx-access.log.
    Arquivo de log Arquivo de configurações Tamanho padrão Número padrão de arquivos salvos
    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
Observação: Para obter uma descrição dos arquivos de log, consulte Como acessar arquivos de log do Workspace ONE Access Connector. Essa página também fornece informações sobre como ativar o modo DEBUG e adicionar fim aos arquivos de log.

Procedimento

  1. Faça logon no servidor do Workspace ONE Access Connector.
  2. Para modificar o tamanho ou o número de arquivos servicename.err.log e servicename.out.log de um serviço, siga estas etapas.
    1. Navegue até a pasta INSTALL_DIR\Workspace ONE Access\servicename e abra o arquivo servicename.xml para edição. Por exemplo, para o serviço de Sincronização de Diretório, edite o arquivo INSTALL_DIR\Workspace ONE Access\Directory Sync Service\DirectorySyncService.xml.
    2. Localize a seguinte entrada:
         <log mode="roll-by-size">
              <sizeThreshold>10240</sizeThreshold>
              <keepFiles>8</keepFiles>
          </log>
    3. Atualize o tamanho do arquivo na entrada <sizeThreshold> e o número de arquivos a serem mantidos na entrada de <keepFiles> com base em seus requisitos.
    4. Salve o arquivo.
  3. Para aumentar o tamanho e o número de arquivos servicename-service.log e servicename-vertx-access.log de um serviço, siga estas etapas.
    1. Navegue até a pasta INSTALL_DIR\Workspace ONE Access\servicename\conf e edite o arquivo log4j2-override.xml. Por exemplo, para o serviço de Sincronização de Diretório, edite o arquivo INSTALL_DIR\Workspace ONE Access\Directory Sync Service\conf\log4j2-override.xml.
    2. Adicione as seguintes linhas dentro das linhas <Configuration …> e </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>
      Observação: A seção <RollingFile name="fileLogger"… é para o arquivo servicename-service.log e a seção <RollingFile name="accessFileLogger"… é para o arquivo servicename-vertx-access.log.
    3. Para especificar o tamanho e o número do arquivo servicename-service.log, na seção <RollingFile name="fileLogger"… que você adicionou, edite as seguintes linhas:
      • <SizeBasedTriggeringPolicy size="50 MB" /> para especificar o tamanho do arquivo com base em suas necessidades
      • <DefaultRolloverStrategy max="5"/> para especificar o número de arquivos a serem mantidos com base em suas necessidades
    4. Para especificar o tamanho e o número do arquivo servicename-vertx-access.log, na seção <RollingFile name="accessFileLogger"… que você adicionou, edite as seguintes linhas:
      • <SizeBasedTriggeringPolicy size="50 MB" /> para especificar o tamanho do arquivo com base em suas necessidades
      • <DefaultRolloverStrategy max="5"/> para especificar o número de arquivos a serem mantidos com base em suas necessidades
    5. Salve o arquivo.