Ejecución del registro para un usuario específico mediante la utilización de categorías seleccionadas

Puede iniciar el registro para un usuario especificado, implementar el rastreo hasta el originador ("dye tracing") y personalizar la salida utilizando categorías seleccionadas y distribuyendo la salida a una o varias definiciones de adicionador.

Procedimiento

  1. En el directorio ubicación_c10\configuration, localice el archivo de rastreo ipf del componente que desea rastrear. Los archivos se denominan ipf<componente>clientconfig.xml.sample. Por ejemplo, ipfAAAclientconfig.xml.
  2. Cree una copia del archivo ipf<componente>clientconfig.xml.sample especificado utilizando el nombre ipfclientconfig.xml.off.
  3. Mediante un editor de texto, abra el archivo ipfclientconfig.xml.off y realice los cambios siguientes:
    • Añada o cambie el nivel de registro de <category> según sea necesario.
    • Añada una nueva sección de <appender>, bajo el último elemento <appender> existente, como se indica a continuación:

      <appender name="DyeTraceOutput" class="org.apache.log4j.RollingFileAppender">

      <param name="File" value="../logs/dyetrace_output.log"/>

      <param name="MaxBackupIndex" value="1"/>

      <param name="MaximumFileSize" value="10485760"/>

      <layout class="org.apache.log4j.PatternLayout"/>

      <param name="ConversionPattern" value="%m%n"/>

      </layout>

      <filter class="com.cognos.indications.LogIPFDyeTraceFilter"/>

      </appender>

      o

    • modifique una de las definiciones de adicionador existentes añadiendo la línea

      <filter class="com.cognos.indications.LogIPFDyeTraceFilter"/>

      delante de la etiqueta </appender> de cierre.

  4. Para las secciones de <category> a las que desea aplicar el filtro de rastreo hasta el originador, edite la propiedad <appender-ref> para que ésta haga referencia al adicionador DyeTraceOutput o al adicionador al que se ha añadido el filtro.

    Por ejemplo:

    <category name="Audit.RTUsage.CAM.AAA" class="com.cognos.indications.LogTypedLogger"

    additivity="false">

    <level value="debug"/>

    <appender-ref ref="DyeTraceOutput"/>

    </category>

  5. Guarde el archivo ipfclientconfig.xml.off.
  6. Para activar este archivo, cambie su nombre por ipfclientconfig.xml.
  7. Puede inhabilitar el registro específico de usuario y reanudar el registro normal cambiando el nombre del archivo ipfclientconfig.xml nuevamente por ipfcliencofig.xml.off. Restablezca los usuarios a los que ha aplicado DyeTracing después de reiniciar el producto.

Resultados

En 60 segundos, el registro específico de usuario se activará automáticamente y se generará salida. Para el adicionador descrito aquí, la salida se almacena en ubicación_c10\logs\dyetrace_output.log. Para otros adicionadores, será el destino configurado para ese adicionador. Cuando se establece una sesión autenticada con IBM® Cognos, sólo se registran las acciones del usuario especificado.

Nota: Puede que reciba alguna indicación no relacionada con el usuario especificado. Por ejemplo, esto podría producirse cuando inicia el producto o cuando se registran indicaciones antes de haberse completado la autenticación del usuario.
Consejo: Puede cambiar el nivel de registro de las categorías para que no se genere un número excesivo de indicaciones.