Every Puppet run generates a report that provides information on that run, such as when the run took place, the nodes that were run, and the activity of resources — fundamental units of a system, such as a specific service or package — in the node. Each report lists the number of resources on the node in each of the following states:
- Failed: Number of resources that failed.
- Changed: Number of resources that changed.
- Unchanged: Number of resources that remained unchanged.
- No-op: Number of resources that would have been changed if not run in the no-op mode.
- Skipped: Number of resources that were skipped because they depended on resources that failed.
- Failed restarts: Number of resources that were supposed to restart but didn’t. For example, if changes to a resource notify a separate resource to restart, and that resource doesn’t restart, a failed restart is reported. It’s an indirect failure that occurred in a resource that was otherwise unchanged.
Each report also contains the following information:
- Config retrieval: Time spent retrieving the catalog for the node (in seconds).
- Run time: Time spent applying the catalog on the node (in seconds).
Working with the Reports page
Filter the reports by run status using the filter drop-down at the top of the Reports page. Click Filter by fact value to display the fact value filter, which allows you to further refine your report searches.
To filter by node fact:
- Click Filter by fact value to open the fact filter.
- Select whether nodes must have all or any of the fact values.
- In the Fact box, select one of the available facts.
- Select an Operator:
- = — is
- != — is not
- ~ — matches regex
- !~ — does not match regex
- > — greater than
- >= — greater than or equal to
- < — less than
- <= — less than or equal to
- In the Value box, type in a value. Strings are case-sensitive, so make sure you use the correct case.
Tips for working with operators:
- The numeric operators >, >=, <, and <= can be used only with facts that have a numeric value.
- To match highly specific node facts, use ~ or !~ with a regular expression for Value.
- Select ~ as the operator to use wildcards and other regular expressions if you want to find matching facts without having to specify the exact value.
You can also inspect a node’s details by clicking the node name in the Reports table. This takes you to the node’s Facts tab in the Node Management section of the console. In this section, you can also examine other details of the node, such as classes, variables, reports, groups, and activity.
Logs and resource events
To examine the report in greater detail, click the Reported at timestamp in the report table. This opens a page that provides details for the node’s resources in two sections: Log and Events.
The Log tab provides errors, warnings, or notifications about what happened during the node’s latest Puppet run.
Each message has one of the following labels:
Caution labels (shown in yellow)
Warning labels (shown in red)
The table items can be sorted by ascending or descending status label or time of run, so that the report can be read chronologically or in order of message level severity.
The Events tab lists each resource on the node, its status, and — if it has changed — what it has changed from and what it has changed to. For example, a user or a file might change from absent to present. Use the filter drop-down at the top of the page to filter resources by run status.
You can sort resource events by utilizing the controls at the top of the Time by type and Resource type columns, or filter results by selecting any result in either of these columns. The results of the sorting and filtering actions performed with the left column populate into the right column, where they can also be sorted by Resource or Status.
If you click the caret next to a changed resource in the list, run details are provided directly below the resource name. The run details describe what happened to the resource during the Puppet run.