Skip navigation.
Downloads | Product Documentation | Support

Administration Console Online Help

# Domains: Configuration: SNMP Agent

Configuration Options Related Tasks Related Topics

An Administration Server can host a Simple Network Management Protocol (SNMP) agent that sends trap notifications to SNMP managers.

Use this page to enable and configure the SNMP agent for the current WebLogic Server domain.

#### Configuration Options

Name | Description
--- | ---
Enabled | Specifies whether the Administration Server in the current WebLogic Server domain uses the SNMP service. MBean Attribute: `SNMPAgentMBean.Enabled` Changes take effect after you redeploy the module or restart the server.
SNMP Port | The port number on which you want the WebLogic SNMP agent to listen for incoming requests from SNMP managers. SNMP managers can this port to ping the WebLogic Server SNMP agent and request the status of specific attributes. MBean Attribute: `SNMPAgentMBean.SNMPPort` Minimum value: `1` Maximum value: `65535` Changes take effect after you redeploy the module or restart the server.
MIB Data Refresh Interval | The minimum number of seconds that the WebLogic SNMP agent caches OIDs before checking if new ones have been added to the Management Information Base (MIB). A MIB is a database of all objects that can be managed through SNMP. When you create a new WebLogic Server resource, the SNMP agent assigns a unique OID to the resource and adds it to the MIB. For example, when you create a new server, the SNMP agent adds an OID to the MIB. MBean Attribute: `SNMPAgentMBean.MibDataRefreshInterval` Minimum value: `30` Maximum value: `65535` Changes take effect after you redeploy the module or restart the server.
Server Status Check Interval Factor | The multiplier used to calculate the interval at which the WebLogic SNMP agent checks for newly started or shut down Managed Servers. The SNMP agent can automatically generate traps when Managed Servers start or shut down. This status check value is multiplied by the MIB Data Refresh Interval to determine the interval: `interval = n * MibDataRefreshInterval` For the most frequent interval, specify `1` as the multiplier value. MBean Attribute: `SNMPAgentMBean.ServerStatusCheckIntervalFactor` Minimum value: `1` Maximum value: `65535` Changes take effect after you redeploy the module or restart the server.
Community Prefix | The password (community name) that you want the WebLogic SNMP agent to use to secure communication with SNMP managers. Note that there are two community names that are needed when the WebLogic SNMP agent and SNMP managers interact: The name that you specify in this community prefix. All SNMP managers must send this name when connecting to the WebLogic SNMP agent. The community name that the SNMP manager defines. The WebLogic SNMP agent must send this name when connecting to the manager. (You supply this community name when you configure a trap destination.) In addition to using the community prefix as a password, the WebLogic SNMP agent uses the prefix to qualify requests from SNMP managers. Because a WebLogic Server domain can have multiple server instances concurrently active, a request that specifies only an attribute name is potentially ambiguous. For example, the attribute `serverUptime` exists for each WebLogic Server instance in a domain. To clarify requests, use the community prefix as follows: To request the value of an attribute on a specific Managed Server, when you send a request from an SNMP manager, append the name of the server instance to the community prefix: `community_prefix@server_name`. To request the value of an attribute on the Administration Server, send a community name with the following form: `community_prefix` To request the value of an attribute for all server instances in a domain, send a community name with the following form: `community_prefix@domain_name` To secure access to the values of the WebLogic attributes, it is recommended that you set community prefix to a value other than `public`. MBean Attribute: `SNMPAgentMBean.CommunityPrefix` Secure value: `not public` Changes take effect after you redeploy the module or restart the server.
Debug Level | The minimum severity of debug messages that the SNMP agent generates. The SNMP agent writes all debug messages to standard out; they are not written to the WebLogic Server log files. Debug messages provide a detailed description of the SNMP agent's actions. For example, the agent outputs a noncritical message each time it generates a trap. Valid values are: `0` No debug messages. `1` Fatal messages only. `2` Critical and fatal messages. `3` Non-critical, critical, and, fatal messages. MBean Attribute: `SNMPAgentMBean.DebugLevel` Secure value: `0` Changes take effect after you redeploy the module or restart the server.
Trap Version | The SNMP trap version that this WebLogic Server domain generates. Valid values are: `1` Generates SNMPv1 traps. `2` Generates SNMPv2 traps. Choose the protocol that your SNMP managers support. MBean Attribute: `SNMPAgentMBean.SNMPTrapVersion` Changes take effect after you redeploy the module or restart the server.
Send Automatic Traps Enabled | Specifies whether the WebLogic SNMP agent sends automatically generated traps to SNMP managers. The WebLogic SNMP agent generates automatic traps when any of the following events occur: The Administration Server starts. An SNMP manager sends an incorrect community string. A Managed Server starts. A Managed Server shuts down. MBean Attribute: `SNMPAgentMBean.SendAutomaticTrapsEnabled` Changes take effect after you redeploy the module or restart the server.

Related Tasks

- Use SNMP to monitor WebLogic Server
- Create trap destinations
- Stop generating traps
- Verify trap generation
- Create SNMP proxies

Related Topics

- WebLogic SNMP Management Guide
- WebLogic SNMP MIB Reference