Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Simple Network Management Protocol Protocol (SNMP) is an Internet-standard protocol for protocol for managing devices on IP networks. Given below is how to configure SNMP in WSO2 ESB, which exposes various MBeans via SNMP.   on IP networks. In order to monitor the ESB using SNMP, you need to configure SNMP with WSO2  ESB.

To configure SNMP with WSO2 ESB

  1. Download the following jar files from http://www.snmp4j.org and add them to the <ESB_HOME>/repository/components/lib directory. 
    • snmp4j-2.1.0.jar
    • snmp4j-agent-2.0.6.jar
  2. Enable SNMP in by adding the following entry to the <ESB_HOME>/repository/conf/synapse.properties file by adding the following entry:
    synapse.snmp.enabled=true

...

  1. Run the ESB in the DEBUG mode.

    Info
    titleNote

    To run the ESB in the DEBUG mode, edit the <ESB_HOME>/repository/conf/log4j.properties file and change the line log4j.category.org.apache.synapse=INFO to log4j.category.org.apache.synapse=DEBUG.

Once you enable SNMP monitoring and run the ESB in the DEBUG mode, you will see the list of registered object identifiers (OIDs) at the ESB server startup along with the SNMP agent and the SNMP transport adapter address.

Code Block
Monitoring Info : OID branch "1.3.6.1.4.1.18060.14" with the following sub-branches:

1 - ServerManager MBean

2 - Transport MBeans

3 - NHttpConnections MBeans

4 - NHTTPLatency MBeans

5 - NHTTPS2SLatency MBeans

MBean OID mappings

Following are the OID equivalents of the server manager and transport MBeans, which are described in JMX Monitoring:

Name=ServerManager@ServerState as OID: 1.3.6.1.4.1.18060.14.1.21.1.0

Name=passthru-http-sender@ActiveThreadCount as OID: 1.3.6.1.4.1.18060.14.2.17.1.0

Name=passthru-http-sender@AvgSizeReceived as OID: 1.3.6.1.4.1.18060.14.2.17.2.0

Name=passthru-http-sender@AvgSizeSent as OID: 1.3.6.1.4.1.18060.14.2.17.3.0

Name=passthru-http-sender@BytesReceived as OID: 1.3.6.1.4.1.18060.14.2.17.4.0

Name=passthru-http-sender@BytesSent as OID: 1.3.6.1.4.1.18060.14.2.17.5.0

Name=passthru-http-sender@FaultsReceiving as OID: 1.3.6.1.4.1.18060.14.2.17.6.0

Name=passthru-http-sender@FaultsSending as OID: 1.3.6.1.4.1.18060.14.2.17.7.0

Name=passthru-http-sender@LastResetTime as OID: 1.3.6.1.4.1.18060.14.2.17.8.0

Name=passthru-http-sender@MaxSizeReceived as OID: 1.3.6.1.4.1.18060.14.2.17.9.0

Name=passthru-http-sender@MaxSizeSent as OID: 1.3.6.1.4.1.18060.14.2.17.10.0

Name=passthru-http-sender@MessagesReceived as OID: 1.3.6.1.4.1.18060.14.2.17.11.0

Name=passthru-http-sender@MessagesSent as OID: 1.3.6.1.4.1.18060.14.2.17.12.0

Name=passthru-http-sender@MetricsWindow as OID: 1.3.6.1.4.1.18060.14.2.17.13.0

Name=passthru-http-sender@MinSizeReceived as OID: 1.3.6.1.4.1.18060.14.2.17.14.0

Name=passthru-http-sender@MinSizeSent as OID: 1.3.6.1.4.1.18060.14.2.17.15.0

Name=passthru-http-sender@QueueSize as OID: 1.3.6.1.4.1.18060.14.2.17.16.0

Name=passthru-http-sender@TimeoutsReceiving as OID: 1.3.6.1.4.1.18060.14.2.17.18.0

Name=passthru-http-sender@TimeoutsSending as OID: 1.3.6.1.4.1.18060.14.2.17.19.0

Name=passthru-https-sender@ActiveThreadCount as OID: 1.3.6.1.4.1.18060.14.2.18.1.0

Name=passthru-https-sender@AvgSizeReceived as OID: 1.3.6.1.4.1.18060.14.2.18.2.0

Name=passthru-https-sender@AvgSizeSent as OID: 1.3.6.1.4.1.18060.14.2.18.3.0

Name=passthru-https-sender@BytesReceived as OID: 1.3.6.1.4.1.18060.14.2.18.4.0

Name=passthru-https-sender@BytesSent as OID: 1.3.6.1.4.1.18060.14.2.18.5.0

Name=passthru-https-sender@FaultsReceiving as OID: 1.3.6.1.4.1.18060.14.2.18.6.0

Name=passthru-https-sender@FaultsSending as OID: 1.3.6.1.4.1.18060.14.2.18.7.0

Name=passthru-https-sender@LastResetTime as OID: 1.3.6.1.4.1.18060.14.2.18.8.0

Name=passthru-https-sender@MaxSizeReceived as OID: 1.3.6.1.4.1.18060.14.2.18.9.0

Name=passthru-https-sender@MaxSizeSent as OID: 1.3.6.1.4.1.18060.14.2.18.10.0

Name=passthru-https-sender@MessagesReceived as OID: 1.3.6.1.4.1.18060.14.2.18.11.0

