Pendo Data Sync provides the ability to export Pendo data (excluding Pendo Feedback data) to your Microsoft Azure Storage account. This article describes how to set up Data Sync with Microsoft Azure Storage.
Prerequisites
- Data Sync is a paid feature. Contact your Pendo representative for access.
- You must be a subscription admin in Pendo to set up a cloud storage destination as part of this process.
- The user must have Write blob and Add blob content permissions in Azure.
Setup overview
Data Sync with Microsoft Azure Storage is set up in Pendo and configured in your Microsoft Azure environment. It involves the following steps:
- Create a client ID and a client secret for accessing the storage account.
- Create an Azure Storage account.
- Set up permissions.
- Create an Azure container inside the storage account.
- Choose a provider in Pendo.
- Configure your storage account destination in Pendo.
Step 1. Generate a client key
To authenticate with Azure, you must you must register Pendo as an application in your Microsoft Azure Storage account and create a client secret (key) for it. To generate this key, go to Azure Active Directory and then:
- Select App registrations under Manage in the left-side menu.
- Select + New registration at the top of the page to start the process of registering a new application.
- Complete the form and then select Register at the bottom to create an application. This takes you to the application's details page. If not, go back to App registrations under Manage in the left-side menu and open the application you just added.
- In the application details page, take note of the values for Application (client) ID and Directory (tenant) ID in the Essentials section. These IDs are needed for Pendo in Step 6 of this article.
- Select Certificates & secrets from the left-side menu in the application details page, open the Client secrets tab, and select + New client secret.
- Enter a description that summarizes its use for Pendo Data Sync, and choose an expiration policy that matches your internal policies.
- Select Add at the bottom of the form.
- Take note of the string in the Value column. This is the client secret needed for Pendo in Step 6 of this article. The value is only visible for a limited time.
Step 2. Create an Azure Storage account
Pendo data is copied to an Azure Storage account as blobs. To create an Azure storage account, go to Storage accounts in Microsoft Azure and then:
- Select + Create from the top left of the page.
- Starting in the Basics tab, follow the workflow to configure the appropriate settings for your storage account.
- Select Review and then Create at the bottom of the form.
Step 3. Set up permissions
In the storage account that you created in Step 2:
- Select Access Control (IAM) from the left-side menu.
- Select + Add and then Add role assignment.
- In the Role tab, search for and select Storage Blob Data Contributor.
- Open the Members tab.
- Next to Assign access to, select User, group, or service principal.
- Select + Select members and search for the client.
You can check your setup in the Role assignments tab.
Step 4. Create an Azure container
In the storage account that you created in Step 2:
- Select Containers under Data storage in the left-side menu.
- Select + Container from the top right of the page.
- Create a meaningful name for the container.
- Select an anonymity access level from the dropdown menu: Private, Blob, or Container.
- Select Create at the bottom of the form.
Step 5. Choose a provider in Pendo
Before you can send data to your storage bucket, you must set a target destination in Pendo.
-
In Pendo, go to Settings > Data Sync.
- Select Connect to destination.
- Hover over the Microsoft Azure Storage tile in the panel that slides out on the right.
- Select Choose destination. The panel then summarizes the next steps for you.
Step 6. Configure your storage account destination in Pendo
The final step is to configure your Microsoft Azure Storage destination in Pendo.
- Enter the name for the storage account that you created in Step 2.
- Enter the name of the container in that storage account that you created in Step 4.
- Optionally, enter the storage path (subdirectory). If the main directory, the container, is sufficient as a location for exporting your files, leave this field blank.
- Enter the tenant and client IDs that you took note of in Step 1.
- Enter the secret (client key) created in Step 1.
- Select Validate destination to test the credentials you entered.
- When successfully validated, select Create destination.
Rotating your credentials
There are two ways to update your credentials after you've configured a destination in Pendo:
- Manually rotate credentials through the Pendo UI.
- Automatically rotate your credentials through the public API.
To use the public API endpoint for rotating Data Sync credentials, you must have an integration key with write access.
Through the Pendo UI
- In Pendo, go to Settings > Data Sync.
- Select Manage destination in the top-right corner of the page.
- Provide new credentials.
Through the public API
- Generate a new Pendo integration key using the instructions outlined in the Pendo integration key article.
- In our public API documentation, go to Data Sync.
- Choose the
PUT
endpoint that corresponds to your cloud storage destination. - Follow the instructions on how to use the public API endpoint to rotate your cloud storage credentials.
Updating your cloud storage destination
You have the option to move your cloud storage destination from one Azure container to another, or to change your cloud storage service to another provider, such as Google Cloud Storage (GCS) or Amazon S3.
Update your Azure container
If you want to change from one Azure container to another existing Azure container, update the name of the container in Pendo:
- In Pendo, go to Settings > Data Sync.
- Select Manage destination in the top-right corner of the page.
- Replace the entry in the Container name field with the name of the new Azure container that you'd like to use for Data Sync.
- Select Update destination.
Change your cloud storage provider
If you want to change your cloud storage destination from Azure to an alternative service, such as Google Cloud Storage (GCS) or Amazon S3, you can delete the existing destination and create a new one.
To delete a destination:
- In Pendo, go to Settings > Data Sync.
- Select Manage destination in the top-right corner of the page.
- Select Delete destination.
- Confirm that you want to delete the destination.
After you delete a destination, any recurring reports and ongoing metadata updates are automatically turned off.
You can then set up a different cloud storage destination by following the instructions outlined in the following article:
- Set up Data Sync with Google Cloud
- Set up Data Sync with Amazon S3 using user access keys
- Set up Data Sync with Amazon S3 using IAM roles
Alternatively, you can set up Data Sync with a Pendo-hosted GCS destination. For more information, contact your Pendo account team.