Cubes





This section describes the functionality provided in the analytics cubes.




1. Jira Core Cube.

The JIRA Core cube works on a JQL and is launched from the issue navigator. All the calculations made will refer to the JQL issues.


JQL is required

JQL is required to load the JIRA Core cube.



The JIRA Core cube works separately with the issues, and extracts information from them without taking into account hierarchies.

For example, the versions of a given issue will be those that appear only in the issue. Possible versions that appear in your subtasks will not be counted as versions of the issue.




1.1. Dimensions/Attributes.

The JIRA Core cube provides 8 basic dimensions to extract information from issues. In addition to these dimensions, a new dimension will be added for each customfield that you want to include in the cube.


1.1.1. Basic Dimenions.



Dimension
IssueCorresponds to the JQL issues.
Attributes
Issue KeyKey + Summary of the issue.
AssigneeIssue assigned.
ReporterIssue creator.
EstimatedIssue estimated. Amount of time you believe is required to solve the issue.
RemainingIssue remaining. Amount of time you believe is required to solve the issue in its current state.
ProjectProject to which the issue belongs.
TypeIssue type.
Status CategoryStatus category of the issue.
StatusIssue status.
PriorityIssue priority.
ResolutionIssue resolution.
Time CreatedCreate date of the issue.The date is separated in year, quarter, month, and day.
Time UpdatedUpdate date of the issue.The date is separated in year, quarter, month, and day.
Time DueDue date of the issue.The date is separated in year, quarter, month, and day.
Time ResolvedResolution date of the issue.The date is separated in year, quarter, month, and day.



Dimension
VersionCorresponds to the versions that appear in the JQL issues. If a version does not have issues, it will not appear in the queries.
Attributes
Name VersionName of the vesion.
Type VersionIndicates whether a version appears in an issue such as 'Affects Version/s' or 'Fix Version/s'
Archived VersionIf the version has been archived or not.
Released VersionIf the version has been released or not.
Time StartStart date of the version.The date is separated in year, quarter, month, and day.
Time ReleaseRelease date of the version.The date is separated in year, quarter, month, and day.



Dimension
WorklogCorresponds to the worklogs of the JQL issues.
Attributes
LoggerAuthor of the worklog.
Time CreatedCreate date of the worklog.The date is separated in year, quarter, month, and day.
Time StartDate when you started the unit of work.The date is separated in year, quarter, month, and day.



Dimension
LabelCorresponds to the labels that appear in the JQL issues.
Attributes
LabelLabel name.



Dimension
ComponentCorresponds to the components that appear in the JQL issues.
Attributes
Component NameComponent name.
Component LeadResponsible/leader of the component.



Dimension
TransitionsCorresponds to the transitions of the JQL issues.
Attributes
Status - FromState "from" of the transition.
Status - ToState "to" of the transition.
Performed byAuthor of the transition.
Time TransitionDate on which the transition was made.The date is separated in year, quarter, month, and day.





Dimension
LinksCorresponds to the linked issues of the JQL issues.
Attributes
Linked Issue KeyKey + summary of the issues linked to JQL issues.
Link TypeType of link.




Dimension
Commentscorresponds to the comments of the JQL issues.
Attributes
AuthorAuthor of the comment.
UpdaterLast user who updated the comment.
Time CreatedCreate date of the comment.The date is separated in year, quarter, month, day, hour and minute.
Time UpdatedLast update date of the comment.The date is separated in year, quarter, month, day, hour and minute.






1.1.2. Custom Field Dimensions.

Users can add custom fields to the JIRA Core cube to extract information about them. These custom fields will be added as dimensions in the cube.

The name of the new dimension will be:

<custom field identifier> - <custom field name>

This nomenclature gives the possibility to include custom fields that have the same name.


The types of custom fields allowed are:


Number Field
Attributes
<Custom Field Name>Value of the custom.




Select List (Cascading)
Attributes
<Custom Field Name> OptionCustom field select option.
<Custom Field Name> SubOptionSuboption within the custom field option.



