Azure DevOps
Connecting Hawkeye to your Azure DevOps account allows us to collect telemetry data such as build logs, pipelines, repositories, and deployment details, enabling real-time monitoring through the Hawkeye dashboard.
The following steps will help you set up this connection:
Step 1: Create a Service Principal
To setup an Azure DevOps integration on Hawkeye, you first need to create a service principal. This will create credentials that you’ll need in completing this integration.
To create this, follow the first and second steps in the Azure connection guide.
Step 2: Setup Azure DevOps Integration
After creating the service principal, you need to grant it access to your Azure DevOps organization.
-
Navigate to Azure DevOps Organization: Log in to your Azure DevOps account and navigate to the organization where you want to grant access.
-
Go to Organization Settings: In the lower left corner, select Organization Settings.
-
Add Service Principal to Users: In the left sidebar, click Users and then select Add Users.
-
Grant Access to Projects: Add the Service Principal to the specific projects you want Hawkeye to access. This ensures Hawkeye can retrieve the necessary telemetry.
After adding these details, click the Add button.
Step 3: Configure your Azure DevOps connection in Hawkeye
Now that you have the necessary credentials, proceed to the Hawkeye dashboard to complete the connection setup:
-
Open Hawkeye dashboard: Navigate to the Connections section of the Hawkeye dashboard and click the New Connection card.
-
Create a New Connection: From the available list, select Azure DevOps.
After this, click on the Next button in the top right corner.
-
Enter the required credentials:
-
Name: Provide a name for your connection.
-
Description: Optionally, add a description for the integration.
-
Tenant ID: Your Azure tenant ID.
-
Client ID: The client ID from your registered application.
-
Client Secret: The secret you created.
-
Organization URL: The URL of the Azure DevOps organization you integrated with in step 2. The organization URL is typically in the format
https://dev.azure.com/your-org-name
.
Once you’ve entered all the details, click Save to establish the connection.
-
-
Confirm connection: To confirm that your connection was successfully created, navigate to the Connections tab and you should see a card like this: