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
API	URL template	Description
Database	http://`<host>:<port>`/maximo/oslc/members/`<memberid>`/dbinfo	Provides information, such as the database version, vendor, or driver information, for the database that is used by the application. The resource provides links to the database connection pool details.
MBO count	http://`<host>:<port>`/maximo/oslc/members/`<memberid>`/mbocount	Provides MBO count information and 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	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	Provides information about the threads in the JVM, such as the current thread count, peak thread count, and if any deadlocks are present. 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	Provides information about the total number of concurrent users on a particular server.
Thread pool	http://`<host>:<port>`/maximo/oslc/members/`<memberid>`/threadpoolinfo	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
Metric name	URL template	Description
mas_manage_db_connectionused_total mas_manage_db_connectionfree_total	http://`<host>:<port>`/maximo/oslc/members/`<memberid>`/dbinfo	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 mas_manage_restservlet_total mas_manage_oslcservlet_total mas_manage_concurrentuser_total	http://`<host>:<port>`/maximo/oslc/members/thisserver/servletstats	Provides information about the total number of concurrent users on a particular server.
mas_manage_cronthread_total	http://`<host>:<port>`/maximo/oslc/members/thisserver/cronthread	Provides the total count of crontask threads
mas_manage_cronthread_peak_total	http://`<host>:<port>`/maximo/oslc/members/thisserver/cronthread	Provides a peak count of crontask threads within one minute.
mas_manage_mbo_total mas_manage_mboset_total	http://`<host>:<port>`/maximo/oslc/members/`<memberid>`/mbocount	Provides MBO count information. 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_heapmemory_used_total mas_manage_heapmemory_max_total	http://`<host>:<port>`/maximo/oslc/members/`<memberid>`/memory	Provides information about the server heap and nonheap memory usage. All units are in megabytes (MB).
mas_manage_thread_deadlock_total mas_manage_thread_peak_total mas_manage_thread_total	http://`<host>:<port>`/maximo/oslc/members/`<memberid>`/threads	Provides information about the threads in the JVM, such as the current thread count, peak thread count, and if any deadlocks are present. 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_threadpool_size_total mas_manage_threadpool_active_total	http://`<host>:<port>`/maximo/oslc/members/`<memberid>`/threadpoolinfo	Counts the total thread pool size and the total active thread pool count.
mas_manage_sessionstats_active_total mas_manage_sessionstats_create_total	http://`<host>:<port>`/maximo/oslc/members/`<memberid>`/sessionstatsinfo	Provides information on the total sessions, active sessions, and live sessions.

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 Manage 8.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	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® 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	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	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	Provides the response time for connecting to Cloud Object Storage.
mas_manage_pingkafka_totaltime_seconds	http://`<host>:<port>`/maximo/oslc/members/`<memberid>`/pingkafka	Provides the response time for connecting to Kafka.
mas_manage_pingdb_availability	http://`<host>:<port>`/maximo/oslc/members/`<memberid>`/pingdb	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	Checks the status for Cloud Object Storage connectivity.
mas_manage_pingkafka_availability	http://`<host>:<port>`/maximo/oslc/members/`<memberid>`/pingkafka	Checks the status for Kafka connectivity.
mas_manage_report_total	http://`<host>:<port>`/maximo/oslc/members/`<memberid>`/report	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	Counts the total concurrent thread count for cron tasks. Also counts 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	Provides the number of integration and UI objects that are exchanged on each server per minute.
Servlet stats	http://<host>:<port>/maximo/oslc/members/`<memberid>`/servletstat	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	Provides the runtime thread count information, which 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	Counts the total concurrent thread count for cron tasks. Also counts 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	Provides the number of integration and UI objects that are exchanged on each server per minute.
mas_manage_ui_mbo_total
mas_manage_systemexception_total	http://`<host>:<port>`/maximo/oslc/members/thisserver/errcountmetrics	Provides the total count of MXSystemException.
mas_manage_applicationexception_total		Provides the total count of MXApplicationException.
mas_manage_uiservlet_responsetime_seconds	http://`<host>:<port>`/maximo/oslc/members/`<memberid>`/servletstats	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	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	Provides the runtime thread count information that includes concurrent thread count and deadlocked thread counts.