Java Management Extensions (JMX) Glossary for 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
  • DescriptionStatistics 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
  • DescriptionA counter of computer check-ins to Jamf Pro.
  • Attribute NameCount

EventLogCounterMBean

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

LdapConnectionsInUseMBean (Deprecated)

  • Object Name
    com.jamfsoftware:Context=/,Type=CounterMBean,Name=com.jamfsoftware.jss.managementextensions
  • DescriptionThe number of LDAP connections currently in use.
  • Attribute NameCount
  • StatusDeprecated. Use LdapConnectionsPoolMBean instead.

MDMCheckinCountMBean

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

PushNotificationCountMBean

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

RestAPIOperationCountMBean

  • Object Name
    com.jamfsoftware:Context=/,Type=CounterMBean,Name=com.jamfsoftware.jss.managementextensions
  • DescriptionA counter of all invocations of the Customer API.
  • Attribute NameCount

HikariDataSourceMBean

  • Object Name
    com.jamfsoftware:Context=/,Type=DataSourceMBean,Name=com.jamfsoftware.jss.managementextensions
  • DescriptionStatistics 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
  • DescriptionTimestamp 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
  • DescriptionThe queue used to facilitate the consumption of events in Jamf Pro.
  • Attribute NameQueueSize

PushQueueSizeMBean

  • Object Name
    com.jamfsoftware:Context=/,Type=QueueSizeMBean,Name=com.jamfsoftware.jss.managementextensions
  • DescriptionA 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 NameQueueSize

VppSendInvitationQueueMBean

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

GeneralThreadPoolMBean

  • Object Name
    com.jamfsoftware:Context=/,Type=ThreadPoolMBean,Name=com.jamfsoftware.jss.managementextensions
  • DescriptionThe 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
  • DescriptionThe 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.