Registros de operaciones en Jitterbit Studio

Introducción

Cuando se ejecuta una operación, se genera un registro de operación. Un registro de operación contiene información sobre cuándo y dónde se ejecutó una operación, el estado de la operación y cualquier mensaje de registro. La visualización de mensajes de registro detallados depende de los niveles de permiso y acceso, y de si el registro en la nube está habilitado.

Las operaciones activadas por API (configuradas a través de API personalizadas u API OData) tienen registro adicional que se puede habilitar según qué configuraciones estén configuradas. Para obtener más detalles, consulta Datos de solicitud y respuesta de API.

Harmony retiene los registros de operaciones, incluidos los mensajes de registro detallados de agentes en la nube y agentes privados, así como los datos de entrada y salida de componentes dentro de los registros de operaciones, durante 30 días.

Acceder a registros de operaciones

Se puede acceder a los registros de operaciones en Studio a nivel de flujo de trabajo, operación o proyecto. Según dónde se acceda, la pantalla de registro de operación incluye un máximo de 1,000 registros para un período de tiempo determinado para operaciones que se han ejecutado en un flujo de trabajo particular, para una operación particular o en un proyecto, respectivamente. Si las operaciones están vinculadas con acciones de operación o la función RunOperation, también se incluyen los registros de operaciones posteriores.

Por flujo de trabajo

La opción Ver registros para un flujo de trabajo, que muestra registros de operaciones que se han ejecutado dentro de un flujo de trabajo particular, se puede acceder desde la pestaña Flujos de trabajo del panel de proyecto (consulta Menú de acciones de flujo de trabajo en Pestaña Flujos de trabajo del panel de proyecto).

Por operación

La opción Ver registros para una operación es accesible desde estas ubicaciones:

• La pestaña Flujos de trabajo del panel de proyecto (consulta Menú de acciones de componente en Pestaña Flujos de trabajo del panel de proyecto).
• La pestaña Componentes del panel de proyecto (consulta Menú de acciones de componente en Pestaña Componentes del panel de proyecto).
• El lienzo de diseño (consulta Menú de acciones de componente en Lienzo de diseño).

Además, después de ejecutar una operación manualmente, puedes hacer clic en el estado de la operación en el lienzo de diseño para mostrar los registros (consulta Estado de operación en Implementación y ejecución de operaciones).

Por proyecto

Al usar la opción Ver registros de un proyecto, se abre la página Runtime de la Consola de administración en una nueva pestaña del navegador y se filtra para mostrar registros de operaciones que se han ejecutado dentro del proyecto.

La opción Ver registros para un proyecto se puede acceder desde estas ubicaciones:

• La página Proyectos (consulta Vista de tarjeta o Vista de lista en Proyectos).
• La barra de herramientas del proyecto (consulta Menú de acciones de proyecto en Barra de herramientas del proyecto).

Pestaña de registro de operaciones del cajón del proyecto

Cuando ves registros por flujo de trabajo u operación, el cajón del proyecto se abre en la parte inferior del lienzo de diseño para mantener tu contexto en el proyecto. Los registros de operaciones se muestran en una vista dividida, con la lista de operaciones a la izquierda e información detallada del registro de la operación seleccionada a la derecha.

• Pestañas: Las pestañas en la parte superior del cajón están etiquetadas con Logging seguidas del nombre de la operación o flujo de trabajo (dependiendo de dónde se accedió a los registros). Cuando accedes a registros adicionales o variables del proyecto, se añaden nuevas pestañas. Para reordenar pestañas, arrastra y suelta una pestaña. Para cerrar una pestaña, haz clic en su icono de cierre. Cerrar la última pestaña o usar el icono de cierre más a la derecha cierra el cajón.
• Redimensionar: La barra en la parte superior del cajón se puede usar para redimensionarlo. Pasa el cursor sobre la barra y arrastra el icono de redimensionamiento hacia arriba o hacia abajo para redimensionar el cajón.
• Contraer: Contrae el cajón para que todos los registros se oculten. Una vez contraído, haz clic en el icono de retorno para volver a la vista anterior.
• Expandir: Expande el cajón a pantalla completa para que se muestren los registros adicionales. Una vez expandido, haz clic en el icono de retorno para volver a la vista anterior.
• Abrir en Runtime: Abre la pestaña de registro de operaciones a la que se accede actualmente con cualquier consulta aplicada en la página Runtime de la Consola de Administración. Los filtros de período de tiempo no se retienen y deben reaplicarse en la página Runtime.
• Cerrar: Cierra el cajón.

