See the supported connectors for Application Integration.

View logs in Cloud Logging

This page describes how to enable Cloud Logging for an integration, view logs in Cloud Logging, and some sample queries to view integration logs in Cloud Logging.

Overview

In Cloud Logging, you can view the Integration execution logs containing integration details, such as status, performance, integration version, request and response parameters, and the trigger and task configurations. For more information about execution logs in Cloud Logging, see Integration execution logs in Cloud Logging. For information about limitations and pricing, see Limitations and Pricing.

By default, Cloud Logging is disabled for integrations. You can enable logging for an integration by editing the unpublished version of the integration.

Enable Cloud Logging

To store integration execution logs in Cloud Logging, you must first enable Cloud Logging for your integration. To do so, follow these steps:

  1. In the Google Cloud console, go to the Application Integration page.

    Go to Application Integration

  2. In the navigation menu, click Integrations.

    The Integrations page appears listing all the integrations available in the Google Cloud project.

  3. Select an existing integration or create a new integration for which you want to enable Cloud Logging.

    This opens the integration in the integration editor.

  4. Select the DRAFT version of your integration. You can't modify the settings for a published or an unpublished version that isn't in the draft mode. For a list of integration versions, see Versions.
  5. Click (Integration summary) in the designer toolbar. The integration summary page appears.
    1. In the Log settings, click the Enable Cloud Logging toggle and then from the Severity list, select the severity type of the logs that you want to store in Cloud Logging:
      • Info: Select this option to capture all execution statuses: SUCCEEDED, FAILED, PROCESSING, PENDING, SUSPENDED, RETRY_ON_HOLD, and CANCELLED.
      • Error: Select this option to capture the following execution statuses: FAILED and CANCELLED.
      • Warning: Select this option to capture the following execution statuses: FAILED and CANCELLED.

        • For a list of integration execution states, see Execution states.

    2. Click Save.

View logs

To view logs in Cloud Logging, you must first enable Cloud Logging and then follow these steps:

  1. In the Google Cloud console, go to the Application Integration page.

    Go to Application Integration

  2. To view the integration execution logs in Cloud Logging, use one of the following methods:
    • In the navigation menu, click Logs, and then, click View Cloud Logs.
    • In the Integration editor, after you test an integration, in the Test integration dialog, click View Cloud Logs.

    The Logs Explorer page appears. Logs are displayed for the last three hours for the following default query: 

    resource.type=integrations.googleapis.com/IntegrationVersion

    3. To understand the log format of Application Integration logs, see the log_entries payload.

Sample queries

You can use the following queries to view logs in Cloud Logging:

  • To view all integration execution logs:

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

  • You can view integration execution logs for a specific execution ID:

    • Searches only the parents executions with the given execution ID: 
          resource.type="integrations.googleapis.com/IntegrationVersion"
    jsonPayload.executionId="EXECUTION_ID"
    • Searches for both parent and child executions launched from the given execution ID: 
          resource.type="integrations.googleapis.com/IntegrationVersion"
    "EXECUTION_ID"

  • To view integration execution logs for a specific integration:

        resource.type="integrations.googleapis.com/IntegrationVersion" 
    "INTEGRATION_NAME"
    Or 
        resource.type="integrations.googleapis.com/IntegrationVersion"
    jsonPayload.integration="INTEGRATION_NAME"

  • To view failed integration executions for a specific integration:

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

  • To view logs with specific request param name. For example, the following query requests logs for the requestUrl parameter:

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

    • For more sample queries, see Cloud Logging sample queries.

Limitations

Integration logs in Cloud Logging are subject to the following limitations:

  • Cloud Logging only supports log entries that are up to 256 KiB in size. If your logs exceed this limit, the request and response parameters are not shown in the logging details. For information about Cloud Logging quotas and limits, see Quotas and limits. To resolve this error, update the integration variables so that the value doesn't exceed the limit. Alternatively, you can also view these logs in Application Integration.
  • If local logging is disabled, the execution logs are not sent to Cloud Logging even if Cloud Logging is enabled.

Pricing

For information about pricing for Cloud Logging, see Cloud Logging pricing.

What's next