For the complete documentation index, see llms.txt. This page is also available as Markdown.

Looker Integration Discovered Resources

Overview

The Looker integration discovers the following resources:

  • Looker Instance

  • Looker Model

  • LookML Explore

  • LookML View

  • Looker Dimension

  • Looker Measure

  • Looker Folder

  • Looker Look

  • Looker Tile

  • Looker Dashboard

  • Table

  • User (when Observe users is enabled)

  • User Group (when Observe groups is enabled)

Note: We don't observe built-in looker models i__looker and system__activity

Looker Instance

The top-level container for a Looker deployment.

Property
Description

name

The Looker host URL for the instance.

type

looker_instance

Looker Model

A LookML model defines the database connection and the explores it exposes.

Property
Description

name

The name of the LookML model.

type

looker_model

parent_container

The Looker instance containing the model.

Looker Folder

Properties

Property
Description

name

The name of the folder.

type

looker_folder

native_id

The ID of the folder in Looker's API.

parent_container

The parent folder, or the Looker instance for root folders.

created_at

The date the folder was created in Looker.

created_by

The email of the user that created the folder.

LookML: Views & Explores

Property
Description
Applicable to

name

The title of the LookML file.

View, Explore

type

looker_view or looker_explore.

View, Explore

description

The resource description from LookML.

View, Explore

sql_dialect

The SQL dialect of the Looker connection for this model.

View, Explore

looker_project_name

The name of the LookML Git project containing the model.

View, Explore

looker_model

The name of the LookML model (display name; the parent resource type is looker_model).

View, Explore

parent_container

The LookML model (looker_model) containing the view or explore.

View, Explore

is_derived

Whether the view is derived.

View

derived_type

The type of derived view: sql_derived_view or native_derived_view. Null for non-derived views.

View

has_refinements

Whether the view includes refinements.

View

looker_refinement_chain

File locations of refinements applied to the view.

View

generated_by_euno

true when the resource was generated by Euno (detected from LookML comments).

View, Explore

pdt_builds_last_30d

Total number of PDT builds in the last 30 days.

View

pdt_total_build_time_30d

Cumulative build time for PDTs in the last 30 days.

View

lookml_view_persistency

Persistency for PDTs: sql_trigger, datagroup_trigger, interval_trigger, or materialized_view.

View

git_repo_url

The URL of the associated Git repository.

View, Explore

git_repo_branch

The branch of the Git repository being used.

View, Explore

total_queries_14d, total_queries_30d, total_queries_60d

Query counts over the last 14/30/60 days from the Looker API (includes cached queries).

View, Explore

distinct_users_14d, distinct_users_30d, distinct_users_60d

Distinct users querying the resource over the last 14/30/60 days. User-level breakdown is available in the side panel and Euno Assistant, but not via EQL.

View, Explore

source_path

Full file path (for example, models/sales/orders.view.lkml).

View, Explore

source_directory

Directory path of the resource in your Git repository.

View, Explore

table_dependencies

Upstream resources referenced by this resource. Views typically list tables, other views, explores, or dbt metrics; explores list base/join views and extended explores.

View, Explore

LookML Refinements

Euno discovers refinement files; however, unlike regular views, refinement files do not constitute resources themselves. Instead, Euno includes the refinement information in the view that it refines. For views with refinements, the property has_refinements will be set to true. Additionally, in the About tab of the refined resource's side panel, the property looker_refinement_chain is displayed, indicating the file locations of the refinement files that refine the resource. When viewing the code of the refined resource, it includes the dimensions and measures from the refinement file as if it were compiled.

Currently Euno does not support the discovery of refinement files for LookML Explores.

Looker data visualizations: Looker Look, Looker Tile and Looker Dashboards

The term "Looker Tile" is used to describe a visualization in a Looker Dashboard that is not a reference to a Looker Look.

In Looker, a dashboard is made up of dashboard elements. Some dashboard elements are data visualizations, which can either reference a Looker Look, or a visualization that "lives" inside the dashboard. Looker documentation uses the terms lookless and tile to describe the latter type of visualization. Euno uses the more commonly used term tile.

