{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["availability","callout","img","faq","faq-item","partial"]},"redocly_category":"General","type":"markdown","userRole":"Users, Editors, and Admins","accountType":"All accounts","plan":"All subscription plans"},"seo":{"title":"Explore data lineage","description":"Trace a metric back to its source, or see what depends on a dataset or column before you change it.","siteUrl":"https://help.databox.com","llmstxt":{"title":"Databox Knowledge Base","description":"Databox is a business analytics platform that consolidates data in one place, enabling real-time performance tracking and insights by mixing and matching data from various sources for a comprehensive view.","details":{"content":"This knowledge base covers everything from account setup and integrations to building Databoards, creating custom metrics, and using AI-powered features."},"sections":[{"title":"General","includeFiles":["docs/general/*.md","docs/general/visualization-types/*.md","docs/general/templates/*.md"]},{"title":"AI","includeFiles":["docs/ai/*.md"]},{"title":"Account Management","includeFiles":["docs/account-management/**/*.md"]},{"title":"Databoards","includeFiles":["docs/databoards/**/*.md"]},{"title":"Data Management","includeFiles":["docs/data-management/**/*.md"]},{"title":"Metrics","includeFiles":["docs/metrics/**/*.md"]},{"title":"Goals","includeFiles":["docs/goals/*.md"]},{"title":"Reports","includeFiles":["docs/reports/*.md"]},{"title":"Notifications","includeFiles":["docs/notifications/*.md"]},{"title":"Pricing and Billing","includeFiles":["docs/pricing-and-billing/*.md"]},{"title":"Mobile","includeFiles":["docs/mobile/*.md"]},{"title":"Support","includeFiles":["docs/support/*.md"]},{"title":"Company","includeFiles":["docs/company/*.md"]},{"title":"Integrations","includeFiles":["docs/integrations/**/*.md"]}]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"explore-data-lineage","__idx":0},"children":["Explore data lineage"]},{"$$mdtype":"Tag","name":"Availability","attributes":{"users":"users","accounts":"all","plans":"all"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["As an account grows, it gets harder to answer two questions with confidence: \"where does this number actually come from?\" and \"what else will break if I change this dataset or column?\" Without a way to see the path data takes, both require digging through datasets, merged datasets, and metric definitions by hand."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The lineage explorer maps that path for you. Starting from any dataset or metric, it draws a graph of everything upstream (what it's built from) and downstream (what's built on top of it) — data sources, datasets, merged datasets, and metrics — so you can trace a value to its source or check the downstream impact of a change before you make it."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"open-the-lineage-explorer","__idx":1},"children":["Open the lineage explorer"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["From a dataset"]}]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Go to ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://app.databox.com/data-manager/datasets"},"children":["Data Manager > Datasets"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Find the dataset you want to trace and click the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["drop-down arrow"]}," (",{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/chevron-down.929b2744de04a93191d6d985439945494abf6248d02439c1d23f78b03eaf9a2d.419bb737.svg","alt":"chevron-down"},"children":[]},") to open the options menu, or ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/view-a-dataset"},"children":["open the dataset"]}," and use the header actions."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Lineage explorer"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["From a metric"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://app.databox.com/metrics/my"},"children":["My Metrics"]}]}," — Click the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["three dots"]}," (",{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/ellipsis.14d1f073796737618cda317e9f526ea5d9aab1a0c66a7e5c5bcaa9c067c85fd0.419bb737.svg","alt":"ellipsis"},"children":[]},") on the metric card or row and select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Lineage explorer"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://app.databox.com/metrics/custom-metrics"},"children":["Custom Metrics"]}]}," — Click the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["drop-down arrow"]}," (",{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/chevron-down.929b2744de04a93191d6d985439945494abf6248d02439c1d23f78b03eaf9a2d.419bb737.svg","alt":"chevron-down"},"children":[]},") and select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Lineage explorer"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/explore-metric-insights"},"children":["Metric Insights"]}]}," — Open the metric, click the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["three dots"]}," (",{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/ellipsis.14d1f073796737618cda317e9f526ea5d9aab1a0c66a7e5c5bcaa9c067c85fd0.419bb737.svg","alt":"ellipsis"},"children":[]},"), and select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Lineage explorer"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"Callout","attributes":{"type":"note"},"children":["You can't open the lineage explorer starting from a data source, though data sources still appear in the graph and you can reveal their datasets and metrics from there. The option is also hidden when the data source is only partly set up, and on a merged dataset whose underlying source has an error — a regular dataset with an error still offers it."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"read-the-lineage-graph","__idx":2},"children":["Read the lineage graph"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The lineage explorer opens with your starting dataset or metric selected, its details open on the right, and one hop visible in each direction: upstream on the left, downstream on the right. Arrows always point in the direction data flows."]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/explore-data-lineage_1.da17682625c2359a861afe97d66be2c744bf340c4604ebb72fac318688fb9889.b1263dd6.png","alt":"lineage-explorer-graph-view","framed":false,"withLightbox":true,"className":"ss-img","style":"margin: 10px 0;"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each type connects to a different set of neighbors:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"class":"table-header-col","className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Selected asset"},"children":["Selected asset"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Upstream (left)"},"children":["Upstream (left)"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Downstream (right)"},"children":["Downstream (right)"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/add-a-data-source"},"children":["Data source"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["—"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Its datasets, custom metrics, and basic metrics"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/understanding-datasets"},"children":["Dataset"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Its data source"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Merged datasets that use it, and custom metrics built on it"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/merge-datasets"},"children":["Merged dataset"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Its input datasets"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Further merged datasets, and custom metrics built on it"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/look-up-metrics-and-integrations-in-the-metric-library"},"children":["Basic metric"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Its data source"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Custom metrics that use it"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/create-a-custom-metric"},"children":["Custom metric"]}," — from a data source or dataset"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The dataset or data source it's built on"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Custom metrics that use it"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/create-a-custom-metric"},"children":["Custom metric"]}," — with calculations"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Every metric in its formula"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Custom metrics that use it"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The graph is read live, so it always reflects the current state of your account."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"explore-the-graph","__idx":3},"children":["Explore the graph"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click a card to select it and open its details. The card and its direct neighbors stay highlighted; everything else fades."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["+N"]}," badge to load the neighbors on that side that aren't shown yet."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Explore from"]}," (top left) to pick any dataset, merged dataset, or metric already on the graph as the new origin. ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Select as origin"]}," in a card's options menu does the same."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use the zoom control (bottom right) to zoom in or out, or scroll to pan the canvas. Pinch or ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Ctrl + scroll"]}," also zooms."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Press ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Esc"]}," to clear the current selection or column trace; press it again to close the lineage explorer. Clicking an empty part of the canvas also clears the selection."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Cards can't be dragged or rearranged, and there's no minimap, legend, or search box — the graph is meant to be explored one hop at a time from a starting point, not searched."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"read-a-card","__idx":4},"children":["Read a card"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Every card in the graph has the same structure:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Header"]}," — the asset's name, its integration logo or type icon, and a colored type label. Its options menu sits on the right."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Status icon"]}," — a red warning means the connection has an error or is on hold; hover over it to see the error title and description. Otherwise, a ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/verify-analytics-assets"},"children":["verified badge"]}," can appear; hover to see who verified it."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Rows"]}," — datasets list their columns, each with a type badge; ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/add-a-calculated-column-to-a-dataset"},"children":["calculated columns"]}," carry an ",{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/formula.47e93c7a21c74b37fc2b900a48866cc25777ce5f89d1483d20fd79bca350b8c2.419bb737.svg","alt":"formula"},"children":[]}," icon. Metrics list their definition, one row per part (see below). Five rows show at first; click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Show more"]}," to see the rest."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["+N badges"]}," — on the left or right edge of a card, showing how many neighbors on that side aren't loaded yet."]}]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/explore-data-lineage_2.eb765c0ee258b079584e7115365c65dabbfe290c5394de5a6da1da9a0d25b2bc.b1263dd6.png","alt":"lineage-explorer-column-trace","framed":false,"withLightbox":true,"className":"ss-img","style":"margin-bottom: 10px;"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Expanding a metric card shows how it's defined, one row per part that's set. A metric with no definition rows can't be expanded."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"class":"table-header-col","className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Row"},"children":["Row"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"What it shows"},"children":["What it shows"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Measure"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The aggregation and the column it's applied to, e.g. SUM(Revenue). If only one is set, only that one shows."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Datetime"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The date column the metric is tracked by, or \"Use sync date & time\" if it uses the sync time instead."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Dimensions"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Every column the metric can be broken down by."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Filtered by"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The columns used in the metric's filters. Filter conditions and values aren't shown."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Formula"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Custom metrics only — the formula, with each metric shown by name. A reference that can't be resolved, such as a deleted metric, stays as its raw token."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["How much of a metric's definition shows up depends on its type:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Custom metric built from a dataset: shows its full definition."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Custom metric built with calculations: shows its formula."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Custom metric built directly on a data source: shows a partial definition, depending on the integration."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Other integration metrics: show a header only."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each card's options menu offers ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Select as origin"]},", which makes that card the graph's new starting point, and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["View dataset"]},", ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["View data source"]},", or ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["View metric insights"]},", which opens the asset's own page. ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Verify"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Unverify"]}," are available on metrics and datasets."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"view-full-details-for-an-asset","__idx":5},"children":["View full details for an asset"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Selecting a card opens its details on the right. Rows with no value are hidden, so the panel varies by asset."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Metric"]}," — Measure, datetime, dimensions, filtered by, formula (custom metrics), verified by, verified at"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Column"]}," — Description, synonyms, unique values, fill rate, null count, top value"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Dataset"]}," — Description, synonyms, default time dimension, entity, rows, size, columns, last sync, verified by, verified at"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Merged dataset"]}," — All dataset rows, plus merge type, operator, and join conditions"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Data source"]}," — No detail rows of its own. Open ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["View data source"]}," for status, sync interval, and owner"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The panel's footer links to the asset's own page — ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["View dataset"]},", ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["View data source"]},", or ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["View metric insights"]}," — and the lineage explorer is still open when you come back."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"trace-a-columns-lineage","__idx":6},"children":["Trace a column's lineage"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Click a column row on a dataset or merged dataset card to trace it through the graph. The trace lights up the column's full path and fades everything else, expanding any card along the way so its relevant rows are visible."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"Callout","attributes":{"type":"tip"},"children":["A trace only covers what's already loaded on screen. To see a column's full downstream impact, expand the relevant ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["+N"]}," badges first, then click the column; newly loaded cards join the active trace automatically."]}]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/explore-data-lineage_3.d0d031b38d6a0270c495557d37fb9cf5c0a46981e3203785ec067a36529c2d7b.b1263dd6.png","alt":"lineage-explorer-column-trace","framed":false,"withLightbox":true,"className":"ss-img"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"upstream","__idx":7},"children":["Upstream"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For a merged dataset, the trace follows the column mapping back to the input column it originated from, even if the column has a different name. It continues through any earlier merged datasets in the lineage."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For a regular dataset, the trace follows the connection back to the data source and stops there because data sources do not have column lists."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"downstream","__idx":8},"children":["Downstream"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The trace follows the column into any merged datasets and custom metrics that use it."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"merged-datasets","__idx":9},"children":["Merged datasets"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The trace shows the merged datasets into which the column is mapped and continues through any subsequent merged datasets."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"custom-metrics","__idx":10},"children":["Custom metrics"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For custom metrics built directly from a data source or dataset, the trace highlights every metric that uses the column as a measure, date, dimension, or filter. The corresponding row is highlighted to show how the column is used."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The trace also includes custom metrics with calculations that reference those metrics, including metrics built from other calculation-based custom metrics. Because formulas reference metrics rather than columns, these appear as highlighted cards instead of highlighting a specific row."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To end the trace, click the selected column again, press ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Esc"]},", or click an empty area of the canvas. To trace another column, select it instead."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"Callout","attributes":{"type":"note"},"children":["A metric only lights up if the lineage explorer could read its definition, so basic metrics without definition rows never light up, and metrics built directly on a data source aren't part of a column trace. If a merged dataset's input dataset was deleted, the trace stops at that merged dataset."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"considerations","__idx":11},"children":["Considerations"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"asset-visibility","__idx":12},"children":["Asset visibility"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A dataset is visible if its data source is ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/share-a-data-source"},"children":["shared with you"]},", or you created the dataset."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A merged dataset is visible only if all of its input data sources are shared with you."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A basic metric is visible if its data source is shared with you."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A custom metric built from a data source or dataset is visible if that source is shared with you."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A custom metric built with calculations is visible only if every metric in its formula is visible to you."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"graph-behavior","__idx":13},"children":["Graph behavior"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The graph loads one hop at a time. The full chain never loads at once, so expand it with ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["+N"]}," badges as needed."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A deleted or hidden metric that a custom metric still depends on appears as a bare placeholder card, and its name may show as a raw token in the formula."]}]},{"$$mdtype":"Tag","name":"Faq","attributes":{},"children":[{"$$mdtype":"Tag","name":"FaqItem","attributes":{"question":"Does the lineage explorer show where a metric is used?"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Not currently. The graph traces a metric back to its source data and forward to any custom metrics built on it, but it doesn't show which analytics assets reference that metric."]}]},{"$$mdtype":"Tag","name":"FaqItem","attributes":{"question":"Why does a +N count stay the same after I click it?"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The count on a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["+N"]}," badge includes assets you don't have access to. Once you click it, only the assets you're permitted to see load in, so the badge's original number doesn't necessarily match what appears."]}]},{"$$mdtype":"Tag","name":"FaqItem","attributes":{"question":"Why is a dataset or metric missing from the graph?"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This is usually a permissions issue. A merged dataset only appears if you have access to all of its input data sources, and a custom metric only appears if you have access to every metric in its formula."]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[" "]},{"$$mdtype":"Tag","name":"Cards","attributes":{"columns":4,"cardMinWidth":160},"children":[{"$$mdtype":"Tag","name":"FooterCard","attributes":{"title":"Ask Genie","icon":"genie","to":"https://app.databox.com/genie","variant":"elevated"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Get instant answers or help with your data using the in-app AI assistant."]}]},{"$$mdtype":"Tag","name":"FooterCard","attributes":{"title":"Talk to an expert","icon":"assistance","to":"https://meetings.hubspot.com/databox-meeting/account-management","variant":"elevated"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For customers: Get help with your setup, strategy, or making the most of Databox."]}]},{"$$mdtype":"Tag","name":"FooterCard","attributes":{"title":"Book a demo","icon":"eye-open","to":"https://meetings.hubspot.com/databox-meeting/ref-knowledge-base","variant":"elevated"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["New to Databox? See how it works and get guidance on getting started."]}]},{"$$mdtype":"Tag","name":"FooterCard","attributes":{"title":"Send an email","icon":"help","to":"mailto:help@databox.com","variant":"elevated"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Reach out to support for help with your account, data, or technical issues."]}]}]}]},"headings":[{"value":"Explore data lineage","id":"explore-data-lineage","depth":1},{"value":"Open the lineage explorer","id":"open-the-lineage-explorer","depth":2},{"value":"Read the lineage graph","id":"read-the-lineage-graph","depth":2},{"value":"Explore the graph","id":"explore-the-graph","depth":2},{"value":"Read a card","id":"read-a-card","depth":2},{"value":"View full details for an asset","id":"view-full-details-for-an-asset","depth":2},{"value":"Trace a column's lineage","id":"trace-a-columns-lineage","depth":2},{"value":"Upstream","id":"upstream","depth":3},{"value":"Downstream","id":"downstream","depth":3},{"value":"Merged datasets","id":"merged-datasets","depth":4},{"value":"Custom metrics","id":"custom-metrics","depth":4},{"value":"Considerations","id":"considerations","depth":2},{"value":"Asset visibility","id":"asset-visibility","depth":3},{"value":"Graph behavior","id":"graph-behavior","depth":3}],"frontmatter":{"slug":"explore-data-lineage","seo":{"title":"Explore data lineage","description":"Trace a metric back to its source, or see what depends on a dataset or column before you change it."},"keywords":{"includes":["data lineage","lineage explorer","where does this metric come from","trace a metric to its source","what breaks if I change this dataset","column tracing","impact analysis","data flow diagram","dataset dependencies","merged dataset lineage","custom metric formula","data lineage audit trail","why is my dataset missing from the graph"]},"metadata":{"userRole":"Users, Editors, and Admins","accountType":"All accounts","plan":"All subscription plans"}},"lastModified":"2026-09-17T14:18:17.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/explore-data-lineage","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}