GitHub Issues Integration
Learn how to automatically create GitHub Issues with Flaky Test webhooks
Last updated
Learn how to automatically create GitHub Issues with Flaky Test webhooks
Last updated
Trunk allows you to automate GitHub Issue creation through webhooks. This will allow you to create GitHub issues and auto-assign them to CODEOWNERS using Webhooks.
This guide will walk you through integrating Trunk Flaky Tests with GitHub Issues through webhooks. You will be able to automatically generate GitHub issues for new flaky or broken tests. This guide should take 15 minutes to complete.
Before you can create a webhook to automate GitHub Issue creation, you need to create an API token to authorize your requests.
Navigate to GitHub Developer Settings under Settings > Developer settings
Under Personal access token > Fine-grained tokens > Click Generate new token
Name the token something like Trunk Flaky Tests
so you can recognize your token and set it never to expire.
Select the repositories you need to create issues to under Repository access
Under Permissions > Repository Permissions, select Read and Write access for Issues.
Click Generate Token and copy your API token.
Trunk uses Svix to integrate with other services, such as GitHub Issues through webhooks.
You can create a new endpoint by:
Login to Trunk Flaky Tests
From your profile on the top right, navigate to Settings
Under Organization > Webhooks, click Automate GitHub Issue Creation
Paste your GitHub repo's Issues endpoint into Endpoint URL. Your Endpoint URL should be formatted as: https://api.github.com/repos/{OWNER}/{REPO}/issues
. You can verify the URL by visiting it in your browser, such as https://api.github.com/repos/trunk-io/docs/issues.
Review the transformation code automatically generated for GitHub issues. You can customize this transformation at any time. Learn more about customizing transformations.
Create the new endpoint. You will be redirected to the endpoint configuration view.
If you're having trouble adding a new webhook endpoint with Svix, please see the Adding Endpoint docs from Svix.
The GitHub Issues API requires some custom headers. You can configure custom headers in the endpoint configuration:
You can add custom headers under Webhooks > Advanced > Custom Headers.
Fill in the Key and Value referencing the table below, and click the + button to add each header.
You'll need to configure the following headers.
Accept
application/vnd.github+json
Authorization
Bearer <YOUR_API_TOKEN>
X-GitHub-Api-Version
2022-11-28
Transformations are custom code snippets you can write to customize the GitHub issues created by the webhook. A working template transformation will be added automatically for your webhook, but you can further customize the behavior of this webhook.
In the endpoint configuration view, navigate to the Advanced tab. Under Transformation, toggle the Enabled switch.
Click Edit transformation to update your transformation code, and click Save to update the transformation.
You can test the transformation by selecting the test_case.status_changed
payload and clicking Run Test. This will test the transformation but not send a message. You will learn to send a test message in step 5.
The generated webhook template contains several configurable constants out of the box:
GITHUB_ISSUE_LABEL_IDS
(Optional) GitHub labels that will be assigned to issues created by Trunk.
PRS_IMPACTED_THRESHOLD
Issues will be created only for flaky tests that have impacted more PRs than the PRS_IMPACTED_THRESHOLD
.
You can adjust this value if you see many issues about low-impact flaky tests.
Here is the provided transformation for context. You can customize your GitHub Issues integration by following the GitHub and Svix transformations documentation.
If you have CODEOWNERS configured for your GitHub repo, you can create issues with assignees using CODEOWNERS. You can uncomment the code block on lines 31-35 or use a snippet similar to:
CODEOWNERS supports assigning files to teams, but GitHub doesn't support assigning issues to teams. If you have team owners in your CODEOWNERS file, the requests will fail.
If your code owners do not map 1:1 with GitHub users, you will need to provide your own mapping, or webhooks will fail.
The example payload provided for testing has the CODEOWNERS assigned to @backend
. If you're testing following the instructions in step 5, the delivery attempt can fail.
You can create test issues by delivering a mock webhook. You can do this by:
In the endpoint configuration view, navigate to the Testing tab and select a Send event
Under Subscribed events, select test_case.status_changed
as the event type to send.
Click Send Example to test your webhook
A GitHub Issue will now be created when a test's health status changes. You can further modify your transformation script to customize your issues.
See the Trunk webhook event catalog
You can monitor the events and the webhook's delivery logs in the Overview tab of an endpoint configuration view.
You can see an overview of how many webhook deliveries have been attempted, how many are successful, how many are in flight, and how many fail in the Attempt Delivery Status modal.
You can see a list of past delivery attempts in the Message Attempts modal. You can filter this list by Succeeded and Failed status, and you can click on each message to see the Message content, response code, and error message of each attempt. You can learn more about replaying messages and filtering logs in the Svix docs.