JQL based imports
HeyQL Metrics allows you to create metrics out of a JQL based search. Each jql-string, which is valid for your JIRA instance is also valid for HeyQL.
You are free to define the JQL and the measurement period. HeyQL Metrics performs a search with the given JQL and the given period. The amount of found issues gets stored in the related issue metric and the execution date is used as timestamp.
JQL Measurement
You can use every valid JQL. This includes also additional JQL parameters from HeyQL Metrics itself or other plugins.
Some examples:
- assignee = Admin
- project = XY AND metricMeanValue > 2
You can easily test you JQL by testing it inside JIRA's Issue Navigator.
Measurement period
The period must be defined as a string and math the following regular expression:
\d{1,3}[smhDMWY]
The following values are allowed for [Period]:
| Y | Years |
|---|---|
| M | Months |
| W | Weeks |
| D | Days |
| h | Hours |
| m | Minutes |
| s | Seconds |
You can combine different periods, like:
- 1W5D12h for 1 Week, 5 Days and 12 Hours.
- 25h72m1Y24M for 1 Year, 24 Months, 25 Hours and 72 minutes.
Which is the same time period as 3 Years, 1 Day, 2 Hours and 12 Minutes (3Y1D2h12m)
There is no need to sort the period elements in any order. Invalid period elements will be ignored, but the valid ones are still used.
The "Measurement Period" defines the time, which must be elapsed since the last metric entry.
Currently the import period is checked every 15 minutes. So a period shorter as 15 minutes makes no sense.
The period string is case-sensitive. So 12M is not the same as 12m.
Examples:
- 12M = 12 Months
- 12m = 12 Minutes
- 4D = 4 Days
- 4d = Invalid period element, will be ignored!
Fields for JQL based imports
