Registro de depurar de operaciones para agentes privados de Jitterbit

Introducción

Los registros de depurar de operaciones son archivos de registro y datos adicionales que se generan para las operaciones cuando el registro de depurar de operación está habilitado.

Precaución

El registro de depurar de operaciones se utiliza principalmente para depurar problemas durante las pruebas y no debe activarse en un ambiente de producción. Los archivos de registro de depurar generados pueden ser grandes en cantidad o tamaño.

En agentes privados, habilitar el registro de depurar de operación puede resultar en la generación de tres tipos de registros:

• Archivos de registro de depurar de operaciones: Archivos escritos en un directorio de agente privado que se generan al habilitar el registro de depurar de operación, ya sea en una operación individual de Integration Studio o Design Studio, o para todas las operaciones de un agente privado a través del archivo de configuración de un agente. Se puede acceder a los archivos directamente en los agentes privados y descargarlos a través de la Management Console Agentes y Operaciones en tiempo de ejecución páginas. Los archivos están sujetos a la política de retención configurada en las reglas de limpieza del agente, que es de 1 día por defecto.

• Datos de entrada y salida del componente: Datos escritos en un registro de operación de Integration Studio cuando el registro de depurar de operación está habilitado en una operación de Integration Studio que se ejecuta en un agente privado de la versión 10.48 o posterior. Harmony conserva los datos durante 30 días.

  Advertencia

  Cuando se generan los datos de entrada y salida de un componente, todos los datos de solicitud y respuesta de esa operación se registran en la nube de Harmony y permanecen allí durante 30 días. Tenga en cuenta que la información de identificación personal (PII) y los datos confidenciales, como las credenciales proporcionadas en la carga útil de una solicitud, serán visibles en texto sin cifrar en los datos de entrada y salida de los registros de la nube de Harmony.

• Registros de operaciones de API: Registros de operaciones para operaciones de API exitosas y fallidas (configuradas para APIs personalizadas o servicios OData). Cuando el registro de depurar de operación no está habilitado, solo las operaciones de API fallidas se registran en los registros de operación.

  Nota

  Los pasos para habilitar el registro de todas las operaciones de API para todo el agente difieren de los pasos descritos en Agente privado completo más adelante en esta página. Para obtener información sobre cómo habilitar el registro de operación de la API para todo el agente, consulte API Operation.

Habilitar el registro de depurar de operación

El registro de depurar 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 de forma predeterminada en los agentes privados 10.48 o posteriores, pero se pueden desactivar mediante configuraciones adicionales en el archivo de configuración del agente privado.

Operación individual

El registro de depurar a nivel de operación puede ayudar si tiene problemas con una operación individual y no necesita activar el registro de depurar a nivel de agente, lo que puede generar archivos de gran cantidad y/o tamaño.

Puede habilitar el registro de depurar para una operación individual mediante Opciones de operación de Integration Studio o Opciones de operación de Design Studio:

• Integration Studio: Utilice el menú de acciones de una operación para seleccionar Configuración. En la pestaña Opciones, seleccione Habilitar modo de depuración hasta y establezca una fecha para desactivar el registro de depurar. También está disponible la opción de aplicar la configuración del modo de depurar en cascada a cualquier operación secundaria.

• Design Studio: Haga clic derecho en el fondo de cualquier operación y seleccione Opciones. En la ventana Opciones de operación, seleccione Habilitar modo de depuración hasta y configure una fecha para desactivar el registro de depurar.

Esta fecha está limitada a dos semanas a partir de la fecha actual. El registro de depurar de operaciones se desactivará al comienzo de esta fecha (es decir, a las 00:00) según la huso horario del agente.

Agente privado completo

El registro de depurar de operación 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.

Precaución

Habilitar el registro de depurar a nivel de agente puede generar archivos muy grandes en el directorio de cada agente privado dentro del grupo de agentes privados. Si tiene problemas con una operación individual, considere habilitar el registro de depurar para dicha operación.

Para habilitar el registro de depurar, edite el archivo de configuración del agente privado como se indica a continuación y, a continuación, reinicie los servicios de Jitterbit.

• En el [TransformationEngine] sección, conjunto WriteLog=true.

• Bajo el [OperationEngine] sección, conjunto Debug=true.

Los archivos creados en este directorio pueden alcanzar un tamaño considerable. Desactive el registro de depurar lo antes posible y elimine los archivos cuando ya no los necesite.

Ajustes adicionales

Los agentes privados de la versión 10.48 y posteriores tienen la sección [VerboseLogging] presente en su archivo de configuración del agente privado con la configuración verbose.logging.enable=true, que permite 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 la 10.48 o posterior, la generación de datos de entrada y salida se habilita automáticamente de forma predeterminada, incluso si [VerboseLogging] sección y el verbose.logging.enable Los ajustes no están presentes en el archivo de configuración.

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

