Resolve common Maxio Metering issues by checking event receipt, validation errors, meter calculations, segment pricing, and invoice charges. Use these checks to identify why usage events are missing, invalid, calculated incorrectly, or not creating usage-based billing charges.
Events are not appearing
To check whether events are being received:
- Go to Metering > Streams.
- Open the stream.
- Click the Events tab.
If no events appear, check the following causes.
| Possible cause | What to check |
|---|---|
| API handle mismatch | Confirm the endpoint URL matches the stream's API handle exactly. |
| Authentication error | Verify that the API key is correct and has the required permissions. |
| Subscription not found | Confirm the Subscription ID or Subscription Reference matches an active subscription. |
| Wrong identifier type | Confirm the event uses the identifier type selected on the stream. |
| Event sent to the wrong site | Confirm that your system sends events to the correct Maxio site. |
For identifier and stream field details, see Configure Metering.
Events are invalid
If events appear as invalid, open the event details and review the validation message.
Common validation issues include:
| Issue | Resolution |
|---|---|
| Missing required property | Add the missing property to the event. |
| Wrong data type | Send values that match the stream schema. |
| Unknown property | Add the property to the stream or remove it from the event. |
| Invalid subscription identifier | Send the correct Subscription ID or Subscription Reference. |
| Timestamp issue | Confirm the event timestamp uses the expected format. |
How to Fix: Update the event payload to match the stream schema. The Event Example panel on the stream setup page shows a valid payload.
Invalid events do not contribute to meter calculations. A high volume of invalid events will cause meter totals to be lower than expected.
Usage totals are incorrect
If events are valid but usage totals are not expected, review the meter configuration.
Check the following items:
- Aggregation type: Aggregation type: Confirm the selected type — Count, Sum, Average, Minimum, Maximum, or Count Unique — matches your billing intent.
- Selected property: Confirm the meter uses the correct numeric or unique property.
- Segment: Confirm the meter segments by the correct property and that the property's data type matches what your events send.
- Billing period: Confirm the event timestamps fall within the expected billing period.
- Duplicates: Confirm your system is not sending duplicate events unless duplicates should count.
Charges are missing from invoices
If usage is calculated but no charge appears on the invoice, check billing setup.
Confirm the following items:
- The meter is attached to a metered component.
- The component is added to the subscription.
- The component has active pricing.
- Segment values have matching prices or a catch-all price.
- Events arrived before the grace period ended.
Segment pricing issues
Segment value matching is case-sensitive.
Example: US-East, us-east, and us_east are different values. Confirm that event values exactly match the segment values configured on the component.
Use the Pipeline tab
The Pipeline tab traces how an event moved through the system. Use this to identify exactly where an event is failing or being routed unexpectedly.
To access this view:
- Open the stream.
- Click the Pipeline tab.
This view shows each stage: event received, system properties added, schema enriched, schema validated, and segments routed.
When to contact Support
Contact Maxio Support if:
- Events are accepted but do not appear in the stream.
- Valid events do not update meter totals.
- Invoice charges do not match confirmed meter results.
- You need help correcting usage for a closed billing period.
Include the stream name, meter name, subscription identifier, event ID, and invoice number when available.
Comments
Article is closed for comments.