Skip to main content

Analyzing base station alarms

About base station alarms

An alarm is raised when a malfunction is detected on a specific base station. Each active alarm is associated with a severity that defines the importance of the service impact:

  • CRITICAL (red): The service is affected. An immediate corrective action is required.
  • MAJOR (orange): The service is partly affected. An urgent action is required.
  • MINOR (yellow): A fault that does not affect the service should be corrected to prevent the problem from aggravating further.
  • WARNING (blue): A potential or impending fault affecting the service should be diagnosed and corrected, if necessary.
  • INDETERMINATE (purple): The severity cannot be determined.

An alarm is automatically CLEARED (green) when the resolution of the associated malfunction is detected. A CLEARED alarm remains in this state until the malfunction is detected again: in this case the alarm is raised again and moves to the associated severity.

To learn more about possible base station alarms and how to troubleshoot them, see Base station alarms.

Viewing the distribution of base station alarms per severity

The distribution of base station alarms per severity provides an overview of the malfunctions currently detected on your fleet of base stations. Alarms acknowledged by administrators are not taken into account in this distribution. See Viewing the list of base station alarms for more information on alarm acknowledgement.

  1. In the left panel, select Alarms.

  2. In BASE STATION ALARMS, a pie chart displays the distribution of base station alarms per severity.

Viewing the list of base station alarms

The list of base station alarms provides a complete view of the malfunctions currently detected on your fleet of base stations in order to take the appropriate corrective actions.

  1. In the left panel, select Alarms.

  2. In ALARMS DETAILS, clicking the Base Stations tab displays the list of base station alarms.

    • By default, alarms that are either cleared or acknowledged are hidden because they don't require any corrective action, and last updated alarms are displayed first. The default filtering and sorting options can be customized, see Filtering base station alarms for more details.
    • The State column either contains the severity of active alarms, or displays CLEARED for already cleared alarms. An occurrence number may be displayed on the alarm state. To learn more about the meaning of the occurrence number for each type of alarm, see Base station alarms.
    • The Base Station Name and LRR-ID columns contain the identifiers of the base station for which the alarm is raised. Clicking on the name or the LRR-ID allows to navigate to the dashboard of the base station.
    • Expanding an alarm, as shown in the preceding screen, displays the alarm's details and the troubleshooting actions to solve the associated malfunction. The VIEW ALARM HISTORY button displays the list of the past instances of the same alarm in the last 15 days. The displayed severity in this list is the last severity reached by the alarm before clearance.
    • If you are entitled to a Base stations manager role, you can acknowledge selected alarms by clicking . Acknowledging an alarm is useful if you consider it as being not important and you do not want to see it in the list of active alarms.
      note

      The acknowledgment will be automatically reversed if the severity of the alarm increases. While an alarm is acknowledged, no email notification is sent for that alarm.

The Domains column is only available if the permission segregation based on domains has been enabled by an Administrator user. In this case, if the alarm has been triggered on a base station associated with a domain, the domain is displayed. For more information, see About domains.

Filtering base station alarms

By default, alarms that are either cleared or acknowledged are hidden because they don't require any corrective action. You can change the default filters to extend or restrict the list of base station alarms. If you change filters, your selection is saved and will apply by default for next sessions on the same computer.

  1. In the left panel, select Alarms.

  2. In ALARM DETAILS, select the Base Stations tab.

  3. If Active filters is displayed:

    • To clear all active values of a same filter, click the filter cross.

    • To delete all active filters, click Clear all.

    • To edit the active filters, click Edit filters.

  4. If no filter is active, click Add filter.

  5. In the Filter base stations alarms dialog box that opens, restrict your search using the filters you want.

    FilterDescription
    LRR IDRetrieves alarms raised on a specific base station by providing its LRR ID. Tips You can copy and paste a LRR ID you get from the traffic shown by Wireless Logger application to investigate further a base station.
    Created afterRetrieves alarms created after the specified date.
    Updated beforeRetrieves alarms updated before the specified date.
    Alarm nameRetrieves a specific alarm by selecting its name in the list. For more information about base station alarms and their meaning, see Base station alarms.
    Clearance statusFilters alarms based on their state: only Active alarms (with a state different than CLEARED), only Cleared alarms (with a state equal to CLEARED), or All alarms.
    Minimum severityRetrieves active alarms having a severity equal to the selected severity or higher. This filter is only applicable when the Clearance status filter is set to Active.
    Ack statusFilters alarms based on their acknowledgement status: only Not acknowledged alarms, only Acknowledged alarms, or All alarms.
  6. Click Apply.

If the segregation based on domains has been enabled by an administrator user, a Domains filter allows to only display base station alarms associated with one of the specified domains. See About domains for more details.

Sorting base station alarms

You can sort the list of base station alarms to prioritize corrective actions. If you change the sort, your selection is saved and will apply by default for next sessions on the same computer.

  1. In the left panel, select Alarms.

  2. In ALARM DETAILS, select the Base Stations tab.

  3. You can sort alarms by clicking the arrow of the following column headers:

    • State: Sorts alarms by state in ascending or decreasing order. Alarms sharing the same state are then sorted by last update in decreasing order.
    • Acked: Sorts alarms by acknowledgement status in ascending or decreasing order. Alarms sharing the same acknowledgement status are then sorted by last update in decreasing order.

