Skip to main content
Community Hub

Troubleshooting Looker connectivity

TL;DR

Learn about troubleshooting looker connectivity.

Your AI can read this via Docs MCPcurl -fsSL "https://docs.atlan.com/install-docs-mcp" | bashConnect

What are known limitations of Looker connector?​

Following are the known limitations of the Looker connector:

  • Persistent derived tables (PDTs) and Liquid parameterized tables are currently not supported for Looker views.

What is timeframe for calculating sourceViewCount for Looks and dashboards?​

The Atlan property sourceViewCount is based on the source property view_count:

  • view_count displays a total count of views for a Look or dashboard since creation of the asset.
  • Atlan currently doesn't support a timestamp for views due to limitations of the Looker APIs.

Why do I get 403 forbidden error after clicking test authentication button?​

If you receive a 403 forbidden error when testing authentication, confirm the following:

  • Verify you have provided the API host URL for Looker. (This may be different from the Looker instance URL.)
  • Verify your Looker instance is running on port 433. If not, add the port number explicitly to the URL.
  • Verify your client ID and secret are correct.
  • Verify you have allowlisted the Atlan IP in your Looker instance. (To get details of your Atlan IP, please raise a support ticket.)

Once you have confirmed or corrected these, retry the authentication.

Why is lineage missing from explore to tile or look?​

If lineage is missing from an Explore to a Tile or Look, this is usually because you haven't given content access to a folder.

Once you have corrected the access in Looker, rerun the Looker crawler in Atlan.

Why is lineage missing between data sources and Looker assets?​

If lineage is missing from data sources to Looker assets, confirm the following:

  • Verify you have given the see_sql permission to the role for which you generated the API3 credentials.
  • Verify you have crawled the data sources' assets in Atlan, before crawling the Looker assets.

Once you have confirmed or corrected these, rerun the Looker crawler in Atlan.

Why is lineage missing on models?​

Models don't appear in lineage. A model is a container that groups explores, similar to a project or a folder. To trace lineage from tables to Looker assets, open one of the model's explores or views. The model's asset page lists its explores under related assets.

Why is relationship missing between models and explores?​

An explore links to its model when the model exists on the Looker instance and its project is included in the crawl. Two cases produce an explore with a model name but no model link:

  • The explore is declared in a view file instead of a model file, so no deployed model exposes it.
  • The model file exists in the Git repository but the model isn't deployed in Looker.

If the model's project is excluded by the crawler's project filters, correct the filters and rerun the Looker crawler in Atlan.

Can I use deploy keys for setup?​

Deploy keys only grant access to a single repository. For more complex projects where Looker connects to multiple repositories, Atlan doesn't support using deploy keys.

Why am I seeing failed to clone project error?​

Exception: ('Failed to clone project %s. Git URL: %s', '<project>', '<git_url>')

If you encounter this error, verify that the SSH key you’re using has access to all the GitHub project files included for crawling. Refer to the Looker setup documentation to learn more.