Puppet Enterprise 2019.1

Use the /usage endpoint to view details about the active nodes in your deployment.

GET /usage

List the daily node usage of the orchestrator and nodes that are present in PuppetDB.

Parameters

start_date
The first day to include in the query. Format as YYYY-MM-DD.
end_date
The last day to include in the query. This date must be on or after the start date and formatted as YYYY-MM-DD.

Response format

The response is a JSON object indicating the total number of active nodes and subtotals of the nodes with and without an agent installed.

The following keys are used:
items
Contains an array of entries from most recent to least recent.
date
The date in ISO 8601 date format YYYY-MM-DD.
total_nodes
The total number of nodes used on the given day.
nodes_with_agent
The number of active nodes in PuppetDB as of UTC midnight.
nodes_without_agent
The number of unique nodes that don't have an agent that were used since UTC midnight.
pagination
An optional object that includes information about the original query.
start_date
The starting day for the request (if specified).
end_date
The last day requested (if specified).
{
  "items":[
      {
        "date": "2018-06-08",
        "total_nodes": 100,
        "nodes_with_agent": 95,
        "nodes_without_agent": 5
      }, {
        "date": "2018-06-07",
        "total_nodes": 100,
        "nodes_with_agent": 95,
        "nodes_without_agent": 5
      }, {
        "date": "2018-06-06",
        "total_nodes": 100,
        "nodes_with_agent": 95,
        "nodes_without_agent": 5
      }, {
        "date": "2018-06-05",
        "total_nodes": 100,
        "nodes_with_agent": 95,
        "nodes_without_agent": 5
      }
  ],
  "pagination":{
     "start_date": "2018-06-01",
     "end_date": "2018-06-30"
  }
}

Error Responses

For this endpoint, the kind key of the error displays the conflict.

Back to top
The page rank or the 1 our of 5 rating a user has given the page.
The email address of the user submitting feedback.
The URL of the page being ranked/rated.