Skip to main content
A metric is a value Orion tracks over time: revenue this week, active users, churn rate, or a whole table of results. Once created, a metric re-runs on its own schedule, keeps every result as history, and renders as a live card on the project’s Metrics page. Where a chat analysis answers a question once, a metric keeps answering it. That makes metrics the building block for everything recurring in Orion: the Metrics page your team checks daily, and Workflows that read metric values on a schedule.

What a metric contains

  • Data sources - One or more queries, SQL or Looker, that pull the raw data
  • A transformation - Python code that turns the query results into the tracked value
  • A value type - A number, percentage, currency, string, table, or a small set of fields
  • A visualization - How the card renders: big number, chart type, colors, labels
  • A schedule - How often the metric refreshes on its own
  • Run history - Every execution result, kept so you can see the value over time
Each metric shows a state pill: Active, Paused, Error, or Draft.

Creating a Metric

Metrics are created in chat. Ask Orion to track something, and it builds the metric for you:
  • “Track daily active users from BigQuery”
  • “Create a metric from this SQL query”
  • “Turn the revenue number from this analysis into a metric”
Before anything is saved, Orion validates the metric with a dry run against your real data and shows you the result. The metric is only created after you confirm.
The easiest path: run an analysis in chat first, then ask Orion to track the number you care about. The metric inherits the validated logic from the analysis.

Orion Suggested metrics

Orion can also propose metrics proactively based on your project data. These carry an Orion Suggested badge and a banner explaining where they came from, with a Hide from Shared Board button if the suggestion misses.

Shared and private metrics

Open a project’s metrics from View Metrics on its home screen. The Metrics page shows every metric you can see in the project, shared and private together. A metric created in the project can be Shared with every project member, or Private to its creator and Tenant Admins. Being a project owner or a Group Admin does not grant access to another member’s private metric. Catalog metrics follow the catalog’s access rules. Use the metric card’s visibility button to move it on or off the shared board. A confirmation dialog (Add to Shared Board?) confirms the change. Tenant Admins and project owners can change visibility on metrics they can access. Analysts can change visibility on metrics they created. Other members see a lock explaining who can.
New project metrics start out Private.

Sharing a dashboard shares its metrics

A metric can also reach the shared board without its visibility button. Sharing a dashboard shares every private metric and view it reads. A project member who cannot read a source cannot see its chart. Those metrics stay shared when the dashboard goes back to Private. If the share fails with “Couldn’t change who can see this” and your connection is fine, you probably cannot change the visibility of one of those metrics. Nothing changed. Share them first, or ask someone who can. See Sources a shared dashboard carries.

Filtering the Metrics page

The filter bar above the grid narrows what the page shows:
  • All: every metric except views
  • Catalog: metrics linked to the Metrics Catalog
  • Custom: metrics not linked to the catalog
  • Views: views only
The search box matches a metric’s name and description.
A project's Metrics page with the All, Catalog, Custom, and Views filter buttons outlined in red and All selected. A search box sits at the right, above a row of four metric cards for one customer account

The Metrics page filter bar

A view is a dataset saved as a base for further analysis, not a value to watch. Ask Orion in chat to create one. A view opens in the same detail sheet as a metric, and the @ menu lists views separately from metrics.

Arranging the Metrics page

Metrics render in a four-column grid on the Metrics page:
  • Reorder - Drag a card to a new position
  • Resize - Drag the handle in a card’s bottom-right corner to change its footprint
  • Layout changes save automatically

Next steps