Data Limits
Each SIM in our system has a usage limit that, when reached, blocks it from using any more data for the specified period. The limit is set in megabytes (MB) and is mandatory for all SIMs.
The default usage limit is: 10 GB per month.
The minimum usage limit is: 0.5 MB per selected period.
Usage Alerts
You can also set an alert threshold that doesn't block the SIM but alerts you before your SIM reaches the data limit. For example, you can set a monthly data limit at 100 MB, and an alert threshold at 10 MB. This means that: as soon as your SIM consumes 90 MB in a given month - you will receive a Usage Alert.
Hitting the alert threshold or usage limit will be displayed in the Network Logs as:
"The SIM has exceeded its data limit alert threshold for its defined data limit period.""The SIM has exceeded its data limit for its defined data limit period. Data is now being blocked."
Setting up
In order to define data limit and alert threshold on a SIM:
Go to SIMs tab.
Find the SIM you want to update.
On the individual SIM page, click "Edit".
Scroll down to "Data limits" section.
Update the properties.
Click "Save changes".
Get notified
While the events will be automatically displayed in the Network Logs, we recommend utilizing Webhooks to get notified outside of the Onomondo app. The notifications will be sent to an HTTPS endpoint of your choice, granted an appropriate Webhook has been set up.
Try setting up your first Webhook using this guide:
Here's an example of what the events will look like:
{
"type": "usage-alert",
"reason": "alert-threshold",
"time": "2021-12-01T10:08:36.530Z",
"sim_id": "000000001",
"iccid": "89457387300000000105",
"ipv4": "100.96.0.1",
"data_limit": {
"used": 1101976,
"total": 2000000,
"type": "monthly",
"period": "202112",
"alert_threshold": 1000000,
"resets_at": "2022-01-01T00:00:00.000Z"
},
"sim_label": "foobar"
}
The "reason" field will either contain the string "blocked" or "alert-threshold" depending on if it was the usage limit that was reached or the alert threshold respectively.
If you have any more questions about usage limits, you are welcome to reach out at [email protected].