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 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.

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

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.

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.

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

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.

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.

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.

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.