Alarms¶

NETCONF alarms can be configured on Virtual Service Router. Those alarms are triggered when an event occurs on the system, for instance when a configured service or interface goes down.

When an alarm is triggered or cleared, a NETCONF notification is sent, and the alarm status change is stored. Then, when the problem is resolved, the alarm will clear itself.

The alarms are enabled by default.

Here is a configuration that will ensure that only the last four status changes are stored, and that all state changes are notified.

vsr running config# system alarm
vsr running alarm# max-alarm-status-changes 4
vsr running alarm# notify-status-changes all-state-changes
vsr running alarm# commit
Configuration committed.

To show the list of available alarms, use show alarm inventory or show state system alarm alarm-inventory.

vsr running alarm# show alarm inventory
show-alarm-inventory
 alarm-type vrouter-alarm:service-alarm fast-path
     will-clear true
     severity-level major
     description "Monitor the fast-path service status. A service is monitored only if configured."
     ..
(...)

To show the list of alarms that have been triggered on the system, use show alarm list or show state system alarm alarm-list.

dut-vm running alarm# show alarm list
show-alarm-list
    number-of-alarms 1
    last-changed 2022-10-05T13:40:40.746371+00:00
    alarm /system/license/enabled vrouter-alarm:service-alarm license
        time-created 2022-10-05T13:40:31.959338+00:00
        is-cleared true
        last-raised 2022-10-05T13:40:40.672655+00:00
        last-changed 2022-10-05T13:40:40.746371+00:00
        perceived-severity major
        alarm-text "The license service is up as configured."
        status-change 2022-10-05T13:40:40.746371+00:00
            perceived-severity cleared
            alarm-text "The license service is up as configured."
            ..
        status-change 2022-10-05T13:40:40.672655+00:00
            perceived-severity major
            alarm-text "The license service is down when configured up."
            ..
        status-change 2022-10-05T13:40:32.016648+00:00
            perceived-severity cleared
            alarm-text "The license service is up as configured."
            ..
        status-change 2022-10-05T13:40:31.959330+00:00
            perceived-severity major
            alarm-text "The license service is down when configured up."
            ..
        ..

To show a summary of the alarm state, use show alarm summary, or show state system alarm summary.

vsr running alarm# show alarm summary
show-alarm-summary
    alarm-summary indeterminate
        total 0
        not-cleared 0
        cleared 0
        ..
    alarm-summary warning
        total 0
        not-cleared 0
        cleared 0
        ..
    alarm-summary minor
        total 0
        not-cleared 0
        cleared 0
        ..
    alarm-summary major
        total 1
        not-cleared 0
        cleared 1
        ..
    alarm-summary critical
        total 0
        not-cleared 0
        cleared 0
        ..
    ..

The alarms can be compressed (i.e. only the last status change is kept) using the cmd compress-alarm command. They can be removed using the flush alarm command.