A node is used to represent virtually anything with an IP address. Nodes are scanned by our platform and configuration discovered, allowing for the tracking of changes, rich configuration differencing and for policies to be created which describe a nodes desired state.

Compare Two Nodes

After selecting a node from the node list, you can compare that node to another by following these simple steps.

  1. Choose “Another Node” from the “Compare to” section on the left of the graph. compare-two-nodes-01

  2. Select the node from the list presented in the pop-out. compare-two-nodes-02

  3. You can also filter the list down to exactly what you are looking for. compare-two-nodes-03

  4. Then simply hit the “compare” button next to the node to go to the comparison view. compare-two-nodes-04

Using File Differencing

File differencing is only possible for files specifically listed in your Scan Options. i.e.: You must enter the full path to the file in the Scan Directories field of the Scan Options. eg:


This indicates to UpGuard that you want the full contents of the file scanned, not just a checksum of the contents.

Now when a change is detected on that file you will get the option to see a side-by-side File Diff of the changes. You can also do side-by-side differencing against the same file on another machine.

Group Differencing

The ability to compare configuration items across multiple nodes in your environment is critical in uncovering and understanding inconsistencies. Classic scenarios where we see this functionality prove to be absolutely critical is in comparing nodes in a cluster (where an assumption exists that all nodes are like configured) or in comparing nodes that can be grouped by certain like characteristics or functionality such as by operating system or role.

Performing a Group Diff

To perform a group diff navigate to Manage, Nodes and select the nodes that you are interested in performing a group diff against. Once multiple nodes are selected, a Diff x Nodes button will appear which will allow you to perform a group diff.


And the results:




The presentation of this data has been inspired by using the Raft election metaphor. When comparing configuration that is the same across all nodes in a group diff, more consensus can be achieved about “what is the same”. This appears as a grey or lighter orange square. Similarly, if a given configuration item is different on each node (such as a package version) less consensus can be achieved and a brighter orange square appears.

What is then surfaced and highlighted are the configuration items that are inconsistent.


Comparing Scan IDs from Two Different Nodes

You can use the current diff tools to compare a node scan from one node to a node scan from another node. To do so, select two nodes within a node group, then click the Diff 2 nodes button.


After diffing, you will be able to toggle the dropdowns in the left sidebar to select scans in the diff. The diff view will change based on the scans selected via dropdown.


Node List

The node list provides an overview of your UpGuard environment, as well as serving as a launch pad for most of UpGuard’s functionality.

Colored Bars

The colored bars on the far left-hand side indicate the status of the most recent scan: Red indicates an exception, black indicates a connectivity failure and no bar indicates success.


Hovering over the node name will give you more detailed status information.


Multi-Select Functionality

Hovering over the node’s name will also reveal a checkbox that facilitates multi-select functionality. This can be used to diff the selected nodes, add the selected nodes to a node group or create a new node group from the selected nodes.