Administration Console Online Help

Previous Next Open TOC in new window
Content starts here

SNMP Log Filters: Configuration

Configuration Options     Related Tasks     Related Topics

Use this page to specify criteria that cause a WebLogic Server SNMP agent to generate an SNMP log notification trap.

The agent generates traps only for the log messages that match the criteria on this page.

Configuration Options

Name Description
Name

The name of this log filter.

Each log filter 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 it.

After you have created a log filter, you cannot change its name. Instead, delete it and create a new one.

MBean Attribute:
SNMPLogFilterMBean.Name

Changes take effect after you redeploy the module or restart the server.

Severity Level

The minimum severity of a message that causes a WebLogic Server SNMP agent to generate a notification.

MBean Attribute:
SNMPLogFilterMBean.SeverityLevel

Subsystem Names

A list of subsystems whose messages are selected by this log filter. If none are specified, messages from all subsystems are selected.

MBean Attribute:
SNMPLogFilterMBean.SubsystemNames

User IDs

A list of user IDs that causes a WebLogic Server SNMP agent to generate a notification.

Every message includes the user ID from the security context in which the message was generated.

If the user ID field for a message matches one of the user IDs you specify in the filter, WebLogic Server generates a notification.

If this log filter doesn't specify user IDs, WebLogic Server can generate a notification for messages from all user IDs.

MBean Attribute:
SNMPLogFilterMBean.UserIds

Message IDs

A list of message IDs or ID ranges that cause a WebLogic Server SNMP agent to generate a notification.

If no IDs are specified, this filter selects all message IDs.

Example list: 20,50-100,300

MBean Attribute:
SNMPLogFilterMBean.MessageIds

Message Substring

A string that is searched for in the message text. Only messages that contain the string are selected. If a string is not specified, all messages are selected.

MBean Attribute:
SNMPLogFilterMBean.MessageSubstring

Enabled Servers

This attribute is applicable only when the SNMP Agent is running on the Admin Server of a WebLogic Domain. The EnabledServers attribute allows the users to limit the scope of the monitored data sources to the specific named Servers. The EnabledServers list is ignored when the SNMAgentDeploymentMBean is targeted to a Managed Server. In the case of a Managed Server the SNMP Agent only looks at the data available in the WebLogic Server where the SNMP Agent is deployed.

For traps based on MBean attributes the SNMP Agent refers to the Domain Runtime MBean Server when it is running on the Admin Server and the Runtime MBean Server when it is deployed to a Managed Server.

In the case of SNMPJMXMonitorMBean and SNMPAttributeChangeMBean the MonitoredMBeanType and MonitoredMBeanName attributes specify the type and name of a WebLogic Server MBean for which the trap will be setup. MBeans that meet the Type and Name criteria are qualified to set the trap on. The EnabledServers attribute allows a user to specify additional criteria based on the Location of an MBean when the SNMP Agent is targeted to the Admin Server. MBeans whose Location matches one of the Servers in the EnabledServers list are considered eligible for the trap to be generated for a corresponding JMX notification. When the EnabledServers attribute is not specified all MBeans whose Type and Name match are considered as valid sources for the SNMP trap.

In the case of SNMPLogFilterMBean the EnabledServers attribute allows a user to specify the Servers in the Domain whose log messages will be monitored when the Agent is running on the Admin Server. When EnabledServers is not specified for an Agent running on the Admin Server log messages on all Managed Servers in the domain are monitored for sending traps. This attribute is not applicable when the SNMP Agent is targeted to a Managed Server, in this case the traps are sent based on log messages generated by the respective Managed Server where the Agent is deployed.

MBean Attribute:
SNMPLogFilterMBean.EnabledServers

Related Tasks

Related Topics


Back to Top