Registro de Depurar de Operaciones para Agentes Privados¶

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

En los 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 cuando se habilita el registro de depurar de operación en una operación individual de Cloud Studio o Design Studio o para todas las operaciones en 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 se pueden descargar 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.

  Precaución

  Cuando el registro de depurar de operación está activado, los archivos de registro de depurar generados pueden ser de gran cantidad o tamaño. Se recomienda desactivar el registro de depurar lo antes posible.

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

  Advertencia

  Cuando se generan datos de entrada y salida de componentes, todos los datos de solicitud y respuesta para 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 una carga útil de solicitud, serán visibles en texto sin formato en los datos de entrada y salida dentro 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 API para todo el agente, consulte API Operation sección en Editar el archivo de configuración del agente.

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 manera predeterminada en los agentes privados 10.48 o posteriores, pero se pueden deshabilitar 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 o tamaño.

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

• Cloud Studio: Use 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 en cascada la configuración del modo de depurar a cualquier operación secundaria.

• Design Studio: Haga clic con el botón 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 establezca una fecha para desactivar el registro de depurar.

Esta fecha está limitada a 2 semanas a partir de la fecha actual. El registro de depurar de operaciones se desactivará al comienzo de esta fecha (es decir, a las 12:00 a. m.) utilizando 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.

Para habilitar el registro de depurar, edite el archivo de configuración del agente privado de la siguiente manera y luego reinicie los servicios de Jitterbit.

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

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

Los archivos creados en este directorio pueden llegar a ser muy grandes. 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 10.48 o posterior, la generación de datos de entrada y salida se habilita automáticamente de forma predeterminada, incluso si el [VerboseLogging] sección y el verbose.logging.enable la configuración no está presente en el archivo de configuración.

Para deshabilitar la generación de datos de entrada y salida de componentes, 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 se habilita el registro de depurar de operación en una operación de Cloud Studio, una operación de Design Studio o un agente privado completo, se generan archivos de registro de depurar de operación para las operaciones aplicables 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 de descarga de registros de 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:

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

• Linux: /usr/local/jitterbit/DataInterchange/Temp/Debug

  Para cambiar el directorio del registro de depurar de operación, edite el archivo de configuración del agente privado de la siguiente manera y luego reinicie los servicios de Jitterbit: - En el [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:

• Windows: C:\Program Files\Jitterbit Agent

• Linux: /usr/local/jitterbit/

Dentro de la CleanupRules.xml archivo, puede editar esta regla de limpieza para cambiar la política de retención del registro de depurar de 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 de operación e incluyen información que se registra antes y después de ejecutar cada transformación. También se incluye información sobre otras acciones, como la lectura y escritura en la memoria caché de Harmony.

Estos archivos normalmente son solicitados por el soporte de Jitterbit 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 Cloud Studio que tiene el registro de 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.

Acceso a Datos de Entrada y Salida¶

Se accede a los datos de entrada y salida de los componentes desde la pantalla de registro de operación de Cloud Studio. En filas de tabla adicionales que se muestran para cada etapa de operación que tiene datos de entrada y salida. En la columna Entrada/Salida, se puede hacer clic en los íconos de las actividades y transformaciones utilizadas como pasos de operación para mostrar u ocultar los datos de entrada y salida de los componentes para ese etapa de operación individual. Cada entrada de registro de entrada y salida está limitada a 100 MB. Si los datos para una entrada de registro de entrada o salida individual superan los 100 MB, no se mostrarán datos.

• Copiar: Copia los datos de registro en el portapapeles. Al hacer clic, aparece un el icono del portapapeles se muestra temporalmente.
• 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 Datos de Entrada y Salida¶

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

Se generan datos de entrada y salida para estos componentes que se utilizan 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 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 puedes 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 ver usando jitterbit --help.