Visualiza los registros de ejecución

Application Integration genera registros de ejecución detallados para cada ejecución de una integración. Puedes usar los registros de ejecución para solucionar problemas de ejecuciones de integración con errores, identificar el estado de ejecución de cada paso de una integración y supervisar el estado de ejecución de las integraciones principales y secundarias. Para obtener más información sobre el registro en Application Integration, consulta Introducción a los registros.

Nota: Application Integration conserva los registros de ejecución de una integración durante un período máximo de 32 días.

Ver los registros de ejecución de integración

Puedes ver los registros de ejecución en la consola de Google Cloud o con la API.

Nota: Si el tamaño de los registros de ejecución es superior a 300 MB, Application Integration muestra el error Response size too large y los registros no se cargan en la página Registros de ejecución. En ese caso, usa el método projects.locations.integrations.executions.list como se explica en la pestaña API.

Console

Para ver los registros de ejecución en la consola de Google Cloud , sigue estos pasos:

1. En la consola de Google Cloud , ve a la página Application Integration.

   Ir a Application Integration

2. En el menú de navegación, haz clic en Registros.

   Aparecerá la página Registros de ejecución con los registros de ejecución generados para las integraciones en la región predeterminada. Los siguientes atributos se muestran para cada mensaje de registro de ejecución:

   • Nombre de la integración: El nombre de la integración.
   • ID de ejecución: Un identificador único generado para cada ejecución de una integración.
   • Estado: Estado de la ejecución de la integración.
     • En proceso: Indica que la integración se está ejecutando actualmente.
     • Correcto: Indica que la integración se ejecutó correctamente.
     • Error: Indica que no se pudo ejecutar la integración.
     • Cancelado: Indica que el usuario canceló la ejecución de la integración.
     • En espera: Indica que la ejecución de la integración está pausada temporalmente y espera a que se complete un evento o una acción.
     • Reintentar en espera: Indica que la ejecución de la integración falló y está esperando un reintento.
     • Suspendida: Indica que la ejecución de la integración está pausada temporalmente y requiere intervención manual para reanudar la integración.
   • Hora de inicio: Marca de tiempo del momento en que comenzó la ejecución.
   • Duración: Tiempo que tomó la ejecución de la integración.
     Nota: No uses el valor Duración para calcular la latencia de ejecución de extremo a extremo de una integración. El tiempo que se muestra en la columna Duración no refleja el tiempo de ejecución total de una integración, ya que no tiene en cuenta el tiempo adicional que tomó la integración antes o después de su ejecución. Por ejemplo, el tiempo necesario para la autenticación o la aplicación de la cuota no se refleja en el valor Duración.
   • Versión de integración: Versión de la integración ejecutada.
   • ID del activador: El valor de ID del activador
   • Cloud Logging: Indica si la integración está configurada para registrar en Cloud Logging. Si Cloud Logging está habilitado, este campo proporciona un vínculo para ver los registros en Cloud Logging. Si Cloud Logging no está habilitado, este campo se establece en Inhabilitado.
   • Reproducida desde: Si se vuelve a reproducir la ejecución de la integración, este campo proporciona el ID de ejecución de la ejecución que se volvió a reproducir. Puedes volver a reproducir una ejecución de integración publicada cuando quieras volver a ejecutar una integración con los mismos parámetros que la ejecución anterior. Por ejemplo, puedes volver a reproducir una ejecución si una integración falló debido a un error de tiempo de espera o si el resultado de una integración no es el esperado. Para aprender a volver a reproducir ejecuciones, consulta Vuelve a reproducir ejecuciones.

3. Para ver los registros de ejecución específicos de la región, cambia la región en la lista Región.
4. De manera opcional, puedes hacer clic en Actualizar registros para volver a cargar la lista de registros actual.

   En la siguiente imagen, aparece una página de muestra de los Registros de ejecución de Application Integration.

   

API

Si el tamaño de los registros de ejecución es superior a 300 MB, Application Integration muestra el error Response too large error y los registros no se cargan en la página Registros de ejecución. En este caso, debes usar el método projects.locations.integrations.executions.list para obtener los registros. Para ver los registros mediante el método de la API, sigue estos pasos:

1. A fin de obtener el ID de ejecución del que deseas ver los registros de ejecución, crea una solicitud GET mediante el método projects.locations.integrations.executions.list con el parámetro snapshotMetadataWithoutParams configurado como TRUE:

   curl -v -X GET \
       -G \
       -H "Content-Type: application/json" \
       -H "Authorization: Bearer $(gcloud auth print-access-token)" \
       'https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/integrations/INTEGRATION_NAME/executions' \
       -d "snapshotMetadataWithoutParams=true"
   

   Reemplaza lo siguiente:

   • PROJECT_ID: El ID del proyecto de Google Cloud.
   • LOCATION: Es la región de la integración.
   • INTEGRATION_NAME: Es el nombre de la integración.

   Los ID de ejecución se muestran en la respuesta. Copia el ID de ejecución del que deseas ver los registros.

2. Para obtener el registro de ejecución del ID de ejecución, crea una solicitud GET mediante el método projects.locations.integrations.executions.list con un filtro en el ID de ejecución que copiaste en el paso anterior:

   curl -X GET \
       -G \
       -H "Content-Type: application/json" \
       -H "Authorization: Bearer $(gcloud auth print-access-token)" \
       'https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/integrations/-/executions' \
       --data-urlencode 'filter=execution_id="EXECUTION_ID"'
   

   Reemplaza lo siguiente:

   • PROJECT_ID: El ID del proyecto de Google Cloud.
   • LOCATION: Es la región de la integración.
   • EXECUTION_ID: Es el ID de ejecución que se copió del paso anterior.

   En la respuesta, consulta el campo ExecutionDetails para ver los detalles del registro.

   Como alternativa, en la consola de Google Cloud , puedes filtrar los registros de ejecución por el ID de ejecución.

Ejemplo: Filtra registros

Si quieres filtrar la respuesta para enumerar los registros de todas las integraciones, excepto una, usa el siguiente formato:

curl -X GET \
    -G \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    'https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/integrations/-/executions' \
    --data-urlencode 'filter=workflow_name!="INTEGRATION_NAME"'

Reemplaza lo siguiente:

• PROJECT_ID: El ID del proyecto de Google Cloud.
• LOCATION: Es la región de la integración.
• INTEGRATION_NAME: Es el nombre de la integración.

Puedes filtrar por los siguientes campos:

• execution_id, workflow_name y trigger_id: Encierra estos valores de cadena entre comillas dobles.
• state: Acepta un valor de estado ExecutionDetails, como FAILED o SUCCEEDED. No uses comillas (por ejemplo, state=FAILED).
• create_timestamp y update_time: Requieren una marca de tiempo RFC 3339 en UTC, que termine en Z. No uses comillas (por ejemplo, create_timestamp>=2026-10-01T00:00:00Z).

Visualiza los detalles de la ejecución de la tarea

Puedes ver registros detallados sobre la ejecución de cada tarea en una integración o subintegración. Para ver los detalles de la ejecución de la tarea, ve a la página Registros de ejecución y expande el nombre de la integración para la que deseas ver los detalles de la ejecución de la tarea.

En la página Registros de ejecución, se muestra una lista de registros de ejecución de la integración. Cada registro de ejecución corresponde a una ejecución específica de la integración.

• Para ver los detalles de ejecución de una tarea específica, haz clic en el nombre de la tarea. Aparecerá el panel Detalles de la ejecución de la tarea con los detalles de la ejecución de la tarea.
  Punto clave: El panel Detalles de ejecución de la tarea muestra los valores completos y sin truncar de las variables de la tarea, lo que te permite depurar de forma eficaz.
  
• Para ver los parámetros de solicitud y respuesta de la tarea, haz clic en Parámetros de solicitud o Parámetros de respuesta.

  

• Para ver los registros de ejecución de una subintegración, expande el nombre de la tarea y haz clic en el nombre de la subintegración. Esto se aplica a la tarea Integración de llamadas, la tarea En paralelo, la tarea Para cada bucle y la tarea Bucle While.

Filter logs

Puedes filtrar los registros según criterios como el nombre de la integración, el ID de la ejecución, el intervalo de fecha o de tiempo, el estado de ejecución, el tipo de variable y el nombre o valor de la variable. Para agregar un filtro para las ejecuciones de casos de prueba, usa el siguiente formato:

Integration name:INTEGRATION_NAME:TEST_CASE_NAME

Reemplaza lo siguiente:

• INTEGRATION_NAME: Es el nombre de la integración que contiene pruebas funcionales.
• TEST_CASE_NAME: Es el nombre del caso de prueba para el que deseas enumerar las ejecuciones de prueba.

Ejemplo: Integration name:example-integration-name:example-test-case.

Usa registros para solucionar problemas

En la siguiente sección, se explica cómo solucionar fallas en los siguientes casos de uso:

• Soluciona problemas de fallas de integración
• Visualiza las excepciones de seguimiento de pila
• Fallas del conector de seguimiento

Soluciona problemas de fallas de integración