Barra de herramientas

La barra de herramientas en la vista de cajón del registro de operaciones incluye filtros para período de tiempo y consultas, y actualización de tabla.

Período de tiempo

Todos los períodos de tiempo se muestran como la hora local del navegador. De forma predeterminada, el período de tiempo se establece en las Últimas 24 horas de registros desde la última ejecución de una operación. Alternativamente, usa el menú para seleccionar Últimas 48 horas, Últimas 72 horas o Hora personalizada:

Para un período de tiempo determinado, se incluye un máximo de 1,000 registros en la tabla de registro de operaciones.

Cuando se selecciona Hora personalizada, se abre un diálogo de configuración:

• Finalizado: Para filtrar por la fecha y hora en que la operación o paso de operación dejó de ejecutarse, haz clic en el icono de calendario para abrir el selector de fecha. Para borrar este campo, haz clic en el icono de borrar filtro.
• Iniciado: Para filtrar por la fecha y hora en que la operación o paso de operación comenzó a ejecutarse, haz clic en el icono de calendario para abrir el selector de fecha. Para borrar este campo, haz clic en el icono de borrar filtro.
• Aplicar: (Se habilita cuando se configura el campo Finalizado o Iniciado.) Aplica todos los filtros de fecha y hora a la tabla de registros de operaciones.
• Borrar: (Se habilita cuando se configura el campo Finalizado o Iniciado.) Borra ambos filtros Finalizado e Iniciado.

Una vez que se hace clic en el icono de calendario, se abre el selector de fecha/hora para ese campo:

• Desde/Hasta la fecha: Usa el calendario bajo uno o ambos de estos campos para seleccionar una fecha dentro de los últimos 30 días. Las fechas fuera de este rango no se pueden seleccionar.

• Mes: Se utiliza el mes actual de forma predeterminada. Usa las flechas para navegar a un mes diferente.

  • Día: Selecciona el día deseado del calendario.

• Hora: Escribe la hora, los minutos y el período de tiempo (AM o PM).

Actualizar

Los registros se actualizan automáticamente cada cinco segundos si alguna operación aún se encuentra en estado de ejecución (estado de Recibido, Enviado, Pendiente o En ejecución).

También puedes actualizar manualmente los registros en cualquier momento para mostrar información actualizada. Para actualizar manualmente los registros, haz clic en el icono Actualizar en la esquina superior derecha.

Consultas

Una consulta consta de uno o más términos clave/valor. Los términos múltiples se separan por punto y coma. Un término tiene la forma <clave><operador><valor>. Para la clave operation, el valor puede incluir un carácter comodín, %, que coincide con cualquier cadena.

Para usar una consulta, ingresa una especificación de consulta válida en la barra de búsqueda y presiona Intro:

La siguiente tabla muestra los componentes de término de consulta disponibles:

Estados de operación

Para los estados que se pueden consultar al usar la clave status, consulta Valores de estado en la página Runtime de la Consola de administración.

Estado del paso de operación

Los pasos de operación aparecen solo cuando esa operación tiene habilitado el registro de depuración de operación a nivel de operación (para agentes en la nube o para agentes privados) y la operación se ejecutó en un agente versión 10.48 o posterior.

Los pasos de operación pueden tener estos estados posibles:

• Completado: El paso de operación se ejecutó y completó sin errores.
• Error: El paso de operación se ejecutó pero no se pudo completar debido a un error.
• Incompleto: El paso de operación no se ejecutó ni completó. Las posibles razones de este estado incluyen que el paso de operación está esperando ser ejecutado o que hubo un error en un paso de operación anterior que impidió la ejecución del siguiente paso.

Vista de registro de operación

La vista de registro de operación muestra una vista dividida con registros de operación en el panel izquierdo e información de registro detallada para la operación seleccionada en el panel derecho. La vista utiliza los controles de tabla seleccionados para filtrar resultados. Si las operaciones están encadenadas, esas operaciones se enumeran bajo la operación principal.

Las operaciones principales (y cualquier operación secundaria bajo ellas) se ordenan en orden ascendente por Iniciado. La tabla se puede ordenar (solo para operaciones de nivel superior) por Nombre, Iniciado, Finalizado, Duración o Estado haciendo clic en la fila de encabezado respectiva.

Se muestra un máximo de 1000 registros de operaciones. Para ver registros de operaciones adicionales, ajusta los filtros según sea necesario.