If you are entitled to a Base stations manager role, you can define an inactivity alarm per base station and set one or two thresholds to trigger this alarm. For example, triggering the alarm with WARNING severity after 1 hour of inactivity, and increasing the severity to MAJOR after 2 hours of inactivity. For more details on the "Unusually low uplink traffic level" alarm, see Unusually low uplink traffic level.

warning

The "Unusually low uplink traffic level" alarm is not supported by base stations using Semtech's Basics Station packet forwarder.

  1. In the left panel, select Base Stations.

  2. On the List tab, click the name of the base station for which you want to define the "Unusually low uplink traffic level" alarm.

  3. Select the Advanced tab, and go to ALARMS SETTINGS.

  4. In Low Uplink Activity Alarm Thresholds, check the Threshold 1, select an inactivity period in the Condition and configure the Severity. Optionally, you can also check the Threshold 2 and configure it the same way.

    -> A confirmation notification displays on your screen.

Managing notifications for base station alarms

Email notifications

You can subscribe to email notifications for base station alarms in your user profile. For more information, see Editing your user profile.

If you are entitled to an Administrator role, you can manage the subscription of all user accounts by editing their user profiles. For more details, see Viewing and modifying a user account.

If you are entitled to an Administrator role, you can also create notifications to any email address.

  1. In the left panel, select Administration > Settings, and go to CONFIGURATION.

    -> In Base Station Alarm Notification > Email Recipients, each email recipient is displayed as a badge containing the email address and the minimum severity:

  2. Click in Email Recipients then click to add a new one.

  3. In Email address, type the recipient email address.

  4. In Minimum severity, choose the minimum severity for which you want the email recipient to be notified.

  5. You can also edit an existing email recipient by clicking on badge content or remove an existing email recipient by clicking on the badge cross.

  6. Confirm your changes.

    -> A confirmation notification displays on your screen.

    • An email notification will be sent to each configured email address in the following situations:
      • A base station alarm is triggered and its severity is equal to the selected minimum severity or higher.
      • The severity of a base station alarm increases and the new severity is equal to the selected minimum severity or higher.
      • The severity of a non-acknowledged base station alarm decreases and the previous severity was equal to the selected minimum severity or higher.
      • A non-acknowledged base station alarm is cleared and its severity before clearance was equal to the selected minimum severity or higher.

Notifications toward external IoT applications

You can enable the notification of base station alarms via the connections toward external IoT applications. To do so, the notification of base station alarms must be enabled on the connection and the connection must be associated with all base stations for which you want to notify the alarms.

Enabling the notification of base station alarms on a connection

If you are entitled to a Devices, multicast groups and connections manager role, you can enable the notification of base station alarms on a connection.

  1. In the left panel, select Connections.

  2. Click the name of the connection for which you want to enable the notification of base station alarms.

    warning

    The notification of base station alarms is not supported via Basic HTTPS connections.

  3. Go to ALARM NOTIFICATION and switch on the Base Station Alarms.

Associating a base station with a connection

If you are entitled to a Base stations manager role, you can associate a base station with a connection for alarms notification purpose.

  1. In the left panel, select Base Stations.

  2. On the List tab, click the name of the base station for which you want to configure the notification of alarms via connections.

  3. Select the Advanced tab, and go to ALARMS SETTINGS.

    -> In Alarm Notification, the list of connections currently associated with the base station for alarms notification is displayed.

    • You can add a new connection by clicking on the ADD A CONNECTION button. The list contains all the connections not already associated with the base station for which the notification of base station alarms is enabled. The button is disabled if no more connections are available.
    • You can also edit an existing connection to replace it with another one, or delete an existing connection.
    • A connection is highlighted in orange when the notification of base station alarms has been disabled on the connection. In this case base station alarms are no more notified via this connection. You need to either enable the notification of base station alarms on the connection or delete it.
  4. Confirm your changes.

    -> A confirmation notification displays on your screen.

    • A notification will be sent to the connection in the following situations:

      • An alarm is triggered for the associated base station.
      • The severity of an alarm increases or decreases for the associated base station.
      • An alarm is cleared for the associated base station.
    • Here's an example of base station alarm notification JSON document:

      {
      "BS_alarm": {
      "ID": 102,
      "State": 1,
      "CreationTime": "2022-12-05T19:57:02Z",
      "LastUpdateTime": "2022-12-05T19:57:06Z",
      "Occurrence": 1,
      "Acked": false,
      "AddInfo1": "1",
      "LrrID": "100001C2",
      "PartnerID": "1100033327",
      "CustomerID": "1100033327",
      "BaseStationData": {
      "name": "My base station 1"
      }
      }
      }

SNMP notifications

note

SNMP notifications are available only on self-hosted ThingPark Enterprise. To use this feature, a platform configuration is required.

See:

SNMP allows to be notified of base station alarms by receiving SNMP traps on a SNMP server. Notifications of alarms via SNMP are added to the notifications of alarms via email.

SNMP traps are defined in the following MIBs: