Data Sources

Custom Charts has recently introduced the addition of Data Sources. For now, this functionality is limited to only Insight custom fields on Jira Cloud.

Data Sources will allow you to pull data into Custom Charts that is not stored directly on Jira issues. This will often require additional authentication and be restricted so you can limit which users can see the data.

Insight custom fields

Custom Charts now provides the ability to display Insight custom field values directly in Custom Charts. This will display the object names, rather than the ID, allowing users to more accurately report on Insight field data in Jira.

To display Insight custom fields in Custom Charts, you will need to provide a user email address and API token.

Once you have enabled the Insight custom field feature, you can complete the following steps:

1. Navigate to the Custom Charts - Settings page, and open the Data sources tab

   1. From the top navigation bar in Jira, choose Apps > Manage your apps

   2. Choose Custom Charts - Settings in the Custom Charts section of the Apps page

   3. From the Custom Charts - Settings page, choose Data sources

2. Expand the Insight custom fields panel

3. Provide the email address of the user whose permissions will be used to load the Insight custom fields

   1. Reminder: This user must have a valid Jira Service Management license. They do not require any additional Insight-specific permissions.

4. Provide the API token for this user

   1. Atlassian documentation on creating an API token: https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/

5. Test the connection

6. Select the groups that contain users who should be able to view Insight custom field data in Custom Charts

   1. Users who are not in these groups will simply see the Insight object ID instead of the object name while viewing charts

Open

Troubleshooting