Documentation for GreenHopper 5.6.x . Documentation for other versions of JIRA Agile is available too.
GreenHopper is now called JIRA Agile. Learn more.

Skip to end of metadata
Go to start of metadata

Statistics can help you track your management constraints such as hours, story points, etc. GreenHopper allows you to view burndown, burnup and value charts, as well as markers, for each field giving you a number of visual aids to assist your planning.

On this page:

Viewing Statistics

The right-hand side of your GreenHopper Planning, Chart and Released Boards contains a 'Statistics Column', which displays 'boxed' summaries of data that relate to the current board being viewed and the board's viewing mode.

  • On the Planning Board, each box relates to an individual Planning Board mode (that is, 'Project Overview', 'Version', 'Assignee' or 'Component' — see Using Planning Board Modes for more information).
  • On the Chart and Released Boards, each box relates to an individual version (see Using the Chart Board and Using the Released Board for more information).

Custom statistics are displayed at the bottom of each box. Custom statistics are number fields that have been configured as custom statistics for the project by the project administrator. For example, if you want to record story points against each issue, you would configure a custom statistic called 'Story Points'. Users can then add 'Story Points' as a marker on their Planning Board (see Using Statistical Markers to Group Issues).

(info) If you are using the 'Scrum' template, custom statistics called Story Points and Business Value will be created for you automatically.

Using the Statistics Column

To select box, click inside it and once selected, the box turns yellow. The content on the rest of the Board you are viewing will be updated to show the data associated with that box.