Configuraciones adicionales en el [VerboseLogging] La sección no debe modificarse a menos que lo indique el soporte de Jitterbit.

Archivos de registro de depurar de operaciones

Una vez que el registro de depurar de operación está habilitado en una operación de Integration Studio, una operación de Design Studio o un agente privado completo, los archivos de registro de depurar de operación para las operaciones aplicables se generan cuando se ejecutan esas operaciones.

Acceso al archivo de registro de depuración

Se puede acceder a los archivos de registro de depurar de operaciones a través de Icono Descargar registros del agente en la Management Console página Agentes, la pestaña Archivos de depuración de la Management Console Operaciones en tiempo de ejecución página, o directamente en el alojar del agente en las siguientes ubicaciones:

WindowsLinux

C:\Program Files\Jitterbit Agent\DataInterchange\Temp\Debug

/usr/local/jitterbit/DataInterchange/Temp/Debug

Para cambiar el directorio del registro de depurar de la operación, edite el archivo de configuración del agente privado de la siguiente manera y, a continuación, reinicie los servicios de Jitterbit:

• En el menú [TransformationEngine] sección, conjunto WriteLogDir A la ubicación del directorio deseado.

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

De forma predeterminada, los archivos de registro de depurar de operación se eliminan automáticamente después de 1 día.

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

WindowsLinux

C:\Program Files\Jitterbit Agent

/usr/local/jitterbit/Dentro del CleanupRules.xml archivo, puede editar esta regla de limpieza para cambiar la política de retención del registro de depurar de la operación:

  <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 depurar de operaciones contienen mensajes de depurar para cada actividad operación e incluyen información registrada antes y después de la ejecución de cada transformación. También se incluye información sobre otras acciones, como la lectura y escritura en la caché de Harmony.

Normalmente, el soporte de Jitterbit solicita estos archivos si se necesita más información durante la resolución de problemas.

Datos de entrada y salida de componentes

Los datos de entrada y salida del componente se generan cuando se realiza una operación de Integration Studio que tiene el depurar de operación habilitado en el nivel de operación se ejecuta en un agente privado 10.48 o posterior que también tiene la configuración predeterminada. Los datos de entrada y salida solo están disponibles para las actividades y transformaciones utilizadas como pasos de operación.

Precaución

La generación de datos de entrada y salida de componentes no se ve afectada por la configuración del grupo de agentes Registro en la nube habilitado. Los datos de entrada y salida de los componentes se registrarán en la nube Harmony incluso si el registro en la nube está deshabilitado.

Para deshabilitar la generación de datos de entrada y salida de componentes en un grupo de agentes, en el archivo de configuración de agente privado bajo el [VerboseLogging] sección, conjunto verbose.logging.enable=false.

Acceso a datos de entrada y salida

Se accede a los datos de entrada y salida de los componentes desde Integration Studio pantalla de registro de operación o Operaciones en tiempo de ejecución de la Consola de administración página en filas adicionales de la tabla que se muestran para cada etapa de operación con datos de entrada y salida. En la columna Entrada/Salida, se puede hacer clic en los iconos de las actividades y transformaciones utilizadas como pasos de la operación para mostrar u ocultar los datos de entrada y salida de cada componente de ese etapa de operación. Cada entrada del registro de entrada y salida tiene un límite de 100 MB. Si los datos de una entrada del registro de entrada o salida superan los 100 MB, no se mostrarán.

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

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

Harmony conserva los datos de entrada y salida de los componentes durante 30 días.

Contenido de los datos de entrada y salida

Los datos de entrada y salida de los componentes se generan para determinados pasos de una operación. Estos datos son apropiados para la función de cada 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 que se utilizan como pasos de operación:

Actividades: Datos de entrada y salida, así como cualquier información relacionada con la ejecución de la actividad. Algunas actividades pueden tener varios 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 secuencias de comandos cuando se utilizan como pasos de operación. El contenido del Secuencia de comandos, como el producido por el WritetoOperationLog función, se muestra en los mensajes de registro de un registro de operación.

Solución de problemas de datos de entrada y salida

Normalmente no debería ser necesario acceder a los registros del Agente relacionados con los datos de entrada y salida. Si cree que puede haber un problema con la generación de los datos de entrada y salida, puede consultar 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 los agentes privados de Linux, también puede deshabilitar y volver a habilitar este servicio mediante estas opciones de línea de comandos de Jitterbit:

jitterbit start_verboselogshipper

jitterbit stop_verboselogshipper

Estas opciones también se pueden visualizar mediante jitterbit --help.