Generic SNMP Trap Format
The following shows the syntax of SNMP trap notifications for Prime Infrastructure:
Component
: Component Name,
Server
: Primary, Secondary or Standalone,
Type
: Process, Sync, Activity, etc.,
Service
: Service Name,
When
: Phase in the Prime Infrastructure Lifecycle,
State
: HA and HM state of the server,
Result
: Warning, Failure, Success, Information, Exception,
MSG
: Free-form text of the message for a given SNMP Trap
Table A-3
describes possible values for each of the generic trap format attributes.
.
Table A-3 Values for Generic SNMP Trap Format Attributes
|
|
Component
|
Health Monitor or High Availability
|
Server
|
From which server (Primary, Secondary or Standalone) was this trap sent?
|
Type
|
Which type of action (Process, Sync, Activity, etc.) resulted in this trap?
|
Service
|
Which Prime Infrastructure service reported this issue? The possible values include Registration, Failover, Failback, NMS, NCS, Health Monitor, All, Prime Infrastructure, Database, Disk Space, and so on.
|
When
|
At what point in the Prime Infrastructure server's life cycle (Startup, Shutdown, etc.) did this happen?
|
State
|
What is the server state (Standalone, Failover, Failback, Registration, etc.)?
|
Result
|
For which condition is this SNMP trap being reported?
|
MSG
|
Freeform text providing more details specific to each SNMP trap.
|
Working With Prime Infrastructure Traps
The following sections explain how to configure and use Prime Infrastructure trap notifications.
Related Topics
Configuring Notifications
For Prime Infrastructure to send northbound SNMP trap notifications, you must configure the correct settings on both the Prime Infrastructure Event Notification and Notification Receivers pages. Once configured, traps will be generated based on the values associated with the Threshold and Severity for the following SNMP Events:
-
Appliance Process Failure
-
HA Operations
-
CPU, disk and memory utilization
-
Disk, fan and PSU Failure
-
Backup failure, certification expiry and licenses violations
You can edit the threshold and severity associated with each event, and enable or disable trap generation for the associated event.
Step 1 Log in to Prime Infrastructure using a user ID with root domain privileges.
Step 2 Select
Administration > Settings > System Settings > Alarms and Events > System Event configuration
.
Step 3 For each SNMP event you want to configure:
a. Click on the row for that event.
b. Set the
Event Severity
level to Critical, Major, or Minor, as needed.
c. For the CPU, disk, memory utilization, life cycle, data center, assurance, and collector traps: Enter the
Threshold
percentage (from 1-99). These events will send the associated SNMP traps when the utilization exceeds the threshold limit. You cannot set thresholds for events for which the threshold setting is shown as NA. These events send traps whenever the associated failure is detected.
d. For backup threshold, certificate expiry, certificate expiry (critical), lifecycle license, data center license, assurance license, and collector license trap: Enter the
Threshold
in days (from x-y, where x is the minimum value and y is the maximum value in days).
e. Set the
Event Status
to Enabled or Disabled. If set to Enabled, the corresponding trap will be generated for this event.
Step 4 When you are finished, click
Save
to save your changes.
Related Topics
Configuring Notification Receivers
Once you have enabled trap notifications and customized their severities and thresholds, you must configure one or more Notification Receivers to receive the traps.
When you add a Notification Receiver, remember to select the System checkbox as one of the Criteria and, set the Severity to the highest severity set under the severity level configured for each trap on the Event Notifications page.
Step 1 Log in to Prime Infrastructure with a user ID that has administrator privileges.
Step 2 Select
Administration > Settings > System Settings > Alarms and Events > Notification Receivers.
Step 3 From the
Select a command
drop-down list, choose
Add Notification Receiver
, then click
Go
.
Step 4 Complete at least the following fields:
a.
IP Address
: Enter the IPv4 or IPv6 address of the server on which the receiver will run.
b.
Server Name
: Enter the host name of the server on which the receiver will run.
c. Under
Criteria - Category
, select at least the
System
checkbox.
d. Under Criteria -
Severity
, select the highest
Severity Level
that you set when you configured the trap notifications themselves.
For example: If you selected “Critical” as the
Event Severity
for a PSU failure, select “Critical” as the value in this field.
Alternatively: Select
All
to receive all traps, regardless of severity.
Step 5 When you are finished, click Save.
Related Topics
Port Used To Send Traps
Prime Infrastructure sends traps to notification receivers on port 162. This port cannot be customized at present. The northbound management system has to register itself through the Notification Receiver web page (see Configuring Notification Receivers).
Configuring Email Notifications for SNMP Traps
You can configure Prime Infrastructure to send email notification for alarms and events generated in response to SNMP traps. All of these alarms and events are considered part of the System event category. You can also customize the severity level for which such notifications will be sent.
Note that, for these email notifications to be sent, the Prime Infrastructure administrator must configure at least a primary SMTP email server.
Step 1 Log in to Prime Infrastructure.
Step 2 Select
Monitor > Monitoring Tools > Alarms and Events.
Step 3 Click
Email Notification tab
. Prime Infrastructure displays the first Email Notification Settings page.
Step 4 In the
Alarm Category
column, click on the
System
category's name. Prime Infrastructure displays a second Email Notification Settings page.
Step 5 Under
Send email for the following severity levels
, select all of the severity levels for which you want Prime Infrastructure to send email notifications.
Step 6 In
To
, enter the email address to which you want Prime Infrastructure to send email notifications. If you have multiple email addresses, enter them as a comma-separated list.
Step 7 Click
Save
. Prime Infrastructure displays the first Email Notification Settings page.
Step 8 In the
Enable
column, make sure System is selected, then click
Save
.
Related Topics
Configuring Email Server Settings
To enable Prime Infrastructure to send email notifications, the system administrator must configure a primary SMTP email server (and, preferably, a secondary email server).
Step 1 Log in to Prime Infrastructure using a user ID with administrator privileges.
Step 2 Select
Administration > Settings > System Settings > Mail and Notification > Mail Server Configuration
.
Step 3 Under
Primary SMTP Server
, complete the
Hostname/IP
,
User Nam
e,
Password
and
Confirm Password
fields as appropriate for the email server you want Prime Infrastructure to use. Enter the IP address of the physical server. You cannot enter a virtual IP address in the Hostname/IP field, and the IP address cannot be behind a load balancer.
Step 4 (Optional) Complete the same fields under
Secondary SMTP Server
.
Step 5 Under
Sender and Receivers
, enter a legitimate email address for the Prime Infrastructure server.
Step 6 When you are finished, click
Save
.
Related Topics
Viewing Events and Alarms for SNMP Traps
Events and Alarms for all of Prime Infrastructure’s internal SNMP traps fall under the System category. You can view them in the Prime Infrastructure Alarms and Events dashboard.
Step 1 Log in to Prime Infrastructure.
Step 2 Select
Monitor > Monitoring Tools > Alarms and Events
.
Filtering Events and Alarms for SNMP Traps
You can use the Prime Infrastructure Filter feature to narrow the display of alarms to just those in the System category, or use a combination of criteria and operators to focus the list on very specific alarms. The following sections explain how to do this.
Related Topics
Filtering for SNMP Traps Using Quick Filters
Prime Infrastructure's Quick Filters allow you to quickly focus on the data inside a table by applying a filter for a specific table column or columns.
Step 1 Log in to Prime Infrastructure.
Step 2 Select
Monitor > Monitoring Tools > Alarms and Events
.
Step 3 From the
Show
drop-down list, select
Quick Filter
. Prime Infrastructure displays a table header listing fields on which you can perform a quick filter, including
Severity
,
Message
, and
Category
.
Step 4 In the
Category
field, enter
System
. Prime Infrastructure displays only System alarms.
Step 5 To clear the Quick Filter, click the funnel icon shown next to the
Show
box.
Filtering for SNMP Traps Using Advanced Filters
Prime Infrastructure's Advanced Filter allows you to narrow down the data in a table by applying a filter combining multiple types of data with logical operators (such as “Does not contain”, “Does not equal”, “Ends with”, and so on). For example, you can choose to filter the table of alarms based on the Category, then further reduce the data by filtering on Severity (as shown in the steps below). You can also save an Advanced Filter for later re-use.
Step 1 Log in to Prime Infrastructure.
Step 2 Select
Monitor > Monitoring Tools > Alarms and Events
.
Step 3 From the
Show
drop-down list, select
Advanced Filter
. Prime Infrastructure displays a table header showing criteria for the first rule in the filter.
Step 4 Complete the first rule as follows:
a. In the first field, select
Category
from the drop-down list.
b. In the second field, select
Contains
from the drop-down list.
c. In the third rule field, enter
System
.
d. Click
Go
. Prime Infrastructure displays only System alarms.
Step 5 Click the plus sign icon to add another rule, then complete the second rule as follows:
a. In the first field, select
Severity
from the drop down list
b. In the second field, select
equals (=)
from the drop-down list.
c. In the third rule field, select
Major
from the drop-down list.
d. Click
Go
. Prime Infrastructure displays only System alarms with Major Severity.
Repeat this step as needed.
Step 6 To save the Advanced filter, click the
Save
icon and supply a name for the filter.
Step 7 To clear the Advanced Filter, click
Clear Filter.
Related Topics
Purging Alarms for SNMP Traps
You can remove an alarm from the list of alarms by changing its status to Acknowledged or Cleared. No e-mails will be generated for these alarms.
Step 1 Log in to Prime Infrastructure.
Step 2 Select
Monitor > Monitoring Tools > Alarms and Events
.
Step 3 Select an alarm, then choose
Change Status > Acknowledge
or
Change Status > Clear
.
Troubleshooting Prime Infrastructure SNMP Traps
If you are having trouble with Prime Infrastructure's internal traps and related notifications, check the following:
Step 1 Ping the notification receiver from the Prime Infrastructure server, to ensure that there is connectivity between Prime Infrastructure and your management application.
Step 2 Check if any firewall ACL settings are blocking port 162, and open communications on that port if needed.
Step 3 Log in to Prime Infrastructure with a user ID that has administrator privileges. Select
Administration > Settings > Logging
and download the log files. Then compare the activity recorded in these log files with the activity you are seeing in your management application:
-
ncs_nb.log: This is the log of all the northbound SNMP trap messages Prime Infrastructure has sent. Check for messages you have not received.
-
ncs-
#
-
#
.log: This is the log of other recent Prime Infrastructure activity. Check for hardware trap messages you have not received.
-
hm-
#
-
#
.log: This is the complete log of Health Monitor activity. Check for recent messages about High Availability state-changes and application-process failures that you have not received.
The messages you see in these logs should match the activity you see in your management application. If you find major differences, open a support case with Cisco Technical Assistance Center (TAC) and attach the suspected log files with your case.
Related Topics