Usage & Accounting Data

Accounting data is kept for each Application and its Devices. This includes the number of Devices Activated, Joined and Deactivated; all Uplink and Downlink communication; as well as new Security Sessions. After being aggregated by Customer Contract ID, this data is used by the Billing and Rating process to generate invoices. The view below provides a summary of activity for Yesterday, Current Month, and Last Month.

screenshot

The Usage Data statistics can be scoped to a specific contract by selecting it from the dropdown menu located in the navigation bar.

screenshot

Field Descriptions

Field Description
Uplinks The number of uplinks seen on an application for a period
Downlinks The number of downlinks seen on an application for a period
Devices Activated & Reporting The number of Devices in the Activated state that have reported on an application for a period
Devices Deactivated & Reporting The number of Devices in the Deactivated state that are still reporting on an application for a period
Devices Registered The number of Devices that where Registered on an application for a period
New Devices The number of new Devices that were first heard for each displayed time period
Security Sessions The number of security sessions (successful joins) processed for each displayed time period

Usage Data and File Formats

On the first of each month an Application Details file is generated for the prior month and made available for viewing/downloading. These contain detailed accounting information for Devices active during the previous month. |

Application Details File

The Application Details file includes network usage statistics for each Device associated with the application. The table below is an example of this usage file. The fields in the file are defined below.

screenshot

Field Description
EUI The Device's permanent IEEE EUI-64 identifier assigned at the time of manufacture and recorded when the device is registered on the Senet Network
First The static timestamp of the Device's first attempt to join the network
Last The dynamic timestamp of the Device's most recently heard Join Request or Uplink
Up Msg The total number of Unconfirmed and Confirmed Uplinks sent by the Device
Down Msg The total number of Unconfirmed and Confirmed Downlinks sent to the Device
Security Sessions The count of Device's Uplinks first-received after a successful Join procedure, for the current month
Profile The current LoRaWAN control Profile assigned to the Device
Activated The timestamp of the last time the Device was Activated
Deactivated but Still Reporting An indication that the Device continues to uplink while Deactivated
Activated Not Joined An indication that the Device is Activated but has not successfully Joined the network
ContractId ID of the Device's billing contract
State The Device's network-access status: Registered, Activated, or Deactivated
Deactivated The timestamp of the last time the Device was Deactivated
Registered The timestamp of when the Device was Registered
Activations The count of the Device's Activation events
Deactivations The count of the Device's Deactivation events

Application Contracts File

The Contracts file includes aggregate usage statistics for all Contracts associated with the Application. The table below is an example of this usage file. The fields in the file are defined below.

screenshot

Column Description
Contract ID The ID of the Contract
Name The name of the Contract
Description An optional description of the Contract
Devices The total number of Devices on the Contract
New Devices Count of Devices that established their first Security Session under the Contract
Registrations The total number of Registrations under the Contract
Activations The total number of Activations under the Contract
Deactivations The total Deactivations under the Contract
Up Msg Total Unconfirmed and Confirmed Uplinks sent by Devices under the Contract
Down Msg Total Unconfirmed and Confirmed Downlinks sent to Devices under the Contract
Security Session The number of times Devices on the Contract successfully joined the network for the current month
Local Up Msg The total number of fractionalized Uplinks from Devices under the contract heard by Base Stations owned by the Application's Operator
Foreign Up Msg The total number of fractionalized Uplinks from Devices under the contract heard by Base Stations not owned by the Application's Operator
Local Down Msg The total number of fractionalized Downlinks from Devices under the contract heard by Base Stations owned by the Application's Operator
Foreign Down Msg The total number of fractionalized Downlinks from Devices under the contract heard by Base Stations not owned by the Application's Operator
Registered Devices The total number of Devices Registered under the Contract
Activated Devices The total number of Devices Activated under the Contract
Deactivated Devices The total number of Devices Deactivated under the Contract
Active Deactivated Devices The total number of Devices that were Deactivated but still uplinking under the contract

