Registro de depuración de operaciones para agentes privados de Jitterbit

Introducción

El registro de depuración de operaciones genera información diagnóstica adicional para ayudar con la solución de problemas. Esta función produce dos tipos de registros:

• Archivos de registro de depuración de operaciones: Mensajes de depuración para cada actividad de operación, incluyendo información registrada antes y después de que se ejecute cada transformación. Los archivos se escriben en el agente privado y están sujetos a la política de retención configurada en las reglas de limpieza del agente (1 día por defecto).

• Datos de entrada y salida de componentes: Los datos de solicitud y respuesta procesados por cada actividad y transformación en una operación. Estos datos están disponibles para operaciones que se ejecutan en agentes privados de la versión 10.48 o posterior. Harmony retiene estos datos durante 30 días.

Habilitar el registro de depuración de operaciones

El registro de depuración de operaciones se puede habilitar en una operación individual o en un agente privado completo. Los datos de entrada y salida de componentes se generan por defecto en agentes privados 10.48 o posteriores, pero se pueden desactivar utilizando configuraciones adicionales en el archivo de configuración del agente privado.

Registro de depuración de operación individual

El registro de depuración a nivel de operación puede ayudar si tienes problemas con una operación individual y no necesitas activar el registro de depuración a nivel de agente, lo que puede generar archivos que son grandes en cantidad y/o tamaño.

Puedes habilitar el registro de depuración para una operación individual utilizando las opciones de operación de Studio o las opciones de operación de Design Studio:

• Studio: Usa el menú de acciones de una operación para seleccionar Configuración. En la pestaña Opciones, selecciona Habilitar registro de depuración hasta y establece una fecha para que el registro de depuración se apague. También está disponible la opción de propagar la configuración del modo de depuración a cualquier operación hija.

• Design Studio: Haz clic derecho en el fondo de cualquier operación y selecciona Opciones. En la ventana Opciones de operación, selecciona Habilitar modo de depuración hasta y establece una fecha para que el registro de depuración se apague.

Esta fecha está limitada a 2 semanas a partir de la fecha actual. El registro de depuración de la operación se apaga al comienzo de esta fecha (es decir, a las 12:00 am) utilizando la zona horaria del agente.

Registro de depuración de todo el agente privado

El registro de depuración de operación a nivel de agente puede habilitarse desde el archivo de configuración del agente privado para todas las operaciones que se ejecutan en un agente privado.

Para habilitar el registro de depuración, edita el archivo de configuración del agente privado de la siguiente manera y luego reinicia los servicios de Jitterbit.

• En la sección [TransformationEngine], establece WriteLog=true.

• En la sección [OperationEngine], establece Debug=true.

Los archivos creados en este directorio pueden volverse muy grandes. Apaga el registro de depuración tan pronto como puedas y elimina los archivos cuando ya no sean necesarios.

Configuraciones adicionales

Los agentes privados que son versión 10.48 o posteriores tienen la sección [VerboseLogging] presente en su archivo de configuración del agente privado con la configuración verbose.logging.enable=true, lo que habilita la generación de datos de entrada y salida de componentes:

[VerboseLogging]
verbose.logging.enable=true

Al actualizar una versión anterior del agente privado a 10.48 o posterior, la generación de datos de entrada y salida se habilita automáticamente por defecto, incluso si la sección [VerboseLogging] y la configuración verbose.logging.enable no están presentes en el archivo de configuración.

Para deshabilitar la generación de datos de entrada y salida de componentes, se debe agregar la sección [VerboseLogging] y establecer verbose.logging.enable=false para evitar que los datos de entrada y salida de componentes se registren en la nube de Harmony.

Las configuraciones adicionales en la sección [VerboseLogging] no deben ser cambiadas a menos que se indique por el soporte de Jitterbit.

Ver registros de operaciones

La ubicación donde se ven los registros de operaciones depende del tipo de registro generado:

• Archivos de registro de depuración de operaciones: Acceder a través del ícono Descargar registros del agente en la página Agentes de la Consola de Administración, la pestaña Archivos de depuración de la página Runtime de la Consola de Administración, o directamente en el host del agente. Para más detalles, ver Acceso a archivos de registro de depuración.

• Datos de entrada y salida de componentes: Ver en los registros de operaciones de Studio desde el menú Ver Registros de la operación o en la página Runtime de la Consola de Administración.

Archivos de registro de depuración de operaciones

Una vez que se habilita el registro de depuración de operaciones en una operación de Studio, operación de Design Studio, o en un agente privado completo, se generan archivos de registro de depuración de operaciones para las operaciones aplicables cuando se ejecutan esas operaciones.

Acceso al archivo de registro de depuración

