Página de Operaciones en Tiempo de Ejecución en la Consola de Administración de Jitterbit

Introducción

La página de Operaciones en Tiempo de Ejecución es una tabla de registros de operaciones. 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, el número de registros de origen y destino procesados, 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. Cuando se habilita el registro de depuración de operaciones (para agentes en la nube o para agentes privados) para una operación individual, cada registro de operación también contiene datos de entrada y salida para la operación.

Para abrir la página de Operaciones en Tiempo de Ejecución, utiliza el menú del portal Harmony para seleccionar Consola de Administración > Operaciones en Tiempo de Ejecución.

Para acceder a esta página, debes ser un administrador de organización de Harmony (un miembro de un rol con el permiso Admin), o un miembro de un rol con acceso Ejecutar o Ver Registros acceso al entorno.

Por defecto, la página de Operaciones en Tiempo de Ejecución no muestra operaciones de API personalizadas o de servicios OData exitosas. Para incluirlas, habilita el registro de depuración de operaciones en la operación, o, solo para agentes privados, establece EnableLogging=true en la sección [APIOperation] del archivo de configuración del agente privado.

Los herramientas y regiones de la página se mencionan a lo largo de este documento. Se identifican en la imagen a continuación:

Tabla de detalles de operación

Las columnas disponibles son las siguientes:

• Operación: El nombre de la operación de Integration Studio o Design Studio. Si una operación tiene hijos, haga clic en el ícono Expandir para revelar toda la cadena. Haga clic en un ícono Minimizar para colapsar una operación y sus hijos.

• Proyecto: El nombre del proyecto donde se está ejecutando la operación.

• Agente: El nombre del agente.

• Entorno: El nombre del entorno al que se desplegó la operación.

• Estado: El estado de la operación, uno de los siguientes:

  • Enviado: Se envió una operación a la cola de Harmony, pero aún no ha sido aceptada por un agente para su ejecución.
  • Recibido: Un agente reconoce haber recibido la solicitud para ejecutar una operación.
  • Pendiente: Una operación está en cola para ejecutarse en un agente.
  • En Ejecución: Un agente está ejecutando la operación.
  • Solicitud de Cancelación: Se ha realizado una solicitud para cancelar la operación. Las operaciones pueden mostrar este estado y continuar ejecutándose después de la cancelación.
  • Cancelada: La operación fue cancelada.
  • Éxito: La operación se completó con éxito.
  • Éxito con Información: La operación se completó con éxito con problemas no fatales.

  • Éxito con Advertencia: La operación se completó con éxito con advertencias como se muestra en los mensajes de registro.

    Una advertencia de subelemento extra en los mensajes de registro generalmente se puede ignorar. Esta advertencia indica que la carga útil de la API de un conector devolvió más nodos o campos de datos de los definidos en el esquema de datos de respuesta.

  • Éxito con Error Infantil: La operación se completó con éxito, pero una o más operaciones secundarias sufrieron errores fatales. (Aplica a operaciones sincrónicas.)

  • Error: La operación falló.
  • Error de SOAP: La operación falló con un error de SOAP. (Aplica a operaciones con puntos finales de SOAP o Salesforce en Integration Studio, o puntos finales de servicios web o Salesforce en Design Studio.)

  Si una operación tiene habilitado el registro de depuración de operaciones a nivel de operación, y la operación se ejecutó en un agente 10.48 o posterior, la columna Estado en la pestaña de Registro de Depuración muestra el estado del paso de la operación:

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

• Iniciado: La hora en que se solicitó la ejecución de la operación.

• Finalizado: La hora en que cambió por última vez el estado de la operación.
• ID de Operación: El identificador único global (GUID) de la operación. (Esta columna está oculta por defecto.)

• Guid de Instancia de Operación Raíz: El identificador único global (GUID) de la operación raíz (de nivel superior) de la operación. Este campo está vacío para operaciones raíz, y la columna está oculta por defecto. Para copiar el valor, pasa el cursor sobre él y luego haz clic en Copiar contenido.

  Nota

  Root Operation Instance Guid es una función beta que se desarrollará más en el futuro.

• Acciones: Pasa el cursor sobre una operación para revelar las siguientes acciones:

  • Cancelar Operaciones: Detener una operación que está en estado Enviado, Recibido, Pendiente o Ejecutándose.
  • Ir a la operación: Abrir el proyecto en Integration Studio y seleccionar la operación.

Cuando hay más de 100 operaciones, se dividen en páginas de 100 cada una. Puedes moverte a través de ellas utilizando estos botones de navegación en la parte inferior de la tabla:

• Página Anterior: Ir a la página anterior.
• Página Siguiente: Ir a la página siguiente.

Para ver los detalles del registro de una operación, selecciona una en la tabla. Se abre un panel en la parte inferior de la ventana con cuatro pestañas, Mensajes, Registros de Actividad, Archivos de Depuración y Registro de Depuración.

Pestaña de Mensajes

