PE’s node graph provides a graphic representation of any node’s configuration, shows you the relationships between classes and resources, and lets you gain greater insight into just how the Puppet master compiles your Puppet code and ships it to a Puppet agent. Visualizing relationships between resources helps you organize them, creating more reliable deployments.
How the node graph can help you
The node graph displays a node’s catalog (as of the last Puppet run) as an interactive visual map. The graph shows the desired state for each resource that PE manages, as well as each resource’s status as of the last run, and helps you understand the dependencies between resources. It also allows you to visually identify complexity you may not need, and problematic dependencies that need your attention.
The node graph is an ideal tool for:
- Gaining greater insight into your PE deployment.
- Visualizing the relationship of resources on your nodes.
- Diagnosing dependency loops and viewing all impacted resources.
- Helping new users to understand relationships among classes and resources in their Puppet catalog.
- Understanding defined resource types as they are deployed across your configuration.
- Understanding the content of modules.
Investigate a change with the node graph
Use the node graph to view the details of a change made to one of your nodes, and see how other resources and classes might be impacted.
Access a node’s graph
You can reach a node’s graph from the Overview page in the PE console:
- In the PE console, click Configuration > Overview.
- (Optional) Use the status counts section at the top of the page to filter nodes by run status.
- In the run status table below the status counts section, locate the name of the node you wish to view, and click Node graph.
Alternately, access a node’s graph from the node inventory section:
- In the PE console, click Nodes > Inventory.
- In the Node name column, click the name of the node you wish to view.
- On the node detail page that opens, click View node graph.
Focus on a change
When the node graph opens, you’ll see the containment view, which presents the catalog in its entirety. This can be a bit overwhelming, but you can use filters to quickly focus on the change event you’re interested in.
- In the Filter: bar, select status from the drop-down list.
- Enter a run status, such as Corrective change, or select from the options available in the drop-down. The details panel at the right of the screen opens and displays a list of resources that match your filter criteria.
- Select any item on the list, and the graph repositions to focus on that resource. The details pane now shows additional data on current event status, as well as the object’s source file, code line number, relevant tags, and class containment information.
If your resource is part of a dependency chain, a Dependency view link is shown in the details pane (this link does not appear for resources without any dependencies).
- Click Dependency view. The details panel at the right of the screen displays a list of the resource’s ancestor and descendant dependencies, as applicable.
- Hover over any item on the list, and the graph highlights that dependency path. Note: In the event that a dependency cycle is detected, PE issues a cycle warning message.
- Click Exit dependency view to return to the containment view.