Monitoring metrics

The monitoring agent for Maximo® Manage provides metrics for application usage and performance.

Monitoring Metrics for Maximo Manage 8.4.0 and earlier

Table 1. Server level monitoring metrics for Maximo Manage 8.4.0 and earlier versions
API URL template Description
Database http://<host>:<port>/maximo/oslc/members/<memberid>/dbinfo This API provides information about the database that is used by the application. Some of the information that is provided includes the database version or vendor information, and driver information. The resource also provides links to the database connection pool details.
MBO count http://<host>:<port>/maximo/oslc/members/<memberid>/mbocount This API provides MBO count information. The resource also provides links to the MBO and MboSet class. This class can be useful when you are trying to resolve out of memory (OOM) or performance issues.
Memory http://<host>:<port>/maximo/oslc/members/<memberid>/memory This API provides information about the server heap and nonheap memory usage. All units are in Megabytes (MB).
Threads http://<host>:<port>/maximo/oslc/members/<memberid>/threads This API provides information about the threads in the JVM, such as the current thread count, peak thread count, and if any deadlocks are present. It also provides a link to count the threads in the system at that instant. The API consumer can check for thread states and lock information about each thread.
Thisserver http://<host>:<port>/maximo/oslc/members/thisserver This API provides information about the total number of concurrent users on a particular server.
Thread pool http://<host>:<port>/maximo/oslc/members/<memberid>/threadpoolinfo This API counts the total thread pool size and the total active thread pool count.
Table 2. Server level monitoring metrics for Maximo Manage 8.5 and earlier versions
Metric name URL template Description
mas_manage_db_connectionused_total http://<host>:<port>/maximo/oslc/members/<memberid>/dbinfo This metric provides information about the database that is used by the application, including the database version or vendor information, and the driver information. The resource also provides links to the database connection pool details.
mas_manage_db_connectionfree_total http://<host>:<port>/maximo/oslc/members/<memberid>/dbinfo This metric provides information about the database that is used by the application, including the database version or vendor information, and the driver information. The resource also provides links to the database connection pool details.
mas_manage_uiservlet_total http://<host>:<port>/maximo/oslc/members/thisserver/servletstats This metric provides information about the total number of concurrent users on a particular server.
mas_manage_oslcservlet_total
mas_manage_restservlet_total
mas_manage_concurrentuser_total http://<host>:<port>/maximo/oslc/members/thisserver/
mas_manage_cronthread_total http://<host>:<port>/maximo/oslc/members/thisserver/cronthread This metric provides the total count of crontask threads.
mas_manage_cronthread_peak_total This metric provides a peak count of crontask threads within one minute.
mas_manage_mbo_total http://<host>:<port>/maximo/oslc/members/<memberid>/mbocount This metric provides MBO count information. The resource also provides links to the MBO and MboSet class. This class can be useful when you are trying to resolve out of memory (OOM) or performance issues.
mas_manage_mboset_total
mas_manage_heapmemory_used_total http://<host>:<port>/maximo/oslc/members/<memberid>/memory This metric provides information about the server heap and nonheap memory usage. All units are in Megabytes (MB).
mas_manage_heapmemory_max_total
mas_manage_thread_deadlock_total http://<host>:<port>/maximo/oslc/members/<memberid>/threads This metric provides information about the threads in the JVM, such as the current thread count, peak thread count, and if any deadlocks are present. It also provides a link to count the threads in the system at that instant. The API consumer can check for thread states and lock information about each thread.
mas_manage_thread_peak_total
mas_manage_thread_total
mas_manage_threadpool_size_total http://<host>:<port>/maximo/oslc/members/<memberid>/threadpoolinfo This metric counts the total thread pool size and the total active thread pool count.
mas_manage_threadpool_active_total
mas_manage_sessionstats_active_total http://<host>:<port>/maximo/oslc/members/<memberid>/sessionstatsinfo This metric provides information on the total sessions, active sessions, and live sessions.
mas_manage_sessionstats_live_total
mas_manage_sessionstats_create_total

Additional monitoring metrics for Maximo Manage 8.5.0 and later

Maximo Manage 8.5.0 provides the following additional metrics.