Los archivos de registro de depuración de operaciones se pueden acceder a través del ícono Descargar registros del agente en la página Agentes de la Consola de Administración, la pestaña Archivos de depuración de la página Tiempo de ejecución de la Consola de Administración, o directamente en el host del agente en las siguientes ubicaciones:

Para cambiar el directorio de registro de depuración de operaciones, edite el archivo de configuración del agente privado de la siguiente manera y luego reinicie los servicios de Jitterbit:

• En la sección [TransformationEngine], establezca WriteLogDir en la ubicación del directorio deseado.

Política de retención de archivos de registro de depuración

Por defecto, los archivos de registro de depuración de operaciones se eliminan automáticamente después de 1 día.

Este período de tiempo es configurable en CleanupRules.xml, que es accesible en agentes privados en estas ubicaciones predeterminadas:

Dentro del archivo CleanupRules.xml, puede editar esta regla de limpieza para cambiar la política de retención de archivos de registro de depuración de operaciones:

  <CleanupRule>
      <DirectoryPath SearchSubDirectory = "YES" >DataInterchange/Temp/Debug</DirectoryPath>
      <Pattern>*</Pattern>
      <FileAge NumDays = "1" Comparator = "GE"/>
      <FileSize Size = "0" Comparator = "GE"/>
  </CleanupRule>

Contenido del archivo de registro de depuración

Los archivos de registro de depuración de operaciones contienen mensajes de depuración para cada actividad de operación e incluyen información que se registra antes y después de que se ejecuta cada transformación. También se incluye información sobre otras acciones, como leer y escribir en la caché de Harmony.

Estos archivos son típicamente solicitados por el soporte de Jitterbit si se requiere más información durante la resolución de problemas.

Datos de entrada y salida del componente

Requisitos previos

Los datos de entrada y salida del componente se generan cuando se cumplen todas las siguientes condiciones:

• Una operación de Studio tiene registro de depuración de operaciones habilitado a nivel de operación.

• La operación se ejecuta en un agente privado de 10.48 o posterior.

• El agente privado tiene la configuración predeterminada.

• El agente privado no se comunica a través de un servidor proxy.

Datos de entrada y salida

Los datos de entrada y salida están disponibles solo para actividades y transformaciones utilizadas como pasos de operación.

Los datos de entrada y salida de componentes se acceden desde la pantalla de registro de operaciones del Studio o desde la página de Tiempo de ejecución de la Consola de Administración en filas de tabla adicionales mostradas para cada paso de operación que tiene datos de entrada y salida. En el panel izquierdo, se muestran íconos para actividades y transformaciones utilizadas como pasos de operación. Puedes hacer clic en un paso de operación para mostrar u ocultar los datos de entrada y salida de componentes para ese paso de operación individual. Cada entrada de registro de entrada y salida está limitada a 100 MB. Si los datos de una entrada de registro de entrada o salida individual superan los 100 MB, no se mostrará ningún dato.

• Buscar: Busca los datos para el texto ingresado.
• Copiar: Copia los datos del registro en tu portapapeles.
• Descargar: Descarga los datos de entrada o salida. El archivo se nombra con el nombre del paso de operación seguido de _input o _output según corresponda.

Política de retención de datos de entrada y salida

Los datos de entrada y salida del componente se retienen durante 30 días por Harmony.

Contenido de datos de entrada y salida

Los datos de entrada y salida del componente se generan para ciertos pasos de una operación. Los datos son apropiados para la función de un paso. La entrada es la estructura que el componente consume, mientras que la salida es la estructura que el componente produce.

Se generan datos de entrada y salida para estos componentes utilizados como pasos de operación:

• Actividades: Datos de entrada y salida y cualquier información relacionada con la ejecución de la actividad. Algunas actividades pueden tener múltiples archivos de entrada y salida.

• Transformaciones: Datos de entrada y salida para la ejecución de la transformación.

Los datos de entrada y salida no son aplicables a los scripts cuando se utilizan como pasos de operación. El contenido del script, como el producido por la función WritetoOperationLog, se muestra en los mensajes de registro de un registro de operación.

Solución de problemas de datos de entrada y salida

Los registros de agente relacionados con los datos de entrada y salida no deberían necesitar ser accedidos normalmente. Si crees que puede haber un problema con la generación de los datos de entrada y salida, puedes verificar los archivos de registro del servicio Verbose Log Shipper en un agente privado:

<JITTERBIT_HOME>/VerboseLogShipper/verbose-log-shipper.out.log

El servicio Verbose Log Shipper se puede reiniciar reiniciando un agente privado.

En agentes privados de Linux, también puedes desactivar y reactivar este servicio utilizando estas opciones de línea de comandos de Jitterbit:

jitterbit start verboselogshipper

jitterbit stop verboselogshipper

Estas opciones también se pueden ver utilizando jitterbit --help.