Monitor helps you manage your fleet of SIMs/Systems deployed on the field. It provides access to all the systems of the company along with their status, provisioning information, usage history, and lifecycle management capabilities. This page is also customizable to present the information that is most important to you.
See Dashboard section for more information.
The Monitor activity is divided in three sections:
The Systems section shows all the Systems in your company along with their state, provisioning and usage information. We call it “Systems” because you can specify the Name, IMEI and Serial Number of the device associated to the SIM, therefore creating and managing a fleet of IoT systems.
The columns displayed can be organized, resized and configured to show the parameters you need:
The state defines whether the subscriptions are activated for usage or not and if the monthly charges are due or not (often used in delivery phase).
Each system state can be described as follows:
This is the state in which the SIMs are shipped to the customer. In this state, it is not possible to use the SIMs. Monthly charges are also not due.
Test-ready-mode can be used to optimize and simplify testing and deployment processes. Test-ready-mode means that a SIM is allowed to be tested during a defined test period and with a limited volume of traffic, without being charged for the monthly fees. Note that you are still accountable of usage fees while in test ready state. Whichever of the time criteria or traffic threshold is met will automatically result in the system status being changed to Active and normal charges will be applied.
To benefit of test ready mode, you simply need to activate the system on a Test-Ready-Mode compatible offer. Upon activation, the system will be displayed in Test Ready state. At the end of the test ready period, the system will automatically switch to Active state, and start being charged based on the offer it has been activated on.
The SIM cards are Active from the date of activation. The offer will be selected as part of the activation. While Active, the SIM cards are charged for the monthly subscription fees and are able to generate traffic corresponding to the activated services and options.
A SIM card in Suspended state cannot generate any traffic. Depending on your contract, the monthly subscription fee may still be running while Suspended.
A “Retired” SIM card cannot be used nor re-activated again. It is blocked for usage, meaning that usage of any bearer service is not possible and will not be possible with this SIM again.
To trig a lifecycle change or provisioning change on one or multiple systems, you will create an operation. The different operation that can be triggered are:
|Review Details||Drill down to the detailed view of one system.|
|Change Label||Add or remove labels.|
|Activate||Activate one or multiple systems/SIMs on a selected offer to enable traffic.|
|Change Offer||Change the offer for one or multiple SIMs. There is no restriction in the target offer, it can be any offer of your contract. If the target offer has a different roaming configuration, the change offer is followed by a detach from network (Cancel Location)|
|Change Provisioning Options||Change provisioning options (permitted services and roaming zone templates) for one or multiple SIMs/Systems. Available options depend on the selected offer. Changing roaming configuration is followed by a detach from network (Cancel Location)|
|Suspend||Suspend one or multiple SIMs/Systems. A suspended SIM will not be able to connect to the network, and therefore will be unable to generate usages.|
|Restore||Restore one or multiple SIMs/Systems. The SIM will be able to reconnect to the network and generate usages.|
|Terminate||Terminate one or multiple SIMs/Systems. A terminated SIM will not be usable any more. The Terminate action cannot be reverted.|
|Swap SIM||Swap out the selected SIM for a replacement. This is to be used for example when a SIM card is stolen or damaged. Only the ICCID will be changed, to that of the new SIM, while keeping all identifiers related to the subscription (MSISDN, Static IP, offer, provisioning options, etc.). The ICCID of the stolen/damaged SIM will be terminated as a consequence of the Swap.|
|Transfer||Transfer one or several systems to a partner, for example to a subaccount. The usages consumed within the original company will remain attached to the original company and therefore will not be displayed in the target company.|
|Send SMS||Send a text SMS to one or multiple systems. For SW Advanced, SW Essentials and 3rd party SIMs this requires a SMS gateway to be configured in your company. See How to configure an SMS account? for help. For Enhanced Carrier Connectivity SIMs, this is straightforward. The Send SMS operation finishing in success means that the SMS has been received by the device; with the exception of SMPP-based SMS accounts, for which it means received by the SMS-C.|
|Export Data||Export in a .csv file a copy of the information available in AirVantage for multiple systems.|
|Edit||Update the system name, IMEI and/or Serial Number of the device associated to the SIM in bulk|
Depending on the current state of your system, only the actions that can be triggered in that state will be available.
There are no restrictions on the number of suspend or change offer operations that can be triggered within a month besides the rules imposed by the carriers. Meaning that:
- SW Advanced, SW Essentials: no restriction
- Verizon: maximum 2 suspend operations per year
See simple example below:
The filtered list can be saved in a group of systems using a label:
Or directly used to perform one of the connectivity management operation.
Most recent activity and configuration of the system is available from the details screen. This page provides access into the configuration, provisioning, usage consumption trends and detailed records.
The details of a given system are accessed from the Systems list view clicking on the Details icon in the actions toolbar after selecting a system or directly in the grid by clicking on the line of the system of choice.
Monitor activity proposes different capabilities to track usage consumption per system and helps you prevent bill shock.
The system list gives you a vision of your fleet along with some of their key usage information:
Note that the usage information displayed in AirVantage in bill shock related functionalities is the invoiced usage data i.e. taking into account billing increments applied to each data session.
Sorting the grid per usage consumption enables you to spot your most consuming devices within the fleet.
In addition to the grid, the AirTime Usage status widget tracks usage consumed against the bundle offer indicating with a color coded status:
This widget is especially helpful in identifying systems that may be experiencing an unplanned usage surge. In case you are using a Pay-per-use model, the usage status will be undefined.
AirVantage supports 2 types of alert:
Each system has got an alert state: a system can either be in alert or not in alert ‘-’.
A system in alert has at least one alert rule for which an alert is currently raised on the system. As soon as the previous alert criteria is no longer met, meaning that the system goes back to expected behavior, its alert state will go back to ‘not in alert’.
If a system is in alert state due to several alerts being raised at the same time, its alert state will be cleared only once all rule violations have been fixed.
You can easily identify systems in alert in the grid of systems using the column “alert state” and “alert state change date”.
You can use the filtering capabilities with the alert state criteria to display only systems that have at least one alert currently raised.
The loudspeaker with a red counter on the top banner displays the number of currently raised alarms on your fleet, with one different entry per system or offer and per alert rule. It appears as soon as you are logged in AirVantage.
The Monitor > Current Alerts section is displaying all alerts currently raised on your systems and offers. Consequently, only stateful alerts currently raised are displayed in this screen. The list can be filtered by Alert rule name, type of target (system or offer) and also on the specific system or offer.
Alert rules are created in the Configure activity: Alert section .
Finally you can click on an alert to show the details:
The Monitor > Alert History section is displaying the alert history of your systems (events and for stateful alerts, when they have been raised and cleared). The list can be filtered by Alert rule name, target system, target offer, or a given period of time. In a single click, you can access to the rule, the system details, the systems with targeted offer, and the system’s timeline to analyze the system(s) behavior.
Alert rules are created in the Configure activity: Alert section .
In case you need a sharp analysis on one SIM or facing some issues with your connectivity, AirVantage provides some functionalities for doing a deeper dive and diagnose your wireless connection.
A new widget is available in the Monitor> System details to pinpoint the latest usages consumed on the selected SIM. The widget shows the type of usage along with the date at which the usage occured and the additional information related to the usage (duration, amount of data consumed, peer phone number depending on type of usage, visited network). If a session is still on-going it will be displayed as in progress.
To view the full list of usages you need to click on the All>> link at the bottom of the widget, or you can also access it by clicking on the Usage History button in the top banner. In this view, the usages displayed are the raw usage consumption i.e without the billing increments. The Usage History displays all usages consumed on the selected SIM (display is limited to 100 records at a time). You can drill down to a specific date by using the filters on top.
For data usages:
- data session START and STOP events are now displayed in usage history and timeline in near real time (usually in a matter of seconds)
- data session are updated every 15 minutes after the start of the session to provide consumption updates (INTERIM UPDATES).
For VOICE, SMS, USSD, usage history is updated every 15 minutes.
The timeline page presents a chronological list view of events in the device life, and can thus provide insight into an issue related to an event:
The filtering mechanism limits display to only the relevant information. You can also browse the timeline.
In case you are not able to establish a communication, suspecting something wrong with the connectivity or want more details about real time status of one device, the diagnose capability helps you to understand what is going on and to troubleshoot the service.
The diagnose is a 3 step operation that can be triggered from System>Details:
Each step can result in one of the following statuses:
When an error is detected, the Diagnose tool will suggest possible causes and ways to troubleshoot the issue.
Note that Diagnose takes 1 to 2 minutes to complete.
Detach the SIM from the network
The detach can be used if you suspect an issue with the wireless service: for instance, the diagnose displays that a session is on-going, but you are not able to effectively transmit data, or the diagnose shows that your device is reachable but you are not able to send SMS.
Clicking on ‘Detach’ in the Voice Status pane trigs a detach procedure from the network side, leading to the device restarting an attach procedure and also a data session establishment from the beginning. To be noted that in most cases the device will register to the same network if this network is available.
If you use a SW Advanced SIM you can also use the ‘Detach Data only’ functionality in the Data Status pane. In that case, the SIM will automatically detect the loss of data service and the device will register to another network.
This section provides you with helpful procedures for common tasks.