DevOps data import

eazyBI for Jira

DevOps source data

eazyBI imports DevOps data related to imported issues and projects. Select issue types [1] associated with Incidents that should be used for pre-defined DevOps calculations. Other issue types will be considered as Change issues in the pre-defined DevOps calculations.

You can import only the most recent DevOps data to reduce import time and DevOps data imported into the cube. You can set an imported data limit [2] for DevOps data in two ways- relative time, like 3 months , or a specific date, like Oct 22 2023 , to set a date range from that date until now. 

You can set a limit to all eazyBI accounts through Advanced settings. When both the account-specific and global limits are used, the limit with the most recent date will be used.

[jira.devops]
data_limit = "2 years"

Lastly, select the needed DevOps integrations [3] and specify the credentials for each.

Bitbucket and Bamboo for Jira Data Center

In case there are several Bitbucket or Bamboo application links in your Jira instance, you can choose from which server you wish to import the data to eazyBI. Bitbucket and Bamboo project names that match Jira project names will be offered for import automatically. If the names differ, you can search the Bitbucket [1] and Bamboo projects [2] with issue links to projects imported in this eazyBI account. 

Bitbucket and Bamboo are closely integrated with Jira. We can detect and import PRs and builds that are related to Jira issues. 

The DevOps data are imported incrementally, and only the new data will be processed with each import. 

Bitbucket Cloud

Data import in Cloud:

No additional setup is required before authorization.

Data import in Data Center (available since eazyBI version 7.2.0):

To import Bitbucket Cloud data in eazyBI for Jira Data Center, you'll need to set up an OAuth app:

In Bitbucket Cloud, go to Settings -> Workspace settings -> OAuth consumers -> Add consumer
Callback URL:
<JIRA_BASE_URL>/plugins/servlet/eazybi/source_applications/auth/jira/devops/callback
Set Read permission for the following items: Account, Workspace membership, Projects, Pull requests, and Pipelines.

After the OAuth app is created, add the following parameters to your eazyBI Advanced settings:

[jira.devops.bitbucket_cloud]
client_id = '...'
client_secret = '...'

Authorization and data selection

Next, authorize Bitbucket Cloud to allow eazyBI to access the data. eazyBI will show a user [1] who authenticated the source and use this authentication for data import. You can reset authorization when it is needed.

Specify which Bitbucket Cloud projects [2] eazyBI should import into the account. 

eazyBI imports data from builds and pull requests containing the issue key in the branch name, pull request title, or commit message to match imported Jira data. You can also enable additional search for issue keys [3] in pull request descriptions.

Jenkins

Data import in Cloud

To import Jenkins data into eazyBI for Jira Cloud, add these parameters to your eazyBI advanced settings:

[jira.devops.jenkins]
enable = true

Data import in Data Center

The integration will be available automatically.

Authorization and data selection

Once the Jenkins data import is enabled, you can select Jenkins data import in the account. For data import from Jenkins, specify the connection to Jenkins [1]: Jenkins URL, Jenkins username, and API token or password. Then select specific Jenkins Builds [2] and/or Jenkins Projects [3] with references to imported Jira issues. 

eazyBI imports data from builds containing pull requests using issue keys from the pull request name or commit messages to match imported Jira data.

GitHub

Data import in Cloud

No additional setup is required before authorization.

Data import in Data Center (available since eazyBI version 7.2.0)

To import GitHub data in eazyBI for Jira Data Center, you'll need to set up an OAuth app:

In GitHub, go to Settings -> Developer settings -> OAuth Apps -> New OAuth app
Homepage URL:
<JIRA_BASE_URL>

Authorization callback URL: 
<JIRA_BASE_URL>/plugins/servlet/eazybi/source_applications/auth/jira/devops/callback

After the OAuth app is created, add the following parameters to your eazyBI Advanced settings:

[jira.devops.github]
client_id = '...'
client_secret = '...'

Authorization and data selection

Authorize GitHub to allow eazyBI to access the data. While the authorization screen may indicate that eazyBI has both read and write access rights, eazyBI will only read the data.

eazyBI will show the user [1] who authenticated the source and used this authentication for data import. You can reset authorization when needed. Specify the GitHub repositories [2] that eazyBI should read from and import data into the account.

By default, eazyBI imports data from builds and pull requests containing the issue key in the branch name or pull request title. You can also enable additional search for issue keys [3] in pull request descriptions or commit messages. Note that these additional selections may slow down the DevOps data import process and may exceed GitHub REST API limits.

Measures

Issue level metrics will link to issues with the issue key specified in Pull Requests, Commit messages, and related to Builds/Deployments.

Min and Max values display on the issue level by finding the pull requests and builds of the issue. The average values show only on the Project level as one pull request can be related to several issues, and several issues can link to one pull request. On the Project level, the average calculation finds the total time as described for each measure and divides it by total pull requests per project.

Properties

On Jira Cloud and starting from eazyBI version 7.1, additional predefined properties are available.

Dimensions

The following DevOps data related dimensions are available on Jira Cloud and starting from eazyBI version 7.1 on Jira Data Center.

On eazyBI versions 7.0 and older these dimensions are hidden from the UI; however, they can be used in calculations by referencing them.

eazyBI also creates new calculated members in the Issue Type dimension:

Sample reports and dashboard

If you have selected to Import sample reports, eazyBI will create several DevOps report examples in a new Samples DevOps folder. In this folder, you will find a collection of essential DevOps metric examples - from Build and Deployment frequency to Change lead time, Build failure rate, and Average time to recovery. eazyBI also organizes these sample reports in one Sample DevOps metrics dashboard.

The reports and dashboard give an overview of the DevOps processes in the top three DevOps projects. The metrics combine data from the already imported Jira Issue data (Incident and Change issue life cycle) with data from Bitbucket, GitHub, Bamboo, and Jenkins. 

Standard DevOps metrics require data on the full Issue life cycle. eazyBI will create measures and sample reports for imported data sets - Pull requests, and Builds. Some measures and reports require both data sets and will not be created if some data is missing. The DevOps dashboard will be created if there are data for the full request life cycle.

If you want to customize some reports, then save them with a different name (as eazyBI overwrites the default sample reports during each Jira import).