Application Provider Documentation

Application Providers manage and monitor the health of one or more applications on the network. The Application Provider Portal provides application management features and visibility into the state of end Devices.


screenshot

Application Views

Click on the header buttons to change the view.

screenshot Dashboard: Message and notification statistics

screenshot Events: View System Events, Application LoRa Events, and Device Management Events

screenshot Devices: Devices that have joined the network

screenshot Devices with Notifiers: Devices with custom notification targets

screenshot Alerts: Application notifier alerts

screenshot Device Management: Registered, Activated and deactivated Devices

screenshot Application Usage: Monthly and daily application statistics

screenshot Device Profiles and Contracts: Available Device profiles and contracts

Details Panel

The Details Panel displays application metadata. Click on the screenshot button to minimize.

screenshot

Dashboard

The Dashboard view shows message and notification statistics for the managed application. Values are updated every 15 minutes.

screenshot

Devices

The Devices view displays transaction data for Devices that have joined the SenRa Network on the managed application.

screenshot

Use the Search bar to find Devices by their EUI.

screenshot

screenshot Update Devices: Upload a CSV file to update Device fields

screenshot Device Configuration: Edit Information and Settings or Tags for the selected Devices

screenshot Refresh: Manually request the latest data

screenshot Settings: Control the column visibility

screenshot Export: Export the table to a Excel file

screenshot Firmware Upgrade: Update the firmware for the selected Device

screenshot Diagnostic Mode: Put selected Devices in Diagnostic Mode

Devices can also be filtered to show the Devices for a specific Contract. Here, the Devices for the GeneticsLab Contract are shown:

screenshot

Checking the Show Map checkbox shows the Devices on a map if either the actual or estimated locations are known.

screenshot

Select Filter to Selected Devices to limit the Devices view to a select group of Devices. This filtered view can be shown with or without the Map.

screenshot

screenshot

Note: The RSSI and SNR columns include color-coded icons to reflect the strength and quality of uplinks from each Device. The following table provides the meaning of each color along with the corresponding value-range. When hovering over an icon, this text will be displayed as a tooltip.

Color RSSI SNR
Green Very Good RSSI: >= -95 Very Good SNR: >= 1
Blue Good RSSI: > -110 and < -95 Good SNR: >= -6 and < 1
Yellow Fair RSSI: >= -125 and < -110 Fair SNR: >= -13 and < -6
Red Poor RSSI: < -125 Poor SNR: < -13

Device Configuration

The following Device information can be set in the Information and Settings dialog: Device Type, Device Profile, Device Class, Firmware Version, Latitude and Longitude and Metadata.

screenshot

Exporting Device Service Metrics Data

Service Metrics data is calculated based on the terms of an associated Contract. The data can be exported from the Application Details Devices view.

  1. Click on the Export button in the view to display a menu showing available export options.
    screenshot

  2. Click on Export Service Metrics Data to show a dialog presenting a list of Contracts associated with the Application.

screenshot

  1. Select the desired Contract and Service Period and click the Export button to begin the export.

  2. The data is exported to an Excel formatted file that appears in the lower left corner of the browser. The columns Metric A, Metric B and Metric C in the exported file, show the percentage of days within a 31 day period that a Device sent an uplink within the associated time window.

Diagnostic Mode

Enabling Diagnostic Mode for a Device adds it to the Developer Dashboard and enables notifiers. Devices with Diagnostic Mode enabled will appear in the Devices table with an screenshot icon next to their EUI. Clicking on an EUI will open the Device Details view. Diagnostic Mode can be enabled on a limited number of Devices. Please contact support@senraco.com to increase the limit for an account.

Device Details

The Device Details view contains a series of sub-views that present Device centric transactional or location data. These views provide in-depth historical information that assists in troubleshooting Device behavior.

Device Transactions Transactions: Display LoRa transactional events for the Device.

Device Map Map: Displays the current location of a Device on a map.

Device RF Statistics RF Statistics: Display RF information for the Device in heatmap form.

Device Statistics Statistics: Display key LoRa transactional statistics for a Device.

Click on a Device EUI to open the Device Details view.


Device Transactions

The Device Details Transactions view is a combined table and chart view that shows the communication events between the Device and the Network Server. The table shows the processed LoRa event data and the chart shows the statistics from those events over time. Events that are received late are specifically identified with light italicized text in the Time column.

The view can be filtered to specific event types or to communications involving specific Base Stations. The chart view will display the statistics from those filtered events and supports display of either one or two statistics at a time.

screenshot

Pre-defined Filters:

The Transactions view has several pre-defined filters to help troubleshoot LoRa network issues. These filters are only applied to events loaded into the view.

Filter Name Description
Unique Uplinks Filters to events with "Uplink" in the type column and where the sub-string "dup=true" is not in the Details column.
Join Activity Filters to events with "Join" in the Type column.
Application Downlinks Filters to Unique Uplink events, events with "Downlink" in the Type column, events with data in the Encrypted or App PDU columns and events with "Ack=true" in the Details column
ADR Activity Filters to events with "ADR Check" in the Type column or events with any of the following strings in the Details column: "LinkADRReq","LinkADRAns", or "ADRAckReq=True".
Uplinks Filters to events with "Uplink" in the Type column.
Downlinks Filters to events with "Downlink" in the Type column.
MAC Commands Filters events with a MAC command string appearing anywhere in the Details column.

Date/Time Filtering:

Events can be filtered to those that occurred at a specific point in time using the Date/Time filter. Click the screenshot button to open the limit and Date/Time filtering options for the view.

The options popup has two modes, a row limiting mode and a Date/Time filter mode. The row limit mode is used to define the number of events that are returned from the server. Limiting the number of rows returned generally improves data processing performance.

