Observa los registros en Cloud Logging

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 las configuraciones de activadores y tareas. Para obtener más información sobre los registros de ejecución en Cloud Logging, consulta Registros de ejecución de la 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 de una integración editando la versión no publicada de la integración.

Antes de comenzar

Para almacenar registros de ejecución de la 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, en la que se enumeran todas las integraciones disponibles en el proyecto Google Cloud .

  3. Selecciona una integración existente o crea una nueva para la que quieras 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 (Resumen de la integración) 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 deseas almacenar en Cloud Logging:
      • Info: 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 la 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 menú de navegación, haz clic en Registros y, luego, en el campo Cloud Logging, haz clic en Ver. 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.
    • En el editor de integración, después de probar una integración, haz clic en Ver registros de Cloud en el panel Probar integración.

    Aparecerá la página Explorador de registros. Los registros se muestran durante 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 la integración, haz lo siguiente:

        resource.type="integrations.googleapis.com/IntegrationVersion"

  • Puedes ver los registros de ejecución de integración para un ID de ejecución específico:

    • Solo busca las ejecuciones principales con el ID de ejecución determinado: 
          resource.type="integrations.googleapis.com/IntegrationVersion"
    jsonPayload.executionId="EXECUTION_ID"
    • Se buscan las ejecuciones tanto principales como secundarias que se iniciaron desde el ID de ejecución determinado: 
          resource.type="integrations.googleapis.com/IntegrationVersion"
    "EXECUTION_ID"

  • Para ver los registros de ejecució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"

  • Para ver las ejecuciones de integración fallidas de una integración específica, haz lo siguiente:

        resource.type="integrations.googleapis.com/IntegrationVersion"
    jsonPayload.integrationExecutionDetails.integrationExecutionState="FAILED"
    jsonPayload.integration="INTEGRATION_NAME"

  • Para ver los 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 ejemplos de consultas, consulta Ejemplos de consultas 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 de hasta 256 KiB. Si tus registros superan este límite, los parámetros de solicitud y respuesta no se mostrarán en los detalles del registro. Para obtener información sobre las cuotas y los límites de Cloud Logging, consulta Cuotas y límites. Para resolver este error, actualiza las variables de integración de modo que el valor no exceda 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?