Gliffy Zoom Zoom
  1. 'Add' (Planning Board in 'Version' mode and Chart Board only. Visible to administrators only.) — Click to create a new version. Read more in Adding a Version.
  2. 'Statistics' (Planning Board in 'Version' mode and Chart Board only. Visible to administrators only.) — Click to configure statistics displayed in the boxes in this column. Read more in Configuring a Custom Statistic.
  3. 'Collapse' — Click the icon to show only the title of each box in the Statistics column.
  4. 'Expand' — Click the icon to show the full details for each box in the Statistics column.
  5. 'Hide' — Click the icon to hide the Statistics column and display the 'Issues' section of the Board in full screen width.
  6. Name ('Version', 'Assignee', 'Component', 'Project Overview' modes only. Visible to administrators only.) — Click the icon (which will appear when you hover this area of the selected box) to edit the project, version or component name.
  7. Actions menu — Click the icon (which will appear at the top right of the selected box when you hover over this area) to display a drop-down menu. This drop-down menu can contain the following items. Be aware that some of these are not available on certain GreenHopper Boards:
    • 'Toggle visibility' — Click to show/hide the current box in the Statistics column.
    • 'Issue Navigator' — Click to go to the Issue Navigator.
    • 'Go to Task Board' ('Version' mode only) — Click to go to the Task Board.
    • 'Go to Planning Board' ('Version' mode only) — Click to go to the Planning Board.
    • 'Go to Chart Board' ('Version' mode only) — Click to go to the Chart Board.
    • 'Non Working Days' ('Version' mode only. Visible to administrators only.) — Click to edit the Non Working Days for a specific version. (Note: to edit the Non Working Days for the whole of GreenHopper, see Specifying your General Configuration.)
    • 'Print Cards' (Planning Board in 'Version' mode only) — Click to print the displayed issues. For details please see Printing Issues in Card Form.
    • 'Print Chart' (Chart and Released Boards only) — Click to print the currently viewed chart.
    • 'Excel (Chart Data)' ('Hour Burndown Chart' on the Chart Board only) — Click to download a csv version of the chart's data.
      (info) You may need to refresh the contents of the chart board first in order to see this menu option.
    • 'Release' ('Version' mode only. Visible to administrators only.) — Click to release the version. A snapshot of all of the charts associated with this version will also be captured (before any issues are swapped). You will be able to access these snapshots via your Released Board.
      (info) If the version contains unfinished issues, you will be prompted to either ignore them and proceed with the release, or move the unfinished issues to another version of your choice.
    • 'Recompute' (Released Board only; 'Project Overview' mode only. Visible to administrators only.) — Click to refresh the Released Board. (Note: the Project Overview is the only chart that is stored statically; all other charts are generated dynamically.)
    • 'Create Wallboard' (Planning Board only; 'Project Overview' mode only) — Click to create a Wallboard.
      1. A wallboard will be created with the name '<Project name> (autogenerated)' and displayed. Your wallboard is a new page on your JIRA dashboard, and will contain:
      2. Select 'View as Wallboard' from the 'Tools' drop-down on your JIRA dashboard, and stare in awe at your fresh new wallboard. For optimal use of screen real-estate, enter full-screen mode on your browser (F11 in Firefox 3.6 and Chrome 5; Safari requires a plugin to enable full-screen mode) and refresh. Wallboards are optimised for 1920x1080 and 1920x1200 screens, but should work in some other resolution modes.
  8. Progress of the version ('Version' mode only) — the green bar indicates the percentage of issues that are complete, the yellow bar indicates the percentage of issues in progress, the red bar indicates the percentage of issues that have not been started. Hover over the bar to see the exact percentages. Click on a coloured section of the bar to be taken to the Issue Navigator for the full list of issues in that colour.
  9. 'Parent' ('Version' & 'Component' modes only) — Click the icon (which will appear when you hover, if you are an administrator) to choose the parent version or component for the version. All issues under the version/component will also be a subset of the parent version/component, e.g. 'Version 1' could be set as the parent version of 'Version 1 milestone 1'. Read more in Setting up a Component Hierarchy and Setting up a Version Hierarchy.
  10. 'Start date' ('Version' mode only) — Click the icon (which will appear when you hover, if you are an administrator) to edit the start date for the version.
  11. 'End date' ('Version' mode only) — Click the icon (which will appear when you hover, if you are an administrator) to edit the end date for the version.
    (tick) Tip: The start date and end date are used to compute the various charts in GreenHopper.
  12. 'Release date' ('Version' mode only) — Click the icon (which will appear when you hover, if you are an administrator) to edit the JIRA release date for the version.
  13. Issue Type statistics — A summary of the number of issues of each type.
  14. Statistics based on the Task Board mapping — A summary of the number of issues in each status (based on the Mappings that your administrator has specified in the Task Board Settings).
  15. Time-tracking statistics — Only displayed if JIRA time tracking is enabled.
    • 'Time Remaining' — Click the icon (which will appear when you hover, if you are an administrator) to specify maximum and minimum limits for the amount of time remaining.
  16. Custom statistics — Displayed if any custom statistics have been created by the project administrator. (The red numbers, if shown, indicate that a statistic's constraint has been exceeded.) If custom statistics exist, you can click the icon to add them as markers on your Planning Board (see Using Statistical Markers to Group Issues).

(tick) Tip: Boxes that relate to child versions or components are attached below their parent version or component and are represented with a right-indented arrow, as shown by the 'Hardening Sprint' example in the screenshot above.

Configuring a Custom Statistic

To add a custom statistic for your project,

  1. Log into JIRA.
  2. Click the 'Agile' link's down arrow in the top navigation bar and select either the 'Planning Board' or 'Chart Board' from the resulting dropdown menu to view that board.
    (info) If you selected the Planning Board, ensure that your viewing mode is set to 'Version' before proceeding.
  3. Click the 'Statistics' button at the top of the Statistics Column. The 'Statistics' window will open, listing the statistics currently displayed on your board (see screenshot below).
  4. Click the 'Add a Number Field to your Project' link. A new add field page will be displayed.
  5. Fill out the fields (accept all field defaults and select whether you want the custom field to apply to a specific project or globally). See the JIRA documentation on Adding a Custom Field for detailed instructions. Make sure you add the custom field to at least one screen.
    (info) Please note: your field must be associated with the 'Number Searcher' Search Template in order to work properly.
  6. Your custom field will be added to the project and be shown in each item's boxes on the right-hand column of your board (see the 'Viewing Statistics' section above). Your custom field will also be available on your issues screens for you to populate (depending on what screens you selected at field creation).

To configure a custom statistic for your project,

  1. Log into JIRA.
  2. Click the 'Agile' link's down arrow in the top navigation bar and select either the 'Planning Board' or 'Chart Board' from the resulting dropdown menu to view that board.
    (info) If you selected the Planning Board, ensure that your viewing mode is set to 'Version' before proceeding.
  3. Click the 'Statistics' button at the top of the Statistics Column. The 'Statistics' window will open, listing the statistics currently displayed on your board (see screenshot below).
    • To configure the 'Capacity' of a custom statistic:
      1. Click the 'Edit' link next to the custom statistic that you want to configure.
      2. Update the 'Min' and 'Max' values for the statistic, as desired. For example, you may wish to set a minimum and maximum value on the 'Time remaining' statistic to help you track time against your versions. The 'Min' and 'Max' values for the statistic will be applied to all versions.
        (info) You can override the 'Min' and 'Max' values for specific versions by clicking the next to the relevant statistic field in the right-hand column of your board.
      3. Click the 'Update' link to save your changes.
    • Choose whether to hide or show a Marker for the statistic on your board:
      • To show a Marker for a custom statistic, select the check box in the 'Markers' column
      • To hide a Marker for a custom statistic, deselect the check box in the 'Markers' column
        (info) This is useful if you do not want to display a marker for a particular statistic on your Planning Board, but want to retain the settings in case you wish to track the statistic via your Chart Board.

To remove a custom statistic from your project,

  1. Log into JIRA.
  2. Click the 'Agile' link's down arrow in the top navigation bar and select either the 'Planning Board' or 'Chart Board' from the resulting dropdown menu to view that board.
    (info) If you selected the Planning Board, ensure that your viewing mode is set to 'Version' before proceeding.
  3. Click the 'Statistics' button at the top of the Statistics Column. The 'Statistics' window will open, listing the statistics currently displayed on your board (see screenshot below).
  4. Click the 'Remove' link corresponding to the statistic you wish to remove.
    (info) Note that the built-in statistics 'Standard issue count' and 'Time remaining' cannot be removed.
  5. Your chosen statistic will be removed from your board. Note that the statistic will still exist as a JIRA custom field.

(tick) Tip: Note that you can 'hide' statistics rather than removing them — see 'Markers' (above).

Screenshot: Configuring Statistics