Property
Description
Applicable to

name

The title of the visualization.

Look, Tile, Dashboard

type

looker_look, looker_tile, or looker_dashboard.

Look, Tile, Dashboard

description

The description of the resource.

Look, Dashboard

sql_dialect

The SQL dialect of the query powering the visualization.

Look, Tile

looker_model

The name of the LookML model powering the visualization.

Look, Tile

looker_project_name

The name of the LookML project containing the model.

Look, Tile

looker_folder

The name of the Looker folder the item is found within.

Look, Dashboard

created_at

The date the resource was created in Looker.

Look, Tile, Dashboard

updated_at

For tiles, includes updates to the tile or the dashboard containing it.

Look, Tile, Dashboard

native_id

The ID of the look, tile, or dashboard in Looker.

Look, Tile, Dashboard

created_by

The display name of the Looker user that created the Look.

Look

updated_by

The display name of the Looker user that last updated the Look.

Look

owner

The display name of the dashboard owner (derived from native_owners).

Dashboard

parent_container

For Looks, the containing folder. For tiles, the containing dashboard. For dashboards, the containing folder.

Look, Tile, Dashboard

last_7d_views, last_30d_views

Impression counts over the last 7 or 30 days.

Look, Dashboard

last_viewed_at

The last impression time.

Look, Dashboard

total_queries_14d, total_queries_30d, total_queries_60d

Query counts over the last 14/30/60 days from the Looker API (includes cached queries).

Look, Tile, Dashboard

distinct_users_14d, distinct_users_30d, distinct_users_60d

Distinct users over the last 14/30/60 days. User-level breakdown is available in the side panel and Euno Assistant, but not via EQL.

Look, Tile, Dashboard

table_dependencies

Upstream explores for looks and tiles. For dashboards, the contained tiles and looks.

Look, Tile, Dashboard

upstream_fields

Explore fields (looker_dimension, looker_measure) used by the look or tile query, including selected fields, filters, and sorts. Used LookML fields remain children of the explore (or view), not of the visualization. Dashboards do not have upstream_fields.

Look, Tile

LookML and Looker Measures and Dimensions

Euno observes fields in both LookML files (views and explores) and visualizations (looks and tiles). LookML fields used by a look or tile stay parented to the explore or view; the visualization links to them with upstream_fields so column-level lineage can connect explore fields to the look or tile. For visualizations, Looker may also make use of Custom Fields. Euno observes each custom field as a child of the look or tile, in the same manner as a LookML measure or dimension. A custom measure, including a filtered custom measure, is observed with the type looker_measure. A custom dimension is observed with the type looker_dimension. Looker dimension groups are also observed as dimensions with the type looker_dimension.

Property
Description

name

The name of the Looker measure or dimension.

type

looker_measure or looker_dimension.

parent_container

The URI of the view, explore, look, or tile where the field is defined.

is_calculated

true for custom fields defined in a visualization.

is_identity_transformation

true when the field directly references an existing warehouse column; false for custom fields.

has_refinements

true when the field includes LookML refinements.

generated_by_euno

true when the parent view or explore was generated by Euno.

total_queries_14d, total_queries_30d, total_queries_60d

Query counts over the last 14/30/60 days (includes cached queries).

distinct_users_14d, distinct_users_30d, distinct_users_60d

Distinct users over the last 14/30/60 days. User-level breakdown is available in the side panel and Euno Assistant, but not via EQL.

tags

Tags associated with the measure or dimension, as defined in LookML.

source_directory

Directory path of the resource in your Git repository.

source_path

Full file path (for example, models/sales/orders.view.lkml).

upstream_fields

Upstream fields (column, looker_dimension, looker_measure, dbt_column, or dbt_metric) referenced by this field. Canonical euno.ai/based_on_column and euno.ai/based_on_metric tags are always retained here, even when the referenced dbt resource is not observed by an authoritative dbt integration.

Users and Groups

When Observe users is enabled, Euno observes Looker users as user resources. When Observe groups is enabled, Euno observes Looker groups as user_group resources with members pointing to observed users.

