Use the Integrations page to monitor, configure, and update your integrations.
The Manage Integrations permission is required to view, manage, or delete integrations.
This permission has three levels:
View and manage
View, manage and delete
Make sure you have the correct level to make changes as desired. We recommend limiting the number of people who have the View, manage and delete level to avoid accidentally deleting critical data.
Adding an integration
To add an integration:
Click Add Integration in the top right corner of the Integrations page.
Select an integration from the Integration Provider list and Flow will guide you through the integration process.
The steps to successfully connect to each vendor vary slightly depending on the authentication methods available. Refer to the article for your specific vendor for more information.
Data from successfully added integrations will not be available immediately. Flow must first ingest and process your data. Learn more about integration processing statuses to understand how your data is processing.
Viewing Vendor URL templates
Self-hosted git hosts may not provide the correct commit URL to Flow. This prevents Flow from properly linking to that commit. Once you’ve set up Vendor URL templates to enable correct linking, use the Vendor URL page to review and edit Vendor URL templates.
From the Integrations page, click the Vendor URLs button.
On the Vendor URL templates page, review the vendor URLs and see which commits are not yet configured. Use this page to review and modify your Vendor URL templates.
On this page:
The Hostname column provides the name of the host for your commit. The hostname is used to populate the Host variable in the URL template.
The Commit URL column shows the URL template linking to the commit.
The Integrations affected column shows the integrations that use the host name. Each of these integrations use this template to link to their commits.
The Last updated column shows the date the URL was last updated.
The Edit column allows you to edit the URLs.
To edit an existing Vendor URL template:
Click the Edit icon next to the URL you want to edit.
You will see a pop up modal where you can edit the URL.
Use the Hostname field to edit the host name of your commit. The hostname field is pre-populated based on the hostname provided to Flow.
Use the Commit URL template field to edit the commit URL. When you click inside the field, you will see URL template variables. Click the variable you want to edit.
The Variables and their meanings section provides the variable names for the URL and their definition. Click a variable name to populate that variable field in the Commit URL template field.
Use the provided URL to verify the URL is correct. The URL will update in real time as you update the template.
When you’ve finished making your changes, click Update.
Use the Actions for all integrations dropdown menu to apply changes to all integrations. This dropdown is only available if you have the View, manage and delete Manage integrations permission.
Update all repos: This is useful when credentials have expired and repos have been blocked. Use this option to queue repos for processing after updating your credentials.
Update background metrics: This is useful when certain activity, like a comment on a PR, isn’t being correctly factored into metric calculations.
Edit deployment source: Use this if you want to enable or disable git tag tracking for deployments for all integrations. This is only available for git-based integrations.
Performing any of these actions requires Flow to reprocess your data. Changes will not be immediate. Once processing is complete, you’ll see a success banner.
Note: You can also edit the deployment source for select integrations by either:
- Using the check boxes on the left to select multiple integrations, then using the Actions dropdown to edit the deployment source.
- Clicking the three dots icon to the right of any integration, then editing the deployment source.
Deleting an integration removes all data associated with that integration. Deletion should be rare and should not be used to edit an integration or solve data issues.
Important: Deleting an integration is an extreme option. If you experience issues with your data and are unable to resolve them, contact Pluralsight Support before attempting to delete integrations. If you do delete an integration and add it back later:
- You should not add the same integration back for at least 24 hours to allow the deletion to complete.
- You may have to merge users again after re-adding the integration.
- When the integration is added back, Flow will need time to re-process all repos, PRs, and tickets.
To delete an integration:
Select the integration(s) you’d like to delete.
Click the Actions dropdown.
Click Remove selected.
Read the warning and click Delete integration to proceed.
Viewing and managing an integration
On the Integrations page, use the columns to sort your integrations:
Integration name: the name given to the integration during integration setup
Provider: indicates which provider was integrated with
Services: lists the repos, pull requests, or ticket services that were enabled
Deployment source: indicates whether git tags are enabled for deployment tracking. For providers with no repo data, this column will be blank
Added by: the Flow user who set up the integration. This may not be the same user whose credentials are used in the integration set up process
Tip: If you want to see which credentials are used for the integration, click Edit on the integration details page to open the authentication configuration modal.
Data status: the current health and processing status of the integration. Learn more about integration data statuses
Last updated: the last time Flow ingested new data from the integration
View repos/tickets: links to the Repos or Ticket projects page for this integration
To see and edit more details about a specific integration, click the integration name to see the integration details page.
On the integration details page, see:
Name: the name of the integration set during the initial integration configuration
Connected by: the Flow user who set up the integration
Note: This may not be the same user whose credentials are used in the integration set up process.
To make changes to the integration, click:
Test connection: tests whether the integration connection is successful
Update: places all projects, repos, pull requests, and tickets associated with the connection into the queue to be updated
Refresh all projects: see new groups, repos, and projects available to import
Edit: update the integration name, authentication method, credentials, or services
Delete (trash can icon): delete the integration
Depending on the vendor, the following tabs are available:
Toggle on Auto-import all groups if you want all repos in all groups imported automatically.
For each group:
Toggle on Auto import to automatically import all repos in the group.
Toggle on Show in Repos page to have the repos appear in the Available or Imported tabs of the Repos page.
Set up repo exclusion rules
Toggle on Auto-import all projects if you want all projects imported automatically.
For each project:
Toggle on Import to import the project
Once a project is imported, configure the ticket project
Set up webhooks
Toggle on or off services available for the integration. Depending on the vendor, available services can include Repos, Pull requests, and Tickets
If you need help, please contact Pluralsight Support.