Name=passthru-https-sender@MessagesSent as OID: 1.3.6.1.4.1.18060.14.2.18.12.0

Name=passthru-https-sender@MetricsWindow as OID: 1.3.6.1.4.1.18060.14.2.18.13.0

Name=passthru-https-sender@MinSizeReceived as OID: 1.3.6.1.4.1.18060.14.2.18.14.0

Name=passthru-https-sender@MinSizeSent as OID: 1.3.6.1.4.1.18060.14.2.18.15.0

Name=passthru-https-sender@QueueSize as OID: 1.3.6.1.4.1.18060.14.2.18.16.0

Name=passthru-https-sender@TimeoutsReceiving as OID: 1.3.6.1.4.1.18060.14.2.18.18.0

Name=passthru-https-sender@TimeoutsSending as OID: 1.3.6.1.4.1.18060.14.2.18.19.0

Name=passthru-http-receiver@ActiveThreadCount as OID: 1.3.6.1.4.1.18060.14.2.19.1.0

Name=passthru-http-receiver@AvgSizeReceived as OID: 1.3.6.1.4.1.18060.14.2.19.2.0

Name=passthru-http-receiver@AvgSizeSent as OID: 1.3.6.1.4.1.18060.14.2.19.3.0

Name=passthru-http-receiver@BytesReceived as OID: 1.3.6.1.4.1.18060.14.2.19.4.0

Name=passthru-http-receiver@BytesSent as OID: 1.3.6.1.4.1.18060.14.2.19.5.0

Name=passthru-http-receiver@FaultsReceiving as OID: 1.3.6.1.4.1.18060.14.2.19.6.0

Name=passthru-http-receiver@FaultsSending as OID: 1.3.6.1.4.1.18060.14.2.19.7.0

Name=passthru-http-receiver@LastResetTime as OID: 1.3.6.1.4.1.18060.14.2.19.8.0

Name=passthru-http-receiver@MaxSizeReceived as OID: 1.3.6.1.4.1.18060.14.2.19.9.0

Name=passthru-http-receiver@MaxSizeSent as OID: 1.3.6.1.4.1.18060.14.2.19.10.0

Name=passthru-http-receiver@MessagesReceived as OID: 1.3.6.1.4.1.18060.14.2.19.11.0

Name=passthru-http-receiver@MessagesSent as OID: 1.3.6.1.4.1.18060.14.2.19.12.0

Name=passthru-http-receiver@MetricsWindow as OID: 1.3.6.1.4.1.18060.14.2.19.13.0

Name=passthru-http-receiver@MinSizeReceived as OID: 1.3.6.1.4.1.18060.14.2.19.14.0

Name=passthru-http-receiver@MinSizeSent as OID: 1.3.6.1.4.1.18060.14.2.19.15.0

Name=passthru-http-receiver@QueueSize as OID: 1.3.6.1.4.1.18060.14.2.19.16.0

Name=passthru-http-receiver@TimeoutsReceiving as OID: 1.3.6.1.4.1.18060.14.2.19.18.0

Name=passthru-http-receiver@TimeoutsSending as OID: 1.3.6.1.4.1.18060.14.2.19.19.0

Name=passthru-https-receiver@ActiveThreadCount as OID: 1.3.6.1.4.1.18060.14.2.20.1.0

Name=passthru-https-receiver@AvgSizeReceived as OID: 1.3.6.1.4.1.18060.14.2.20.2.0

Name=passthru-https-receiver@AvgSizeSent as OID: 1.3.6.1.4.1.18060.14.2.20.3.0

Name=passthru-https-receiver@BytesReceived as OID: 1.3.6.1.4.1.18060.14.2.20.4.0

Name=passthru-https-receiver@BytesSent as OID: 1.3.6.1.4.1.18060.14.2.20.5.0

Name=passthru-https-receiver@FaultsReceiving as OID: 1.3.6.1.4.1.18060.14.2.20.6.0

Name=passthru-https-receiver@FaultsSending as OID: 1.3.6.1.4.1.18060.14.2.20.7.0

Name=passthru-https-receiver@LastResetTime as OID: 1.3.6.1.4.1.18060.14.2.20.8.0

Name=passthru-https-receiver@MaxSizeReceived as OID: 1.3.6.1.4.1.18060.14.2.20.9.0

Name=passthru-https-receiver@MaxSizeSent as OID: 1.3.6.1.4.1.18060.14.2.20.10.0

Name=passthru-https-receiver@MessagesReceived as OID: 1.3.6.1.4.1.18060.14.2.20.11.0

Name=passthru-https-receiver@MessagesSent as OID: 1.3.6.1.4.1.18060.14.2.20.12.0

Name=passthru-https-receiver@MetricsWindow as OID: 1.3.6.1.4.1.18060.14.2.20.13.0

Name=passthru-https-receiver@MinSizeReceived as OID: 1.3.6.1.4.1.18060.14.2.20.14.0

Name=passthru-https-receiver@MinSizeSent as OID: 1.3.6.1.4.1.18060.14.2.20.15.0

Name=passthru-https-receiver@QueueSize as OID: 1.3.6.1.4.1.18060.14.2.20.16.0

Name=passthru-https-receiver@TimeoutsReceiving as OID: 1.3.6.1.4.1.18060.14.2.20.18.0

Name=passthru-https-receiver@TimeoutsSending as OID: 1.3.6.1.4.1.18060.14.2.20.19.0