A WebLogic-Based Application Metrics
This appendix describes how WebLogic Monitoring Exporter collects metrics in the following groups to produce data for monitoring PDC, Business Operations Center, Billing Care, and Billing Care REST API in Prometheus and Grafana:
WLS Server Metrics Group
Use the WLS server metrics group to retrieve runtime information about a server instance and to transition a server from one state to another. Table A-1 lists the metrics in this group.
Table A-1 WLS Server Metrics
| Metric Name | Label | Metric Type | Description |
|---|---|---|---|
|
wls_server_activation_time |
location |
long |
Returns the time when the server was started. |
|
wls_server_admin_server_listen_port |
location |
int |
Returns the port on which this server is listening for requests. |
|
wls_server_open_sockets_current_count |
location |
int |
Returns the current number of sockets registered for socket muxing on this server. |
|
wls_server_state_val |
location |
int |
Returns the current state of the server as an integer:
|
Application Runtime Metric Group
Use the application runtime metric group to collect runtime information about a deployed enterprise application. Table A-2 describes the metrics in the group.
Table A-2 Application Runtime Metrics
| Metric Name | Label | Metric Type | Description |
|---|---|---|---|
|
wls_webapp_config_deployment_state |
location app name |
int |
Returns the current state of the deployment as an integer. |
|
wls_webapp_config_open_sessions_current_count |
location app name |
int |
Returns the current number of open sessions in this module. |
|
wls_webapp_config_open_sessions_high_count |
location app name |
int |
Returns the highest number of open sessions on this server at any one time. |
|
wls_webapp_config_sessions_opened_total_count |
location app name |
int |
Returns the total number of sessions that were opened. |
Servlets Metric Group
Each WAR file can contain multiple servlets, and each WAR file can be integrated into an enterprise archive (EAR). Use the servlets metric group to obtain runtime information about a web application and each servlet. Table A-3 describes the metrics in this group.
Table A-3 Servlets Metrics
| Metric Name | Label | Metric Type | Description |
|---|---|---|---|
|
wls_servlet_execution_time_average |
location app name servletName |
long |
Displays the average amount of time, in milliseconds, it took to execute all invocations of the servlet since it was most recently deployed. |
|
wls_servlet_execution_time_high |
location app name servletName |
long |
Displays the average amount of time, in milliseconds, that the single longest invocation of the servlet has executed since it was most recently deployed. |
|
wls_servlet_execution_time_low |
location app name servletName |
long |
Displays the average amount of time, in milliseconds, that the single shortest invocation of the servlet has executed since it was most recently deployed. |
|
wls_servlet_execution_time_total |
location app name servletName |
long |
Displays the average amount of time, in milliseconds, that all invocations of the servlet have executed since it was most recently deployed. |
|
wls_servlet_invocation_total_count |
location app name servletName |
int |
Displays the total number of times the servlet has been invoked since WebLogic Server started. |
|
wls_servlet_pool_max_capacity |
location app name servletName |
int |
Displays the maximum capacity of this servlet for single thread model servlets. |
|
wls_servlet_reload_total_count |
location app name servletName |
int |
Displays the total number of times WebLogic Server has reloaded the servlet since it was last deployed. WebLogic Server typically reloads a servlet if it has been modified. |
JVM Runtime Metric Group
Use the JVM runtime metric group to retrieve information about the Java Virtual Machine (JVM) that the current server instance is running. Table A-4 describes the metrics in this group.
Table A-4 JVM Runtime Metrics
| Metric Name | Labels | Metric Type | Description |
|---|---|---|---|
|
wls_jvm_heap_free_current |
name |
long |
Returns the current amount of memory, in bytes, that is available in the JVM heap. |
|
wls_jvm_heap_free_percent |
name |
int |
Returns the percentage of the JVM heap that is free. |
|
wls_jvm_heap_size_current |
name |
long |
Returns the current size, in bytes, of the JVM heap. |
|
wls_jvm_heap_size_max |
name |
long |
Returns the maximum size, in bytes, of the JVM heap. |
|
wls_jvm_process_cpu_load |
name |
time |
Returns the amount of CPU time that the Java virtual machine is running in nanoseconds. |
|
wls_jvm_uptime |
name |
long |
Returns the number of milliseconds that the virtual machine has been running. |
Execute Queue Runtimes Metric Group
Use the execute queue runtime metric group to return information about the queue. Table A-5 describes the metrics in this group.
Table A-5 Execute Queue Runtimes Metrics
| Metric Name | Labels | Metric Type | Description |
|---|---|---|---|
|
wls_socketmuxer_pending_request_current_count |
name |
int |
Returns the number of waiting requests in the queue. |
Work Manager Runtimes Metric Group
Use the work manager runtimes metric group to retrieve information about requests from the work manager. Table A-6 describes the metrics in this group.
Table A-6 Work Manager Runtimes Metrics
| Metric Name | Label | Metric Type | Description |
|---|---|---|---|
|
wls_workmanager_completed_requests |
name |
int |
Returns the number of requests that have been processed. |
|
wls_workmanager_pending_requests |
name |
int |
Returns the number of waiting requests in the queue. |
|
wls_workmanager_stuck_thread_count |
name |
int |
Returns the number of stuck threads in the thread pool. |
Thread Pool Runtime Metric Group
Use the thread pool runtime metric group to monitor the self-tuning queue. Table A-7 describes the metrics in this group.
Table A-7 Thread Pool Runtime Metrics
| Metric Name | Label | Metric Type | Description |
|---|---|---|---|
|
wls_threadpool_execute_thread_total_count |
name |
int |
Returns the total number of threads in the pool. |
|
wls_threadpool_hogging_thread_count |
name |
int |
Returns the threads that are currently being held by a request. These threads will either be declared as stuck after the configured timeout period or be returned to the pool. |
|
wls_threadpool_queue_length |
name |
int |
Returns the number of pending requests in the priority queue. |
|
wls_threadpool_stuck_thread_count |
name |
int |
Returns the number of stuck threads in the thread pool. |
JDBC Service Runtime Metric Group
Use the JDBC service runtime metric group to retrieve runtime information about a server instance and to transition a server from one state to another. Table A-8 describes the metrics in this group.
Table A-8 JDBC Service Runtime Metrics
| Metric Name | Label | Metric Type | Description |
|---|---|---|---|
|
wls_datasource_active_connections_average_count |
name |
int |
Returns the average number of active connections in this data source instance. |
|
wls_datasource_active_connections_current_count |
name |
int |
Returns the number of connections currently in use by applications. |
|
wls_datasource_active_connections_high_count |
name |
int |
Returns the highest number of active database connections in this data source instance since the data source was instantiated. |
|
wls_datasource_commit_outcome_retry_total_count |
name |
int |
Returns the cumulative total number of commit outcome query retries conducted before resolving the outcome or exceeding the retry seconds in this data source since the data source was deployed. |
|
wls_datasource_connection_delay_time |
name |
int |
Returns the average amount of time, in milliseconds, that it takes to create a physical connection to the database. |
|
wls_datasource_connections_total_count |
name |
int |
Returns the cumulative total number of database connections created in this data source since the data source was deployed. |
|
wls_datasource_curr_capacity_high_count |
name |
int |
Returns the highest number of database connections available or in use (current capacity) in this data source instance since the data source was deployed. |
|
wls_datasource_curr_capacity |
name |
int |
Returns the current count of JDBC connections in the data source's connection pool. |
|
wls_datasource_deployment_state |
name |
int |
Returns the module's current deployment state. |
|
wls_datasource_failed_repurpose_count |
name |
int |
Returns the number of repurpose errors that have occurred since the data source was deployed. |
|
wls_datasource_failed_reserve_request_count |
name |
int |
Returns the cumulative running count of connection requests from this data source that could not be fulfilled. |
|
wls_datasource_failures_to_reconnect_count |
name |
int |
Returns the number of times that the data source attempted to refresh a database connection and failed. |
|
wls_datasource_highest_num_available |
name |
int |
Returns the highest number of database connections that were idle and available to be used by an application at any time in this data source instance since the data source was deployed. |
|
wls_datasource_highest_num_unavailable |
name |
int |
Returns the highest number of database connections that were in use by applications or being tested by the system in this data source instance since the data source was deployed. |
|
wls_datasource_leaked_connection_count |
name |
int |
Returns the number of leaked connections. |
|
wls_datasource_num_available |
name |
int |
Returns the number of database connections that are currently idle and available to be used by applications in this data source instance. |
|
wls_datasource_num_unavailable |
name |
int |
Returns the number of connections currently in use by applications or being tested in this data source instance. |
|
wls_datasource_prep_stmt_cache_access_count |
name |
long |
Returns the cumulative, running count of the number of times that the statement cache was accessed. |
|
wls_datasource_prep_stmt_cache_add_count |
name |
long |
Returns the cumulative, running count of the number of statements added to the statement cache. |
|
wls_datasource_prep_stmt_cache_current_size |
name |
int |
Returns the number of prepared and callable statements currently cached in the statement cache. |
|
wls_datasource_prep_stmt_cache_delete_count |
name |
long |
Returns the cumulative, running count of statements discarded from the cache. |
|
wls_datasource_prep_stmt_cache_hit_count |
name |
long |
Returns the cumulative, running count of the number of times that statements from the cache were used. |
|
wls_datasource_prep_stmt_cache_miss_count |
name |
long |
Returns the number of times that a statement request could not be satisfied with a statement from the cache. |
|
wls_datasource_reserve_request_count |
name |
long |
Returns the cumulative, running count of connection requests from this data source. |
|
wls_datasource_waiting_for_connection_current_count |
name |
int |
Returns the number of connection requests waiting for a database connection. |
|
wls_datasource_waiting_for_connection_failure_total |
name |
long |
Returns the cumulative, running count of connection requests from this data source that had to wait before getting a connection and eventually failed to get a connection. |
|
wls_datasource_waiting_for_connection_high_count |
name |
int |
Returns the highest number of application requests concurrently waiting for a connection from this data source instance. |
|
wls_datasource_waiting_for_connection_success_total |
name |
long |
Returns the cumulative, running count of connection requests from this data source that had to wait before getting a successful connection. |
|
wls_datasource_waiting_for_connection_total |
name |
long |
Returns the cumulative, running count of connection requests from this data source that had to wait before getting a connection. This includes requests that eventually got a connection and those that did not get a connection. |
JTA Runtime Metric Group
Use the JTA runtime metric group to access transaction runtime characteristics within a WebLogic Server. Table A-9 describes the metrics in this group.
Table A-9 JTA Runtime Metrics
| Metric Name | Label | Metric Type | Description |
|---|---|---|---|
|
wls_jta_active_transactions_total_count |
name |
long |
Returns the number of active transactions on the server. |
|
wls_jta_seconds_active_total_count |
name |
int |
Returns the total number of seconds that transactions were active for all committed transactions. |
|
wls_jta_transaction_abandoned_total_count |
name |
long |
Returns the total number of transactions that were abandoned since the server was started. |
|
wls_jta_transaction_committed_total_count |
name |
long |
Returns the total number of transactions committed since the server was started. |
|
wls_jta_transaction_heuristics_total_count |
name |
long |
Returns the number of transactions that completed with a heuristic status since the server was started. |
|
wls_jta_transaction_llrcommitted_total_count |
name |
long |
Returns the total number of LLR transactions that were committed since the server was started. |
|
wls_jta_transaction_no_resources_committed_total_count |
name |
long |
Returns the total number of transactions with no enlisted resources that were committed since the server was started. |
|
wls_jta_transaction_one_resource_one_phase_committed_total_count |
name |
long |
Returns the total number of transactions with more than one enlisted resource that were one-phase committed due to read-only optimization since the server was started. |
|
wls_jta_transaction_total_count |
name |
long |
Returns the total number of transactions processed. This total includes all committed, rolled back, and heuristic transaction completions since the server was started. |
WLS Scrape MBean Metric Group
Use the WLS scrape metric group to monitor the performance of the WebLogic Server. Table A-10 describes the metrics in this group.
Table A-10 WLS Scrape MBean Metrics
| Metric Name | Label | Metric Type | Description |
|---|---|---|---|
|
wls_scrape_mbeans_count_total |
instance |
long |
Returns the number of metrics scraped. |
|
wls_scrape_duration_seconds |
instance |
long |
Returns the time required to do the scrape. |
|
wls_scrape_cpu_seconds |
instance |
long |
Returns the amount of time the CPU used during the scrape. |
Persistent Store Runtime MBean Metric Group
Use the persistent store runtime MBean metric group to monitor a persistent store. Table A-11 describes the metrics in this group.
Table A-11 Persistent Store Runtime MBean Metrics
| Metric Name | Label | Metric Type | Description |
|---|---|---|---|
|
wls_persistentstore_allocated_io_buffer_bytes |
name |
long |
Returns the amount of off-heap (native) memory, in bytes, reserved for file store use. When applicable, this is a multiple of the file store configurable attribute IOBufferSize. This applies to synchronous write policies Direct-Write and Cache-Flush policies. |
|
wls_persistentstore_allocated_window_buffer_bytes |
name |
long |
Returns the amount of off-heap (native) memory, in bytes, reserved for file store window buffer use. Applies to synchronous write policies Direct-Write-With-Cache and Disabled, but only when the native wlfileio library is loaded. |
|
wls_persistentstore_create_count |
name |
long |
Returns the number of create requests issued by this store. |
|
wls_persistentstore_delete_count |
name |
long |
Returns the number of delete requests issued by this store. |
|
wls_persistentstore_object_count |
name |
int |
Returns the number of objects contained in the connection. |
|
wls_persistentstore_physical_write_count |
name |
long |
Returns the number of times the store flushed its data to durable storage. |
|
wls_persistentstore_read_count |
name |
long |
Returns the number of read requests issued by this store, including requests that occur during store initialization. |
|
wls_persistentstore_update_count |
name |
long |
Returns the number of update requests issued by this store. |