Monitoring is the process of reviewing the statistics of a system to improve performance or solve problems. By monitoring the state of various components and services deployed in the Enterprise Server, you can identify performance bottlenecks, predict failures, perform root cause analysis, and ensure that everything is functioning as expected. Data gathered by monitoring can also be useful in performance tuning and capacity planning.
The asadmin utility provides multiple ways of viewing monitoring data: by using the monitor command to view common data, and by using the list and get commands to view more comprehensive data.
The following topics are addressed here:
A monitorable object is a component, subcomponent, or service that can be monitored. Enterprise Server uses a tree structure to track monitorable objects. Because the tree is dynamic, the tree changes as components of the Enterprise Server instance are added or removed.
In the tree, a monitorable object can have child objects (nodes) that represent exactly what can be monitored for that object. All child objects are addressed using the dot (.) character as a separator. These constructed names are referred to as dotted names.
The following are monitorable objects for the instance server:
server.applications server.http-service server.jvm server.web |
Dotted names can also address specific attributes in monitorable objects. For example, the jvm type has a memory attribute called maxheapsize-count. The following dotted name addresses the attribute:
server.jvm.memory.maxheapsize-count
Although an object is monitorable, it is not necessarily being monitored. For instructions on activating monitoring, see Configuring Monitoring.
Each monitorable object has a hierarchical tree structure. In the tree, a replaceable such as *statistics represents the name of the attribute that you want to show statistics for.
This section shows the node tree hierarchies of the following monitorable objects:
The applications tree contains the following nodes:
server.applications application-name virtual-server request *statistic
An example dotted name might be server.applications.hello.server.request.maxtime-count. For available attributes, see Applications Statistics.
The http-service tree contains the following nodes:
server.http-service virtual-server request *statistic _asadmin request *statistic
An example dotted name might be server.http-service.virtual-server1.request.requestcount-count. For available attributes, see HTTP Service Statistics.
The jvm tree contains the following nodes:
server.jvm class-loading-system compilation-system garbage-collectors memory operating-system runtime
An example dotted name might be server.jvm.memory.maxheapsize-count. For available attributes, see Java Virtual Machine (JVM) Statistics.
The web tree contains the following nodes:
server.web jsp *statistic servlet *statistic session *statistic request *statistic
An example dotted name might be server.web.servlet.activeservletsloadedcount-count. For available attributes, see Web Module Common Statistics.
The following asadmin commands are provided for monitoring the services and components of Enterprise Server:
The set command is used to set the monitoring levels for monitorable objects, essentially turning monitoring on or off for Enterprise Server components and services. For instructions, see Configuring Monitoring.
The monitor --type command is used to display basic data for a particular type of monitorable object. For instructions, see Viewing Common Monitoring Data.
The list --monitor command is used to display available monitorable objects. For guidelines and instructions, see Guidelines for Using the list and get Commands for Monitoring.
The get command is used to display comprehensive data, such as the attributes and values for a dotted name. The get command used with a wildcard parameter displays all available attributes for any monitorable object. For instructions on viewing comprehensive data, see To View Comprehensive Monitoring Data.