Tracking goal progress

Community Platform

With runZero goals, users are able to create and monitor progress toward achieving security initiatives. All goal types are supported by the robust query language on the backend. All types of inventory queries are supported by the goal tracking feature.

There are three types of goals:

• Saved query - a goal based on the results of a user-defined or runZero system query.
• Asset ownership - a goal that measures progress toward assigning owners to assets in your inventory.
• Asset risk - a goal that measures progress toward reducing the number of assets with a minimum risk level in your inventory.

Goal creation

New goals can be created by users whose default role is user or greater from the Goals page in the console. Users with viewer-level or greater access will be able to view the goals page and see the goals that apply to organizations they have access to.

To create a new goal, click the New goal button on the Goals page in the console.

Creating saved query goals

1. On the Goal type tab, select the Saved query type.
2. On the Build goal tab, complete any desired fields:
   • Name: Provide a name for your goal.
   • Description: Provide a description for the goal.
   • Notes: Add relevant notes about this goal.
   • Organization access: By default, a goal will be created for the currently selected organization, but you may select additional organizations as desired. Goals are editable by any user with User role access to every organization associated with the goal, and can be read by any user with Viewer role access to at least one organization.
   • Query: Determine the query you want to use to track progress for this goal by selecting the query from the table. If needed, use the search field to find the query you wish to use.
   • Threshold: Select whether goal progress will be calculated as Greater than or equal or Less than or equal, whether goal progress will be calculated as a percent or fixed number, and then set the desired threshold value.
   • Target date: Provide an optional target date for achieving this goal.
3. Click Save when you’re ready, or make changes as needed.

Creating asset ownership goals

1. On the Goal type tab, select the Asset ownership type.
2. On the Build goal tab, complete any desired fields:
   • Name: Provide a name for your goal.
   • Description: Provide a description for the goal.
   • Notes: Add relevant notes about this goal.
   • Organization access: By default, a goal will be created for the currently selected organization, but you may select additional organizations as desired. Goals are editable by any user with User role access to every organization associated with the goal, and can be read by any user with Viewer role access to at least one organization.
   • Ownership type: Select the ownership type you wish to track for this goal. New ownership types can be created by users with a default role of administrator or superuser from the Ownership page.
   • Target coverage: Set the target coverage for the selected ownership type.
   • Target date: Provide an optional target date for achieving this goal.
3. Click Save when you’re ready, or make changes as needed.

Creating asset risk goals

1. On the Goal type tab, select the Asset risk type.
2. On the Build goal tab, complete any desired fields:
   • Name: Provide a name for your goal.
   • Description: Provide a description for the goal.
   • Notes: Add relevant notes about this goal.
   • Organization access: By default, a goal will be created for the currently selected organization, but you may select additional organizations as desired. Goals are editable by any user with User role access to every organization associated with the goal, and can be read by any user with Viewer role access to at least one organization.
   • Minimum risk: Select the minimum level of risk you wish to track for this goal.
   • Minimum criticality: Set the minimum criticality of the assets tracked by this goal (optional).
   • Target percent: Set the percent threshold you aim to be under. As an example, you might define a goal to have less than 25% of your critical assets with a risk level of medium or higher by setting target percent to 25%, minimum criticality to critical, and minimum risk to medium.
   • Target date: Provide an optional target date for achieving this goal.
3. Click Save when you’re ready, or make changes as needed.

Goal progress calculation

Once a goal has been created, the progress will be calculated once a day and when tasks complete. As a result, you may see a different number of metric calculations in the historical line chart depending on the number of tasks that are completed on a given day.

The overall status noted in the Goal details card on a goal details page reflects the progress toward goal completion for all the configured organizations that you have access to. This may differ for a user with more or less per-organization access.

Note: When a goal applies to multiple organizations, progress is calculated per-organization and extrapolated across all applicable organizations.

Goal events and notifications

The events system includes the following events related to goals:

• goal-created: This event fires when a goal is created and saved.
• goal-updated: This event fires when a goal is modified and saved.
• goal-completed: This event fires when the progress of a goal crosses the completion threshold.
• goal-lapsed: This event fires when the progress for a previously completed goal falls below the completion threshold.
• goal-removed: This event fires when a goal is deleted.

These events can be used with channels and rules to receive notifications about a change in goal status. After a notification channel has been created, create a rule for the desired event and select the channel you wish to receive the notification through.