> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.solvimon.com/platform-guides/meter-and-event-design/meter/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.solvimon.com/_mcp/server.

# Meters

Usage meters are a users' action within your product and consist of **meter values** and **usage metrics**, and **meter properties**.

![](/_fern-img/b87bdb876f7ee5c220609e6071677f9c01d5d7ff08ea4854fe129b433edc7762.webp)

\


---

## Setting up a Meter

To start ingesting events, you need an active **meter**. There are four ways to get one:

* **Create it upfront**: configure the meter, its values and its properties before sending any events. This is the default, described below.
* **Create it inline from the product catalog**: while setting up a usage-based revenue item in Desk, the [guided billing metric setup](/platform-guides/products-and-pricing/product-catalog/products-1) can create the meter, its values and its calculation method on the spot, pre-filled from the product you were configuring.
* **Create it dynamically**: send events with `meter_validation=DYNAMIC` and let Solvimon create the meter, its values and its properties on the fly as part of ingestion. See [Dynamic meter creation](/platform-guides/meter-and-event-design/meter/dynamic-meter-creation).
* **Import from Metronome**: pull your existing Metronome Billable Metrics in as meters, including values, calculations and properties derived from group keys. See the [Metronome integration](/integrations/data-imports/metronome).

```mermaid
flowchart TD
    A[Start ingesting usage] --> B{Meter already configured?}
    B -- "Create upfront" --> C[Configure meter, values and properties]
    C --> D[Ingest event]
    B -- "Create dynamically" --> E["Ingest event with meter_validation=DYNAMIC"]
    E --> F[Solvimon creates missing meter, values and properties]
    F --> G[Event is processed]
    D --> G
    B -- "Import from Metronome" --> H[Billable metrics imported as meters]
    H --> D
    B -- "Create inline from product" --> I[Guided billing metric setup in Desk]
    I --> C
```

The APIs can handle high volumes of traffic and allow you to either ingest individual events in real-time or push predefined aggregated events. The option to send real-time events enables you and your customers to have up-to-date visibility into revenues throughout the billing period.

### Creating a meter upfront

A Meter that is connected to a product consists of at least one **meter value** that, together with a calculation method, becomes a **usage metric**.  Optionally, it also consists of one or more **meter properties**.

When you configure a meter, you need to fill in the following information as shown in the form below

* Name
* Reference
* Meter value
* Meter properties

> **Tip**
>
> Meters can consist of multiple meter properties and multiple meter values, but can also be configured with one of each only.

![](/_fern-img/8e911253aaf3d047d1c35c4847ef7d8245c5d8ff719cca2edeb29c722909c700.webp)

## Required or optional

When adding a meter value and meter property, you need to specify if they are required, as shown in the screenshot above. Once you select the `Required` checkbox, you must add the usage metric information, which has been defined in the [meter values](/platform-guides/meter-and-event-design/meter/meter-values#usage-metric) and [meter properties](/platform-guides/meter-and-event-design/meter/meter-properties#usage-metric)

Making a metric value and/or property `required` or `not required` determines the information you need to send for that meter in the events. If it's not required, the event data for that meter can be ingested without those values or properties. Conversely, if it is required and missing, it may cause an error in event ingestion.

> **Note**
>
> In order to use Properties when setting up different [pricing conditions](/platform-guides/products-and-pricing/pricing-plans/usage-based-pricing-methods/pricing-rules), the property must be configured as required

---

## Docs

- [Meter values](https://docs.solvimon.com/platform-guides/meter-and-event-design/meter/meter-values.md)
- [Meter properties](https://docs.solvimon.com/platform-guides/meter-and-event-design/meter/meter-properties.md)
- [Meter property variables](https://docs.solvimon.com/platform-guides/meter-and-event-design/meter/meter-property-variables.md)
- [Usage metrics](https://docs.solvimon.com/platform-guides/meter-and-event-design/meter/calculation-methods.md)
- [Dynamic meter creation](https://docs.solvimon.com/platform-guides/meter-and-event-design/meter/dynamic-meter-creation.md)