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, communication history, usages, configuration and management. This page is also customizable to present the information that is most important to you.
All the functionalities provided by AirVantage may not be available on all the devices.
See How to configure your dashboard? for more information.
The Monitor activity is divided in three sections:
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 systems are created after shipment of the SIM to the customer. In this state, the SIM will not be usable, and the system will therefore not communicate. 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 systems are Active from the date of activation. The offer will be selected as part of the activation. While Active, the system are charged for the monthly subscription fees and the SIMs are able to generate traffic corresponding to the activated services and options.
A system in Suspended state cannot communicate any more. The corresponding SIM card will not be allowed to generate any traffic. Depending on your contract, the monthly subscription fee may still be running while Suspended.
A “Retired” system cannot be used nor re-activated again. The corresponding SIM card is blocked for usage, meaning that usage of any bearer service is not possible and will not be possible with this SIM again. If you want to reuse the device of a “Retired” system, you can still use the bulk edit to put the device in another system.
To trigger a lifecycle change or provisioning change on one or multiple systems, you need to create an operation. The different operations that can be triggered are:
General and Life Cycle
|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)|
|Change Label||Add or remove labels.|
|Suspend||Suspend one or multiple systems. A suspended system will not be able to connect to the network, and therefore will be unable to generate usage data.|
|Restore||Restore one or multiple systems. The system will be able to reconnect to the network and generate usage data.|
|Terminate||Terminate one or multiple systems. A terminated system will not be usable any more. The Terminate action cannot be reverted.|
|Import & Edit||Import systems with 3rd party SIMs & Update existing systems in bulk|
|Transfer||Transfer one or several systems to a partner, for example to a subaccount. Usages and device data consumed within the original company will remain attached to the original company and therefore will not be displayed in the target company. Transferring a system is restricted to systems without private applications.|
|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.|
|Export data history||Export a .csv file containing information in AirVantage for a single system.|
|Export last data||Export a .csv file containing the last known information in AirVantage for multiple systems.|
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
Module Management and Device Management
|Apply Template||Change the configuration of one or multiple systems applying a predefined template.|
|Reboot||Reboot one or multiple systems.|
|Configure Communication||Change the frequency your systems are communicating with AirVantage, and also define datasets and frequency of these datasets.|
|Upgrade Firmware||Upgrade one or multiple systems with a new firmware.|
|Synchronize||Create an operation to Synchronize AirVantage with your systems.|
|Retrieve Data||Retrieve on-demand some data from one or multiple systems using a predefined dataset.|
|Export Data||In addition to the capability to export the latest data stored in AirVantage for multiple systems, can also be used to export in a .csv file the history of device &application data stored in AirVantage for a given system and a period of time.|
|Apply Workflow(s)||Apply several configuration operations in sequence to one or multiple systems. See How to configure systems using Apply Workflow(s)? for help.|
|Custom command||Send a command to a system. Commands must be defined in one of the applications running in your system.|
|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.|
|Wake Up||Send a wake-up message to your systems to trigger a communication with AirVantage. A SMS gateway needs to be configured in your company. See “How to configure an SMS account?” for help. The operation needs to be supported in the firmware of your device.|
|Factory Reset||Reset to factory default one or multiple systems. The operation needs to be supported in the firmware of your device.|
|Install Application||Install or upgrade an embedded application on your systems.|
Depending on the capabilities of your firmware/application, only some of the operations listed above may be available.
See the 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 device management operations.
You can switch to see your systems and status on the map from the system grid, and toggle from one to another.
Most recent activity from the system is available from the system details screen. This page provides access into the device communications history as well as device configuration, direct access to AceManager by clicking on the IP address and other functions. check System View page for details.
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 actions column of the system.
Sierra Wireless team is pushing new firmware packages on AirVantage so you can keep your fleet up to date with the latest features and security patches. AirVantage also provides different widgets showing which firmware versions are actually deployed on your systems and the upgrade status compared to latest released firmware.
There are two ways to launch a firmware upgrade.
Before upgrading, please ensure that the latest firmware is certified by your carrier. (You can find certification information for each firmware revision at Sierra Wireless Source
The Upgrade Status widget on the Start Page Dashboard identifies systems in need of firmware upgrades, and lets you apply the latest build to all systems of a device type with a single click.
Where all devices of a given type are already up to date, a green status icon is shown on the widget. If some or all devices of a given type need updating, an amber or red status is shown.
Upgrade the firmware of one or a group of devices:
Upgrade or install an embedded application on one or multiple devices.
AirVantage supports 2 types of alert:
Each system has 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 .
You set the alert once, and will get noticed when the alert is raised, and then when the alert is over and the system working back the expected way.
For mass configuration, templates can be created or modified starting from an existing device or from scratch. You can find how to create a new template in the Configure pages.
Configuring your systems, you may require to specify a different value for each. This is the case for names, identifiers, passwords, or unique configuration parameter like static IP address.
AirVantage provides a way to apply this mass configuration change. The individual settings are loaded from file (.csv format). The systems can be identified using one among:
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.
In addition to the widgets, bill shock can also be avoided by using alert rules dedicated to connectivity bill shock management. For a full explanation of alerts and alert statuses, see the main Alerts section of this topic.
The alert rule templates that can be used to prevent usage violations are:
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.
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 SmartSIM Advanced 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.