Saltar al contenido

Operación de Registro de Depuración 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 Agentes Privados, habilitar el registro de depurar de operación puede dar como resultado la generación de tres tipos de registros:

  • Archivos de registro de depuración de operaciones: Archivos escritos en un directorio de Agente Privado que se generan cuando el registro de depurar de operación está habilitado, ya sea 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 > 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 grandes en cantidad y/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 claro 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 API fallidas se registran en los registros de operación.

    Nota

    Los pasos para habilitar el registro de todas las operaciones API para todo el agente difieren de los pasos descritos en Todo el Agente Privado 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 la API Operation sección en Editar el archivo de configuración del Agente.

Habilitar el Registro de Depuración de Operaciones

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 Agentes Privados 10.48 o posterior, pero se pueden desactivar usando 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 grandes en cantidad y/o tamaño.

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

  • Cloud 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 conectar en cascada la configuración del modo de depurar 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 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.

Precaución

Habilitar el registro de depurar a nivel de agente puede crear 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 una operación individual.

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 la [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 tan pronto como pueda y elimine los archivos cuando ya no sean necesarios.

Ajustes Adicionales

Agentes Privados que sean 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 de 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 cambiarse a menos que así lo indique el soporte de Jitterbit.

Archivos de Registro de Depuración 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 desde Management Console o directamente desde la máquina del agente:

  • Management Console
    Puede descargar un archivo ZIP de los archivos de registro de depurar de operación desde estos Management Console páginas:
    • Agentes: Desde Agentes > Agentes, seleccione el agente y luego use el menú desplegable Acciones para seleccionar Descargar registro del Agente.
    • Actividades: Desde Operaciones en tiempo de ejecución, seleccione la operación, luego vaya a la pestaña Archivos de depuración y use el enlace para descargar los registros.
  • Agente Privado
    En un Agente Privado, puede acceder a un archivo ZIP de los registros en estas ubicaciones predeterminadas:

    • Windows: C:\Program Files\Jitterbit Agent\DataInterchange\Temp\Debug
    • Linux: /usr/local/jitterbit/DataInterchange/Temp/Debug

    Para cambiar el directorio de registro de depurar de operación, edite el archivo de configuración del Agente Privado de la siguiente manera y luego reinicie los servicios Jitterbit: - Bajo el [TransformationEngine] sección, conjunto WriteLogDir a la ubicación del directorio deseada.

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 desde Agentes Privados en estas ubicaciones predeterminadas:

  • Windows: C:\Program Files\Jitterbit Agent

  • Linux: /usr/local/jitterbit/

Dentro de 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 leer y escribir en la caché de Harmony.

Estos archivos normalmente los solicita el soporte técnico de Jitterbit si se requiere más información durante la resolución de problemas.

Datos de Entrada y Salida de Componentes

Los datos de entrada y salida de los componentes se generan cuando una operación de Cloud Studio tiene 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 los ajustes de configuración predeterminados. Los datos de entrada y salida están disponibles solo para 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 Habilitar registro en la nube (consulte Agentes > Grupos de Agente). Los datos de entrada y salida de los componentes se registrarán en la nube de 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 del Agente Privado bajo la [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 Cloud Studio pantalla de registro de operación en filas adicionales de la tabla 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 iconos de las actividades y transformaciones utilizadas como pasos de operación para mostrar u ocultar los datos de entrada y salida del componente para ese etapa de operación individual. Cada entrada del 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án datos.

encabezado de pasos de operación de la tabla de registros

  • Copiar: Haga clic en el icono de copiar copiar 2 para copiar los datos del registro a su portapapeles. Al hacer clic, aparece un icono del portapapeles copiar 2 se muestra temporalmente.
  • Descargar: Haz clic en el ícono de descarga descargar para descargar los datos de entrada o salida. El archivo lleva el nombre del etapa de operación seguido de _input o _output según sea apropiado.

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

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

  • Actividades: Datos de entrada y salida y cualquier información relacionada para 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 se aplican a los secuencias de comandos cuando se utilizan como pasos de operación. 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 es 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 Linux Agentes Privados, también puede deshabilitar y volver a habilitar este servicio usando estas opciones de línea de comando de Jitterbit:

jitterbit start_verboselogshipper
jitterbit stop_verboselogshipper

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