Metric Library: Create and Manage Your Metrics

The Metric Library is where all your organization’s metrics live.
It allows you to create, explore, and edit reusable metrics that can be used across Workbooks and other Arkham modules.

Instead of having dozens of similar queries scattered around, you can store metrics in one place — with consistent names, logic, and visualizations.

A space to create, explore, and edit reusable metrics.

What You Can Do

From the Metric Library, you can:

• View all existing metrics in a single list.
• Search metrics by name.
• Create a new metric from scratch.
• Edit a metric’s name, description, and query.
• Test and configure its visualization before using it elsewhere.
• Insert metrics directly into your Workbooks.

graph TD
    subgraph "Governed Data Sources"
        A["Data Catalog (Production Tier)"]
        B["Data Catalog (ML Models)"]
    end

    subgraph "Business Contextualization"
        C["SQL Editor"]
        D["Business Metric"]
        E["Graphic Panel"]
    end

    subgraph "End User Experience"
        F["Interactive Workbook"]
        G["TARS AI-Agent"]
    end

    A -- "Directly Queried via" --> C
    B -- "Directly Queried via" --> C
    C -- "Interpreted as" --> D
    D -- "Default Visualized via" --> E
    D -- "Utilized in" --> F
    D -- "Consumed by" --> G
    %% Layout helpers: invisible edges to enforce vertical stacking of subgraphs
    E --> F
    E --> G
    linkStyle 6 stroke:transparent,opacity:0
    linkStyle 7 stroke:transparent,opacity:0

    classDef data fill:#FFF8E1,stroke:#FBC02D
    classDef builder fill:#E3F2FD,stroke:#1976D2
    classDef consumer fill:#E8F5E9,stroke:#388E3C

    class A,B data
    class C,D,E builder
    class F,G consumer

This diagram reveals the workflow of the Metric Library. It describes the origin of business metrics, their visualization, and their consumption in Workbooks and TARS.

Exploring Metrics

When you open the Metric Library, you’ll see a list of all available metrics.

You can use the search bar to find metrics by name or keyword.
This helps you reuse existing ones instead of building new ones from scratch.

Creating a New Metric

There are several ways to create a metric:

From the Metric Library

Click “New Metric” to start from an empty query editor.
You can write your SQL query, preview results, and save it once ready.

From Playground

If you already have a query in Playground, you can save it as a metric.
This turns your query into a reusable resource that can be shared or added to Workbooks.

From a Dataset

When viewing a Dataset in the Catalog, you can create a metric using it as a base.
This will open the Metric Library with your dataset preselected.

Editing a Metric

When you open a metric, you’ll see three main areas:

1. Basic Info — Name and description.
2. Query Editor — Where you can write or modify your SQL query.
3. Data Preview — A quick look at your metric’s results.

Once you’re happy with the configuration, click Save to keep your changes.

Configuring Its Default Visualization

Each metric can have a default visualization, which defines how it’s displayed when used in a Workbook.

To set it:

1. Open your metric.
2. Enable the Edition mode.
3. Choose your preferred type (e.g., Table, Bar Chart, Line, KPI).
4. Adjust basic settings like grouping, labels, and formatting.
5. Save your changes.

This visualization will automatically appear when the metric is added to any Workbook.

Why Use Metric Library?

The Metric Library ensures everyone in your organization uses consistent definitions and reliable data.
It reduces duplication, simplifies dashboard building, and allows any user to find and reuse trusted metrics easily.

Related Topics

• Workbooks — Create live dashboards using your saved metrics.
• Playground — Write and test queries before turning them into metrics.
• Data Catalog — Explore your datasets and create metrics from them.