Date Picker
Attributes
<Custom Field Name>Date included in the custom field.The date is seperated in year, quarter, month and day.



Date Time Picker
Attributes
<Custom Field Name>Date and time included in the custom field.The date is separated in year, quarter, month, day, hour and minute.



Labels
Attributes
<Custom Field Name>Custom field labels.



Project Picker (single project)
Attributes
<Custom Field Name>Project of the custom field.



User Picker (single user)
Attributes
<Custom Field Name>User of the custom field.



User Picker (multiple users)
Attributes
<Custom Field Name>Users of the custom field.



Group Picker (single group)
Attributes
<Custom Field Name>Group of the custom field.



Group Picker (multiple groups)
Attributes
<Custom Field Name>Groups of the custom field.



Version Picker (single version)
Attributes
<Custom Field Name>Version of the custom field.
Archived VersionIf the version has been archived or not.
Released VersionIf the version has been released or not.
Time ReleaseRelease date of the version.
Time StartStart date of the version.



Version Picker (multiple versions)
Attributes
<Custom Field Name>Versions of the custom field.
Archived VersionIf the version has been archived or not.
Released VersionIf the version has been released or not.
Time ReleaseRelease date of the version.
Time StartStart date of the version.



1.2. Measures.


MEASURES
Count IssuesCount issues.
Sum Estimated TimeSum the estimated time.
Sum Remaining TimeSum the remaining time.
Count Different VersionsCount versions without repetition.

Differences between the metrics:


Count Total VersionsCount versions with repetition.
Count WorklogsCount worklogs.
Sum Time SpentSum worklog time.
Count Different LabelsCount labels without repetition.

Differences between the metrics:


Count Total LabelsCount labels with repetition.
Count Different ComponentsCount components without repetition.

Differences between the metrics:

Count Total ComponentsCount components with repetition.
Count TransitionsCount transitions.
Sum Time in Status FromSum time in a status.
Count Num. LinksCount links.

Differences between the metrics:

Count Linked IssuesCount the linked issues.
Count Link TypesCount types of links.
Count CommentsCount comments.



MEASURES FOR CUSTOM FIELD NUMBER
{Min Custom Field Number}Minimum value of the numerical custom field.
{Max Custom Field Number}Maximum value of the numerical custom field.
{Sum Custom Field Number}Sum value of the numerical custom field.
{Avg Custom Field Number}Average value of the numerical custom field.



1.3. Dimensions/Measures matrix.

The matrix specifies the dimensions on which a metric can be applied.



DIMENSIONS

CommentsComponentIssueLabelLinksTransitionsVersionWorklog{Custom Field X}











Measures




















Count Issues

Sum Estimated Time
Sum Remaining Time
Count Different Versions
Count Total Versions
Count Worklogs
Sum Time Spent
Count Different Labels
Count Total Labels
Count Different Components
Count Total Components
Count Transitions
Sum Time in Status From
Count Num. Links
Count Linked Issues
Count Link Types
Count Comments
{Min Custom Field Number}
{Max Custom Field Number}
{Sum Custom Field Number}
{Avg Custom Field Number}





2. Jira Software Cube.

The JIRA Software cube works on a board (Kanban or Scrum) and is launched from a board.  All calculations made will refer to the board issues.


There are three basic dimensions that constitute a hierarchy: Epic --> Issues --> Subtask. 


Hierarchy
Epic

Epics of the board.Issue type Epic.

 

Issue
Issues included in the epicStandard issue types, except epic type.

   
SubtaskSubtasks of the issues included in the epicsSubtask issue types.


Any calculation on one of these dimensions will include the data of its descendants in the hierarchy.


For example, the versions of an epic will be:

  1. The versions of the epic itself.
  2. Plus the versions of the issues included in the epic.
  3. Plus the versions of the subtasks of the issues included in the epic.



Data in Jira:

Analytics:



Other example, the estimated time of an issue will be:

  1. The time of the issue.
  2. Plus the estimated times of the subtasks of the issue.


Data in JIRA:

Analytics:



2.1. Dimensions/Attributes.

