Saltar al contenido

Registros de Operaciones

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, la cantidad de registros de origen y destino procesados y cualquier mensaje de registro. Si se muestran mensajes de registro detallados depende de los niveles de permiso y acceso y de si el registro en la nube está habilitado. Cuando se genera un registro de depurar de operación (para agentes de 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 la nube: Para las operaciones de API en un agente de la 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 configurar EnableLogging=true en el [APIoperation] sección del archivo de configuración del agente privado.

  • Acceder a los Registros de Operación

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

    Por Proyecto

    Se puede acceder a la opción Ver registros de un proyecto, que muestra los registros de las operaciones que se han ejecutado dentro de un proyecto, desde estas ubicaciones:

    Por Flujo de Trabajo

    Se puede acceder a la opción Ver registros de 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).

    Vistas del Registro de Operaciones

    La pantalla de registro de operación tiene dos vistas: pantalla completa y cajón. La vista que se muestra depende de dónde se acceda a los registros:

    • Pantalla completa: Al visualizar registros por proyecto, se carga la vista de pantalla completa y la pantalla del registro de operación se carga en una nueva pestaña:

      registros en pantalla completa

      • Nombre del proyecto: El nombre del proyecto (después del texto Registro para:) aparece en la parte superior de la pantalla del registro de operación.
      • Cerrar: Para volver a la pantalla anterior, haga clic en el botón icono de cerrar.
    • Cajón: Al visualizar registros por flujo de trabajo u operación, se abre un cajón de registro de operación en la parte inferior del diseñador de proyectos para mantener su contexto en el proyecto:

      cajón de registros

      • Pestañas: Las pestañas en la parte superior del cajón de registro de operación están etiquetadas con Registro seguido del nombre de la operación o flujo de trabajo (según desde dónde se accedió a los registros). Cuando accede a registros adicionales, se agregan 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 de registro.
      • Cambiar tamaño: La barra en la parte superior del cajón de registro se puede usar para cambiar el tamaño del cajón de registro. Pase el cursor sobre la barra y arrastre el icono cambia el tamaño del ícono hacia arriba o hacia abajo para cambiar el tamaño del cajón de registro.
      • Contraer: Contrae el cajón de registros para que todos los registros queden ocultos. Una vez contraído, haga clic en el botón icono de retorno para volver a la vista anterior.
      • Expandir: Expande el cajón de registros a pantalla completa para que se muestren los registros adicionales. Una vez expandido, haga clic en el ícono de retorno para volver a la vista anterior.
      • Abrir en una nueva pestaña: Abre la vista del registro de operación en pantalla completa en una nueva pestaña.
      • Cerrar: Cierra el cajón de registro.

    La información del resto del cuerpo de estas vistas es la misma en ambas vistas y se trata en las siguientes subsecciones.

    Controles de la Tabla de Registro de Operaciones

    Ambas pantallas de registro de operación vistas tienen los mismos controles en la parte superior de la tabla de registro de operación, incluido un filtro para período de tiempo, capacidad de refrescar la tabla de registro, un filtro en estado de la operación, y un cuadro de búsqueda.

    Periodo de Tiempo

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

    De forma predeterminada, el rango de tiempo de inicio está configurado para que se muestren las últimas 24 horas de registros desde la última ejecución de una operación:

    rango de registros

    La fecha y la hora para la selección del intervalo de tiempo utilizan la hora local del navegador. Pase el cursor sobre la información sobre herramientas Intervalo de tiempo de inicio para ver la huso horario local del navegador:

    rango de registros al pasar el mouse

    Para cambiar el período de tiempo por el que se filtran los registros, haga clic en el campo Rango de tiempo de inicio para abrir el selector de fecha y hora. Luego, use los controles dentro del selector para ajustar la fecha y/o la hora:

    rango de operación mes

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

    • Año: El año actual se utiliza de forma predeterminada. Haga clic en el año y luego use las flechas flechas para navegar a un año diferente. Luego, seleccione el mes deseado del año en el selector de meses. Al seleccionar un mes, regresará al selector de fecha y hora.

      año del rango de operación

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

    • Hora: Utilice los controles deslizantes para ajustar la hora (control deslizante superior) y los minutos (control deslizante inferior).

    Actualizar

    Los registros iniciales se muestran en función de la fecha y la hora en que se ejecutó la última operación, como se muestra en la parte superior de la tabla. 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). La fecha y la hora en que se actualizó la vista por última vez se indican debajo del Rango de tiempo de inicio:

    registros actualizados

    También puede actualizar manualmente los registros en cualquier momento para mostrar información actualizada. Para actualizar manualmente los registros, haga clic en Actualizar en la parte superior derecha:

    actualización de registros

    Estado

    La tabla se puede filtrar por estado de la operación como se describe a continuación. Estado del paso de operación también aparece en la tabla.

    Estado de la Operación

    Para filtrar los registros por estado de operación, utilice el menú en la parte superior derecha:

    estado de los registros

    • Todos: Se muestran todas las operaciones independientemente del estado.

    • 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 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 se 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 por varios medios:

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

    • Pendiente: Una vez que se programa 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 estar en estado Pendiente durante períodos prolongados, ya que los agentes deben tomar la solicitud y comenzar a ejecutar operaciones en un breve período de 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 hasta que se produce un error. El agente comienza a registrar los mensajes generados por la operación a medida que se ejecuta, de modo que los usuarios puedan realizar un seguimiento de qué parte de la operación se está ejecutando en ese momento.

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

      Alternativamente, pueden habilitar otra operación para cancelar una operación utilizando una combinación de las GetOperationQueue y CancelOperation funciones. 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 de tiempo relativamente corto.

    • Cancelado: Una vez que un agente cancela una operación, establece el estado en Cancelado y la operación finaliza. Toda la información de registro hasta el momento de la cancelación está disponible para su revisión en los mensajes de registro, de modo que sepa en qué momento 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 en el WriteToOperationLog se utilizó la función para escribir mensajes en el registro, luego el estado se establece en Éxito con información. Esto alerta al usuario para que verifique la información en los mensajes del 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 publicación en el sistema de destino y hubo una advertencia, el estado se establece en Éxito con advertencia. Esto alerta al usuario para que verifique si hay advertencias en los mensajes de registro.

      Un extra subelement la advertencia 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 de nodos o campos de datos que los definidos en el esquema de datos de respuesta.

    • É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, 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 algún motivo, se muestra Estado retrasado. Harmony intentará obtener los registros seis veces, con un tiempo de espera de 10 segundos entre cada llamada. Actualice o vuelva a verificar los registros más tarde. No puede filtrar las operaciones con Estado retrasado, pero puede verlas 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 se 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ó. Entre las posibles razones de este estado se incluyen que el etapa de operación está esperando a ser ejecutado o que hubo un error en un etapa de operación anterior que impidió la ejecución del siguiente paso.

    Haga clic en el icono de búsqueda para mostrar un cuadro de búsqueda para ingresar palabras clave en el formato especificado que se buscará dentro de la pantalla de registro de operación.

    Un símbolo de porcentaje (%) se puede utilizar como comodín al principio y/o al final de una palabra clave.

    Por Proyecto o Flujo de Trabajo

    Al visualizar los registros de todo el proyecto o de un flujo de trabajo, puede buscar por nombre de operación o por mensaje dentro de la pantalla de registro de operación:

    proyecto de búsqueda de registros

    • Operación: Las búsquedas por nombre de operación deben especificarse en el formato de operation=keyword.
    • Mensaje: Las búsquedas por mensaje deben especificarse en el formato de message=keyword.

    Solo se admiten una única palabra clave de operación y una única palabra clave de mensaje. Cuando se proporcionan tanto una palabra clave de operación como una palabra clave de mensaje, las palabras clave se tratan como una combinación; es decir, se devuelven registros de operación que coinciden tanto con la palabra clave de operación y con la palabra clave de mensaje.

    Por Operación

    Al visualizar los registros de una sola operación, puede buscar únicamente por mensaje de registro de operación:

    operación de búsqueda de registros

    • Mensaje: Las búsquedas por mensaje deben especificarse en el formato de message=keyword.

    Sugerencia

    Para obtener capacidades de búsqueda de registros adicionales, también puede ver los registros a través de Operaciones en tiempo de ejecución página de la Management Console.

    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, 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 Hora de inicio. La tabla se puede ordenar (solo para operaciones de nivel superior) por Nombre, Hora de inicio, Hora de finalización o Duración haciendo clic en la fila de encabezado correspondiente.

    Se muestran un máximo de 250 filas de operación. Para ver los registros de operaciones adicionales, ajuste los filtros según corresponda o utilice la Management Console Operaciones en tiempo de ejecución página, que no tiene el límite de 250 registros.

    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 de la nube o para agentes privados).

    tabla de registro

    • Nombre: El nombre de la operación o del etapa de operación. 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 manera predeterminada, se expanden todas las operaciones principales. Utilice el comando colapsar lista o expandir los íconos de lista en el encabezado de la columna para contraer o expandir todas las operaciones principales.

      • Operación con datos de entrada y salida: Cuando se expande 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. Se proporciona más información en 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.

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

    • Hora de finalización: La fecha y la 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 la Hora de inicio y la Hora de finalización, 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 Estado anteriormente en esta página.

    • Cancelar: Para las operaciones que están en estado Enviado, Recibido, Pendiente o En ejecución, se muestra un botón Cancelar junto al estado:

      cancel

      Haga clic en Cancelar para enviar una solicitud al agente para que detenga la operación. Al hacer clic en Cancelar se envía una solicitud al agente para que detenga la operación y se muestra el estado Cancelación solicitada junto al estado de la operación en tiempo real:

      cancelar operación

      Nota

      Las operaciones que tienen un estado Cancelación solicitada aún pueden ejecutarse.

    • Registro de operaciones: Para mostrar u ocultar un registro de una operación individual, haga clic en cualquier parte de una fila de operación, excepto en los íconos que se muestran en la columna Entrada/Salida (si está presente):

      tabla de registro expandida

      • Registros de origen: Un recuento de registros que se han leído del sistema de origen.

      • Registros de destino: Un recuento de registros que se han publicado en el sistema de destino.

      • Mensajes de registro: Los mensajes de registro incluyen los detalles de 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 sección Mensajes de registro en la Management Console Operaciones en tiempo de ejecución documentación de la página.

        En determinadas circunstancias, puede aparecer un botón Intentar de nuevo, que se explica en Operación de reintento, abajo.

        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 informan en su formato original desde la fuente del mensaje de registro.

      • Copiar: Copia los datos de registro en el portapapeles. Al hacer clic, aparece un el icono del portapapeles se muestra temporalmente.

      • Cerrar: Oculta el registro de operación.

    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 Habilitar registro en la nube. 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 datos de entrada y salida de componentes, todos los datos de solicitud y respuesta para 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 una carga útil de solicitud, serán visibles en texto sin formato en los datos de entrada y salida dentro 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 íconos de las actividades y transformaciones utilizadas como pasos de operación para mostrar u ocultar los datos de entrada y salida de los componentes para ese etapa 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án datos.

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

    • Copiar: Copia los datos de registro en el portapapeles. Al hacer clic, aparece un el icono del portapapeles se muestra temporalmente.

    • 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 etapa de operación seguido de _input o _output según corresponda.

    Operación Reintentar

    Si una operación falla debido a un error relacionado con las dependencias de archivos, este problema se puede resolver volviendo a sincronizar el proyecto entre el agente y Harmony. En este escenario, aparece un botón Intentar de nuevo en el registro de operación:

    tabla de registro, inténtalo de nuevo

    Al hacer clic en Intentar de nuevo, el proyecto se vuelve a sincronizar entre el agente y Harmony.

    Una vez finalizada la resincronización, se vuelve a intentar ejecutar la operación automáticamente. En los casos en que falla una operación principal o secundaria, se vuelve a intentar toda la cadena de operación desde el nivel superior hasta todas las operaciones abajo en la cadena.

    Si la operación se realiza correctamente, se muestra un estado de éxito en el nuevo registro de operación. Si la operación falla nuevamente, los intentos adicionales para sincronizar el agente no servirán de nada y el motivo de la falla puede deberse a otra cosa (comuníquese con soporte de Jitterbit para obtener ayuda).