PE 2.0 » Console » Viewing Reports

A newer version is available; see the version menu above for details.

Console: Navigating the ConsoleIndexConsole: Grouping and Classifying Nodes

Viewing Reports and Inventory Data

When nodes fetch their configurations from the puppet master, they send back inventory data and a report of their run. These end up in the console, where you can view them in that node’s page.

Reading Reports


Each node page has a pair of graphs: a histogram showing the number of runs per day and the results of those runs, and a line chart tracking how long each run took.

The pair of graphs on a node page

The daily run status histogram is broken down with the same colors that indicate run statuses in the console’s sidebar: red for failed runs, orange for pending runs (where a change would have been made, but the resource to be changed was marked as no-op), blue for successful runs where changes were made, and green for successful runs that did nothing. You can hover over a block of color for a tooltip showing how many runs of that type occurred:

Tooltip showing two changed runs

Note: Run status histograms also appear on group pages, class pages, and run status pages.

The run time chart graphs how long each of the last 30 Puppet runs took to complete. A longer run usually means changes were made, but could also indicate heavy server load or some other circumstance. You can hover over a point on the line for a tooltip showing the number of seconds it represents:

Tooltip showing how long a run took

Normal Reports

Each node page has a short list of recent reports, with a “more” button at the bottom for viewing older reports:

The list of recent reports

Each report represents a single Puppet run. Clicking a report will take you to a tabbed view that splits the report up into metrics, log, and events.

Metrics is a rough summary of what happened during the run, with resource totals and the time spent retrieving the configuration and acting on each resource type.

The metrics tab of a report

Log is a table of all the messages logged during the run.

The log tab of a report

Events is a list of the resources the run managed, sorted by whether any changes were made. You can click on a changed resource to see which attributes were modified.

The events tab of a report

Viewing Inventory Data

Each node’s page has a section called inventory. This section contains all of the fact values reported by the node on its most recent run.

The location of the inventory section

Facts in the inventory

Facts include things like the operating system (operatingsystem), the amount of memory (memorytotal), and the primary IP address (ipaddress). You can also add arbitrary custom facts to your Puppet modules, and they too will show up in the inventory.

The facts you see in the inventory can be useful when filtering nodes in the live management page.

Searching by Fact

Use the “inventory search” page to find a list of nodes with a certain fact value.

The inventory search page

Results of a search

You can add more facts to filter the search results further, and can change the comparison criteria for each one.

Console: Navigating the ConsoleIndexConsole: Grouping and Classifying Nodes

↑ Back to top