Jolokia endpoints

The v2 metrics endpoint uses the Jolokia library, an extensive open-source metrics library with its own documentation.

The documentation below provides only the information you need to use the metrics as configured by default for Puppet Server, but Jolokia offers more features than are described below. Consult the Jolokia documentation for more information.

For security reasons, we enable only the read-access Jolokia interface by default:

read

list

version

search

Configuring Jolokia

To change the security access policy, create the /etc/puppetlabs/puppetserver/jolokia-access.xml file with contents that follow the Jolokia access policy and uncomment the metrics.metrics-webservice.jolokia.servlet-init-params.policyLocation parameter before restarting puppetserver.

The MBean names can then be created by joining the the first two keys of the
value table with a colon (the domain and prop list in Jolokia parlance).
Querying the MBeans is achieved via the read operation. The read operation
has as its GET signature: