Metrics API

Use the metrics API to query Java Management Extension (JMX) metrics related to Puppet Server and the orchestrator service.

You can use the GET /status/v1/services/<SERVICE NAME> endpoint to get a summary of metrics. Form your request as: /status/v1/services/orchestrator-service?level=debug

There are many metrics available. For example, the "depoy-queue.length" metric reports how many nodes are waiting in queue to execute a deployment due to the global-concurrent-compiles setting, and the "task-queue.length" metric reports how many nodes are waiting in queue to execute a task due to the task_concurrency setting. The "jobs-created" metric expresses how many jobs were created in the current instance, and the "puppet-run-time" metric describes a trailing five-minute average of how long it takes a Puppet run to complete (only for Puppet runs triggered by the orchestrator).

  • Metrics API v2

    The /metrics/v2/ endpoints use the Jolokia library for Java Management Extension (JMX) metrics to query Orchestrator service metrics.

  • Metrics API v1

    Puppet Enterprise (PE) includes an optional web endpoint for Java Management Extension (JMX) metrics managed beans (MBeans).

Related information