Skip to main content

Microsoft Azure DevOps Server version tags

Tell Coralogix when a new build ships, straight from your Azure DevOps Server pipeline. A service hook on build completion creates a version tag, which is what version benchmark reports compare behavior across.

What you need

  • Access to your Azure DevOps Server team project's settings.
  • A personal or team API key with the CICDIntegration preset. Presets pick up new permissions automatically; individual permissions have to be maintained by hand.
  • The Azure DevOps version tags endpoint for your Coralogix domain. Use the domain selector at the top of this page to resolve it: https://api./api/v1/external/tfs?application=YOUR_APPLICATION_NAME&subsystem=YOUR_SUBSYSTEM_NAME&name=YOUR_TAG_NAME
PresetActionsGrants
CICDIntegrationVERSION-BENCHMARK-TAGS:READ
VERSION-BENCHMARKS-REPORTS:READ
VERSION-BENCHMARK-TAGS:UPDATE
View version benchmark tags
View version benchmark reports
Modify version benchmark tags

Create the service hook

1.
Open service hooks

Sign in to Azure DevOps Server, select your team project, then Settings, then Service hooks.

2.
Add a web hook

Select Add new service hooks, then Web Hooks.

3.
Trigger on completed builds

Select Build Completed as the trigger, set Build status to Succeeded, and select Next. Add any further filters you want.

4.
Point it at Coralogix

Enter the Azure DevOps version tags endpoint for your domain, with the query parameters below.

ParameterWhat to enter
applicationRequired. Must match your logs application name exactly
subsystemMust match your logs subsystem name. Separate multiple names with commas
5.
Authorize the request

Add a header carrying your API key, then select Finish.

Authorization: Bearer <cx_api_key>
Last updated on
On this page
Was this page helpful?