Tags are short, user-defined text strings that can be assigned to any performance test or snapshot in the Rigor Optimization application. Tags can be any string of length 80 characters or less and include a priority level of Low, Medium, or High.
Tags can help you prioritize your workflow and share results with your team. For example, your team could filter by high priority tags to address recent performance regressions and then dismiss or reclassify those tags with a lower priority once issues have been addressed.
Any Rigor Optimization user with a ‘User’ permissions role can create and apply tags to organize noteworthy results or filter test and snapshot results to match your workflow.
How to Assign Tags
Tags can be assigned both at the Performance Test or Performance Snapshot level.
From a Test Results page or from a Performance Snapshot page, we can see that each test has a small “tag” icon under each name in the row for individual assignment. There’s also an “Add Tags” button in the toolbar we can use to assign tags in bulk across multiple rows.
Click either to open the ‘Add Tag’ modal:
Tag names can include spaces or punctuation and must be less than 80 characters. As a best practice, choose a tag name that’s concise, yet descriptive. For example, some good names for tags could be “Site Redesign v2” or “Introduced New Compression Bug.”
When you create a tag, assign a priority of Low, Medium, or High. Tags are color-coded based on priority (Grey for Low, Yellow for Medium, and Red for High) which will help us easily identify tags by priority. We ma also filter tags by priority.
Click ‘Add Tag’ to close the modal and apply the tags to selected defects.
We can assign multiple, different tags to the same tests or snapshots.
Note: Tags can be assigned at the Test or Snapshot level, but tags assigned at one level will not automatically be added to the other. If we assign a tag on the results for one test it will only be visible when we’re viewing the test and not when we’re viewing snapshots for that test. Similarly, if we set tags on a snapshot for a test these will only be visible when we’re viewing other snapshots.
How to Remove Tags
There are two ways to remove tags:
- Individually: Click the “x” icon to remove any specific tag, or
- Clear all tags: Use the ‘Remove Tags’ button to remove all tags set on a specific test or snapshot.
Searching and Filtering by Tags
Both the Test Results and Snapshot Results views have searching and filtering options for tags. To search for items with a tag, simply type the tag name (or a substring thereof) in the search box of the toolbar to see results for all matching tags.
Additionally, we can filter by the tag priority. On the Test level filters are available in the Filter Results toolbar:
And from a Snapshot we can use a toolbar in the Performance Snapshots table:
Tagging and the API
The Rigor Optimization API has full support for creating, removing and searching for tags both at the Performance Test and Snapshot level. Using tags with the API can be an effective way of automatically capturing specific milestones in your software development lifecycle, for example tagging a snapshot with a build number, or tagging performance tests against different testing environments.