With the Metric Builder for Jira, you can create Custom Jira Metrics using a combination of Metrics, Dimensions and Filters.
- Access Custom Metric and Metric Builder for Jira
- Use the Metric Builder for Jira
- Create a Custom Jira Metric [Example]
- Add a Custom Jira Metric to a Databoard
- Additional Information
How to access Custom Metric and Metric Builder for Jira
Navigate to Metrics > Custom Metrics to access the Metric Builder for Jira. Click the green + New Custom Metric button and select your connected Jira Account from the Data Source drop-down list.
Metric Builder is available on the Professional and higher plans. Request a trial of Metric Builder by following these steps.
How to use the Metric Builder for Jira
The Dimensions parameter re-categorizes the returned Metric value based on common criteria. Examples of Dimensions are "Assignee," "Project," and "Features." If no Dimension is selected, the Custom Metric will store 1 aggregated Metric value for each Date Range.
Pro Tip : If you don't know which Filters to put in place for your use case, use the Dimension + Data Preview to troubleshoot and get more insight into the data that is returned from your ira Account for each field. Learn more here.
How to create a Custom Jira Metric [Example]
In this example, we'll create a Custom Metric to report on Progress, split up based on the Creator. We only want to include tasks that are labeled "Urgent" or "High" Priority.
- Navigate to Metrics > Custom Metrics
- Click the green + New Custom Metric button
- Select the appropriate Jira Data Source
- Since a "Progress" is what we're looking to track, we will select Progress from the Metric dropdown list
- After selecting Progress as the Metric, a new field is exposed called Dimension. Click on Dimension and select Creator from the dropdown list. This will split up the Progress based on the task Creator
- We want to include any tasks that were updated during the specified Date Range, so we'll select Updated as the Date Field
- Lastly, we want to restrict the Custom Metric to only retain data for Urgent and High Priority cases, so we'll add 2 Filters.
First, we'll open the Field drop-down list and will select Priority. The Operator selection will be = and the first Value is Urgent. Since we want to include Urgent or High Priority, we'll click on the + sign to add another Filter. We'll select OR so only 1 Filter needs to be satisfied for data to be retained. For this Filter, we'll select Priority = High.
- In order to accurately explain what this Custom Metric is reporting on, we'll name the Custom Metric "Progress by Creator (Urgent/ High Priority)"
- Click Preview data to generate a Data Preview of the Custom Metric
- Once we confirm that these are the results we're looking for, we'll click Save to save the Custom Metric
How to add a Custom Jira Metric to a Databoard
Learn how to add a Custom Metric to a Databoard here.
- Only the first 15 Values returned will be displayed in the Value drop-down list. Follow these steps to determine the exact Filter Value and manually enter it into the Value field.