Table 3. Additional instance level monitoring metrics for Maximo Manage8.5.0
API URL template Description
Table size http://<host>:<port>/maximo/oslc/members/<memberid>/tablesize This API provides information about the five database tables that have the largest table size per day. The table size is measured in MB per day.
DB connection and average response time http://<host>:<port>/maximo/oslc/members/<memberid>/pingdb This API checks the database connection and calculates the average response time that is required to run 10 recent queries. These queries are obtained from the system tables. The queries are run on Db2® and DB2® databases.
Table 4. Additional instance level monitoring metrics for Maximo Manage 8.5
Metric name URL template Description
mas_manage_db_top5tablesize_bytes http://<host>:<port>/maximo/oslc/members/<memberid>/tablesize This metric provides information about the five database tables that have the largest table size per day. The table size is measured in MB per day.
mas_manage_pingdb_totaltime_seconds http://<host>:<port>/maximo/oslc/members/<memberid>/pingdb This metric checks the database connection and calculates the average response time that is required to run 10 recent queries. These queries are obtained from the system tables. The queries are run on Oracle and Db2 databases.
mas_manage_pingcos_totaltime_seconds http://<host>:<port>/maximo/oslc/members/<memberid>/pingcos This metric provides the response time for connecting to Cloud Object Storage and the status for Cloud Object Storage connectivity.
mas_manage_pingkafka_totaltime_seconds http://<host>:<port>/maximo/oslc/members/<memberid>/pingkafka This metric provides the response time for connecting to Kafka and the status for Kafka connectivity.
mas_manage_pingdb_availability http://<host>:<port>/maximo/oslc/members/<memberid>/pingdb This metric checks the database connection and calculates the average response time that is required to run 10 recent queries. These queries are obtained from the system tables. The queries are run on Oracle and Db2 databases.
mas_manage_pingcos_availability http://<host>:<port>/maximo/oslc/members/<memberid>/pingcos This metric provides the response time for connecting to Cloud Object Storage and the status for Cloud Object Storage connectivity.
mas_manage_pingkafka_availability http://<host>:<port>/maximo/oslc/members/<memberid>/pingkafka This metric provides the response time for connecting to Kafka and the status for Kafka connectivity.
mas_manage_report_total http://<host>:<port>/maximo/oslc/members/<memberid>/report This metric provides the total number of reports that are run for the previous hour.
Table 5. Additional server level monitoring metrics for Maximo Manage 8.5
API URL template Description
Cron thread http://<host>:<port>/maximo/oslc/members/<memberid>/cronthread This API counts the total concurrent thread count for cron tasks and the peak count of total cron threads in each server per minute.
Integration and UI objects exchanged http://<host>:<port>/maximo/oslc/members/<memberid>/objexchanged This API provides the number of integration and UI objects that are exchanged in each server per minute.
Servlet stats http://<host>:<port>/maximo/oslc/members/<memberid>/servletstat This API provides request and response information about the OSLCServlet, RESTServlet, and UIServlet for each deployed application. The response time is measured in milliseconds.
Thread stats http://<host>:<port>/maximo/oslc/members/<memberid>/threads This API provides the runtime thread count information that includes concurrent thread count and deadlocked thread counts.
Table 6. Additional server level monitoring metrics for Maximo Manage
Metric name URL template Description
mas_manage_cron_thread_total http://<host>:<port>/maximo/oslc/members/<memberid>/cronthread This metric counts the total concurrent thread count for cron tasks and the peak count of total cron threads in each server per minute.
mas_manage_integration_mbo_total http://<host>:<port>/maximo/oslc/members/<memberid>/objexchanged This metric provides the number of integration and UI objects that are exchanged in each server per minute.
mas_manage_ui_mbo_total
mas_manage_systemexception_total http://<host>:<port>/maximo/oslc/members/thisserver/errcountmetrics This metric provides the total count of MXSystemException created
mas_manage_applicationexception_total This metric provides the total count of MXApplicationException created
mas_manage_uiservlet_responsetime_seconds http://<host>:<port>/maximo/oslc/members/<memberid>/servletstats This metric provides the request and response information about the OSLCServlet, RESTServlet, and UIServlet for each deployed application. The response time is measured in milliseconds.
mas_manage_oslcservlet_responsetime_seconds
mas_manage_restservlet_responsetime_seconds
mas_manage_thread_deadlock_total http://<host>:<port>/maximo/oslc/members/<memberid>/threads This metric provides the runtime thread count information that includes concurrent thread count and deadlocked thread counts.
mas_manage_thread_total
mas_manage_thread_peak_total http://<host>:<port>/maximo/oslc/members/<memberid>/threads This metric provides the runtime thread count information that includes concurrent thread count and deadlocked thread counts.