Traps

Overview

Object name: TRAP

Show

In order to list available traps, use the SHOW action:

[root@centreon ~]# ./centreon -u admin -p centreon -o TRAP -a show
id;name;oid;manufacturer
576;alertSystemUp;.1.3.6.1.4.1.674.10892.1.0.1001;Dell
577;alertThermalShutdown;.1.3.6.1.4.1.674.10892.1.0.1004;Dell
578;alertTemperatureProbeNormal;.1.3.6.1.4.1.674.10892.1.0.1052;Dell
599;alertFanEnclosureInsertion;.1.3.6.1.4.1.674.10892.1.0.1452;Dell
600;alertFanEnclosureRemoval;.1.3.6.1.4.1.674.10892.1.0.1453;Dell
601;alertFanEnclosureExtendedRemoval;.1.3.6.1.4.1.674.10892.1.0.1454;Dell
602;alertLogNormal;.1.3.6.1.4.1.674.10892.1.0.1552;Dell
605;ccmCLIRunningConfigChanged;.1.3.6.1.4.1.9.9.43.2.0.2;Cisco
[...]

Add

In order to add a trap, use the ADD action:

[root@centreon ~]# ./centreon -u admin -p centreon -o TRAP -a add -v "aNewTrap;.1.3.6.1.4.1.11.2.3.9.7.1.0.30"

Required fields are:

Order

Description

1

Trap name

2

OID of the SNMP Trap

Del

If you want to remove a Trap, use the DEL action. The Name is used for identifying the Trap to delete:

[root@centreon ~]# ./centreon -u admin -p centreon -o TRAP -a del -v "aNewTrap"

Setparam

If you want to change a specific parameter of a Trap, use the SETPARAM command. The Name is used for identifying the Trap to update:

[root@centreon ~]# ./centreon -u admin -p centreon -o TRAP -a setparam -v "aNewTrap;vendor;3com"

Arguments are composed of the following columns:

Order

Column description

1

Name of Trap

2

Parameter name

3

Parameter value

Parameters that you may change are:

Column

Description

Possible values

name

Name

comments

Comments

output

Output

oid

OID

status

Status

ok, warning, critical, unknown or 0, 1, 2, 3

vendor

Vendor name

A valid vendor name

matching_mode

Advanced regexp matching mode

1 to enable, 0 to disable

reschedule_svc_enable

Whether or not will reschedule service check when trap is received

1 to enable, 0 to disable

execution_command

Command to be executed when trap is received

A valid Unix command line

execution_command_enable

Whether or not will execute the ‘execution_command’

1 to enable, 0 to disable

submit_result_enable

Whether or not will submit result to Service

1 to enable, 0 to disable

Getmatching

In order to display the list of matching rules defined for a specific trap, use the GETMATCHING command:

[root@centreon ~]# ./centreon -u admin -p centreon -o TRAP -a getmatching -v "aNewTrap"
id;string;regexp;status;order
8;@OUTPUT@;/test/;UNKNOWN;1

Column

Description

ID

ID of the matching rule

String

String to match

Regexp

Matching Regular Expression

Status

Status to submit

Order

Priority order of the matching rule

Addmatching

In order to add a matching rule, use the ADDMATCHING command:

[root@centreon ~]# ./centreon -u admin -p centreon -o TRAP -a addmatching -v "aNewTrap;@OUTPUT@;/test2/;critical"

Required fields are:

Order

Description

Possible values

1

Trap name

2

String to match

3

Matching Regular Expression

4

Status to submit

ok, warning, critical, unknown or 0, 1, 2, 3

Delmatching

In order to delete a matching rule, use the DELMATCHING command:

[root@centreon ~]# ./centreon -u admin -p centreon -o TRAP -a delmatching -v "8"

Required fields are:

Column

Description

ID

ID of the matching rule

Updatematching

In order to delete a matching rule, use the UPDATEMATCHING command:

[root@centreon ~]# ./centreon -u admin -p centreon -o TRAP -a updatematching -v "8;status;critical"

Arguments are composed of the following columns:

Order

Column description

1

ID of the matching rule

2

Parameter name

3

Parameter value

Parameters that you may change are:

Column

Description

Possible values

string

String to match

order

Priority order

status

Status to submit

ok, warning, critical, unknown or 0, 1, 2, 3

regexp

Matching Regular Expression