Consulta los conectores compatibles con Application Integration.

Ver registros en Cloud Logging

En esta página, se describe cómo habilitar Cloud Logging para una integración, ver registros en Cloud Logging y algunas consultas de ejemplo para visualizar registros de integración en Cloud Logging.

Descripción general

En Cloud Logging, puedes ver los registros de ejecución de la integración que contienen detalles de la integración, como el estado, el rendimiento, la versión de la integración, los parámetros de solicitud y respuesta, y la configuración del activador y la tarea. Para obtener más información sobre los registros de ejecución en Cloud Logging, consulta Registros de ejecución de integración en Cloud Logging. Para obtener información sobre las limitaciones y los precios, consulta Limitaciones y Precios.

De forma predeterminada, Cloud Logging está inhabilitado para las integraciones. Puedes habilitar el registro para una integración si editas la versión no publicada de la integración.

Habilitar Cloud Logging

Si quieres almacenar registros de ejecución de integración en Cloud Logging, primero debes habilitar Cloud Logging para tu integración. Para hacerlo, 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 Integraciones.

    Aparecerá la página Integraciones con una lista de todas las integraciones disponibles en el proyecto de Google Cloud.

  3. Selecciona una integración existente o crea una nueva para la que desees habilitar Cloud Logging.

    Esto abrirá la integración en la página del editor de integración.

  4. Selecciona la versión DRAFT de tu integración. No puedes modificar la configuración de una versión publicada o no publicada que no esté en modo de borrador. Para obtener una lista de las versiones de integración, consulta Versiones.
  5. Haz clic en (Integration summary) en la barra de herramientas del diseñador. Aparecerá la página de resumen de la integración.
    1. En Configuración de registros, haz clic en el botón de activación Habilitar Cloud Logging y, luego, en la lista Gravedad, selecciona el tipo de gravedad de los registros que quieres almacenar en Cloud Logging:
      • Información: Selecciona esta opción para capturar todos los estados de ejecución: SUCCEEDED, FAILED, PROCESSING, PENDING, SUSPENDED, RETRY_ON_HOLD y CANCELLED.
      • Error: Selecciona esta opción para capturar los siguientes estados de ejecución: FAILED y CANCELLED.
      • Advertencia: Selecciona esta opción para capturar los siguientes estados de ejecución: FAILED y CANCELLED.
      • Para obtener una lista de los estados de ejecución de la integración, consulta Estados de ejecución.

    2. Haz clic en Guardar.

Ver registros

Para ver los registros en Cloud Logging, primero debes habilitar Cloud Logging y, luego, seguir estos pasos:

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

    Ir a Application Integration

  2. Para ver los registros de ejecución de integración en Cloud Logging, usa uno de los siguientes métodos:
    • En el menú de navegación, haz clic en Registros y, luego, en Ver registros de Cloud.
    • En el Editor de integraciones, después de probar una integración, en el panel Probar integración, haz clic en Ver registros de Cloud.

    Aparecerá la página Explorador de registros. Se muestran los registros de las últimas tres horas para la siguiente consulta predeterminada:

    resource.type=integrations.googleapis.com/IntegrationVersion

  3. Para comprender el formato de registro de los registros de Application Integration, consulta la carga útil de log_entries.

Consultas de muestra

Puedes usar las siguientes consultas para ver los registros en Cloud Logging:

  • Para ver todos los registros de ejecución de integración, haz lo siguiente:

        resource.type="integrations.googleapis.com/IntegrationVersion"
            
  • Puedes ver los registros de ejecución de integración de un ID de ejecución específico:

    • Busca solo las ejecuciones superiores con el ID de ejecución proporcionado:
          resource.type="integrations.googleapis.com/IntegrationVersion"
          jsonPayload.executionId="EXECUTION_ID"
              
    • Busca ejecuciones superiores y secundarias que se iniciaron a partir del ID de ejecución determinado:
          resource.type="integrations.googleapis.com/IntegrationVersion"
          "EXECUTION_ID"
          
      .
  • Para ver los registros de ejecución de integración de una integración específica, sigue estos pasos:

        resource.type="integrations.googleapis.com/IntegrationVersion" 
        "INTEGRATION_NAME"
    O
        resource.type="integrations.googleapis.com/IntegrationVersion"
        jsonPayload.integration="INTEGRATION_NAME"
        
  • Sigue estos pasos para ver las ejecuciones de integraciones con errores de una integración específica:

        resource.type="integrations.googleapis.com/IntegrationVersion"
        jsonPayload.integrationExecutionDetails.integrationExecutionState="FAILED"
        jsonPayload.integration="INTEGRATION_NAME"
        
  • Para ver registros con un nombre de parámetro de solicitud específico. Por ejemplo, la siguiente consulta solicita registros para el parámetro requestUrl:

        resource.type="integrations.googleapis.com/IntegrationVersion"
        "requestUrl"
  • Para obtener más consultas de muestra, revisa Consultas de muestra de Cloud Logging.

Limitaciones

Los registros de integración en Cloud Logging están sujetos a las siguientes limitaciones:

  • Cloud Logging solo admite entradas de registro que tengan un tamaño de hasta 256 KiB. Si tus registros superan este límite, los parámetros de solicitud y respuesta no se muestran en los detalles de registro. Para obtener información sobre las cuotas y los límites de Cloud Logging, consulta Cuotas y límites. Si quieres corregir este error, actualiza las variables de integración para que el valor no supere el límite. Como alternativa, también puedes ver estos registros en Application Integration.
  • Si el registro local está inhabilitado, los registros de ejecución no se envían a Cloud Logging, incluso si Cloud Logging está habilitado.

Precios

Para obtener información sobre los precios de Cloud Logging, consulta Precios de Cloud Logging.

¿Qué sigue?