Panel de lista de operaciones

Cuando abres la vista de registro de operación, el primer registro de operación en la lista se selecciona de forma predeterminada. La información de registro detallada de esta operación aparece en el panel derecho.

• Nombre: El nombre de la operación o paso de operación. Los símbolos de intercalación , que se pueden usar para expandir o contraer filas adicionales, se muestran en operaciones principales y en operaciones para las que hay datos de entrada y salida de componentes disponibles:

  • Operaciones principales: Cuando expandes una operación principal, aparecen filas adicionales para sus operaciones secundarias en el orden en que se ejecutaron. De forma predeterminada, todas las operaciones principales están expandidas. Usa los iconos contraer lista o expandir lista junto a la columna Nombre para contraer o expandir todas las operaciones principales.

  • Operación con datos de entrada y salida: Cuando expandes una operación con datos de entrada y salida, aparecen filas adicionales para cada paso de operación en el orden en que se ejecutaron. Se proporciona más información en Datos de entrada y salida de componentes.

• Iniciado: La fecha y hora en que comenzó a ejecutarse la operación o paso de operación, mostrada como la hora local del navegador.

• Finalizado: La fecha y hora en que dejó de ejecutarse la operación o paso de operación, mostrada como la hora local del navegador. Este campo está en blanco mientras la operación o paso de operación aún se está ejecutando.

• Duración: El tiempo transcurrido entre Iniciado y Finalizado, reportado en segundos para operaciones y en milisegundos para pasos de operación. Este campo está en blanco mientras la operación o paso de operación aún se está ejecutando.

• Estado: El estado de la operación o paso de operación. Para obtener una lista completa de los estados posibles, consulta Estados de operación anteriormente en esta página.

• Acciones: Esta acción está disponible:

  • Cancelar operación: Habilitado para operaciones que están en estado Enviado, Recibido, Pendiente o En ejecución.

    Cancelar operación envía una solicitud al agente para detener la operación. Una vez que se hace clic, se muestra el estado Cancelación solicitada junto al estado de operación en tiempo real.

    Nota

    Enviar una solicitud de cancelación no garantiza que se cancele la operación. Las operaciones que tienen un estado Cancelación solicitada aún pueden ejecutarse, dependiendo del estado de ejecución actual del agente.

• Actualizar: Haz clic para actualizar la lista de registros de operaciones.

• Preferencias de vista: Abre un menú que controla qué operaciones aparecen en la vista de registro.

  • Operaciones encadenadas: Muestra u oculta operaciones secundarias en una cadena de operaciones. Cuando está habilitado (), la vista de registro muestra la operación seleccionada y todas las operaciones secundarias en su cadena de operaciones. Cuando está deshabilitado (), solo aparecen los registros de la operación seleccionada.

• Filtrar columnas: Haz clic para abrir un panel que te permite reordenar las columnas o ajustar su visibilidad en el panel de lista de operaciones:

  

  • Mostrar todo: Haz visibles todas las columnas.

  • Mover: Arrastra y suelta para cambiar la posición de la columna en relación con otras.

• Ocultar: La columna es visible. Haz clic para ocultarla.

  • Mostrar: La columna está oculta. Haz clic para mostrarla.

• Cambiar el tamaño de las columnas: Arrastra la barra Cambiar tamaño de una columna para redimensionarla.

Panel de registro de operaciones

Haz clic en cualquier fila de operación en el panel izquierdo para mostrar su información de registro detallada en el panel derecho:

• Nombre: El nombre de la operación o paso de operación al que pertenece el registro.

• Estado: El estado de la operación o paso de operación.

• Iniciado: La fecha y hora en que comenzó a ejecutarse la operación o paso de operación, mostrada como la hora local del navegador.

• Finalizado: La fecha y hora en que dejó de ejecutarse la operación o paso de operación, mostrada como la hora local del navegador. Este campo está en blanco mientras la operación o paso de operación aún se está ejecutando.

• Duración: El tiempo transcurrido entre Iniciado y Finalizado, reportado en segundos para operaciones y en milisegundos para pasos de operación. Este campo está en blanco mientras la operación o paso de operación aún se está ejecutando.

• Registros de origen: Cuando se utiliza una actividad de FTP o Base de datos como origen, se muestra la cantidad de registros que se han leído del sistema de origen. Para otros conectores, la cantidad muestra 0 independientemente del número de registros de origen.

