Configuring Telemetry

Telemetry allows you to collect and transmit data about the performance and operation of the router and connected devices, so that this data can be remotely monitored and analyzed.

Under Services > Telemetry, you can configure the AirLink OS Telemetry settings as shown below:

Initializing Table Of Contents...

General

The following settings can be configured for AirLink OS Telemetry.

Vehicle Settings

Vehicle settings are a subset of telemetry. If vehicle ignition status reporting is desired, then the following settings must be set to specify how the router has been installed in the vehicle.

AMR Reports

The complete telemetry data set can be sent to AirVantage allowing for the viewing of all Advanced Mobility Reports (AMR).

Custom Reports

Custom reports allow you to tailor your reports to better suit your needs. Initially you would define the report with specific data content and then you would assign it to the trigger event.

REPORTS

Define reports with your specific data requirements that can be sent to ALMS and/or an MQTT broker.

PERIODIC TRIGGERS (Generate reports at fixed intervals)

Reports can be generated at fixed time intervals using Periodic Triggers.

UNCONDITIONAL TRIGGERS (Generate reports upon every data sample)

Reports can be generated when a data sample changes using Unconditional Triggers.

Example 1: GPIO Input Cumulative

GPIO Input Cumulative is calculated using the Primary GPIO Input (line 4 of the power connector). Any change in the GPIO Input will affect the GPIO Input Cumulative and generate a report.

Example 2: WAN Ready

A WAN Ready sample is generated when WAN connectivity of the router switches between up or down.

Example 3: Ignition Status

• Time A: Ignition is DOWN.
• Time B: Ignition is UP.
• Time C: Ignition is DOWN.

Two Ignition Status samples are generated because the Ignition Status changed.

Example 4: Primary WAN

A PRIMARY WAN sample is generated whenever there is a switch in which interface is evaluated as primary.

• Time A: Wi-Fi Client is UP and is designated as the PRIMARY WAN. Cellular is also UP.
• Time B: Wi-Fi Client is UP. Cellular is DOWN.

No PRIMARY WAN sample is generated in this example.

• Time A: Wi-Fi Client is UP and is designated as the PRIMARY WAN. Cellular is also UP.
• Time B: Wi-Fi Client goes down. The PRIMARY WAN designation is re-evaluated to see if Wi-Fi Client is still the PRIMARY WAN, and it is not. Wi-Fi Client – Down. Cellular – New PRIMARY WAN.

A PRIMARY WAN sample is generated in this example.

DELTA TRIGGERS (Generate reports at minimum change in value or maximum elapsed time)

Reports can be generated using Delta Triggers when the sampled value has changed at least the configured amount since the last sample or a configured maximum time has passed.

LEVEL TRIGGERS (Generate a report for each monitored data sample that meets the trigger condition)

Reports can be generated when a configured condition is true.

EDGE TRIGGERS (Generate one report when monitored condition becomes true)

A single report can be generated when a monitored condition crosses the configured edge threshold.

MQTT

The MQTT section will only display if a custom report has the REPORT MODE set to an MQTT option.

A destination MQTT broker can be configured using the following settings.

6Q1099009902AC24/test {
  “atp.ser” :
   {
        “t”: 1693258321.3640001,
        “v” : “6Q1099009902AC24”
    },
        “ts” : 1693268920.464
}

More information about MQTT can be found here.