How-to: Set usage limits
Control usage with Limits
When deploying large numbers of SIM cards, it is challenging to keep track of usage. That’s why we built 'Limits’. A Limit keeps track of the usage of your SIM card. It can warn you when usage is above a set limit and can automatically deactivate a SIM.
A few things to consider:
Limits verify usage per SIM cards set up by a user. Usage per SIM card is collect when a network operator creates a Call Detail Record (CDR). An operator sends a CDR when:
- An SMS is sent
- A data session closes, or the SIM switches to another operator
- Every 6 hours
CDR’s process after receiving the record from the operator. The limit rule is checked and executed. It can occur that usage on notification is higher than set in the limit rule. This happens because the session didn’t end and sent yet.
Triggers for limit rules are set for usage per calendar month. This way it’s equal to the billing cycle. If data limit is set for 5Mb, the SIM is allowed to use 5Mb till the end of the calendar month.
Once a limit triggers, it will not trigger the limit rule again in that month. You can stack limit rules. For example, send a notification at 10Mb and disable the SIM card at 15Mb. After disabling, you can activate the SIM card by changing the status manually.
Limits can apply on all SIM cards or filtered per group.
Per account or group you can set more than one rule. We apply a fair use policy to the usage of these limits.
Setting up limits
To provide flexibility many options are available. Check the description of every step to understand what you can set up in detail.
Login to your account at oliviawireless.io and go to limits. So setup your first limit rule, click ‘Add limit’. You will see the pop-up below:
Only active rules trigger actions. If you would like to delete a rule, deactivate it first.
Give the limit a name to identify the rule.
Apply the rule to:
All SIM cards: The limit applies to all the SIM cards in your account
Specific group: The limit will only apply to SIMs in this group. A drop down will appear to select a group.
Set the allowed data limit per SIM to use in a calendar month. The limit is per SIM per month. Leave blank if you don’t want to set a Data limit
Set the number of allowed SMS per SIM to use in a calendar month. The limit is per SIM per month. Leave blank if you don’t want to set an SMS limit.
By default the rule is set to ‘No’. If set to ‘Yes’, the SIM card pauses when the limit (data or SMS) is reached. The SIM remains Paused until you reactivate it again manually by changing the SIM State.
Enter an email address that will receive a notification email when the limit is reached. Leave blank if you don’t want a notification email.
Notification web hook:
Enter a URL (including the https:// prefix) to receive a message on your webhook. You will receive:
Body type: raw
Content type: JSON (application/json)
“device_name”: “test device“,
“policy_id”: “policy id“,
“type”: “MB” or “SMS”,
“block”: “true” or “false“