View logs in Cloud Logging

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, seeIntegration execution logs in Cloud Logging. For information about limitations and pricing, seeLimitations andPricing.

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

Before you begin

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 theApplication Integration page.

   Go to Application Integration

2. In the navigation menu, clickIntegrations.

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

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

   This opens the integration in theintegration editor.

4. Select theDRAFT 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, seeVersions.
5. Clicksettings (Integration summary) in the designer toolbar. The integration summary page appears.
1. In theLog settings, click theEnable Cloud Logging toggle and then from theSeverity 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, andCANCELLED.
   • Error: Select this option to capture the following execution statuses:FAILED andCANCELLED.
   • Warning: Select this option to capture the following execution statuses:FAILED andCANCELLED.Note: Currently, bothError andWarning severity levels captureFAILED andCANCELLED execution states.

   For a list of integration execution states, seeExecution states.

2. ClickSave.

View logs

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

1. In the Google Cloud console, go to theApplication 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, clickLogs, and then, clickView Cloud Logs.
   • In the navigation menu, clickLogs, and then in theCloud Logging field, clickView. If Cloud Logging is enabled, this field provides a link to view logs in Cloud Logging. If Cloud Logging is not enabled, this field is set toDisabled.
   • In the Integration editor, after youtest an integration, in theTest integration pane, clickView Cloud Logs.

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

   resource.type=integrations.googleapis.com/IntegrationVersion

To understand the log format ofApplication Integration logs, see thelog_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 therequestUrl parameter:

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

For more sample queries, seeCloud 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, seeQuotas and limits. To resolve this error, update the integration variables so that the value doesn't exceed the limit. Alternatively, you can alsoview these logs in Application Integration.
• Iflocal 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, seeCloud Logging pricing.

What's next

• Learn aboutexecution logs in Cloud Logging.
• Learn how toquery and view logs.
• Learn aboutlog based metrics.
• Learn how logs are stored, routed and how you canexport to different destinations.
• Learn how tocreate alerts on log-based metrics.