• Products
  • Documentation
  • Resources

Connect to the Atlassian Data Lake

Atlassian Analytics gives you access to the Atlassian Data Lake. Now it’s easier than ever to pull your product data together into a single place, then visualize that data into insightful dashboards that help drive your business decisions. More about the Atlassian Data Lake.

You must be an organization admin to create connections to the Atlassian Data Lake.

You can create up to ten connections to the Data Lake. If possible, only create multiple connections if you need to restrict access to sensitive data. Consider best practices for creating Data Lake connections.

Start the connection process

First connection

If you’ve just added Atlassian Analytics to your organization, you’ll need to create the first Data Lake connection before you jump into Atlassian Analytics. The process starts right away, so go to the next section to learn more about the product selection step.

Haven’t added Atlassian Analytics yet? Learn how to add it to your organization.

Subsequent connections

If you’ve already created the first Data Lake connection, do the following to add a new Atlassian Data Lake connection:

  1. Select Data from the global navigation.

  2. Select Add data source > Atlassian Data Lake.

This begins the process for connecting to the Atlassian Data Lake.

Select your products

Only data for Jira, Jira Service Management, Jira Product Discovery, Jira Work Management, and Confluence are available in the Atlassian Data Lake at this time. Data for more products is coming soon.

All the data for your Cloud products data is available in the Atlassian Data Lake, so you should see all your organization’s products listed in this step, including products with non-Enterprise plans. Each product you select will give you access to a set of tables and columns that you’ll use to query your product data. More about the data model of the Data Lake.

Sandbox sites will appear in the product selection, but the data may not be immediately available to query. Contact support if you want to include sandbox site data.

The number of product instances you select affects how much data becomes accessible through this connection. Refine the amount of data even further by including or excluding specific projects from your selected product instances.

Keep in mind that site admins and product admins of selected products will get an email notifying them that the data is available through this connection.

Selecting Jira Product Discovery instance with 1 project

Select your scope of data

The scope of data refers to the types of data that will be accessible through this connection. This applies to all the products you selected in the previous step.

There are two scopes you can choose from:

  • All data

  • Limited data

Selected 'All data' for scope of data of this Atlassian Data Lake connection.

All data

When you select All data, you get access to everything available in the Data Lake:

  • Detailed content — This includes data you and your team provide in open text fields like issue summaries, descriptions, and labels.

  • User data — Access user IDs, public names, and email addresses for all accounts in your organization.

The people you share this connection with will be able to query all data you make accessible from it.

Depending on the products you select, Atlassian Analytics provides dashboard templates to give you an idea of how you can use your product data in Atlassian Analytics. Read about dashboard templates.

Limited data

If you believe your selected products contain sensitive data, select Limited data to reduce the scope of data to:

  • Only descriptive data — You’ll only have access to data like issue IDs, created dates, and project statuses.

  • Only user IDs — You won’t have access to public names and email addresses.

Selecting limited data also means you won’t get dashboard templates; you’ll need to build charts and dashboards from scratch.

Acknowledge the difference in data permissions

The data permissions you’ve set in other Atlassian products do not carry over to Atlassian Analytics. Learn more about data permissions for the Atlassian Data Lake.

After you select your scope of data, read the acknowledgment statement, then select the checkbox. By selecting it, you acknowledge and understand the difference in data permissions between Atlassian Analytics and other Atlassian products. Select Next to continue.

Checkbox selected to acknowledge data permissions for the Atlassian Data Lake.

Name your data connection

The display name you provide here will appear in the list of your connected data sources and wherever this connection is referenced throughout Atlassian Analytics. Give the connection a unique name—something that will make it easier to identify the type of data accessible from it.

You can edit this name later in this connection’s data source settings. Learn more about data source settings.

Create the connection

Select Create connection. There’s potentially a lot of data to pull in, so it may take a couple minutes for us to create your connection.

If you have any Atlassian products with a Cloud Enterprise plan, you can also connect third-party data sources then blend your Atlassian data with your third-party data for richer insights.

Add people to the connection

After your connection is created, you can optionally add people to it if you already know who needs to query its data or manage the connection going forward. Learn more about data source permissions.

If you want to add people to the connection later, you can always do so from its data source settings. Learn how to manage data source access.

Now you and anyone else with access to the connection can start creating dashboards with your Atlassian data.

Still need help?

The Atlassian Community is here for you.