• Registros de destino: Cuando se utiliza una actividad de FTP o Base de datos como destino, se muestra la cantidad de registros que se han publicado en el sistema de destino. Para otros conectores, la cantidad muestra 0 independientemente del número de registros de destino.

• Mensajes de registro: Los mensajes de registro incluyen los detalles del registro para la operación seleccionada. Si se muestran los mensajes de registro depende de si el registro en la nube está habilitado. Para obtener más información, consulta la pestaña Mensajes en la documentación de la página Runtime de la Consola de administración.

  Nota

  • Las fechas y horas en los mensajes de registro aparecen en su formato original del origen y no se convierten a la hora local del navegador.
  • Los mensajes de registro que superan ~100 KB de tamaño (~99,000 caracteres) se truncan, indicado con message truncated que aparece al final del registro.

• Copiar: Copia los datos del registro al portapapeles.

• Descargar: Descarga los mensajes de registro como un archivo de texto.

• Mostrar / ocultar: Muestra u oculta los mensajes de registro.

Datos de entrada y salida de componentes

Los datos de entrada y salida de componentes se generan cuando una operación tiene el registro de depuración de operaciones habilitado a nivel de operación (para agentes en la nube o para agentes privados) y la operación se ejecutó en un agente versión 10.48 o posterior.

Cuando hay datos de entrada y salida de componentes presentes, se muestra una representación gráfica de la operación o paso de operación en el panel de lista de operaciones:

Se puede hacer clic en los pasos de la 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 se limita 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.

• Buscar: Busca en los datos el texto ingresado.

• Copiar: Copia los datos del registro al portapapeles.

• Descargar: Descarga los datos de entrada o salida como un archivo en el formato de datos apropiado. El archivo se nombra con el nombre del paso de operación seguido de _input o _output según corresponda.

Datos de solicitud y respuesta de API

Cuando una operación se activa mediante una API personalizada o API OData de API Manager, la información que se muestra en los registros de operación depende de qué configuraciones estén habilitadas. Las operaciones fallidas siempre se registran. Las ejecuciones exitosas aparecen en los registros de operación de Studio solo cuando Habilitar modo de depuración hasta (una configuración de API Manager) u Operación de registro de depuración (una configuración de agente) está activa. indica que la configuración añade esa capacidad; indica que no:

Información de API

El registro de operación puede mostrar la siguiente información para llamadas de API:

• API: El nombre de la API que activó la operación.

  • Abrir API en pestaña nueva: Haz clic para abrir la API en una pestaña nueva en API Manager.

• Tipo de API: Este campo puede tener uno de los siguientes tipos:

  • CUSTOM_API: Una API personalizada creada en API Manager.
  • ODATA: Una API OData creada en API Manager.

• Método de solicitud: El método HTTP utilizado para la llamada de API. Los valores posibles incluyen GET, POST, PUT, DELETE, PATCH y MERGE.

• ID de solicitud de API: Un identificador único para la solicitud de API. Se puede usar este ID para correlacionar registros en diferentes sistemas y para buscar solicitudes específicas. Haz clic en el icono de copiar para copiar el valor.

• IP de origen: La dirección IP de la aplicación cliente o servidor que realizó la solicitud de API.

• Puerta de enlace de API: La puerta de enlace de API que procesó la solicitud. Este campo muestra el nombre de dominio de la puerta de enlace de API en la nube o puerta de enlace de API privada que manejó la llamada de API.

• URL del servicio de API: La URL completa para llamar a la API, incluyendo la URL base, raíz del servicio, versión y cualquier parámetro de ruta. Esta es la URL del servicio de API completa tal como la consume el cliente.

• Aplicación de origen: La aplicación o navegador que realizó la solicitud de API.

Información de llamada

El registro de operaciones muestra una sección de Información de llamada con los encabezados de solicitud HTTP enviados con la llamada de API. Cada encabezado se muestra como un par clave-valor, como accept, accept_encoding, content_length, fulluri, host, user_agent y encabezados de reenvío. Los encabezados que contienen credenciales o datos de sesión se enmascaran, como se describe en Encabezados enmascarados.

Registro de llamada

El registro de operaciones también muestra una sección de Registro de llamada con información de seguimiento detallada sobre el procesamiento de la solicitud de API. Esta información se puede usar para solucionar problemas de la puerta de enlace de API, problemas de tiempo de espera o para entender el flujo de procesamiento interno de la API. El contenido específico del registro de llamada varía según la configuración de la API, la configuración de la puerta de enlace y si ocurrieron problemas durante el procesamiento de la solicitud.