Java Management Extensions (JMX) Glossary for Jamf Pro

Updated: 20 August 2021
Product: Jamf Pro

Java Management Extensions (JMX) can be used to generate metrics for monitoring on-premise server performance. This article is a reference for configuring JMX in your Jamf Pro environment after you have enabled JMX.

For instructions on how to enable JMX, see the Enabling Java Management Extensions (JMX) for Jamf Pro article.

General Requirements

  • Jamf Pro with JMX enabled

  • JMX monitoring tool (e.g., Jconsole, Zabbix, Nagios)

JMX Objects

LdapConnectionsPoolMBean

  • Object Name— 
    com.jamfsoftware:Context=/,Type=ConnectionsPoolMBean,Name=com.jamfsoftware.jss.managementextensions.LdapConnectionsPoolMBean
  • Description—Statistics for the LDAP connection pool used by Jamf Pro
    Attribute NameAttribute Description
    ActiveCountThe total number of instances currently borrowed from the pool but not yet returned.
    BorrowedCountThe total number of objects successfully borrowed from this pool over the lifetime of the pool.
    CreatedCountThe total number of objects created for this pool over the lifetime of the pool.
    DestroyedCountThe total number of objects destroyed by this pool over the lifetime of the pool.
    IdleCountThe total number of instances currently idle in this pool.
    MaxSizeThe maximum number of objects that can be allocated by the pool. A negative number means there is no limit.
    MaxSizePerKeyThe limit on the number of object instances allocated by the pool per LDAP server.

ComputerCheckinCountMBean

  • Object Name— 
    com.jamfsoftware:Context=/,Type=CounterMBean,Name=com.jamfsoftware.jss.managementextensions.ComputerCheckinCountMBean
  • Description—A counter of computer check-ins to Jamf Pro.
  • Attribute Name—Count

EventLogCounterMBean

  • Object Name— 
    com.jamfsoftware:Context=/,Type=CounterMBean,Name=com.jamfsoftware.jss.managementextensions
  • Description—A counter of invocations of an event that is registered by the Jamf Event Notification service.
  • Attribute Name—Count

LdapConnectionsInUseMBean (Deprecated)

  • Object Name— 
    com.jamfsoftware:Context=/,Type=CounterMBean,Name=com.jamfsoftware.jss.managementextensions
  • Description—The number of LDAP connections currently in use.
  • Attribute Name—Count
  • Status—Deprecated. Use LdapConnectionsPoolMBean instead.

MDMCheckinCountMBean

  • Object Name— 
    com.jamfsoftware:Context=/,Type=CounterMBean,Name=com.jamfsoftware.jss.managementextensions
  • Description—A counter of mobile device check-ins to Jamf Pro.
  • Attribute Name—Count

PushNotificationCountMBean

  • Object Name— 
    com.jamfsoftware:Context=/,Type=CounterMBean,Name=com.jamfsoftware.jss.managementextensions
  • Description—A counter of push notifications sent from Jamf Pro.
  • Attribute Name—Count

RestAPIOperationCountMBean

  • Object Name— 
    com.jamfsoftware:Context=/,Type=CounterMBean,Name=com.jamfsoftware.jss.managementextensions
  • Description—A counter of all invocations of the Customer API.
  • Attribute Name—Count

HikariDataSourceMBean

  • Object Name— 
    com.jamfsoftware:Context=/,Type=DataSourceMBean,Name=com.jamfsoftware.jss.managementextensions
  • Description—Statistics regarding the connection pool implementation used for database access.
    Attribute NameAttribute Description
    ActiveConnectionCount The total number of connections currently borrowed from the pool but not yet returned.
    IdleConnectionCountThe total number of connections currently idle in this pool.
    TotalConnectionCountThe total number of connections in the pool. (The combination of Active Connection Count and Idle Connection Count.)
    WaitingThreadCountThe total number of threads that are currently blocked waiting for a connection from the pool.

ClusterThreadLastRunTimeMBean

  • Object Name— 
    com.jamfsoftware:Context=/,Type=LastClusterRunTimeMBean,Name=com.jamfsoftware.jss.managementextensions
  • Description—Timestamp of the last cluster thread run and also the last time updates were digested fully by the thread.
    Attribute NameAttribute Description
    LastDigestRunTime The time in which the cluster thread last completed processing all necessary updates.
    LastDigestRunTimeMillisThe time in which the cluster thread last completed processing all necessary updates, measured in milliseconds.
    LastRunTimeThe time in which the cluster thread last completed.
    LastRunTimeMillis The time in which the cluster thread last completed, measured in milliseconds.

EventLogQueueSizeMBean

  • Object Name— 
    com.jamfsoftware:Context=/,Type=QueueSizeMBean,Name=com.jamfsoftware.jss.managementextensions
  • Description—The queue used to facilitate the consumption of events in Jamf Pro.
  • Attribute Name—QueueSize

PushQueueSizeMBean

  • Object Name— 
    com.jamfsoftware:Context=/,Type=QueueSizeMBean,Name=com.jamfsoftware.jss.managementextensions
  • Description—A queue that holds all outgoing push notifications until they can be sent by Jamf Pro. This queue is built by the every 5 minute command queue monitor, which looks for commands that have not received a push in the last 6 hours (including commands that never received a push).
  • Attribute Name—QueueSize

VppSendInvitationQueueMBean

  • Object Name— 
    com.jamfsoftware:Context=/,Type=QueueSizeMBean,Name=com.jamfsoftware.jss.managementextensions
  • Description—A queue that holds all outgoing volume purchasing invitations until they can be sent by Jamf Pro.
  • Attribute Name—QueueSize

GeneralThreadPoolMBean

  • Object Name— 
    com.jamfsoftware:Context=/,Type=ThreadPoolMBean,Name=com.jamfsoftware.jss.managementextensions
  • Description—The multi-purpose thread pool in Jamf Pro used for running tasks asynchronously.
    Attribute NameAttribute Description
    ActiveThreadCountThe number of threads in the thread pool that are actively executing tasks.
    CurrentPoolSize The number of threads in the thread pool.
    QueuedTaskCountThe number of tasks or jobs that have been submitted to the pool but are queued and are not actively executing on one of the pool's threads.

ScheduledThreadPoolMBean

  • Object Name— 
    com.jamfsoftware:Context=/,Type=ThreadPoolMBean,Name=com.jamfsoftware.jss.managementextensions
  • Description—The thread pool in Jamf Pro that is used for executing tasks that are run on a schedule.
    Attribute NameAttribute Description
    ActiveThreadCountThe number of threads in the thread pool that are actively executing tasks.
    CurrentPoolSizeThe number of threads in the thread pool.
    QueuedTaskCountThe number of tasks or jobs that have been submitted to the pool but are queued and are not actively executing on one of the pool's threads.