Consulta los conectores compatibles con Application Integration.

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 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 Google Cloud consola, 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, en la que se enumeran 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 registrarse 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.
   • Se volvió a ejecutar desde: Si se vuelve a ejecutar la integración, este campo proporciona el ID de ejecución de la ejecución que se volvió a ejecutar. Puedes volver a ejecutar una 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 ejecutar una integración si falló debido a un error de tiempo de espera o si el resultado no es el esperado. Para obtener información sobre cómo repetir ejecuciones, consulta Repetición de 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 forma opcional, puedes hacer clic en refresh Actualizar registros para volver a cargar la lista de registros actual.

   En la siguiente imagen, se muestra 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' \
       -d 'filter=executionId=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 copiaste en el paso anterior.

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

   Como alternativa, en la Google Cloud consola, 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 esperadas para una integración, 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' \
    -d 'filter=workflowName!=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.

Cómo ver 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 los 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 ejecución de la tarea, en el que se mostrarán los detalles de la ejecución de la tarea.
  Concepto principal: En el panel Detalles de ejecución de la tarea, se muestran los valores completos y sin truncar de las variables de la tarea, lo que te permite depurar de manera 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 de integración de llamadas, la tarea de bucle For Each paralelo, la tarea de bucle For Each y la tarea de 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 fallidas, en el campo Filtro de registro de ejecución, selecciona Estado de ejecución para mostrar la lista de estado y, luego, selecciona Fallido.
6. Para mostrar las integraciones fallidas entre un período específico, en el campo Filtro de registro de ejecución, selecciona Fecha de inicio posterior a y, luego, ingresa la hora deseada en el formato válido. Luego, selecciona Fecha de finalización anterior a y, luego, ingresa la hora deseada. Varios filtros se combinan mediante 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.

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 fallida se almacenan con Cloud Logging y se pueden ver en el Explorador de registros.

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

Sigue estos pasos para acceder a los datos de registro de una tarea de conector fallida 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 fallida y el seguimiento de pila hasta la fila que contiene la tarea de conectores fallida.
3. En la columna Estado, haz clic en Falló.

   

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

Para recuperar manualmente los datos de registro de una tarea de conectores fallida, 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 registros de una ejecución de integración específica para facilitar la depuración y el análisis. Los registros contienen información detallada sobre el proceso de ejecución, incluidas marcas de tiempo, eventos y cualquier error que se haya encontrado.

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 descarga predeterminada del 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 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.