Metrics Catalog
A read-only, searchable directory of every metric (reveal) defined across your workspace's domains.
Metrics Catalog
What is the Metrics Catalog
The Metrics Catalog is a read-only browser for every metric — internally called a reveal — defined in your workspace. The page header in code describes it as "Every metric in your workspace — searchable and filterable," and a comment calls it the "App Store for metrics."
Reveals are not stored in their own table. The backend (catalogService.listReveals) flattens the reveals: array out of each domain's YAML (domains.content) and enriches each one with:
- Certification — looked up best-effort from a
reveal_certificationstable; defaults to not-certified if the table is absent. - Usage counts —
query_count,mosaic_count, andlast_queried_at, derived best-effort fromquery_logsandmosaic_tiles, cached in memory for one hour.
When to use it
- To find an existing metric before building a new one (avoid duplicates).
- To see which metrics are certified vs. ad-hoc.
- To spot metric disagreements — the page cross-references
/api/conflictsand flags reveals that appear in an open conflict.
How to use it
- Open the Catalog.
- Filter by domain using the pills across the top (domains are derived from the loaded reveals).
- Toggle Certified only to hide uncertified metrics. The empty state says: "No certified metrics yet. Certify metrics in Forge."
- Sort by Most used (default), Name (A–Z), or Recently updated.
- Search by metric name or description.
The Catalog has no create/edit controls. Metrics are authored in Forge and surfaced here.
Key concepts / fields
Each metric card (MetricCard) is backed by a reveal object with these fields (from catalogService):
| Field | Meaning |
|---|---|
id | ${domain_name}__${reveal_name} |
name | reveal label, falling back to its name |
description | from the reveal YAML |
domain | { id, name, slug } |
node | primary node, if the reveal declares primary_node |
certified / certified_by / certified_at / certification_note | from reveal_certifications |
query_count / mosaic_count / last_queried_at | usage signal |
status | reveal status, else domain status, else published |
updated_at | the domain's updated_at |
Note: the Catalog hides reveals that have no description, no usage, and no certification (treated as auto-generated stubs) — unless nothing passes that filter, in which case it shows everything.