The JIRA Core cube provides 8 basic dimensions to extract information from issues. In addition to these dimensions, a new dimension will be added for each customfield that you want to include in the cube.


2.1.1. Basic Dimensions.

Dimension
EpicsCorresponds to the epics of the board.
Attributes
Epic KeyKey + Summary of the epic.
Epic ProjectProject to which the epic belongs.
Epic AssigneeEpic assigned.
Epic ReporterEpic creator.
Epic EstimatedEpic estimated. Amount of time you believe is required to solve the epic.
Epic RemainingEpic remaining. Amount of time you believe is required to solve the epic in its current state.
Epic Status CategoryStatus category of the epic.
Epic StatusEpic status.
Epic PriorityEpic priority.
Epic ResolutionEpic resolution.
Epic CreatedCreate date of the epic.The date is separated in year, quarter, month, and day.
Epic UpdatedUpdate date of the epic.The date is separated in year, quarter, month, and day.
Epic DueDue date of the epic.The date is separated in year, quarter, month, and day.
Epic ResolvedResolution date of the epic.The date is separated in year, quarter, month, and day.



Dimension
IssuesCorresponds to the issues of the board. All board issues, except epics and subtasks.
Attributes
Issue KeyKey + Summary of the issue.
In BacklogIf the issue is in the backlog.
Issue AssigneeIssue assigned.
Issue ReporterIssue creator.
Issue EstimatedIssue estimated. Amount of time you believe is required to solve the issue.
Issue RemainingIssue remaining. Amount of time you believe is required to solve the issue in its current state.
Issue ProjectProject to which the issue belongs.
Issue TypeIssue type.
Issue Status CategoryStatus category of the issue.
Issue StatusIssue status.
Issue PriorityIssue priority.
Issue ResolutionIssue resolution.
Issue Time CreatedCreate date of the issue.The date is separated in year, quarter, month, and day.
Issue Time UpdatedUpdate date of the issue.The date is separated in year, quarter, month, and day.
Issue Time DueDue date of the issue.The date is separated in year, quarter, month, and day.
Issue Time ResolvedResolution date of the issue.The date is separated in year, quarter, month, and day.



Dimension
SubtasksCorresponds to the subtasks of the board issues.
Attributes
Subtask KeyKey + Summary of the subtask.
In BacklogIf the subtask is in the backlog.
Subtask AssigneeSubtask assigned.
Subtask ReporterSubtask creator.
Subtask EstimatedSubtask estimated. Amount of time you believe is required to solve the subtask.
Subtask RemainingSubtask remaining. Amount of time you believe is required to solve the subtask in its current state.
Subtask ProjectProject to which the subtask belongs.
Subtask TypeSubtask  type.
Subtask Status CategoryStatus category of the subtask.
Subtask StatusSubtask status.
Subtask PrioritySubtask  priority.
Subtask ResolutionSubtask resolution.
Subtask Time CreatedCreate date of the subtask.The date is separated in year, quarter, month, and day.
Subtask Time UpdatedUpdate date of the subtask.The date is separated in year, quarter, month, and day.
Subtask Time DueDue date of the subtask.The date is separated in year, quarter, month, and day.
Subtask Time ResolvedResolution date of the subtask.The date is separated in year, quarter, month, and day.



Dimension
VersionsCorresponds to the versions that appear in the board issues. If a version does not have issues, it will not appear in the queries.
Attributes
Name VersionName of the vesion.
Type VersionIndicates whether a version appears in an issue such as 'Affects Version/s' or 'Fix Version/s'
Project VersionProject of the version.
Archived VersionIf the version has been archived or not.
Released VersionIf the version has been released or not.
Time Start VersionStart date of the version.The date is separated in year, quarter, month, and day.
Time Release VersionRelease date of the version.The date is separated in year, quarter, month, and day.



Dimension
SprintsCorresponds to the board sprints.
Attributes
Sprint NameName of the sprint.
Sprint StateState of the sprint (Active, Closed, Future)
Time Start SprintStart date of the sprint.The date is separated in year, quarter, month, day, hour and minute.
Time Complete SprintComplete date of the sprint.The date is separated in year, quarter, month, day, hour and minute.
Time End SprintEnd date of the sprint.The date is separated in year, quarter, month, day, hour and minute.



