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. Dependiendo de 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 actualmente accedida 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.

Controles de la tabla de registro de operaciones

La vista de cajón del registro de operaciones incluye filtros para período de tiempo y consultas, y actualización de la 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 Tiempo personalizado:

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 Tiempo personalizado, 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: (Habilitado cuando se configura cualquiera de los campos Finalizado o Iniciado.) Aplica todos los filtros de fecha y hora a la tabla de registros de operaciones.
• Borrar: (Habilitado cuando se configura cualquiera de los campos 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 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

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 se 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 actividades de Salesforce, Salesforce Service Cloud, ServiceMax, SOAP o Workday.

• Enviado: 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 Enviado. Las operaciones se pueden enviar de varias formas:

  • 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, incluida JitterbitUtils, que llame a una API de API Manager

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

• Pendiente: Una vez que se programa una operación para ejecutarse en el motor de operaciones de un agente, el estado cambia a Pendiente. Las operaciones no deben permanecer en estado Pendiente durante períodos prolongados, ya que los agentes deben recoger la solicitud e iniciar la ejecución de operaciones en poco tiempo.

• En ejecución: Una vez que el agente comienza a ejecutar una operación, el estado debe cambiar a En ejecución. 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 mientras se ejecuta, de modo que los usuarios puedan rastrear qué parte de la operación se está ejecutando actualmente.

• Cancelación solicitada: Indica que se ha enviado una solicitud para detener la operación. Si un usuario desea detener una operación que se encuentra en estado Enviada, Recibida, Pendiente o En ejecución, puede hacerlo desde estas ubicaciones:

  • La operación (consulta estado en tiempo de ejecución en Lienzo de diseño).
  • La tabla de registro de operaciones.
  • La página Tiempo de ejecución de la Consola de administración.

  Alternativamente, pueden habilitar otra operación para cancelar una operación utilizando una combinación de las funciones GetOperationQueue y CancelOperation. Una vez que se solicita una cancelación, el estado de la operación cambia a Cancelación solicitada. Una operación no debe permanecer en este estado durante mucho tiempo, ya que el agente debe cancelar la operación en un período bastante corto.

• Cancelada: Una vez que un agente cancela una operación, establece el estado en Cancelada y la operación se termina. Toda la información de registro hasta el punto de cancelación está disponible para revisión en los mensajes de registro, de modo que sabes en qué punto se canceló la operación.

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

• Éxito con información: 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 en el sistema de destino, o se utilizó la función WriteToOperationLog para escribir mensajes en el registro, entonces el estado se establece en Éxito con información. Esto alerta al usuario para que verifique la información en los mensajes de registro.

• Éxito con advertencia: 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 en el sistema de destino, y hubo una advertencia, entonces el estado se establece en Éxito con advertencia. Esto alerta al usuario para que verifique las advertencias en los mensajes de registro.

• Éxito con error secundario: Si el agente completa la ejecución exitosa de una operación, pero dentro de una o más operaciones secundarias, 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 secundario. Este estado no se aplica a operaciones asincrónicas.

• Estado retrasado: Si el agente no devuelve un registro de operación por ningún 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 operaciones con Estado retrasado, pero puedes verlas en los registros de operaciones.

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 operaciones 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 se 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 se 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 impide que se ejecute el siguiente paso.

Vista del registro de operaciones

La vista del registro de operaciones muestra una vista dividida con registros de operaciones en el panel izquierdo e información detallada del registro de 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 del registro de operaciones, el primer registro de operación en la lista se selecciona de forma predeterminada. La información detallada del registro 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 se detuvo la ejecución de 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 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 pueden seguir ejecutándose, 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: Hace visibles todas las columnas.

  • Mover: Arrastra y suelta para cambiar la posición de la columna respecto a 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 Redimensionar 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 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. 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 FTP o Base de datos como origen, se muestra el recuento de registros que se han leído del sistema de origen. Para otros conectores, el recuento muestra 0 independientemente del número de registros de origen.

• Registros de destino: Cuando se utiliza una actividad FTP o Base de datos como destino, se muestra el recuento de registros que se han publicado en el sistema de destino. Para otros conectores, el recuento 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 de la fuente 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 a tu 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 habilitado el registro de depuración de operaciones 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 del componente, 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 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 o salida se limita a 100 MB. Si los datos de una entrada de registro de entrada o salida individual superan 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 Enable debug mode until (una configuración de API Manager) u Operation debug logging (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 una 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. Puedes usar este ID para correlacionar registros en diferentes sistemas y para buscar solicitudes específicas. Haz clic en el icono de copia 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, la raíz del servicio, la 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 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 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 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 llamadas 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.