Environment are scanned by default every 24 hours after which an email report is sent to your inbox detailing configuration changes and policy pass/fail results. A notification email is also sent detailing any nodes that could not be scanned.

Change Report

There are several ways to reach the change report. The most obvious is perhaps to click Discover in the navigation bar and select Change Report. This will set the report to show detailed changes on all nodes over the last week. It can also be reached from the drop down beneath Edit on the node page under View Change Report, in which case it will be set to show only changes for that node.

Configuring the Data Set

Like on the node page, the left pane sets the context for the data set to investigate. You can choose the date range from some common presets or select a custom date range if you like to get fancy. Below that you set which nodes to examine.

  • After selecting Environments the drop down will show a list of environments.
  • If you select Node Groups, you will see a list of node groups.
  • To report on individual nodes, select Nodes and then use the search field to find the one you seek.

Grouping

Given the time frame and nodes specified above, there are a number of ways to organize the data. On the right side of the screen there are three options for how to group the data.

  • No Grouping is a list of all items that have changed.
  • Group by Node sorts each change under the node on which it took place.
  • Group by Day and Group by Month sort by the date of the change.

Filtering

With a substantial number of nodes or over a long period of time the number of changes becomes unwieldy. When sorting by node, a top level filter lets you search for nodes by name. Clicking a grouping category (node or date) lists all the changed items. In this context, the filter applies to changes. The change filter carries over between nodes so that if you search for changes on “openssl” on one node, when you click to expand another node it will be pre-filtered to the same set of changes.

Environment Reports (User Settings)

Users can fine tune the criteria for receiving Environment Reports e-mails. To do so, click on the dropdown menu in the top right corner, and click on “Manage…”

w300

Click on the name of the organization.

w300

Click the green “Edit” button and adjust the values in the drop downs against each environment as desired. You can choose from “Send Daily”, “Send for Changes Only”, or “Don’t Send” in the event you would like to not receive any notifications from UpGuard.

drift-notification-types-01

Group Differencing Email

To receive information regarding Group Differencing along with your daily UpGuard Notification email:

  1. Choose the desired Node Group. group-diff-email-01

  2. Click the setting wheel. Click on edit. group-diff-email-02

  3. Click on General to open the drop down box and choose the Notify on Group Diff box. group-diff-email-03

  4. To finish, click the green Save button at the bottom. group-diff-email-04