uCosminexus Application Server, Operation, Monitoring, and Linkage Guide

[Contents][Glossary][Index][Back][Next]

4.3.5 Output Format and Contents

The records of resource depletion monitoring information are output in CSV format files.

The following figure shows the output format:

Figure 4-1 Output format of resource depletion monitoring information

[Figure]

The output format is described below:

The file output contents depend on the values set in usrconf.properties, application attributes, or resource adapter attributes.

The output information for each is described in the following sections.

Organization of this subsection
(1) Monitoring information of memory depletion
(2) Monitoring information of depletion of file descriptors
(3) Monitoring information of thread depletion
(4) Monitoring information of depletion of thread dump
(5) Monitoring information of depletion of queue of HTTP requests pending execution
(6) Monitoring information of the number of depleted sessions
(7) Monitoring information of the depletion of connection pool

(1) Monitoring information of memory depletion

The following table describes the information output in monitoring information of memory depletion:

Table 4-6 Contents output in monitoring information for memory depletion

Character string of output title Output contents
Rate1 Memory usage of the Old area is output.
The unit is %.
The memory usage of the Old area is calculated using the following formula:
  • Memory usage of the Old area = Size of occupied Old area / Total size of Old area x 100
Rate2 Total memory usage of the New area is output for maximum free memory in the Old area.
The unit is %.
Total memory usage of the New area for the maximum free memory in the Old area is calculated using the following formula:
  • Total memory usage of the New area for the maximum free memory in the Old area = Total size of New area / Maximum free size in the Old area x 100
Note that this value may exceed 100.
Rate3 Memory usage of the Permanent area is output.
The unit is %.
The memory usage of the Permanent area is calculated using the following formula:
  • Memory usage of the Permanent area = Occupied size of Permanent area / Total size of Permanent area x 100
Free [New] The free memory size of the New area is output.
The unit is bytes.
Total [New] The total memory size of the New area is output.
The unit is bytes.
Max [New] The maximum memory size of the New area is output.
The unit is bytes.
Free [Old] The free memory size of the Old area is output.
The unit is bytes.
Total [Old] The total memory size of the Old area is output.
The unit is bytes.
Max [Old] The maximum memory size of the Old area is output.
The unit is bytes.
Free [Permanent] The free memory size of the Permanent area is output.
The unit is bytes.
Total [Permanent] The total memory size of the Permanent area is output.
The unit is bytes.
Max [Permanent] The maximum memory size of the Permanent area is output.
The unit is bytes.
Threshold Threshold value is output.
The unit is %.
Note
The prerequisite of the function for monitoring memory depletion is a system tuned in such a way that the full garbage collection does not occur since sufficient memory is designed. The purpose of this function for monitoring memory depletion is to detect in advance the temporary termination of an application due to full garbage collection, even in a system tuned in such a way. Note that if the memory tuning is insufficient, unnecessary alerts may be output.
When monitoring memory depletion, we recommend that you specify the same value for the maximum size and initial size of the Permanent area. To be more precise, set the same value for the -XX:MaxPermSize and -XX:PermSize of usrconf.cfg. If different values are specified, alerts might be issued even during the expansion of the Permanent area. For details on other tuning parameters, see the information on the Oracle website.
A full garbage collection does not necessarily occur when the memory usage being monitored by this functionality reaches 100%. The monitored value is used for predicting if there is a high possibility of the occurrence of full garbage collection.
The Java heap is now used effectively such that the full garbage collection does not easily occur from Application Server 09-00 onwards. Due to this, the system continues to operate while the usage rate of the Java heap is high, and an unnecessary alert might be output. In such cases, adjust the threshold value.
Reference note
The heap and memory of JavaVM contain the following three types of areas:
  • New area
    This area is applicable to Eden and Survivor. This area stores new objects.
  • Old area
    This area is applicable to Tenured. This area stores objects existing for a long time.
  • Permanent area
    This area stores classes loaded in JavaVM.
The Information of free area, occupied area, and maximum area size for each of these areas at that point of time is output in memory monitoring result.
If memory monitoring is set, messages are output in the following cases:
  • If the occupied size of the Old area corresponding to the total size of the Old area exceeds the threshold value
    The message is output if "Occupied size of Old area / Total size of Old area x 100[Figure]threshold value(%)".
  • If the total size of the New area corresponding to the maximum free size of the Old area exceeds the threshold value
    The message is output if "Total size of New area / Maximum free size of Old area x 100[Figure]threshold value(%)".
  • If the occupied size of the Permanent area corresponding to the total size of the Permanent area exceeds the threshold value
    The message is output if "Occupied size of Permanent area / Total size of Permanent area x 100[Figure]threshold value(%)".

(2) Monitoring information of depletion of file descriptors

The following table describes the information output in the result of monitoring file descriptors information. You cannot monitor the number of file descriptors in Windows or AIX.

Table 4-7 Contents output in the monitoring information for depletion of file descriptors

Character string of output title Output contents
Current The number of file descriptors used by J2EE server processes is output.
Max The number of file descriptors that can be allocated to a process is output. For Solaris, normally "-" is output.
Threshold Threshold value is output.

(3) Monitoring information of thread depletion

The following table describes the information output in monitoring information of thread depletion:

Table 4-8 Contents output in the monitoring information for thread depletion

Character string of output title Output contents
Current The number of threads using self-process is output.
Max
  • In Windows
    Normally "-" is output
  • In UNIX
    Number of threads that can be generated by a process is output.
Threshold Threshold value is output.

(4) Monitoring information of depletion of thread dump

The following table describes the information output in the monitoring information of depletion of thread dump:

Table 4-9 Contents output in the monitoring information for thread dump depletion

Character string of output title Output contents
Rate The percentage of number of files of the current thread dump corresponding to its maximum value is output.
The unit is %.
Current The current value of the number of thread dump files is output.
Max The upper limit of the number of thread dump files is output.
Threshold Threshold value is output.
The unit is %.

(5) Monitoring information of depletion of queue of HTTP requests pending execution

The queue of HTTP requests pending execution is the pending queue for Web applications and the default pending queue corresponding to the concurrently executing threads of the Web application.

The following table describes the information output in the monitoring information depletion of queue of HTTP request pending execution. This depletion monitoring information includes the following two types of information:

(6) Monitoring information of the number of depleted sessions

The following table describes the information output in monitoring information of the number of depleted sessions:

Table 4-11 Contents output in the monitoring information for depletion of the number of sessions

Character string of output title Output contents
J2eeApplicationName The J2EE application name is output.
ContextRootName Context root name is output.
Rate The percentage of the number of current sessions created corresponding to its maximum value is output.
The unit is %.
If the maximum value is not set, "-" is output.
Current The current value of the number of sessions is output.
Max The maximum value of the number of sessions is output.
If the maximum value is not set, "-" is output.
Threshold Threshold value is output.
The unit is %.

(7) Monitoring information of the depletion of connection pool

The following table describes the information output in monitoring information of depletion of a connection pool:

Table 4-12 Contents output in the monitoring information for connection pool depletion

Character string of output title Output contents
ResourceName The resource adapter name given by the user is output in the following format:

When the resource adapter is directly deployed on a J2EE server
Resource-adapter-name

When the resource adapter is deployed by including in a J2EE application
J2EE-application-name:Resource-adapter-name

When the resource adapter is deployed by including in a J2EE application, and then starting in the test mode
TEST#J2EE-application-name:Resource-adapter-name
Rate The usage of a connection pool is output.
The unit is %.
If the maximum value of the number of connections is infinite, "-" is output.
Active The number of connections in use is output.
Free The number of unused connections is output.
Current The current value of the number of connections is output. #
Min The minimum value of the number of connections is output.
Max The maximum value of the number of connections is output.
If a connection pool is infinite, "-1" is output.
Threshold Threshold value is output.
The unit is %.
All The total number of connections (total number of connections managed in connection pool and not managed in connection pool) is output. #

#
Depending on the timing when the connection is established, a value greater than All might be output to Current temporarily.