Jira

Overview

Visualize and analyze Jira resources, including projects, issues, and workflows. Gain actionable insights into project status, issue trends, and team productivity. Monitor governance, track progress toward organizational objectives, and ensure project alignment with business goals. Facilitate better decision-making through real-time data and reporting capabilities.

Configurations

Configuration	Description
Blueprint Account Name	A human-readable name for your account that will be used to identify this account across the application.
Jira URL	The base URL of Kaleidoscope's Jira instance (i.e., https://foo.atlassian.net/).
User Name	Your Jira username associated with your Jira account.
Access Token	A Jira API access token. You can generate this in your Jira account under the API token section.
Jira Account ID	The unique ID associated with your Jira account. This can be found in your Jira account settings.(i.e. 601cc79df564b600716b81db)
Data Crawl Frequency	The frequency at which Kaleidoscope will crawl your Jira account for updates and changes.

Permissions

The Jira blueprint requires an API Token which you can create by clicking here. Please ensure that you use the "Create API token" option to create a simple token (not the scoped one) and give the API token a descriptive label.

When creating the API token, note that simple API tokens inherit your user permissions. Ensure your account has atleast one of the following permissions in the projects you want to monitor:

Required Permissions:

• BROWSE_PROJECTS

• ADMINISTER

Permission Details:

Permission	Why it's needed
BROWSE_PROJECTS	Access and read project information, issues, workflows, and basic project data
ADMINISTER	Full access to project configuration, advanced settings, and administrative functions

Important Notes:

• API tokens inherit the permissions of the user who created them

• The token works with Basic Authentication using your email address and the token

• Ensure your user account has appropriate permissions in all projects you want Kaleidoscope to access

For more details on the Jira permissions, you can refer to the following documentation:Jira Permissions Overview

Schema Model

Resources	Source Entity	Normalized Entity	Description
Jira Project	jira.Project	Project	A project in Jira.
Jira Account	jira.JiraAccount	Account	An account in Jira.
Jira Issue Link	jira.IssueLink	IssueLink	A link between issues in Jira.
Jira Watches	jira.Watches	Watches	A watch record for Jira issues.
Jira Board	jira.Board	Board	A board in Jira for managing tasks.
Jira Progress	jira.Progress	Progress	Progress tracking data in Jira.
Jira Issue	jira.Issue	Issue	An issue or ticket in Jira.
Jira Issue Fields	jira.IssueFields	IssueFields	Detailed fields of a Jira issue.
Jira User	jira.User	User	A user in the Jira platform.
Jira Permission	jira.Permission	Permission	Permissions assigned in Jira.
Jira Holder	jira.Holder	Holder	Entity that holds a specific role/permission.
Jira Role	jira.Role	Role	A role defined in Jira.
Jira Issue Type	jira.IssueType	IssueType	The type/category of an issue in Jira.
Jira Priority	jira.Priority	Priority	Priority level of a Jira issue.
Jira Subtasks	jira.Subtasks	Subtask	Subtasks associated with a Jira issue.
Jira Permission Scheme	jira.PermissionScheme	PermissionScheme	A scheme for managing Jira permissions.
Jira Avatar URLs	jira.AvatarUrls	AvatarUrls	URL links to avatars in Jira.
Jira Actor	jira.Actor	Actor	An actor (user or group) in Jira.
Jira Status Category	jira.StatusCategory	StatusCategory	A category representing issue statuses.
Jira Status	jira.Status	Status	The current status of a Jira issue.
Jira Resolution	jira.Resolution	Resolution	The resolution of a Jira issue.
Jira Issue Link Type	jira.IssueLinkType	IssueLinkType	Types of links between Jira issues.
Jira Actor User	jira.ActorUser	User	A specific user acting on an issue.
Jira ServiceDesk Created	jira.servicedesk.Created	Created	Record of ServiceDesk creation in Jira.
Jira ServiceDesk Customer	jira.servicedesk.Customer	Customer	A customer using Jira ServiceDesk.
Jira ServiceDesk	jira.servicedesk.JiraServiceDesk	ServiceDesk	A Jira ServiceDesk project.
Jira ServiceDesk Project	jira.servicedesk.ServiceDesk	ServiceDeskProject	A project under Jira ServiceDesk.
Jira ServiceDesk Org	jira.servicedesk.Organization	Organization	An organization in Jira ServiceDesk.
Jira ServiceDesk Queue	jira.servicedesk.Queue	Queue	A queue in Jira ServiceDesk.
Jira ServiceDesk Issue	jira.servicedesk.Issue	Issue	An issue under Jira ServiceDesk.
Jira ServiceDesk SLAs	jira.servicedesk.SLAs	SLA	Service Level Agreements in Jira.