Esta pestaña muestra lo siguiente:

• Registros de Origen: Al usar una actividad de FTP o Base de Datos como origen, se muestra el conteo de registros que se han leído del sistema de origen. Para otros conectores, el conteo muestra 0 independientemente del número de registros de origen.

• Registros de Destino: Al usar una actividad de FTP o Base de Datos como destino, se muestra el conteo de registros que se han publicado en el sistema de destino. Para otros conectores, el conteo muestra 0 independientemente del número de registros de destino.

• Mensaje: Detalles del registro que incluyen cualquiera de lo siguiente:

  • Mensajes generados por el sistema que indican que la operación se completó sin errores.
  • Mensajes de información y advertencia devueltos por los sistemas de origen o destino.
  • Advertencias de validación devueltas por los servicios de transformación, validación y scripting de Jitterbit.
  • Mensajes definidos por el usuario generados por la herramienta Invoke Operation (Beta) (cuando Generar error si la operación falla está habilitado) o la función WriteToOperationLog().

Para ver los mensajes de registro de una operación en la pestaña Mensajes, deben cumplirse las siguientes condiciones:

• Debe ser miembro de un rol con un mínimo de permiso de organización de Lectura y acceso al entorno de Ejecutar. (Un nivel de acceso al entorno de Ver registros no es suficiente.)
• La recopilación de registros en la nube está habilitada en el grupo de agentes privados. (La recopilación de registros en la nube siempre está habilitada en grupos de agentes en la nube.) Cuando está deshabilitada, y si la configuración de su red le permite conectarse directamente al host del agente, los mensajes de registro se pueden ver de forma segura haciendo clic en el enlace Ver mensajes de registro del Agente.

Pestaña de Registros de Actividad

Esta pestaña contiene enlaces a archivos de éxito o fallo creados por las actividades de Salesforce, Salesforce Service Cloud, o ServiceMax que se ejecutan en un agente privado.

Los archivos están en formato CSV. Para descargar uno, haga clic en su enlace.

Los archivos de registro de actividad se eliminan automáticamente después de 14 días por el servicio de limpieza de archivos del agente privado. Puede cambiar este comportamiento en la sección [ResultFiles] del archivo jitterbit.conf del agente privado, o cambiando las reglas del servicio de limpieza de archivos.

Las descargas de registros de actividad están deshabilitadas para agentes en la nube. Puede ver enlaces de descarga para los registros de actividad de agentes en la nube, pero intentar descargar registros genera un mensaje de error.

Pestaña de Archivos de Depuración

Cuando la recopilación de registros de depuración está habilitada para agentes privados, esta pestaña contiene un enlace para descargar archivos de registro de depuración de operaciones. Los archivos de depuración se eliminan después de 1 día por defecto, o según lo configurado en las reglas de limpieza de un agente privado.

Los descargas de archivos de registro de depuración están deshabilitadas para los agentes en la nube. Puede ver enlaces de descarga para archivos de depuración de agentes en la nube, pero intentar descargar archivos genera un mensaje de error.

Pestaña de Registro de Depuración

Cuando el registro de depuración está habilitado 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, esta pestaña muestra los detalles de la jerarquía de ejecución completa de una operación de Integration Studio. Cuando la operación seleccionada está vinculada con acciones de operación, también se incluyen los registros de las operaciones posteriores.

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 de encabezado respectiva.

• Nombre: El nombre de la operación o paso de operación. Los triángulos de divulgación , que se pueden usar para expandir o colapsar filas adicionales, se muestran en las operaciones principales y en las operaciones para las cuales están disponibles los datos de entrada y salida de componentes:

  • Operaciones principales: Cuando se 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. Utilice los íconos colapsar lista o expandir lista para colapsar o expandir todas las operaciones principales.

• Entrada/Salida: Los datos de entrada y salida accesibles a través de esta parte de la tabla de registros se describen 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.

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

• Estado: El estado de la operación o paso de operación. Para una lista completa de posibles estados, consulta la tabla de detalles de operación más arriba en esta página.

• Acciones: Estas acciones están disponibles:

  • 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 de Cancelación Solicitada pueden seguir ejecutándose.

  • Ir a operación: Abre el proyecto en Integration Studio y selecciona la operación.

• Registro de operación: Para mostrar u ocultar un registro de una operación individual, haz clic en cualquier parte de una fila de operación, excepto en los íconos mostrados en la columna Entrada/Salida:

  

  • Mensajes de registro: Los mensajes de registro incluyen los detalles del registro para la operación seleccionada. La visualización de los mensajes de registro depende de los permisos y niveles de acceso del usuario actual y de si el registro en la nube está habilitado. Para más información, consulta la pestaña de Mensajes más arriba en esta página.

    Nota

    Las fechas y horas mostradas dentro de los mensajes de registro no se convierten a la hora local del navegador, sino que se reportan en su formato original desde la fuente del mensaje de 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 del componente

