8 Monitoring Domains
Use WebLogic Remote Console to monitor WebLogic Server and its related resources and services.
For general information on monitoring, diagnostic, and tuning tools in WebLogic Server, see Monitoring, Diagnosing, and Troubleshooting in Understanding Oracle WebLogic Server.
Monitor Servers
Review the servers in your domain to ensure they are functioning as expected.
View Node Manager Status and Logs
You can check the current status of Node Manager and use Node Manager logs to help troubleshoot problems in starting or stopping individual Managed Servers.
For more information, see Log Files in Administering Node Manager for Oracle WebLogic Server.
Note:
Node Manager must be running to view its logs.- In the Monitoring Tree, go to Environment, then Node Manager Logs.
- Click the name of the machine whose Node Manager logs you want to view.
- Click Download.
When using Hosted WebLogic Remote Console, your browser controls the location where the log files are downloaded. If you want to change the default download location, update your browser settings accordingly.
Configure Health Monitoring
A server can monitor key aspects of its subsystems and report when a subsystem is not functioning properly.
If the server is running under a Node Manager, the Node Manager can automatically restart a server with an unhealthy subsystem. Node Manager can only perform automatic monitoring and shutdown for servers that it starts.
- In the Edit Tree, go to Environment, then Servers, then myServer.
- On the Health tab, modify the options as necessary.
- Click Save.
Dashboards
Use dashboards to quickly assess and filter data about your domain. You can specify criteria for WebLogic Remote Console to match against MBeans in your domain and then review the results.
Dashboards are highly customizable. Start from any node in the Monitoring perspective and you can use its properties to develop precise criteria that go far beyond simple true/false statements. Dashboards let you find obscure, cross-functional data that might otherwise require comparison across multiple nodes.
Dashboards are only available on the Monitoring Tree perspective.
Tip:
You can expand the Dashboards node at the bottom of the Navigation tree to see any saved or built-in dashboards.
Dashboard Filters
In dashboards, filters are the criteria that you use to curate your results. Generally, filters are based on the properties of a node.
WebLogic Remote Console restricts which filters are available based on your current node so you can focus on the criteria that is relevant to your goals. As such, the filters that are available on the Environments: Servers node are different than those available under Deployments: Application Runtime Data.
Each filter consists of a name (or property) from the domain, a value, and an operator that determines how the name and value interact with each other. A basic dashboard filter is simply name=value
. The following example dashboard filter returns any servers that require a restart to apply configuration changes:
ServerRuntime.RestartRequired == true
Values come in three formats:
- Text
- Numeric
- Boolean (expressed as option toggles). Set the option to
On
for True,Off
for False.
Use operators to determine how a value should be assessed. Only the operators that are applicable to a name or property appear as options - you won't see greater than
for text values. By default, all filters are set to Any
to provide the broadest possible search parameters.
Dashboards consist of one or more filters and filters are cumulative - beans must match ALL of the defined filters to be returned as a result. Therefore, when you build a dashboard, only edit the filters that are relevant to your query and leave the rest of the filters unchanged.
Built-In Dashboards
WebLogic Remote Console provides a set of pre-defined dashboards to monitor common domain statistics.
On the Monitoring Tree, expand the Dashboards node to see both custom and built-in dashboards.
You cannot edit or delete built-in dashboards. However, you can use a built-in dashboards as a starting point for another dashboard. Select a built-in dashboard and click Copy, then enter a new name for your custom dashboard. Edit it as you would a custom dashboard.
Create a Dashboard
You can create your own custom dashboards to monitor the state of your domain.
- In the Monitoring Tree, go to the node in the Navigation Tree that most closely matches the type of content that you want to track. For example, if you want to learn about servers, open the Environment: Servers node.
- Click New Dashboard.
- Enter a name for your new dashboard and then begin configuring the filters that will determine the results of the dashboard. For guidance on how to build filters, see Dashboard Filters.
- Click Create to generate the dashboard.
- Optional: Click Customize Table to control which columns appear in the dashboard.
All of your dashboards are available in the Dashboards node of the Monitoring Tree.
Dashboards are not automatically refreshed with new data. You must refresh or rerun the dashboard page to see any changes to MBeans. Click Reload to update the results. You can also click Auto Reload Interval to set the dashboard to regularly reload and update the results.
Log Messages
WebLogic Server logging services provide facilities for writing, viewing, filtering, and listening for log messages. These log messages are generated by WebLogic Server instances, subsystems, and Java EE applications that run on Oracle WebLogic Server or in client JVMs.
Use WebLogic Remote Console to configure WebLogic Server Logging services. For general information on WebLogic Server logging services, see Understanding WebLogic Logging Services in Configuring Log Files and Filtering Log Messages for Oracle WebLogic Server.
View Logs
Each subsystem within WebLogic Server generates log messages to communicate its status. To keep a record of the messages that its subsystems generate, WebLogic Server writes the messages to log files.
For more information on WebLogic logging services, see Understanding WebLogic Logging Services in Configuring Log Files and Filtering Log Messages for Oracle WebLogic Server.
Configure Logs
WebLogic Server generates log files to track and communicate the status of its various subsystems. To ensure these log files remain valuable and usable, you can configure their settings.
Each WebLogic Server instance writes all messages from its subsystems and applications to a server log file that is located on the local host computer. In addition to writing messages to the server log file, each server instance forwards a subset of its messages to a domain-wide log file. By default, servers forward only messages of severity level Notice
or higher. See Server Log Files and Domain Log Files in Configuring Log Files and Filtering Log Messages for Oracle WebLogic Server.
The server log records information about events such as the startup and shutdown of servers, the deployment of new applications, or the failure of one or more subsystems. The messages include information about the time and date of the event as well as the ID of the user who initiated the event. You can view and sort these server log messages to detect problems, track down the source of a fault, and track system performance.
You can also create client applications that listen for these messages and respond automatically. For example, you can create an application that listens for messages indicating a failed subsystem and sends email to a system administrator.
For more information on WebLogic logging services, see Understanding WebLogic Logging Services in Configuring Log Files and Filtering Log Messages for Oracle WebLogic Server.
- In the Edit Tree, go to Environment, then Servers, then myServer.
- Click the Logging tab.
- Modify the logging settings to suit your needs.
- Click Save.
- Repeat on the rest of the servers.
- Go to Environment, then Domain.
- Click the Logging tab.
- Modify the settings for the domain-level log to suit your needs.
- Click Save.
Define Debug Settings
Specify debugging settings for WebLogic Server.
If you haven't already, you should configure general logging settings for this server. See Configure Logs.
If you create applications to run on WebLogic Server, you can configure your applications to generate messages of severity DEBUG
. These messages are never forwarded to the domain log and are intended to contain detailed information about the operation of an application or the server.
Filter Log Messages
WebLogic Server can generate a significant amount of data in its log messages. You can filter log messages so only certain messages are published.
For example, you can filter out messages of a certain severity level, or from a particular subsystem, or according to some other specified criteria. Only the log messages that satisfy the filter criteria get published. You can also create separate filters for the messages that each server instance writes to its server log file, standard out, memory buffer, or broadcasts to the domain-wide message log.
WebLogic Server offers multiple methods for filtering log messages and you can use these methods simultaneously. Choose the methods that work for your environment. For more information, see Filtering WebLogic Server Log Messages in Configuring Log Files and Filtering Log Messages for Oracle WebLogic Server.
Create a Log Filter
Log filters provide control over the log messages that get published. A filter uses custom logic to evaluate the log message content, which you use to accept or reject a log message
For example, to filter out messages of a certain severity level, from a particular subsystem, or according to specified criteria. Only the log messages that satisfy the filter criteria get published. You can create separate filters for the messages that each server instance writes to its server log file, standard out, memory buffer, or broadcasts to the domain-wide message log.
Rotate Log Files
Set a rotation schedule for the log files generated by WebLogic Server.
For more information, see Rotating Log Files in Configuring Log Files and Filtering Log Messages for Oracle WebLogic Server.
Note:
WebLogic Server sets a threshold size limit of 2,097,152 kilobytes before it forces a hard rotation to prevent excessive log file growth.
Configure java.util.logging Logger Levels
WebLogic Server supports configuring java.util.logging.Logger
levels for named loggers in the JDK LogManager
.
Enable Configuration Auditing
You can configure the Administration Server to emit audit messages that enable auditing of configuration changes in a domain.
This provides a record of changes to the configuration of any resource within a domain or invokes management operations on any resource within a domain. Configuration audit records can be saved to a log file, sent to an Auditing provider in the security realm, or both.
If you plan to audit configuration changes, then you must configure the WebLogic Auditing Provider first. See Configure an Auditing Provider.
- In the Edit Tree, go to Environment, then Domain.
- Click Show Advanced Fields.
- From the Configuration Audit Type drop-down list, select the method to use for auditing configuration change events.
- None: No audit configuration change events are written.
- Log:Configuration events will be written to the server log.
- Audit: Configuration events will be directed to the Security Framework and handled by the Auditing provider.
- LogAudit: Configuration events will written to the server log as well as directed to the Security Framework and handled by the Auditing provider.
- Click Save.
Display Thread Stacks
You can display the current stack for an active thread.
- In the Monitoring Tree, go to Environment, then JVM Runtime.
- Click the Thread Stack Dump tab to see an overview of the thread stack dumps for each server in the domain.
- To see the thread stack dump for a single server, click the server instance in the table. This sends you to the JVM Runtime node for the selected server. Click the Thread Stack Dump tab.
Tuning Performance
To ensure that your WebLogic Server environment is performing optimally, you should regularly monitor its behavior and then adjust its settings accordingly.
- In the Edit Tree, go to Environment, then Servers, then myServer.
- On the Advanced tab, select the Tuning subtab.
- Modify the available options as recommended based on the needs of your environment.
- Click Save.
- Repeat as needed for the rest of the servers in your domain.