Configure Maxio Metering

Set up the Streams, event properties, Meters, and Segments that turn raw activity into billable usage in Advanced Billing. Use these settings to control how Maxio receives usage events, calculates Meter results, and prepares usage for billing.

Step 1 - Metering settings

Use Metering settings to enable Metering and control billing-period timing.

Important: Metering must be enabled for your site before you begin. Contact your Customer Success Manager or Maxio Support to request activation.

1. Go to Config > Settings > Metering.

   

2. Toggle on Metering.

3. In Subscription Renewal Grace Period (In Minutes), enter the number of minutes Maxio waits after a billing period ends before finalizing usage. Enter a value between 0 and 120.

4. Click Save Settings.

Step 2 - Subscription Renewal Grace Period

The Subscription Renewal Grace Period (In Minutes) gives Maxio extra time to receive usage events before closing a billing period.

Use a grace period when your system may send usage shortly after the billing period ends. Events received after the grace period may not be included in the closed billing period.

Step 3 - Stream configuration

A Stream defines the schema for incoming events.

To create or update a Stream:

1. Go to Metering > Streams.
2. Click Create Event Stream, or open an existing Stream.
3. Configure the Stream fields.

Step 4 - Subscription identifiers

A Stream can define both a Subscription ID property and a Subscription Reference property, but only one of them is used to match incoming events to a Subscription.

All events sent to a Stream must use the identifier type selected for billing on that Stream.

Step 5 - Event properties

Event properties define the fields included in incoming usage events. Every property belongs to one of two groups:

When you add a property manually on the stream creation page, you add it directly under the matching group. When you import properties from JSON, you instead select whether each detected property is used for Calculations or Segmenting.

Import properties from JSON

Use JSON import when you already have a sample event.

1. On the Stream creation page, click JSON Import.
2. Paste a sample event.
3. Review the detected properties.
4. Confirm the data type and usage for each property.
5. Click Add Properties.

Meter configuration

A Meter calculates usage from Stream events.

To create or update a Meter:

1. Open the Stream.
2. Click the Meters tab.
3. Click Create Meter, or open an existing Meter.
4. Configure the Meter fields.

Step 6 - Analysis: Aggregation types

Choose the aggregation type that matches what you bill for.

Step 7 - Segment configuration

Use a Segment when usage must be grouped by a property value. Segment properties support String, Integer, Float, Boolean, or Date types.

A Meter supports up to 10 Segment properties simultaneously, enabling granular usage splits by dimensions such as region, model tier, API key, plan type, and environment.

Examples:

• region
• customer_tier
• feature_type

When a Meter uses a Segment, configure matching Segment pricing on the connected metered Product.

Segment value matching is case-sensitive.

Exclude Events configuration

Use Exclude Events when specific events should be left out of a Meter's usage calculation, such as internal test traffic or requests from a particular environment.

Important: Exclude Events conditions remove matching events from usage. They do not add events to usage. An event that matches your conditions is excluded from the Meter's aggregation; every other event is still counted toward usage. If you want a Meter to count only events that match a condition, set up conditions that exclude everything else instead.

Excluded events are still ingested and remain queryable on the Stream's Events tab. Exclude Events conditions only affect what counts toward billed usage, not what Maxio accepts or stores.

To add an exclude condition:

1. Under Exclude Events, click + to add a condition.

2. Select a Property from the Stream's segment or meter properties.

3. Select an Operator. Available operators depend on the property's data type:

   Data type	Available operators
   String	is, is not, in, not in, is null, is not null
   Integer, Float	is, is not, in, not in, <, >, <=, >=, is null, is not null
   Boolean	is, is not, is null, is not null
   Date	is, is not, <, >, <=, >=, is null, is not null

4. Enter a Value to compare against, if the operator requires one.

5. Repeat to add up to 25 conditions.

When a Meter has more than one condition, choose how they combine:

• Match all (AND): an event is excluded only when it matches every condition.
• Match any (OR): an event is excluded when it matches at least one condition.

Once a condition has both a property and an operator set, Maxio shows a summary confirming the net effect: matching events are excluded from the Meter, and every other event is counted toward usage.

The Meter's read-only detail view lists the configured Exclude Events conditions, or shows No exclusion filter configured when the Meter has none.

Step 8 - Review event results

Use the Events tab to confirm that Maxio accepts incoming events.

1. Go to Metering > Streams.
2. Open the Stream.
3. Click Events.
4. Review valid and invalid events.
5. Open invalid events to see validation details.

If events are missing, invalid, or producing unexpected results, see Troubleshoot Maxio Metering Issues.

Before going live, also confirm that a metered Product is connected to the Meter and added to the correct Subscriptions. See Design Your Catalog: Use Metering with Products.

Related information

To follow the first-time setup workflow, see Get Started with Maxio Metering.

For Stream concepts, see Understand Streams, Meters, and Segments.

For billing impact, see Understand Meter Results in Billing.

For Product pricing, see Design Your Catalog: Use Metering with Products.