Los mensajes del registro de ejecución pueden ser recursos valiosos para solucionar problemas de ejecución de integraciones fallidas.

Por ejemplo, si una integración no se ejecutó en un período específico, sigue estos pasos para acceder y filtrar los registros y solucionar problemas de fallas:

1. Busca o selecciona la integración para solucionar problemas de la lista Integraciones y haz clic a fin de abrir el editor de integración.
2. Haz clic en Registros en la barra de herramientas del editor de integración para ver los mensajes de registro.
3. En el campo Filtro de registro de ejecución, selecciona Nombre de la integración y, luego, ingresa el nombre de la integración cuyos registros deseas ver.
4. Haz clic en Ingresar.
5. Para mostrar las integraciones con errores, en el campo Filtro de registro de ejecución, selecciona Estado de ejecución para mostrar la lista de estados y, luego, selecciona Con errores.
6. Para mostrar las integraciones con errores entre un período específico, en el campo Filtro de registro de ejecución, selecciona Fecha de inicio posterior al y, luego, ingresa la hora deseada en el formato válido. Luego, selecciona Fecha de finalización anterior al y, luego, ingresa la hora deseada. Varios filtros se combinan con la condición Y de forma predeterminada.

Si la integración falló durante el período filtrado, la página Registros de ejecución mostrará una lista de mensajes de registro. Cada mensaje de registro corresponde a una ejecución con errores específica de la integración.

Para obtener información sobre cómo solucionar problemas de registros de ejecución con errores con IA, consulta Soluciona problemas de registros de ejecución con errores con IA.

Visualiza las excepciones de seguimiento de pila

Para ver la lista de excepciones, haz clic en cualquier mensaje de registro. Haz clic en los vínculos de cada mensaje de excepción para ver el seguimiento de pila completo de la excepción.

Nota: Los parámetros del evento de mensaje de registro de ejecución (string o JSON) se truncan con un límite de 2,000 caracteres.

Fallas del conector de seguimiento

Puedes usar los mensajes de registro de ejecución para solucionar problemas y realizar un seguimiento de las ejecuciones de tareas de conectores con errores. Los datos de registro de una tarea de conector con errores se almacenan con Cloud Logging y se pueden ver en el Explorador de registros.

Nota: Los datos de registro de una tarea de conectores con errores solo están disponibles en el Explorador de registros si Cloud Logging está habilitado para la conexión correspondiente en Integration Connectors. Consulta Visualiza los registros del conector para obtener más detalles.

Sigue estos pasos para acceder a los datos de registro de una tarea de conector con errores desde Application Integration:

1. Ve a la página Registros de ejecución de la integración que desees.
2. Expande el mensaje de registro de la ejecución con errores y realiza un seguimiento de pila hasta la fila que contiene la tarea de conectores con errores.
3. En la columna Estado, haz clic en Con errores.

   

Application Integration ejecuta automáticamente la consulta requerida para la tarea de conectores con errores y abre la página Explorador de registros para mostrar los datos detallados del registro de ejecución.

Para recuperar de forma manual los datos de registro de una tarea de conectores con errores, puedes ejecutar la siguiente consulta en la página Consulta del Explorador de registros. Para obtener más información sobre cómo usar el Explorador de registros, consulta Interfaz del Explorador de registros.

Formato de consulta

resource.type="connectors.googleapis.com/Connection"
jsonPayload.integration_connectors_trace_id="EXECUTION_ID_EXECUTION_TASK_ID_EXECUTION_ATTEMPT_NUMBER"

Ejemplo

resource.type="connectors.googleapis.com/Connection"
jsonPayload.integration_connectors_trace_id="9db51e4b-7d57-473d-931f-cc27b282dfad_1_2"

Descargar registros

Puedes descargar los registros de una ejecución de integración específica para ayudar con la depuración y el análisis. Los registros contienen información detallada sobre el proceso de ejecución, incluidas las marcas de tiempo, los eventos y los errores que se encontraron.

Para descargar los registros de ejecución de una integración, sigue estos pasos:

1. Ve a la página Registros de ejecución.
2. En la fila correspondiente a la ejecución de la integración para la que deseas descargar los registros, haz clic en (menú de acciones) y, luego, selecciona Descargar.

Los registros de ejecución se descargan como un archivo JSON en la carpeta de descargas predeterminada de tu navegador.

Limitación

• Si el registro local está inhabilitado para una integración, los registros de ejecución no se generan para esa integración.

¿Qué sigue?

• Para obtener más información sobre los registros en Application Integration, consulta Introducción a los registros.
• Obtén más información sobre los casos de prueba.