Saltar al contenido

Registros de operaciones en Jitterbit Integration Studio

Introducción

Cuando se ejecuta una operación, se genera un registro de operación. Este operación contiene información sobre cuándo y dónde se ejecutó una operación, su estado 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. Cuando depurar de operación (para agentes en la nube o para agentes privados) está habilitado para una operación individual, cada registro de operación también contiene datos de entrada y salida para la operación.

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

Los registros de operaciones también se pueden ver en la Management Console Operaciones en tiempo de ejecución página.

Importante

De forma predeterminada, las operaciones de API exitosas (configuradas para APIs personalizadas o servicios OData) no están incluidos en los registros de operación a menos que una de estas configuraciones esté habilitada:

  • Agentes de nube: Para operaciones de API en un agente de nube, registro de depurar de operación debe estar habilitado en la operación.
  • Agentes privados: Para las operaciones de API en un agente privado, registro de depurar de la operación debe estar habilitado en la operación o debe configurarlo EnableLogging=true en el [APIoperation] sección del archivo de configuración del agente privado.

  • Para obtener información sobre cómo resolver ciertos errores que pueden ocurrir al ejecutar una operación, consulte Solución de problemas de operación.

    Acceder a los registros de operación

    Se puede acceder a los registros de operaciones en Integration 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 1000 registros para un período determinado de operaciones ejecutadas en un flujo de trabajo, una operación o un proyecto, respectivamente. Si las operaciones están vinculadas con acciones de operación o el RunOperation Función, también se incluyen registros de operaciones abajo en la cadena.

    Por flujo de trabajo

    Se puede acceder a la opción Ver registros para un flujo de trabajo, que muestra los registros de las operaciones que se han ejecutado dentro de un flujo de trabajo en particular, desde la pestaña Flujos de trabajo del panel del proyecto (consulte menú de acciones del Flujo de trabajo en la pestaña Flujos de trabajo del panel Proyecto)

    Por operación

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

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

    Por proyecto

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

    Se puede acceder a la opción Ver registros de un proyecto desde estas ubicaciones:

    Nota

    El resto de esta página describe la interfaz de usuario del registro de operación para flujos de trabajo y operaciones. Para obtener información sobre cómo ver los registros de operación de un proyecto completo, consulte Operaciones en tiempo de ejecución.

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

    Al ver los registros por flujo de trabajo u operación, el cajón del proyecto se abre en la parte inferior del tela de diseño para mantener el contexto en el proyecto:

    cajón de registros

    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 (según el origen del acceso a los registros). Al acceder a registros adicionales o variables del proyecto, se añaden nuevas pestañas. Para reordenar las pestañas, arrastre y suelte una pestaña. Para cerrar una pestaña, haga clic en su... Icono de cerrar. Cerrar la última pestaña o usar el icono más a la derecha. El icono de cerrar cierra el cajón. - Redimensionar: La barra en la parte superior del cajón permite cambiar su tamaño. Pase el cursor sobre la barra y arrastre el icono. Ajusta el tamaño del icono hacia arriba o hacia abajo para cambiar el tamaño del cajón. Contraer: Contrae el cajón para ocultar todos los registros. Una vez contraído, haga clic en el botón Icono de retorno para volver a la vista anterior. Expandir: Amplía el cajón a pantalla completa para que se muestren los registros adicionales. Una vez expandido, haga clic en el icono de retorno. Para volver a la vista anterior. - Abrir en operaciones de tiempo de ejecución: Abre la pestaña del registro de operación a la que se accede actualmente con cualquier consulta aplicada) en la Management Console Operaciones en tiempo de ejecución. Los filtros de intervalo de tiempo no se conservan y deben reaplicarse en la página Operaciones en tiempo de ejecución. - Cerrar: Cierra el cajón.

    Controles de la tabla de registro de operaciones

    El registro de operación vista del cajón incluye filtros para período de tiempo y consultas, y la tabla actualizar.

    Periodo de tiempo

    Todos los intervalos de tiempo se muestran como la hora local del navegador. De forma predeterminada, el intervalo de tiempo se establece en las Últimas 24 horas de registros desde la última ejecución de una operación. Como alternativa, utilice el menú para seleccionar Últimas 48 horas, Últimas 72 horas o Hora personalizada:

    Intervalo de tiempo

    Para un período de tiempo determinado, se incluye un máximo de 1000 registros en la tabla de registro de operación.

    Nota

    Los registros de operaciones se almacenan durante un máximo de 30 días.

    Al seleccionar Tiempo personalizado, se abre un cuadro de diálogo de configuración:

    tiempo personalizado

    • Terminado: Para filtrar por fecha y hora en que la operación o el etapa de operación dejó de ejecutarse, haga clic en el icono Icono de calendario para abrir el selector de fechas. Para borrar este campo, haga clic en el Icono de borrar filtro.
    • Iniciado: Para filtrar por fecha y hora en que comenzó a ejecutarse la operación o el etapa de operación, haga clic en el icono Icono de calendario para abrir el selector de fechas. Para borrar este campo, haga clic en el Icono de borrar 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 operación.
    • Borrar: (Habilitado cuando se configuran los campos Finalizado o Iniciado). Borra ambos filtros.

    Una vez que Al hacer clic en el icono del calendario, se abre el selector de fecha y hora para ese campo:

    rango de operación mes

    • Fecha de inicio/fin: Use el calendario debajo de uno o ambos campos para seleccionar una fecha de los últimos 30 días.

      • Mes: Se usa el mes actual por defecto. Use el Flechas para navegar a otro mes.

      • Día: Seleccione el día deseado en el calendario.

    • Hora: Escriba 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 está en estado de ejecución (estado de Recibido, Enviado, Pendiente o En ejecución).

    También puede actualizar manualmente los registros en cualquier momento para ver la información actualizada. Para actualizar manualmente los registros, haga clic en el botón Icono de Actualizar en la esquina superior derecha.

    Consultas

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

    Para utilizar una consultar, ingrese una especificación de consultar válida en la barra de búsqueda y luego presione Enter:

    Barra de búsqueda

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

    Clave Columna clave Operadores permitidos Valor1
    name o operation Nombre = Nombre de la operación
    status Estado = Nombre del estado
    started Comenzó <= Fecha/hora
    >=
    finished Terminado <= Fecha/hora
    >=
    message n/a n/a Mensaje de registro de operaciones

    1Tipos de valores

    • Nombre del estado: la cadena que se muestra en la columna Estado de la tabla de registros de operación .
    • Fecha/hora: formato de fecha mes/día/año, con hora opcional hora:minuto:segundo en formato AM/PM:
      • Solo fecha: MM/DD/AAAA
      • Fecha y hora (AM): MM/DD/AAAA HH:MM:SS AM
      • Fecha y hora (PM): MM/DD/AAAA HH:MM:SS PM

    Estados de operación

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

    • 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 fatal de validación en la transformación, o la lógica de la transformación activó el RaiseError función, entonces el estado de la operación se establece en Error y la ejecución de la operación finaliza.

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

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

      • Servicio de programación Jitterbit o servicio de programación externo
      • Ejecución manual de la operación en Integration Studio
      • A RunOperation función de un secuencia de comandos o transformación
      • Cualquier herramienta, incluyendo JitterbitUtils, que llama a una API de API Manager
    • Recibido: Una vez que se selecciona un agente y el agente reconoce que recibió la solicitud para ejecutar una operación, el estado cambia a Recibido.

    • Pendiente: Una vez programada la ejecución de una operación en el motor de operación de un agente, el estado cambia a Pendiente. Las operaciones no deben permanecer en estado Pendiente durante largos periodos, ya que los agentes deben atender la solicitud y comenzar a ejecutar las 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 se produce un error. El agente comienza a registrar los mensajes generados por la operación durante su ejecución para que los usuarios puedan rastrear qué parte de la operación se está ejecutando.

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

      Alternativamente, pueden habilitar otra operación para cancelar una operación utilizando una combinación de las GetOperationQueue y CancelOperation Funciones. Una vez solicitada una cancelación, el estado de la operación cambia a Cancelación solicitada. Una operación no debe permanecer en este estado por mucho tiempo, ya que el agente debe operación en un plazo breve.

    • Cancelado: Cuando un agente cancela una operación, el estado se establece en Cancelado y la operación se da por terminada. Toda la información del registro hasta el momento de la cancelación está disponible para su revisión en los mensajes de registro, lo que le permite saber cuándo 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 advertencias escritas en la transformación utilizando la WriteToOperationLog función, 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 publicación en el sistema de destino o el WriteToOperationLog Se usó la función para escribir mensajes en el registro, y el estado se establece en Información correcta. Esto alerta al usuario para que revise la información en los mensajes del registro.

    • Éxito con advertencia: Si el agente completa la ejecución de una operación, pero se produjeron problemas menores en la transformación o la publicación en el sistema de destino, y se generó una advertencia, el estado se establece en Éxito con advertencia. Esto alerta al usuario para que revise 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 fatal de validación en la transformación, o la lógica de transformación activó el RaiseError Función, el estado de la operación se establece en Éxito con error secundario. Este estado no aplica a operaciones asincrónicas.

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

    Estado del paso de operación

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

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

    • Completado: El etapa de operación se ejecutó y completó sin ningún error.
    • Error: El etapa de operación se ejecutó pero no se pudo completar debido a un error.
    • Incompleto: El etapa de operación no se ejecutó o no se completó. Este estado puede deberse a que el etapa de operación está pendiente de ejecución o a que un error en un etapa de operación anterior impidió la ejecución del siguiente.

    Tabla de registro de operaciones

    La tabla de registro de operación muestra los registros de operación utilizando los controles de tabla seleccionados). Si las operaciones están vinculadas con acciones de operación o el RunOperation Función, también se incluyen registros de operaciones abajo en la cadena.

    Las operaciones principales (y cualquier operación secundaria que esté 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 correspondiente.

    Se muestra un máximo de 1000 registros de operación. Para ver los registros de operaciones adicionales, ajuste los filtros según corresponda.

    Consejo

    La configuración básica de lo que se incluye en un registro de operación se especifica en la pestaña Opciones de la configuración de operación (consulte Opciones de operación). Consulte otras opciones de registro (para agentes en la nube o para agentes privados).

    tabla logarítmica

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

      • Operaciones principales: Cuando se expande 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 se expanden. Utilice el colapsar lista o Expandir los íconos de lista junto a la barra de búsqueda para contraer o expandir todas las operaciones principales.

      • Operación con datos de entrada y salida: Al expandir una operación con datos de entrada y salida, aparecen filas adicionales para cada etapa de operación en el orden en que se ejecutaron. Para más información, consulte Datos de entrada y salida del componente.

    • Entrada/Salida: Esta columna se muestra solo cuando la tabla contiene una operación que tiene habilitado el registro de depurar de operación en el nivel de operación (para agentes de la nube o para agentes privados) y la operación se ejecutó en un agente 10.48 o posterior. Los datos de entrada y salida a los que se accede a través de esta parte de la tabla de registro se describen en Datos de entrada y salida del componente.

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

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

    • Duración: El tiempo transcurrido entre Inicio y Financiamiento, informado en segundos para las operaciones y en milisegundos para los pasos de la operación.

    Estado: El estado de la operación o del etapa de operación. Para obtener una lista completa de los posibles estados, consulte Estados de la 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. Al hacer clic, se muestra el estado Cancelación solicitada junto al estado de la operación en tiempo real.

        !!! note "Nota"
             Las operaciones que tienen un estado **Cancelación solicitada** aún pueden ejecutarse.
    
    • Registro de operaciones: Para mostrar u ocultar el registro de una operación individual, haga clic en cualquier lugar de la fila de una operación, excepto en los íconos que se muestran en la columna Entrada/Salida (si está presente):

      tabla de registro expandida

      • Registros de origen: Al utilizar un FTP o Base de datos actividad como origen, se muestra el recuento de registros leídos del sistema de origen. Para otros conectores, el recuento indica 0 independientemente del número de registros de origen.

      • Registros de destino: Al utilizar un FTP o Base de datos actividad como objetivo, se muestra el recuento de registros publicados en el sistema de destino. Para otros conectores, el recuento indica 0 independientemente del número de registros de destino.

      • Mensajes de registro: Los mensajes de registro incluyen los detalles del registro de 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 obtener más información, consulte la pestaña Mensajes en la Management Console Operaciones en tiempo de ejecución documentación de la página.

        Nota

        Las fechas y horas que se muestran en los mensajes de registro no se convierten a la hora local del navegador, sino que se muestran en el formato original del mensaje de registro.

      • Copiar: Copia los datos de 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 habilitado el registro de depurar de operación en el nivel de operación (para agentes de la nube o para agentes privados) y la operación se ejecutó en un agente 10.48 o posterior.

    Nota

    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 los componentes se registrarán en la nube Harmony incluso si el registro en la nube está deshabilitado.

    Para deshabilitar la generación de datos de entrada y salida de componentes en un grupo de agentes privados, en el archivo de configuración del agente privado bajo el [VerboseLogging] sección, conjunto verbose.logging.enable=false.

    Advertencia

    Cuando se generan los datos de entrada y salida de un componente, todos los datos de solicitud y respuesta de esa operación se registran en la nube de Harmony y permanecen allí durante 30 días. Tenga en cuenta que la información de identificación personal (PII) y los datos confidenciales, como las credenciales proporcionadas en la carga útil de una solicitud, serán visibles en texto sin cifrar en los datos de entrada y salida de los registros de la nube de Harmony.

    Cuando hay datos de entrada y salida del componente, se muestra una columna Entrada/Salida que muestra una representación gráfica de la operación o el etapa de operación en la tabla de registro de operación.

    En la columna Entrada/Salida, se puede hacer clic en los iconos de las actividades y transformaciones utilizadas como etapa de operación de operación para mostrar u ocultar los datos de entrada y salida de cada componente. Cada entrada de registro de entrada y salida tiene un límite de 100 MB. Si los datos de una entrada de registro de entrada o salida superan los 100 MB, no se mostrarán.

    encabezado de pasos de operación de la tabla de registro

    • Buscar: Busca los datos del texto introducido.

    • Copiar: Copia los datos de registro al portapapeles.

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