Consulta los conectores compatibles con Application Integration.

Visualiza los registros de ejecución

Application Integration genera mensajes de registro para cada ejecución de una integración. Los mensajes de registro contienen información que puede ser útil a la hora de determinar el estado de cada paso de una integración o solucionar problemas de una integración, una tarea o un evento con errores. 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

Para ver la página Registros de ejecución, selecciona una de las opciones:

Console

1. En Application Integration, ve a la página Registros.

   Ir a Registros de Application Integration

2. En el menú de navegación, haz clic en Registros. Como alternativa, en el menú de navegación, haz clic en Integración y selecciona la integración cuyos registros deseas ver. Luego, haz clic en Ver registros de ejecución de esta integración. Aparecerá la página Registros de ejecución.
   Nota: Si el tamaño de los registros de ejecución es superior a 300 MB, la integración de aplicaciones 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 de la API.
3. En la lista Región, selecciona la región para ver los registros de ejecución específicos de la región de la integración. También puedes hacer clic en 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 la integración de aplicaciones.

   

   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 como Inhabilitado.
   • Se volvió a reproducir desde: Si se vuelve a reproducir la ejecución de 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 Cómo volver a reproducir ejecuciones.

4. En el campo Filtro, agrega filtros. 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 obtener una búsqueda más personalizada, usa el método projects.locations.integrations.executions.list como se explica en la pestaña de la API.

   Si deseas 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 las pruebas funcionales.
   • TEST_CASE_NAME: Es el nombre del caso de prueba para el que deseas enumerar las ejecuciones de prueba.

   Por ejemplo, Integration name:example-integration-name:example-test-case.

API

Si el tamaño de los registros de ejecución supera los 300 MB, Application Integration arroja el error Response too large error y los registros no se cargan en la página Execution Logs. 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 -G GET
       -H "Content-Type: application/json"
       -H "Authorization: Bearer $(gcloud auth print-access-token)"
       -d 'snapshotMetadataWithoutParams=true'
       'https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/integrations/INTEGRATION_NAME/executions'
   

   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 POST 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 -v -X -G GET 
       -H "Content-Type: application/json"
       -H "Authorization: Bearer $(gcloud auth print-access-token)"
       -d 'filter=execution_id="EXECUTION_ID"'
       'https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/integrations/INTEGRATION_NAME/executions'
   

   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 esperadas para una integración, usa el siguiente formato:

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

Usa registros para solucionar problemas

En la siguiente sección, se explica cómo solucionar problemas con el registro de ejecución de Application Integration.

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 que fallaron, en el campo Filtro de registro de ejecución, selecciona Estado de ejecución para mostrar la lista de estado y, luego, selecciona Falló.
6. Para mostrar las integraciones fallidas entre un intervalo de tiempo específico, en el campo Filtro del registro de ejecución, selecciona Fecha de inicio después de y, luego, ingresa la hora deseada en el formato válido. Luego, selecciona Fecha de finalización antes 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 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 que falló están disponibles en el Visor de registros solo si Cloud Logging está habilitado para la conexión respectiva en los conectores de integración. Consulta Cómo ver los registros del conector para obtener más información.

Sigue estos pasos para acceder a los datos de registro de una tarea de conector que falló desde la integración de aplicaciones:

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

   

Application Integration ejecuta automáticamente la consulta necesaria 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 manualmente 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"

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 información sobre los casos de prueba.