Dimension
Story PointsCorresponds to the story points of the Histories.
Attributes
Story Point ValueValue of the story point. As in JIRA Software, the history points of the epics will not be taken into account for the calculations.



Dimension
Epic StatusCorresponds to the state of the epic. In JIRA, it is presented in a custom field.
Attributes
Epic Status ValueCurrent state of the epic (To Do, In Progress, Done).



Dimension
WorklogsCorresponds to the worklogs of the board issues.
Attributes
LoggerAuthor of the worklog.
Time CreatedCreate date of the worklog.The date is separated in year, quarter, month, and day.
Time StartDate when you started the unit of work.The date is separated in year, quarter, month, and day.



Dimension
TransitionsCorresponds to the transitions of the board issues.
Attributes
Status - FromState "from" of the transition.
Status - ToState "to" of the transition.
Performed byAuthor of the transition.
Time TransitionDate on which the transition was made.The date is separated in year, quarter, month, and day.



Dimension
LinksCorresponds to the linked issues of the board issues.
Attributes
Linked IssueKey + summary of the issues linked to board issues.
Link TypeType of link.



Dimension
LabelsCorresponds to the labels that appear in the board issues.
Attributes
LabelLabel name.



Dimension
ComponentsCorresponds to the components that appear in the board issues.
Attributes
Component NameComponent name.
Component LeadResponsible/leader of the component.



Dimension
Commentscorresponds to the comments of the board issues.
Attributes
AuthorAuthor of the comment.
UpdaterLast user who updated the comment.
Time CreatedCreate date of the comment.The date is separated in year, quarter, month, day, hour and minute.
Time UpdatedLast update date of the comment.The date is separated in year, quarter, month, day, hour and minute.



2.2.2. Custom Field Dimensions.

The custom fields dimensions work the same as for the JIRA Core cube. Users can add custom fields to the JIRA Core cube to extract information about them.

(View 1.1.2. Custom Field Dimensions)


2.2. Measures.

The JIRA Software cube uses the same metrics as the JIRA Core cube.

(View 1.2. Measures)


In addition, the JIRA Software cube adds some new metrics:


MEASURES
Count EpicsCount epics.
Count SubtaskCount subtask.
Count SprintsCount sprints.
Min Story PointsMinimum value of history points.
Max Story PointsMaximum value of history points.
Sum Story PointsSum value of history points.
Avg Story PointsAverage value of history points.



2.3. Dimensions/Measures matrix.

The matrix specifies the dimensions on which a metric can be applied.



DIMENSIONS
EpicsIssuesSubtaksVersionsSprintsStory PointsEpic StatusWorklogsTransitionsLinksLabelsComponentsComments{Custom Field X}





















Measures

Count Epics
Count Issues
Count Subtask
Sum Estimated Time
Sum Remaining Time
Count Sprints
Count Different Versions
Count Total Versions
Count Worklogs
Sum Time Spent
Count Transitions
Sum Time in Status From
Min Story Points
Max Story Points
Sum Story Points
Avg Stroy Points
Count Num. Links
Count Linked Issues
Count Link Types
Count Different Labels
Count Total Labels
Count Different Components
Count Total Components
Count Comments
{Min Custom Field Number}
{Max Custom Field Number}
{Sum Custom Field Number}
{Avg Custom Field Number}



3. Custom Metrics.

You can create your own metrics through the integrated MDX editor. In this way you can adapt Analytics to your needs.



3.1. Calculating Percentages.

You can easily calculate the percentages of your metrics through the integrated MDX editor.

For example, if you wanted to know the percentage of story points resolved for each epic.

1. Calculate the story points of each epic.

2. Add an calculated percentage metric.

3. The calculated metric will be added to the available metrics.



4. References

[1] Saiku Documentation

[2] Analysis Services Language Reference

[3] Saiku Chart Plus

[4] ISO 3166-2