Application Summary File

The Summary file includes aggregate usage statistics for all Devices associated with the Application. The table below is an example of this usage file. The fields in the file are defined below.

screenshot

Field Description
Number of Devices The number of Devices contained in the detailed Devices output file (total of "billable" Devices)
Number of Active Devices The number of active Devices on the Application
Number of Reporting Devices The number of Devices on the Application that are active and have sent uplinks
Number of Devices Evaluated The total number of Devices processed when generating detailed output file
Total Registrations The total number of Registrations on the Application
Total Activations The total number of Activations on the Application
Total Up Packets The total number of up packets heard on that application during the given month
Total Down Packets The total number of down packets heard on that application during the given month
Total Security Sessions The total number of Security Sessions across all "billable" Devices
Total Local Up Msg The number of uplinks forwarded across assets belonging to this customer
Total Foreign Up Msg The number of uplinks forwarded across assets NOT belonging to this customer
Total Local Down Msg The number of downlinks forwarded across assets belonging to this customer
Total Foreign Down Msg The number of downlinks forwarded across assets NOT belonging to this customer
Billable Features A list of billable features enabled for the Application
Application Notifiers A list of Notification Targets enabled for the Application
Device Counts by Profile ID A list of Device Counts for each Device Profile ID on the Application
Contract Summary A list of Device statistics for each contract on the Application

Usage Reports

Usage reports provide presentations of statistical trends in chart or table form. The reports are categorized by related statistics such as Devices in the Operational Summary, to provide strategic insight into the overall status of the Application.

Message Summary

The "Message Summary" shows a set of communication-specific charts for the Application. Each chart displays historical data for a given statistic. The time interval selection determines the aggregation period of the chart, e.g. Daily or Monthly.

screenshot

Chart Description
Uplinks The number of uplinks processed for the application for each displayed time period
Downlinks The number of downlinks processed for the application for each displayed time period
Security Sessions The number of successful joins processed for each displayed time period

Onboarding Summary

The "Onboarding Summary" shows a set of charts for Devices that were added, removed, Activated, Deactivated or Registered to the Application. Each chart displays historical data for a given statistic. The time interval selection determines the aggregation period of the chart, e.g. Daily or Monthly.

screenshot

Checking the "Show Combined Charts" checkbox presents a consolidated view of the Onboarding Summary charts.

screenshot

Chart Description
New Devices The number of new Devices that were first heard for each displayed time period
Devices Activated The number of Devices that were Activated during each displayed time period
Devices Registered The number of Devices that were Registered during each displayed time period
Devices Deactivated The number of Devices that were Deactivated during each displayed time period

Operational Summary

The "Operational Summary" shows a set of charts for Device communication activity or inactivity . Each chart displays historical data for a given statistic. The time interval selection determines the aggregation period of the chart, e.g. Daily or Monthly.

screenshot

Checking the "Show Combined Charts" checkbox presents a consolidated view of the Operational Summary charts.

screenshot

Chart Description
Devices Activated & Reporting The number of Devices that were heard from in each displayed time period and were in the Activated state
Devices Deactivated & Reporting The number of Devices that were heard from in each displayed time period and were in the Deactivated state
Devices Activated & Not Reporting The number of Devices that have not been heard during each displayed time period

Device Contracts

A contract defines the billing rate and communications entitlement associated with a pool of Devices. When contracts are established, Contracts IDs are assigned by Senet and made available to associate in the Registration and Activation processes. Contracts are optionally assigned to Devices during the Registration Process, but it is mandatory to assign a contract during the Device Activation process. Once the Device has been Activated and has Joined the network a contract may only be updated by contacting Senet Support. When a Device is Activated it transitions to a billable state.

The panel below displays all of the available contracts that are associated with the Application Provider. These contracts are available to assign to your Devices during the Registration and Activation processes, the ID field maps to the contractId variable for use with the Registration/Activation API . The list of contracts is updated as new contracts are created for different engagements on the Senet Network.

screenshot