# Metrics

The **Metrics** page shows the numbers your connections bring in — your **ledger groups** from accounting, and operational figures from payment, CRM, HR, e-commerce, ERP and other sources — one tab per source, month by month. The same metrics feed your [financial model](/doc/models-YH0auizks1) as **metric operands** in driver formulas and your [Views](/doc/views-LBO9DPep2l) as chart widgets. With **more than one legal entity**, metrics reflect the **entity selected** in the sidebar switcher.

**Metrics** appears in the sidebar once a connection has synced metrics for the selected entity; until then there is nothing to show. Opening **Metrics** needs **Metrics** → **View**, which the built-in **User** role has. See [Team & Roles](/doc/team-roles-ORspfM4rgP).


---

## In this section

| \#  | Topic | What it covers |
|-----|-------|----------------|
| 1   | [Exploring Metrics](/doc/exploring-metrics-ytsDb7VIaI) | Source tabs, chart and table, periods, transactions behind accounting metrics |
| 2   | [Search and Filters](/doc/dimension-filter-DHuxU1b9tD) | Finding metrics by name, filtering by dimension |
| 3   | [Dimension Groups](/doc/dimension-aggregation-groups-lx4U3uYXTa) | Your own rollups across dimensions, with include/exclude filters |
| 4   | [Metric Reference](/doc/metric-reference-mIcXe6HnqH) | Every built-in metric, by source, with its dimensions |


---

## Where metrics come from

* **Your ledger groups.** Each group you map on [Ledgers](/doc/ledgers-hb3KZdebdp) becomes an accounting metric, recalculated whenever the mapping changes.
* **Connections.** Each sync brings in the metrics of that source — see the [Metric Reference](/doc/metric-reference-mIcXe6HnqH). Connect sources on [Integrations](/doc/integrations-3Z3f4wXFJi).
* **Metrics you build.** On the [Data](/doc/data-AjXVW15H9e) page you can define metrics of your own on synced tables; they appear here once saved. See [Building Custom Metrics](/doc/building-custom-metrics-gVf1lCMcgv).
* **The API.** Metrics you push through the [API integration](/doc/api-integration-5Nan2cfvu4) appear on the **API** tab.
* **FX Rates.** Turn on **FX Rates** under **Integrations** for monthly average exchange rates.


---

## Key ideas

**Dimensions** split a metric into slices — for example revenue by **product** and **currency**, or costs by **cost center**. A **dimension combination** is one set of values, such as `product: Enterprise / currency: EUR`. You can filter the page by one or more dimensions or build [dimension groups](/doc/dimension-aggregation-groups-lx4U3uYXTa) that roll data up. For accounting dimensions, see [Dimensions](/doc/dimensions-oCHoBNArhY).

**Flow or point-in-time.** Most metrics count what **happened during** a period — revenue booked, deals created. **Point-in-time** metrics report what was **present as of** each period — open deals in a pipeline stage, active contracts, MRR. The [Metric Reference](/doc/metric-reference-mIcXe6HnqH) marks which is which.

**Sum or average.** When several slices are shown together, or months are rolled into quarters and years, amounts and counts are **added up** while rates and prices are **averaged**.


---

## How Metrics Connect to Your Model

```
Integration (Accounting, HR, CRM, PSP, ...)
        |
        | sync / push
        v
   Metric Data
   (period + value + dimensions)
        |
        +---> Metrics Page (view & filter)
        |
        +---> Views (metric widgets — chart, filter, or split dimensions)
        |
        +---> Models Page (use as metric operand in formulas)
                    |
                    v
              Views (calculated results)
```

When building formulas on the [Models page](/doc/models-YH0auizks1), you can reference metrics as **metric operands** — pulling their values directly into driver calculations.


---

## Getting Started


1. Connect at least one source on the [Integrations page](/doc/integrations-3Z3f4wXFJi), or map your ledgers on [Ledgers](/doc/ledgers-hb3KZdebdp)
2. Open **Metrics** and pick the source tab you want to explore
3. Search for a metric or use the [dimension filters](/doc/dimension-filter-DHuxU1b9tD) to focus on one slice
4. Switch between chart and table in the toolbar — see [Exploring Metrics](/doc/exploring-metrics-ytsDb7VIaI)

---

**Documents**

- [Exploring Metrics](https://docs.peaky.ai/s/052dba34-0c8e-4a5d-90a7-c0572642e54f/doc/exploring-metrics-ytsDb7VIaI)
- [Search and Filters](https://docs.peaky.ai/s/052dba34-0c8e-4a5d-90a7-c0572642e54f/doc/search-and-filters-DHuxU1b9tD)
- [Dimension Groups](https://docs.peaky.ai/s/052dba34-0c8e-4a5d-90a7-c0572642e54f/doc/dimension-groups-lx4U3uYXTa)
- [Metric Reference](https://docs.peaky.ai/s/052dba34-0c8e-4a5d-90a7-c0572642e54f/doc/metric-reference-mIcXe6HnqH)