Registro de depuración de operaciones para agentes en la nube de Jitterbit
Introducción
El registro de depuración de operaciones genera información diagnóstica adicional para ayudar con la resolución de problemas. Esta función produce dos tipos de datos:
-
Datos de entrada y salida del componente: Los datos de solicitud y respuesta procesados por cada actividad y transformación en una operación. 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 del Administrador de API 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.
Advertencia
Cuando se generan datos de entrada y salida del componente, 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. La información de identificación personal (PII) y datos sensibles como credenciales proporcionadas en una carga de solicitud serán visibles en texto claro en los datos de entrada y salida dentro de los registros de la nube de Harmony.
Debido a estas implicaciones de seguridad, utilice el registro de depuración de operaciones solo para depurar problemas durante las pruebas. No habilite esta función en un entorno de producción.
Habilitar el registro de depuración de operaciones
Puede habilitar el registro de depuración para una operación individual de Studio o Design Studio con estos pasos:
-
Studio: Utilice el menú de acciones de una operación para seleccionar Configuración. En la pestaña Opciones, seleccione Habilitar registro de depuración hasta y establezca una fecha para desactivar 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: 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 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 a. m.) utilizando la zona horaria del agente.
Advertencia
En grupos de agentes en la nube, la duración de esta configuración es poco confiable. Los registros pueden dejar de generarse antes del final del período de tiempo seleccionado.
Ver registros de operaciones
Cuando habilitas el registro de depuración de operaciones, puedes ver los registros de operaciones en dos ubicaciones:
- Registros de operaciones de Studio: Ver registros desde el menú Ver registros de la operación en Studio.
- Página de ejecución: Ver registros en la página Runtime de la Consola de Administración.
Ambas ubicaciones muestran registros de operaciones con datos de entrada y salida de componentes (cuando están disponibles) y datos de solicitud de API (cuando la operación es activada por una API personalizada del Administrador de API). La carga útil de solicitud y respuesta se incluye solo cuando el registro detallado de API también está habilitado.
Datos de entrada y salida de componentes
Los datos de entrada y salida de componentes se generan cuando se ejecuta una operación de Studio que tiene registro de depuración de operaciones habilitado a nivel de operación. 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 Registro en la nube habilitado. Los datos de entrada y salida de componentes se registrarán en la nube de Harmony incluso si el registro en la nube está deshabilitado.
Acceso a datos de entrada y salida
Los datos de entrada y salida de componentes se acceden desde la pantalla de registro de operaciones de Studio o desde 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 la columna Entrada/Salida, se pueden hacer clic en los íconos de actividades y transformaciones utilizadas como pasos 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 exceden los 100 MB, no se mostrará ningún dato.

- Buscar: Busca los datos del 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
_inputo_outputsegú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.
Datos de solicitud de API
Interfaz de Analytics nueva requerida
La función de datos de solicitud de API está disponible solo para organizaciones que han sido actualizadas a la nueva Analytics interfaz. Esta actualización se está implementando gradualmente. Si estás interesado en acceso anticipado, contacta a soporte de Jitterbit.
Cuando una operación es activada por un API personalizado de API Manager o API OData, la cantidad de información mostrada en los registros de operación depende de qué configuraciones estén habilitadas:
| Configuración habilitada | Información registrada | Cómo habilitar |
|---|---|---|
| Ninguna (predeterminado) |
|
Este es el comportamiento predeterminado. |
| Registro de depuración de operaciones | Tanto operaciones exitosas como no exitosas con información de solicitud de API en los registros de operaciones de Studio y en la página de la Consola de Gestión Runtime. Se excluye la carga útil de solicitud y respuesta. |
|
| Registro de depuración de operaciones y registro detallado de API | Tanto operaciones exitosas como no exitosas con información de solicitud de API en los registros de operaciones de Studio y en la página de la Consola de Gestión Runtime, incluyendo carga útil de solicitud y respuesta. | Habilitar el registro de depuración de operaciones para agente en la nube o agentes privados, y en el Administrador de API, habilitar Registro detallado en la pestaña de configuración de la API. |

Información de API
El registro de operaciones puede mostrar la siguiente información para llamadas a la API:
-
Información de API: Detalles sobre la llamada a la API, incluyendo nombre de la API, tipo de API, método de solicitud, ID de solicitud de API, IP de origen, puerta de enlace de API, URL del servicio de API y aplicación de origen. Para descripciones de campos, consulte Información de 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_agenty encabezados de reenvío. -
Registro de llamadas: Información de seguimiento sobre el procesamiento de solicitudes de la API.