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 tres 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.

• Datos de solicitud de API: Información detallada de llamadas a la API para operaciones activadas por un API personalizada o API OData, incluyendo el nombre de la API, método de solicitud, IP de origen, detalles de la puerta de enlace y datos de seguimiento de llamadas. Para detalles sobre cuándo aparece esta información en los registros, consulte Datos de solicitud de API.

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 los 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.

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 se desactive el registro de depuración. También está disponible la opción de propagar la configuración del modo de depuración a cualquier operación secundaria.

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

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

Agente privado completo

El registro de depuración de operaciones a nivel de agente se puede habilitar 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. Desactiva 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 posterior 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, debes 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 cambiarse a menos que lo indique 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: Accede a través del ícono Descargar registros del agente en la página de Agentes de la Consola de Gestión, la pestaña Archivos de depuración de la página Runtime de la Consola de Gestión, o directamente en el host del agente. Para más detalles, consulta Acceso a archivos de registro de depuración.

• Datos de entrada y salida de componentes y datos de solicitudes de API: Visualiza 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 Gestió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 a archivos 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 Runtime 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 de directorio deseada.

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 registros 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>

Contenidos de los archivos 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 el registro de depuración de operaciones habilitado a nivel de operación.

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

• El agente privado tiene la configuración de 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 del componente se acceden desde la pantalla de registro de operaciones de Studio o la página Runtime 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 del componente 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 exceden 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.

Contenidos 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 del 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 revisar 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.

Datos de solicitud de API

Cuando una operación es activada por un API Manager [API personalizada] o OData API, la cantidad de información mostrada en los registros de operaciones depende de qué configuraciones estén habilitadas:

Información de la API

El registro de operaciones puede mostrar la siguiente información para las llamadas a la API:

• Información de la API: Detalles sobre la llamada a la API, incluyendo el nombre de la API, el tipo de API, el método de solicitud, el ID de solicitud de la API, la IP de origen, la puerta de enlace de la API, la URL del servicio de la API y la aplicación de origen. Para descripciones de los campos, consulte Información de la API.

• Información de la llamada: Los encabezados de solicitud HTTP enviados con la llamada a la API, tales como accept, accept_encoding, content_length, fulluri, host, user_agent y encabezados de reenvío.

• Registro de llamadas: Información de seguimiento sobre el procesamiento de solicitudes de la API.