For property details and membership relationships, see Users as a Resource.

Table

The Looker Integration will discover resources of type Table when it discovers a LookML view that refers to a database table. For example, if a LookML view is using the sql_table_name parameter, Euno will observe the referred table.

To determine the exact location of the referred table, the Looker Integration looks up the correct Looker Connection using the LookML Model's connection parameter. The Looker Connection usually has all the metadata required for Euno to uniquely determine the URI of the referred table.

In the case of a connection with dialect athena, The Looker Integration is not able to fetch from Looker's API the term "AWS account id" which is required to uniquely identify the referred tables. In this case, Euno defaults to using the aws account id default_aws_account.us_central1 . If you have multiple AWS accounts and you need to distinguish between them, set up manual "connection mapping".

Property
Description

name

The name of the table.

database_technology

The database technology, based on the connection dialect.

database

The name of the database.

schema

The name of the schema.

Relationships

Containment (has parent / has child)

Source type(s)
Relationship
Target type(s)
Notes

looker_dimension, looker_measure

has parent

looker_view, looker_explore, looker_look, looker_tile

looker_view, looker_explore

has parent

looker_model

looker_model

has parent

looker_instance

looker_folder

has parent

looker_instance, looker_folder

Root folders parent to the instance; nested folders parent to a parent folder.

looker_look, looker_dashboard

has parent

looker_folder

looker_tile

has parent

looker_dashboard

Resource lineage (has upstream / has downstream)

Downstream resources list their upstream dependencies via table_dependencies. For example, looker_view has upstream table when the view references a warehouse table.

Source type(s)
Relationship
Target type(s)
Notes

looker_view

has upstream

table, looker_view, looker_explore, dbt_metric

looker_explore

has upstream

looker_view, looker_explore

Base/join views; extends

looker_look

has upstream

looker_explore

Query explore

looker_tile

has upstream

looker_explore

Query explore

looker_dashboard

has upstream

looker_tile, looker_look

Dashboard elements

Column-level lineage (has upstream_fields / has downstream_fields)

Downstream resources list upstream fields via upstream_fields. For example, looker_measure has upstream_fields column when the measure references a warehouse column. Looks and tiles also list the explore fields they query, so lineage can connect those fields to the visualization even though the fields are not children of the look or tile.

Source type(s)
Relationship
Target type(s)
Notes

looker_dimension, looker_measure

has upstream_fields

column, looker_dimension, looker_measure, dbt_column, dbt_metric

dbt_column and dbt_metric come from canonical euno.ai/based_on_column / euno.ai/based_on_metric tags and are retained even when the dbt target is not authoritatively observed.

looker_look, looker_tile

has upstream_fields

looker_dimension, looker_measure

Fields used by the visualization query. Custom fields defined on the look or tile are children of that visualization and have their own upstream_fields. Dashboards do not emit upstream_fields.

Group membership (has group / has member)

Source type(s)
Relationship
Target type(s)
Notes

user_group

has member

user

When Observe groups is enabled

Defined-by (defines / has definer)

Source type(s)
Relationship
Target type(s)
Notes

dbt_column

defines

looker_dimension, looker_measure

Derived from euno.ai/based_on_column tags only while the referenced dbt_column exists and is authoritatively observed by a dbt integration. Looker retains the field-side tag reference but never observes or sponsors the dbt target.

dbt_metric

defines

looker_measure

Derived from euno.ai/based_on_metric tags only while the referenced dbt_metric exists and is authoritatively observed by a dbt integration. Looker retains the field-side tag reference but never observes or sponsors the dbt target.

looker_dimension

has definer

dbt_column

Inverse of dbt_column defines.

looker_measure

has definer

dbt_column, dbt_metric

Inverse of dbt defines.

Euno does not currently support column-level lineage for Looker derived views when the referenced upstream tables or columns are not observed through an authoritative source integration (such as dbt, Snowflake, BigQuery or Databricks). If the columns are only referenced in the Looker SQL and not part of an observed schema, they will not appear in lineage.

Last updated