Los datos de entrada y salida del componente se generan cuando una 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.

Cuando hay datos de entrada y salida de componentes presentes, se muestra una columna Entrada/Salida que muestra una representación gráfica de la operación o paso de operación en la tabla de registros de operaciones.

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 100MB. Si los datos de una entrada de registro de entrada o salida individual superan los 100MB, 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.

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 las claves operation, project, environment, agent, los valores pueden 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 luego presiona enter:

Cuando el interruptor de Vista del árbol de ejecución está habilitado, una consulta que utiliza la clave operation (descrita a continuación) devuelve resultados para toda la jerarquía de cualquier operación padre o hija vinculada a la operación. La cadena de palabras clave se resalta en azul dentro de los resultados. Cuando el interruptor de Vista del árbol de ejecución está deshabilitado, solo se devuelven las operaciones que coinciden con la consulta.

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

Ejemplos de consulta

Los siguientes son términos de consulta de ejemplo:

Consultas guardadas

Las consultas se pueden guardar y usar, luego editar o eliminar, de la siguiente manera:

• Para guardar una consulta, haga clic en Guardar consulta. Se abre el formulario de consulta:

  

  Ingrese o seleccione valores para los siguientes campos, luego haga clic en Guardar:

  • Nombre: Un nombre para la consulta.
  • Consulta: Uno o más términos de consulta utilizando la misma sintaxis que la barra de búsqueda. Puede agregar términos de las siguientes maneras:
    • Haga clic en el campo para mostrar una lista de términos de búsqueda disponibles. Seleccione uno para ingresarlo en el campo de consulta, luego agregue un operador y un valor.
    • Seleccione una de las sugerencias de consulta.
    • Ingrese un término de consulta, seguido de un punto y coma.

  • Columnas: Seleccione las columnas para mostrar en los resultados de búsqueda.

    

  Cuando se guarda, se abre el formulario de Consultas guardadas:

  

  Haga clic en Consultas guardadas para cerrarlo.

• Para usar una consulta guardada, haga clic en Consultas guardadas, luego haga clic en la consulta que desea ejecutar. Los términos de la consulta se copian en la barra de consulta y la consulta se ejecuta automáticamente.

• Para editar una consulta guardada, haga clic en Consultas guardadas, haga clic en el ícono Editar para la consulta que desea editar. La consulta se abre en el panel de Editar consulta:

  

  Edite la consulta, luego haga clic en Guardar para guardarla, o Cancelar para cancelar.

• Para eliminar una consulta guardada, haga clic en Consultas guardadas, luego haga clic en el ícono Eliminar para la que desea eliminar. Un diálogo de Eliminar consulta guardada le pide que confirme. Haga clic en Eliminar para continuar, o Cancelar para cancelar.

Rango de tiempo

La página de Operaciones en Tiempo de Ejecución devuelve el período de tiempo que se muestra en el menú de rango de tiempo:

Para cambiar el período, abre el menú y selecciona una de las siguientes opciones:

• Últimas 24 horas

• Últimas 48 horas

• Últimas 72 horas

• Tiempo personalizado: Selecciona para abrir el diálogo de Tiempo personalizado. Con esto, puedes filtrar las operaciones según las fechas de los campos Iniciado y Finalizado:

  

  Haz clic en el ícono de calendario para abrir un selector de fechas para un campo:

  

  Establece una o ambas fechas desde o hasta utilizando el calendario. La configuración regional de tu navegador determina cómo se muestran las fechas.

  Para establecer una hora, ingresa la hora y el minuto en formato HH:MM y el período de tiempo (AM o PM).

  Haz clic en cualquier parte del diálogo de Tiempo Personalizado para cerrar el selector de fechas.

  Cuando se establecen uno o ambos rangos de fechas, haz clic en Aplicar. Para limpiar el rango, haz clic en Limpiar. Para limpiar las fechas de un campo, haz clic en su ícono .

Configuración de la página

Puedes ordenar la tabla, reorganizar sus columnas o actualizar su contenido:

• Ordenar: Para ordenar la tabla en orden ascendente, haz clic en cualquier encabezado de columna. Haz clic nuevamente para invertir el orden de clasificación.

• Columnas: Para cambiar la disposición y visibilidad de las columnas, haz clic en Filtrar Columnas. Se abre el panel de Columnas:

  

  El panel tiene los siguientes controles:

  • 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.
  • Guardar: Guardar las columnas.
  • Cancelar: Cerrar el panel de columnas sin guardar cambios.

• Actualizar: La tabla se actualiza automáticamente.

  Para cambiar el intervalo de actualización automática, haz clic en Configuración. Se abre el panel de Configuración:

  

  Selecciona un intervalo de actualización automática, uno de Nunca (el predeterminado), 1 minuto, 5 minutos, 15 minutos o 30 minutos, y luego haz clic en el botón Guardar.

  Para actualizar la tabla en cualquier momento, haz clic en Actualizar.