screenshot

As noted, the Date/Time filtering mode is used to filter events to a specific point in time. Selecting a date and time, determines the starting point for the events that will be returned. The Duration value determines the maximum amount of time from the specified start time that events will be returned. For example, starting at 7 a.m. with a duration of 1 hour will return events that occurred between 7 a.m. and 8 a.m. Since the number of events that occur within a specified timeframe is variable, the Max Rows value is used to further limit the returned data.

screenshot

Device Map

The Device Details Map view provides a location context for the Device. The position of the Device may be actual or estimated depending on GPS support or activation of the estimated location feature. Historical positional data may also be available if the Device model includes that data when communicating with the Network Server. Like the main Map view, the Device Details Map view supports display of detailed Device information in the Map.

screenshot

Path Quality information is also available:

screenshot

Device RF Statistics

The RF Statistics view consists of three heatmap charts that show Uplink,SNR and RSSI statistics on a per-channel basis over time. The view supports daily or monthly aggregation of the data and supports navigation through time in 1 hour, 6 hour or 1 day increments.

screenshot

The view also supports displaying the backing data in table format as shown here:

screenshot

Device Statistics

The Device Statistics view shows historical charts of important Device data, such as PSR, Data Rate, RSSI, SNR and others. The view supports displaying the statistics in hourly, daily and lifetime timeframes.

screenshot

Chart Description
PSR/Data Rate A combined chart showing the Device's historical PSR and Data Rate for each displayed time period.
ADR Changes A chart showing a count of the Data Rate changes that occur due to ADR for each displayed time period.
Avg. RSSI/SNR A combined chart showing the Device's historical RSSI and SNR values for each displayed time period.
Redundancy A chart showing a count of the Base Stations hearing the Device for each displayed time period.
Up Pkts A chart showing the count of northbound packets sent to the Network Server for each displayed time period.
Down Pkts A chart showing a count of southbound packets sent to the Device for each displayed time period.
Up Bytes A chart showing the count of northbound bytes sent to the Network Server for each displayed time period.
Down Bytes A chart showing a count of southbound bytes sent to the Device for each displayed time period.
Join Requests/Accepts A combined chart showing a count of join requests sent by the Device and counts of join accepts sent to the Device for each displayed time period.
Security Sessions The number of successful joins processed for each displayed time period

Details Panel

The Details Panel on the left side of the image above allows users to create or edit a custom Notification Target, send downlinks and view Device information and statistics. Click on the screenshot button to minimize.

Device Details Details: Display current information about the Device

Device Downlink Send Downlink: Send downlink PDUs to the Device

Device Edit Edit Device: Open the Edit Device window (see below). This button is only visible if Diagnostic mode is enabled for the Device.

On-demand application downlinks can be sent directly from the Device Details view. A message is sent by specifying the message PDU and the target port on the Device. Message confirmation is enabled by checking the corresponding checkbox.

screenshot

When operating as Class-B or Class-C, the Device's Details Send Downlink UI will display a Device Class selector. 

Downlink options include: 

screenshot

Edit Device

screenshot

Create a custom Notification Target or edit the previously configured Notification Target. Devices with custom Notification Targets will appear in the Devices with Notifiers view. See the Developer Streaming documentation for more details.


Application Events

The Application Events view provides a consolidated view of the LoRa events associated with the Application. Like other event views, the Application Events may be filtered by date and time to focus events that occurred at a specific point in time. Events may also be traversed historically using the "More" button. Events that are received late are specifically identified with light italicized text on the Time column.

screenshot

System Events

System events are system level events for the Application and Join Servers. This table allows you to navigate these events to help troubleshoot issues with the Application.

screenshot

Clicking on a system event allows you to view the details of the event.

screenshot

Device Management Events

Device management are specific audit events generated by Device management changes. They contain the details of the changes including; The time the changes took place, which Devices were changed (Ids), who completed the changes (Username), and how the changes were performed (Authentication). Events are generated in batches of 500 devices so it is not uncommon to see several events for a single change.

screenshot

You can view the details of an event by clicking on a row in the table which launches a dialog.

screenshot

Devices with Notifiers

Streaming data for Devices with custom notification targets are displayed in the Device with Notifiers view.

screenshot

Use the Search bar to find Devices by their EUI.

screenshot

screenshot Refresh: Manually request for the latest data

screenshot Settings: Control the column visibility

screenshot Export: Export the table to a CSV file

Device Management

The Device Management view shows Device onboarding data.

screenshot

Use the Search bar to find Devices by their EUI.

screenshot

screenshot Upload: Upload a CSV file to Register, Activate or Deactivate Devices

screenshot Activate/Deactivate: Activate or Deactivate the selected Devices

screenshot Request Token: Request a Device registration token

screenshot Refresh: Manually request for the latest data

screenshot Settings: Control the column visibility

Device Profiles

A Device Profile can be leveraged to serve multiple purposes, it allows for the configuration of certain Device attributes that aide the network in properly managing the Device behavior. For example, the profile allows for the definition of an expected transmit interval. This transmit interval helps to identify how well a Device is performing against its daily expected communication profile.

The Device Profile also allows for the configuration of certain options that can be useful during testing and QA efforts. For example, the minimum/maximum Data Rate or range that a Device can operate at can be defined through the profile. A Device can be forced to operate at a Data Rate that is either higher or lower than that which the network would normally decide. Additional attributes that can be controlled include, but are not limited to; Tx power, Channel Plan, operational LoRa Version of the Device.

screenshot

Device Contracts

The Device Contracts view shows all Contracts created for the Application that can be used to group Devices for billing and usage data collection. See the Device Contracts section under Application Usage and Accounting for more details. screenshot