Dataset: Issues & Pull Requests
Entity: Pull Requests, Issues
Field ID: metatags
Type: List of text values
Description: A list of keywords categorizing the type of work associated with the issue or pull request.
Source: Calculated
Transformation logic:
Issues: the combination of
labelsandsub_type.Pull requests: the combination of
labelsfrom the pull request andmetatagsfrom resolved issues. Resolved issues are issues referenced by the pull request via auto-closing keywords.
From: |
|
Github (PRs, Issues) | Inferred from self and resolved issues |
Gitlab (PRs, Issues) | Inferred from self and resolved issues |
Bitbucket (PRs) | Inferred from self and resolved issues |
Azure DevOps (PRs, Issues) | Inferred from self and resolved issues |
JIRA (Issues) | Calculated |
ClickUp (Issues) | Calculated |
Trello (Issues) | Calculated |
Reporting Use Cases
The Metatags field is one of the most powerful attributes for accurately categorizing work, as it provides a comprehensive list of all relevant keywords associated with an item. For pull requests, its unique ability to inherit the labels and types from the issues it resolves makes it superior to Labels for almost any kind of categorization.
Accurate Work Categorization: This is the primary use case for metatags. Since it includes tags from resolved issues, you can accurately categorize a pull request based on the problem it solves, not just the labels on the PR itself.
Change Failure Rate (DORA Metric): You can build a highly accurate Change Failure Rate metric by identifying pull requests that fix bugs. A custom formula like
COUNT_IF(CONTAINS(metatags, "Bug"))will correctly count a PR that resolves a Jira "Bug" issue, even if the PR itself is not labeled "Bug".Work Type Analysis: Create a pie chart to see the breakdown of your engineering efforts. Use a dimension with a formula like
IF(CONTAINS(metatags, "bug"), "Bug Fixes", "Feature Work")to correctly categorize all merged pull requests.
Filtering and Scoping: You can create powerful reports that link development activity back to your planning process.
Find all Bug-Fixing PRs: Create a report of all pull requests that address a bug by using a single filter:
Metatags contains "bug". This is much more reliable than filtering on PR labels alone.Track Work by Issue Type: Find all pull requests related to "Story" or "Task" issues from Jira with a filter like
Metatags contains any of "Story,Task".
Reporting on Individual Tags: Just like with label_names, you can use the
FLATTENfunction to analyze the prevalence of each individual tag across all your work items.To see a list of the most common tags (including inherited ones), create a report with
FLATTEN(metatags)as the dimension andCOUNT()as the metric.
