Skip to main content
Last updated on

Troubleshoot Google Analytics ingestion

This page describes common issues with the Google Analytics Raw Data connector in Databricks Lakeflow Connect and how to resolve them.

General pipeline troubleshooting​

If a pipeline fails while executing, click on the step that failed and confirm whether the error message provides sufficient information about the nature of the error.

View pipeline event logs in the UI

You can also check and download the cluster logs from the pipeline details page by clicking Update details in the right-hand panel, then Logs. Scan the logs for errors or exceptions.

View pipeline update details in the UI

Network connectivity and DNS resolution failures​

Error:

java.net.UnknownHostException: bigquery.googleapis.com

or

Failed to connect to Google APIs: Connection refused

Cause:

These errors typically indicate that network policies are preventing the connector from resolving or reaching Google API domains. This commonly occurs when using a security egress gateway without proper allowlist configuration.

Resolution:

Add the following Google API domains to your network policy allowlist:

  • bigquery.googleapis.com
  • oauth2.googleapis.com
  • bigquerystorage.googleapis.com
  • googleapis.com

For more information, see Manage network policies for serverless egress control.