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, así como de si el registro en la nube está habilitado.

Las operaciones activadas por API (configuradas a través de APIs personalizadas o APIs OData) tienen registros adicionales que se pueden habilitar dependiendo de la configuración de los ajustes. Para más detalles, consulte Datos de solicitud de API.

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 operación, se retienen durante 30 días por Harmony.

Acceso a registros de operaciones

Los registros de operaciones se pueden acceder en Studio a nivel de flujo de trabajo, operación o proyecto. Dependiendo de dónde se acceda, la pantalla de registro de operaciones 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 del proyecto (consulte Menú de acciones de flujo de trabajo en Pestaña Flujos de trabajo del panel del 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 del proyecto (ver Menú de acciones del componente en Pestaña de flujos de trabajo del panel del proyecto).
• La pestaña Componentes del panel del proyecto (ver Menú de acciones del componente en Pestaña de componentes del panel del proyecto).
• El lienzo de diseño (ver Menú de acciones del componente en Lienzo de diseño).

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

Por proyecto

Al usar la opción Ver registros de un proyecto, se abre la página Tiempo de ejecución de la Consola de administración en una nueva pestaña del navegador y se filtra para mostrar los registros de las 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 (ver Vista de tarjeta o Vista de lista en Proyectos).
• La barra de herramientas del proyecto (ver Menú de acciones del proyecto en Barra de herramientas del proyecto).

Registro de operaciones del cajón del proyecto

Cuando se visualizan 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 el contexto en el proyecto. Los registros de operaciones se muestran en una vista dividida, con la lista de operaciones a la izquierda y la información detallada del registro para la operación seleccionada a la derecha.

• Pestañas: Las pestañas en la parte superior del cajón están etiquetadas con Registro seguido del nombre de la operación o flujo de trabajo (dependiendo de dónde se accedió a los registros). Cuando se accede a registros adicionales o variables del proyecto, se añaden nuevas pestañas. Para reordenar las pestañas, arrastra y suelta una pestaña. Para cerrar una pestaña, haz clic en su icono de cerrar . Cerrar la última pestaña o usar el icono de cerrar más a la derecha cierra el cajón.
• Redimensionar: La barra en la parte superior del cajón se puede usar para redimensionar el cajón. Pasa el cursor sobre la barra y arrastra el icono de redimensionar hacia arriba o hacia abajo para redimensionar el cajón.
• Colapsar: Colapsa el cajón para que todos los registros estén ocultos. Una vez colapsado, 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 operación actualmente accedida con cualquier consulta aplicada en la página de Runtime de la Consola de Gestión. Los filtros de intervalo de tiempo no se retienen y deben aplicarse nuevamente en la página de Runtime.
• Cerrar: Cierra el cajón.

Controles de la tabla de registros de operaciones

La vista del cajón de registros incluye filtros para intervalo de tiempo y consultas, y actualización de la tabla.

Marco de tiempo

Todos los marcos de tiempo se muestran como la hora local del navegador. Por defecto, el marco de tiempo está configurado en las Últimas 24 Horas de registros desde la última ejecución de una operación. Alternativamente, utiliza el menú para seleccionar Últimas 48 Horas, Últimas 72 Horas o Tiempo personalizado:

Para un marco de tiempo dado, se incluyen un máximo de 1,000 registros en la tabla de registros de operaciones.

Cuando se selecciona Tiempo personalizado, se abre un cuadro de diálogo de configuración:

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

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

• Fecha Desde/Hasta: Utiliza el calendario bajo uno o ambos de estos campos para seleccionar una fecha dentro de los últimos 30 días.

  • Mes: Se utiliza el mes actual por defecto. Usa las flechas para navegar a un mes diferente.

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

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

Refresh

Los registros se actualizan automáticamente cada cinco segundos si alguna operación sigue en estado de ejecución (estado de Recibido, Enviado, Pendiente o Ejecutándose).

También se pueden actualizar manualmente los registros en cualquier momento para mostrar información actualizada. Para actualizar manualmente los registros, haga clic en el ícono de Actualizar en la parte superior derecha.

Queries

Una consulta es 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 <key><operator><value>. Para la clave operation, el valor puede incluir un carácter comodín, %, que coincide con cualquier cadena.

Para usar una consulta, ingrese una especificación de consulta válida en la barra de búsqueda y luego presione enter:

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

Estados de operación

Los siguientes son estados que se pueden consultar al usar la clave status:

• Error: Si el agente completa la ejecución de una operación, pero hubo un error fatal al escribir en el sistema de destino, o hubo un error de validación fatal en la transformación, o la lógica de transformación activó la función RaiseError, entonces el estado de la operación se establece en Error y la ejecución de la operación termina.

• SOAP Fault: Si el agente completa la ejecución de una operación, y el resultado fue un error SOAP, entonces el estado se establece en SOAP Fault. Este estado es aplicable solo para operaciones que utilizan Salesforce, Salesforce Service Cloud, ServiceMax, SOAP, o Workday actividades.

• Submitted: Cuando las operaciones se envían a la cola de Harmony, pero aún no han sido recogidas por un agente para su ejecución, tienen un estado de Submitted. Las operaciones se pueden enviar por varios medios:

  • Servicio de programación de Jitterbit o servicio de programación externo
  • Ejecución manual de la operación en Studio
  • Una función RunOperation desde un script o transformación
  • Cualquier herramienta, incluyendo JitterbitUtils, que llame a una API del API Manager

• Received: Una vez que se selecciona un agente y el agente ha reconocido que ha recibido la solicitud para ejecutar una operación, el estado cambia a Received.

• Pending: Una vez que una operación está programada para ejecutarse en el motor de operaciones de un agente, el estado cambia a Pending. Las operaciones no deberían estar en estado Pending durante largos períodos, ya que los agentes deberían recoger la solicitud y comenzar a ejecutar las operaciones en un corto período de tiempo.

• Running: Una vez que el agente comienza a ejecutar una operación, el estado debe cambiar a Running. Las operaciones permanecen en este estado hasta que se completan o encuentran un error. El agente comienza a registrar los mensajes generados por la operación a medida que se ejecuta para que los usuarios puedan rastrear qué parte de la operación se está ejecutando actualmente.

• Cancel Requested: Indica que se ha enviado una solicitud para detener la operación. Si un usuario desea detener una operación que está en estado Submitted, Received, Pending o Running, puede hacerlo desde estas ubicaciones:

  • La operación (ver runtime status en Design canvas).
  • La operation log table.
  • La página de Runtime de la Management Console.

  Alternativamente, puede habilitar otra operación para cancelar una operación utilizando una combinación de las funciones GetOperationQueue y CancelOperation. Una vez que se solicita la cancelación, el estado de la operación cambia a Cancel Requested. Una operación no debería permanecer en este estado por mucho tiempo, ya que el agente debería cancelar la operación en un período de tiempo relativamente corto.

• Canceled: Una vez que un agente cancela una operación, establece el estado en Canceled y la operación se termina. Toda la información del registro hasta el momento de la cancelación está disponible para revisión en los mensajes de registro, por lo que se sabe en qué momento se canceló la operación.

• Success: Una vez que un agente completa la ejecución de una operación, si el resultado fue un éxito sin advertencias del sistema objetivo, o advertencias escritas en la transformación utilizando la función WriteToOperationLog, entonces el estado se establece en Success.

• Success with Info: Si el agente completa la ejecución de una operación, pero hubo problemas no fatales en la transformación o en la publicación al sistema objetivo, o se utilizó la función WriteToOperationLog para escribir mensajes en el registro, entonces el estado se establece en Success with Info. Esto alerta al usuario para que verifique la información en los mensajes de registro.

• Success with Warning: Si el agente completa la ejecución de una operación, pero hubo problemas no fatales en la transformación o en la publicación al sistema objetivo, y hubo una advertencia, entonces el estado se establece en Success with Warning. Esto alerta al usuario para que verifique las advertencias en los mensajes de registro.

• Éxito con Error Infantil: Si el agente completa la ejecución exitosa de una operación, pero dentro de una o más operaciones hijas, hubo un error fatal al escribir en el sistema de destino, o hubo un error de validación fatal en la transformación, o la lógica de transformación activó la función RaiseError, entonces el estado de la operación se establece en Éxito con Error Infantil. Este estado no se aplica a operaciones asincrónicas.

• Estado Retrasado: Si el agente no devuelve un registro de operación por cualquier motivo, se muestra Estado Retrasado. Harmony intentará obtener registros seis veces, con un tiempo de espera de 10 segundos entre cada llamada. Actualiza o verifica los registros más tarde. No puedes filtrar por operaciones con Estado Retrasado, pero puedes verlas en los registros de operación.

Estado de 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 10.48 o posterior.

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

• Completo: El paso de operación se ejecutó y completó sin errores.
• Error: El paso de operación se ejecutó pero no pudo completarse debido a un error.
• Incompleto: El paso de operación no se ejecutó ni completó. Las posibles razones para 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 impide que el siguiente paso se ejecute.

Vista de registro de operación

La vista de registro de operación muestra una vista dividida con los registros de operación en el panel izquierdo y la información detallada del registro 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 debajo de 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 del encabezado respectivo.

Se muestran un máximo de 1000 registros de operaciones. Para ver registros de operaciones adicionales, ajuste los filtros en consecuencia.

Panel de lista de operaciones

Cuando abre la vista de registro de operaciones, el primer registro de operación en la lista se selecciona por defecto. La información detallada del registro para esta operación aparece en el panel derecho.

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

  • Operaciones principales: Cuando expande una operación principal, aparecen filas adicionales para sus operaciones secundarias en el orden en que se ejecutaron. Por defecto, todas las operaciones principales están expandidas. Use los íconos colapsar lista o expandir lista junto a la columna Nombre para colapsar o expandir todas las operaciones principales.

  • Operación con datos de entrada y salida: Cuando expande 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 la operación o paso de operación comenzó a ejecutarse, mostrada como la hora local del navegador.

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

• Duración: El tiempo transcurrido entre Iniciado y Terminado, reportado en segundos para operaciones y en milisegundos para pasos de operación.

• Estado: El estado de la operación o paso de operación. Para una lista completa de posibles estados, consulta Estados de operación más arriba 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 Ejecutándose.

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

    Nota

    Las operaciones que tienen un estado Cancelación solicitada pueden seguir ejecutándose.

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

• Ver preferencias: Abre un menú que controla qué operaciones aparecen en la vista de registros.

  • Operaciones encadenadas: Muestra u oculta operaciones secundarias en una cadena de operación. Cuando está habilitado (), la vista de registros muestra la operación seleccionada y todas las operaciones secundarias en su cadena de operación. 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: Hacer visibles todas las columnas.

  • Mover: Arrastra y suelta para cambiar la posición de la columna en relación con las demás.

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

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

• Redimensionar columnas: Arrastra la barra de Redimensionar de una columna para cambiar su tamaño.

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 la operación o paso de operación comenzó a ejecutarse, mostrada como la hora local del navegador.

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

• Duración: El tiempo transcurrido entre Iniciado y Finalizado, reportado en segundos para operaciones y en milisegundos para pasos de operación.

• Registros de origen: Al utilizar una actividad de FTP o Base de datos como fuente, se muestra el conteo de registros que han sido leídos del sistema fuente. Para otros conectores, el conteo muestra 0 independientemente del número de registros de origen.

• Registros de destino: Al utilizar una actividad de FTP o Base de datos como destino, se muestra el conteo de registros que han sido publicados en el sistema de destino. Para otros conectores, el conteo 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 o no los mensajes de registro depende de si el registro en la nube está habilitado. Para 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) son truncados, indicado con mensaje truncado apareciendo al final del registro.

• Copiar: Copia los datos del registro en tu portapapeles.

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

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

Datos de entrada y salida del componente

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

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

Puedes hacer clic en los pasos de 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 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á ningún dato.

• Buscar: Busca los datos para el texto ingresado.

• Copiar: Copia los datos del registro en tu 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 de API

Cuando una operación es activada por un API personalizado de API Manager o un API OData, la cantidad de información mostrada en los registros de operación depende de qué configuraciones estén habilitadas:

Información de la API

El registro de operaciones puede mostrar la siguiente información para las llamadas a la API:

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

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

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

  • CUSTOM_API: Una API personalizada creada en el Administrador de API.
  • ODATA: Una API OData creada en el Administrador de API.

• Método de solicitud: El método HTTP utilizado para la llamada a la 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. Puedes usar este ID para correlacionar registros entre diferentes sistemas y para buscar solicitudes específicas. Haz clic en el icono 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 de la puerta de enlace de API privada que manejó la llamada a la 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 la llamada

El registro de operaciones muestra una sección de Información de la llamada con los encabezados de solicitud HTTP enviados con la llamada a la 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.

Registro de llamadas

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