Manually marking a commit within the platform will keep the commit from appearing in any of the reports or being used in metrics except the Work log. Below are the steps to mark a commit as an outlier.
Who can use this?
In order to manually mark a commit as an outlier you need to have the permissions to do so. You will need two permissions:
- Manage commits
- Manage configurations
See our Advanced outlier detection settings help document for instructions on permission settings. Once you have access, the Advanced outlier detection feature needs to be turned on. Go to the top navigation bar and click Settings. Using the left navigation under Report Settings, click Configurations.
On the Configurations page, turn the Override legacy detection mode On and save your changes. Once you have completed this, you will be able to mark commits manually.
Marking a commit as an outlier
Navigate to the Work log report and find the commit you want to mark as an outlier.
Click on the commit, then click on the three dots icon to bring up the context menu allowing you to either view the commit on your Git host or mark the commit as an outlier.
Success! The manually marked outlier commit appears as an empty commit cell with a reason of Manually excluded in its tooltip when the Outlier filter is selected.
This commit will now appear in your manually marked commits list in your Configuration page. Follow the steps below to see your list of manually marked outlier commits.
Managing outlier commits via the Configurations page
Using the main navigation, click Settings then click Configurations.
On the Outlier tab of the Configurations page, select View all manually marked outliers in the top right corner. To reprocess all of the existing commit data, click the Rescore all past commits button. It can take up to 24 hrs to rescore past commits.
The Manually marked outliers modal will appear. Here all the manually marked outliers will appear in a list.
Note: This will also include any commit you marked as an outlier then later reverted back to a normal commit. These commits will be shown as normal as seen in the second commit in the image below.
In this modal there are 3 actions you can take:
Manually mark any commit in the list as an outlier or normal commit.
Marking a commit as an outlier means you are re-marking it as an outlier commit.
Marking a commit as normal will return the commit to all reports and metrics within Flow. The commit will still remain in this list and will not be eligible to be re-scored by your Advanced outlier detection settings.
Reset all manually marked commits
Doing this will reset all of the manually marked outliers in your account. This will include those you set, as well as anyone else from your organization. They will no longer appear in the list, and they will be eligible to be re-scored by your Advanced outlier detection settings.
Click Reset all manually marked outliers.
All commits in the list will be grayed out as seen below. Here you will be able to re-add any commits if necessary.
To update your manual marked outliers list you will need to click Update.
A modal will appear asking you to confirm your decision. If you are ready to reset all the manually marked outliers, click Yes, update my list.
You successfully reset all manually marked outliers. All of the removed commits will be eligible to be re-scored by your Advanced outlier detection settings if applicable.
Reset manually marked commits individually
You may reset commits individually. They will no longer appear in the list, and they will be eligible to be re-scored by your Advanced outlier detection settings.
Next to the commit you would like to remove from the list Manually marked outliers list. Click Reset.
The commit will be greyed out and you will be able to add it back into the list if you want to undo your action.
Once you are done making changes to individual commits click Update.
A modal will appear asking you to confirm your decision. If you are ready to remove the individual commit from the manual exclusion list, click Yes, update my list.
You have successfully removed the individual commit from the manual excusing list. This commit will now be eligible to be re-scored by your other Advanced outlier detection settings if applicable. You will no longer see this commit in your list.
If you reset a commit individually as you did above, AND made changes to a commit’s state (Outlier to Normal Commit or vice versa) you will see the following message:
Un-marking a manually outliered commit via the Work log report
You can mark any manually marked outlier commit as a normal commit in the Work log report. This will only mark it as a normal commit. It will not remove it from your manually marked outliers list.
Locate the manually outliered commit in the Work log report.
Click on the commit to bring up the context menu. Click the three dots icon and select Mark as normal commit.
You have successfully marked the outlier commit as a normal commit. This commit will now be seen and used in your other reports and metrics.
If you need help, please email Support (opens email form) for 24/7 assistance.