Connect to the Atlassian Data Lake

Atlassian’s analytics offering 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.

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

You can create up to 10 connections to the Data Lake. If possible, you may want to create a connection for each business function or team. Having customized connections helps to ensure people only access data that are relevant to them.

1. Start the connection process

To add a new Atlassian Data Lake connection:

From the Analytics navigation, select Data.
Select Add data source > Atlassian Data Lake.

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

2. Select your products

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

All your product data is available in the Atlassian Data Lake, so you should see all your organization’s products listed in this step. Each product you select will give you access to a set of tables and columns that you’ll use to query your product 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.

Remember, you can create more connections to the Atlassian Data Lake, so it may be better to only include some products rather than all of them.

3. Include or exclude user-generated content

For each product you selected in the previous step, select whether or not to exclude user-generated content (UGC) from the data accessible through this connection. Including UGC will add more columns to each product table.

You may want to exclude UGC if you believe it contains any sensitive information. If you include UGC, the people you share this connection with will be able to query all data you make accessible from it.

UGC is any type of data inputted by users.

Examples of UGC data in the Atlassian context include but are not limited to:

issue summaries
page titles
descriptions
attachments

Examples of non-UGC data include but are not limited to:

created dates
issue numbers
IDs

4. Acknowledge the difference in data permissions

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

After you make your UGC selections, read the acknowledgment statement, then select the checkbox. By selecting it, you acknowledge and understand the difference in data permissions between Atlassian’s analytics offering and other Atlassian products. Select Next to continue.

5. Name your data connection

The name you provide here will appear in the list of your connected data sources and wherever this connection is referenced throughout Atlassian’s analytics offering. 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.

6. 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. We also use this time to generate your starter dashboards if you’ve included UGC for any of your selected products.