Understanding Object Lineage

Introduced in v6.2.5, Lineage helps understand how objects relate to each other in Metric Insights.

Through the interactive diagram, a user can track the hierarchy and interrelationship between Objects, including deleted ones, both upstream and downstream. Each node (item) in the diagram includes more details and allows actions to be performed on it.

Lineage is available on all key objects:

  • Elements, both Viewers and Editors, and the Elements List
  • Datasets, both Viewer and Editor, and the Datasets List
  • Data Source Editor and Data Sources list
  • User Maps, both Viewer and Editor, and User Maps List
  • Burst Editor and Burst List

Search results will also display links to Lineage, whenever relevant.


  • Legacy Reports support Lineage, which provides a convenient way to make decisions on the importance of a given Legacy Report for an organization. This is essential since Metric Insights stops support for Legacy Reports in 2022. Learn more.
  • Collection and storage of Snowflake metadata is now available. This allows for tracking of Object relations outside Metric Insights and reflecting them in Lineage. 


  • The user is able to see all elements and objects that are available on the diagram regardless of the assigned Permissions; however, users are only able to fully view or edit a given object if they have the necessary permissions or in case they created that object.
  • If Certification Levels are enabled, they will be visible in the action menu.

To allow Regular and Power Users to access the Lineage feature, the Show Lineage Icon in Search and on Viewers Privilege must be granted.  For more information, see Lineage Security.

Accessing Lineage

Using its special icon, Lineage can be accessed from all key Viewers, Editors, and List pages as well as Search results. The example above shows Data Source List page.

Understanding Lineage Diagram

  1. Each item on the Diagram represents either Parent or Child Node.
    • Child Nodes in turn can be a Parent to other Nodes.
  2. The bottom left includes basic controls: Larger, Smaller, Fit to Window, Reset Zoom.
  3. The collapsible menu on the lower right includes View Settings and Legend.

Action Menu

An Action menu appears upon clicking a Node. Depending on the type of Object, its settings, and its place in the hierarchy, the Action menu can include information and options described below. The example is a certified Metric.

  1. Key Details:
    • Object type (icon) and its name
    • Object Description
    • Ownership
    • Certification info: the certifier and date of certification
    • Available Tags, including Governed Tags
    • Engagement: Object views
  2. Collapse/Expand Child Nodes: show/hide child Nodes
  3. Collapse/Expand This Node: group/ungroup Nodes of same type and from same parent (displayed if there are multiple Nodes of the same type that belong to one parent)
  4. Focus This Node: set the Node as a starting point
  5. Edit: open Editor
  6. View: open Viewer