Subscribe to Alarms

Function Description

The OPS allows a maintenance assistant to subscribe to alarms. When an alarm is generated, the maintenance assistant is triggered.

Command Prototype

opsObj.alarm.subscribe(tag, feature, event, condition[4]=None, alarm_state=start, occurs=1, period=30)

Parameter Description

Table 1 describes parameters supported by alarm subscription APIs.
Table 1 Parameters supported by alarm subscription APIs




Specifies an OPS object. It is obtained through ops.ops() instantiation.


Specifies a condition ID. The value is a string of 1 to 8 case-sensitive characters. It starts with a letter and can contain letters, digits, and underscores (_). The value can be None Working conditions with a tag and without a tag are mutually exclusive. If the two conditions are used, the condition that is successfully configured first takes effect. In addition, the tag cannot be set to and, or, or andnot.


Specifies a feature name, which is a well-known character string, such as ospf.


Specifies an event name, which is a well-known character string, such as VFM_FLHSYNC_FAIL.


Specifies a condition array. The value can be None. The array contains a maximum of four members. For example:

conditions = []

con1 = {'name':'ifIndex', 'op':'eq', 'value':'100'}


con2 = {'name':' vpnInstance', 'op':'eq', 'value': 'abc'}


The relationship between multiple conditions is AND.


Whether an alarm is generated or cleared. The value can be start or end.


Specifies the number of occurrence times within a statistical period.


Specifies a subscription period.

Description of Return Values

  • First return value: The value 0 indicates a success, and the value 1 indicates a failure.
  • Second return value: This value describes success or failure reasons, expressed in a character string.


import ops 

def ops_condition(_ops):
   _ops. alarm.subscribe("alm1", "bgp", "bgpBackwardTransition", condition, alarm_state='start')

def ops_execute(_ops):
   handle, err_desp  =
   _ops.cli.execute(handle,"display device > ops_test.log")
   ret = _ops.cli.close(handle) 
   return 0

After the script is executed, an alarm is triggered when bgpBackwardTransition is detected.

Copyright © Huawei Technologies Co., Ltd.
Copyright © Huawei Technologies Co., Ltd.
< Previous topic