SNMP Counter Monitors: Configuration
Configuration Options Related Tasks Related Topics
Use this page to configure a counter monitor, which periodically polls an attribute whose value is an integer and compares the attribute value with a high threshold that you define. A counter monitor generates a notification if the attribute value equals or exceeds the high threshold. You can also configure an offset or modulus, which increases or decreases the threshold each time the threshold is crossed.
Configuration Options
Name Description Name The name of this counter monitor.
Each monitor within a domain must have a unique name.
The name displays in the Administration Console, and if you use WebLogic Server command-line utilities or APIs, you use this name to identify the monitor.
After you have created a monitor, you cannot change its name. Instead, delete it and create a new one.
MBean Attribute:
SNMPCounterMonitorMBean.Name
Changes take effect after you redeploy the module or restart the server.
Monitored MBean Type The MBean type that defines the attribute you want to monitor. Do not include the
MBean
suffix. For example,ServerRuntime
.MBean Attribute:
SNMPCounterMonitorMBean.MonitoredMBeanType
Changes take effect after you redeploy the module or restart the server.
Monitored MBean Name The name of the MBean instance that you want to monitor. If you leave the name undefined, WebLogic Server monitors all instances of the MBean type that you specify in Monitored MBean Type.
If you target SNMP agents to individual Managed Servers, make sure that the MBean instance you specify is active on the Managed Servers you have targeted. For example, if you specify
MServer1
as the name of a ServerRuntimeMBean instance, this monitor will only function if you target an SNMP agent either to the Administration Server or to a Managed Server namedMServer1
.Do not enter the full JMX object name of the MBean instance. Instead, enter only the value of the object name's
Name=name
name-value pair. To create unique MBean object names, WebLogic Server encodes several name-value pairs into each object name. One of these pairs isName=name
. For example:
"MedRec:Name=MedRecServer,
Type=ServerRuntime"
In the previous example, specify
MedRecServer
as the name of the MBean instance.MBean Attribute:
SNMPCounterMonitorMBean.MonitoredMBeanName
Changes take effect after you redeploy the module or restart the server.
User Entered MBean Name The short name of an MBean instance. Requires you to select
User Entered MBean Name
in the Monitored MBean Name list.Enter a name in this field if you want to monitor an MBean instance that is not currently active.
You provide the short name for an MBean when you create the associated resource.
Monitored Attribute Name The name of an MBean attribute to monitor. This attribute must be in the WebLogic Server MIB.
MBean Attribute:
SNMPCounterMonitorMBean.MonitoredAttributeName
Changes take effect after you redeploy the module or restart the server.
Polling Interval The frequency (in seconds) that WebLogic Server checks the attribute value.
MBean Attribute:
SNMPCounterMonitorMBean.PollingInterval
Minimum value:
1
Maximum value:
65535
Changes take effect after you redeploy the module or restart the server.
Threshold Specifies a value that triggers the Counter Monitor to generate a notification.
The monitor generates a notification the first time the observed value transitions from below the threshold to at or above the threshold. While the observed value remains at or above the threshold, the Counter Monitor does not generate additional notifications. If the observed value falls below the threshold and then later equals or exceeds the threshold, the Counter Monitor does not generate an additional notification.
You can specify an offset value to cause this threshold value to increase each time the observed value equals or exceeds the threshold. The first time the observed value equals or exceeds the new threshold value, this monitor generates a notification and adds the offset value to the new threshold value.
For example, if you set Threshold to 1000 and Offset to 2000, when the observed attribute equals or exceeds 1000, the Counter Monitor sends a notification and increases the threshold to 3000. When the observed attribute equals or exceeds 3000, the Counter Monitor sends a notification and increases the threshold again to 5000.
MBean Attribute:
SNMPCounterMonitorMBean.Threshold
Minimum value:
0
Offset A value to be added to the threshold value each time the observed value equals or exceeds the threshold.
MBean Attribute:
SNMPCounterMonitorMBean.Offset
Minimum value:
0
Modulus A value to be subtracted from the threshold value when the threshold value is crossed.
If Modulus is 0, a notification is generated each time the agent polls the monitored attribute and its value still exceeds or equals the threshold value.
If Modulus is larger than 0, the value of the modulus is subtracted from the threshold each time the threshold is crossed.
MBean Attribute:
SNMPCounterMonitorMBean.Modulus
Minimum value:
0