JBoss.org Community Documentation
JBoss has an SNMP adaptor service that can be used to intercept JMX notifications emitted by MBeans, convert them to traps and send them to SNMP managers. In this respect the snmp-adaptor acts as a SNMP agent. Future versions may offer support for full agent get/set functionality that maps onto MBean attributes or operations.
This service can be used to integrate JBoss with higher order system/network management platforms (HP OpenView, for example), making the MBeans visible to those systems. The MBean developer can instrument the MBeans by producing notifications for any significant event (e.g. server coldstart), and adaptor can then be configured to intercept the notification and map it onto an SNMP traps. The adaptor uses the JoeSNMP package from OpenNMS as the SNMP engine.
The SNMP service is configured in snmp-adaptor.sar
. This service is only available in the all
configuration, so you'll need to copy it to your configuration if you want to use it. Inside the snmp-adaptor.sar directory, there are two configuration files that control the SNMP service.
managers.xml : configures where to send traps. The content model for this file is shown in Figure 10.2, “The schema for the SNMP managers file”.
notifications.xml : specifies the exact mapping of each notification type to a corresponding SNMP trap. The content model for this file is shown in Figure 10.3, “The schema for the notification to trap mapping file”.
The SNMPAgentService
MBean is configured in snmp-adaptor.sar/META-INF/jboss-service.xml
. The configurable parameters are:
HeartBeatPeriod : The period in seconds at which heartbeat notifications are generated.
ManagersResName
: Specifies the resource name of the managers.xml
file.
NotificationMapResName
: Specifies the resource name of the notifications.xml
file.
TrapFactoryClassName
: The org.jboss.jmx.adaptor.snmp.agent.TrapFactory
implementation class that takes care of translation of JMX Notifications into SNMP V1 and V2 traps.
TimerName : Specifies the JMX ObjectName of the JMX timer service to use for heartbeat notifications.
SubscriptionList : Specifies which MBeans and notifications to listen for.
TrapdService
is a simple MBean that acts as an SNMP Manager. It listens to a configurable port for incoming traps and logs them as DEBUG messages using the system logger. You can modify the log4j configuration to redirect the log output to a file. SnmpAgentService
and TrapdService
are not dependent on each other.