JIRA
Install
Admin
Use
Search JIRA documentation:

Charting Portlets

PDF
PDF

Overview

The Charting portlets display visual representations of a project or a saved filter, in a variety of contexts. In general, charts are:

  • run over any saved filter or project.
  • for a period of X days previous to the current date.
  • broken down into incremental periods of hours, days, weeks, months, quarters or years.
  • hyperlinked to relevant issues in the Issue Navigator.
  • linked to a relevant report showing a larger chart, as well as a detailed data table.

What do they look like?

The Created vs Resolved Issues portlet should appear as follows on the dashboard:

Charting Portlet on Dashboard

This is just one of the available charting portlets, which include:

  • Recently Created Issues — a bar chart showing the issues recently created.
    • The green portion of the bar shows the created issues which are resolved, the red portion shows created but as yet unresolved issues.
    • This visually shows both how quickly you're creating issues, as well as how many of those created issues are resolved.
  • Created vs Resolved Issues — a difference chart showing the issues created vs resolved over a given period.
    • This chart can either be cumulative or not.
    • Areas in red show periods where more issues were created than resolved, areas in green show periods where more were resolved than created.
    • Versions can also be added to this chart, showing you how issue creation & resolution related to releases
  • Resolution Time — a bar chart showing the average resolution time (in days) of resolved issues.
    • This is useful to show you over time whether your team is getting better or worse at resolving issues in a timely fashion.
  • Average-Age Open Issues — a bar chart showing the average number of days that issues have been unresolved
    • This chart displays the average of how long issues remain open on a specified interval (e.g. daily, weekly, etc.)
  • Pie Chart — display issues from a project or filter grouped by a statistic type in pie-chart format
    • The issues can be grouped by any statistic type (e.g. Status, Priority, etc.)
  • Average Time in Status — displays the average number of days issues have spent in a status.
  • Average Number of Times in Status — displays the average number of times an issues has been in a status.
Note
The Charting portlets will only be available to add to your dashboard if your JIRA administrator has installed the Charting plugin.

Adding Portlets to Dashboard

To add a Charting portlet to your dashboard:

  1. Navigate to the dashboard configuration page.
  2. Select one of the Charting portlets as listed above.
  3. Click the Add button.
  4. The 'Edit Portlet' screen will be displayed. Select the relevant project or saved filter, and specify any other information required for the chart. For example, the Created vs Resolved Issues chart requires the following information:

    Configuring the Charting Portlet
  5. Click the Save button.
  6. The portlet can be positioned on the dashboard through the dashboard configuration page.
Note
You can also save any search results from the Issue Navigator as a dashboard portlet.

Further information on all JIRA portlets is available here.

Configuring your Internet Explorer cache settings

For Internet Explorer users, you will also need to configure your browser to be able to print pages with charts correctly:

  1. Select 'Internet Options' from the 'Tools' menu:

    Internet Explorer Tools Menu
  2. The 'Internet Options' window will display. Click the 'Settings' button in the 'Temporary Internet files' (i.e. cache) section:

    Internet Explorer Internet Options
  3. The 'Settings' window will display. Ensure that you have do not have the 'Every visit to the page' (i.e. no caching) option selected. If so, select the 'Automatically' option instead.

    Internet Explorer Cache Settings
Note
The Charting portlet only keeps rendered images on the server long enough to send the immediate response for display. If Internet Explorer is setup to check for newer versions of stored pages on every visit to the page, the portlet will unsuccessfully attempt to re-request the image upon printing. Hence, the Print or Print Preview functions in Internet Explorer will not display the chart.