Usually, when making software updates to your binaries and applications, your development teams don’t always have direct access to the metadata surrounding events (example: during the compilation of that code). Getting this information is especially important when you have different teams in charge of different parts of your software delivery pipeline. Our integration with PagerDuty allows this monitoring to take place so your on-call teams can monitor events in real-time.
- Users will install the JFrog Artifactory integration application from within the PagerDuty Service Directory and receive a URL to setup the PagerDuty webhook events within JFrog Artifactory.
- JFrog Artifactory will utilize the PagerDuty webhook trigger to send notifications to PagerDuty. Users will be able to configure their webhook events for repositories, builds, artifact properties, and release bundles within JFrog Artifactory and associate these events with the PagerDuty webhook trigger.
- Once the webhook is configured within JFrog Artifactory, a change event alert will be available within the PagerDuty service whenever an event occurs.
- Artifactory performs a re-check of all selected repositories, builds, artifact properties, and release bundles and any events generated will be sent as a change event to the service in PagerDuty. Events from Artifactory will trigger a new change event on the corresponding PagerDuty service, or group them as alerts into an existing change event.
Users may review change events within a PagerDuty service’s recent activity area during incident triage or hypercare. They can also see recent changes on incidents of that service, and navigate across all changes in a comprehensive list of recent changes across all services.
- PagerDuty integration requires an Admin base role for account authorization. If you do not have this role, please reach out to an Admin or Account Owner within your organization to configure the integration.
- JFrog Artifactory requires an Admin based role with administrative privileges to configure the integration. If you do not have this role, please reach out to an Admin or Account Owner within your organization to configure the integration.
If you need help with this integration, please contact partner_support@jfrog.com
All notifications are based on webhook events in the JFrog Platform. The currently supported notifications include:
| Type | Events |
|---|---|
| Artifact | deployed, deleted, moved, copied |
| Artifact Properties | added, deleted |
| Docker Tag | pushed, deleted, promoted |
| Builds | uploaded, deleted, promoted |
| Release Bundles (Enterprise+) | created, signed, deleted |
| Distribution (Enterprise+) | stared, completed, aborted, failed, deletion started, deletion failed, deletion completed |
First, if you don’t already have one, you’ll need to register an account with PagerDuty. Then, once logged into PagerDuty, you’ll hover over the People tab to get started. You can refer to the PagerDuty Quick Start Guide for more information regarding each of these pre-steps to setup and associate your recent changes with a service within PagerDuty.
Add JFrog Artifactory integration to an existing PagerDuty service or create a new service by following the steps below:
First, you’ll need to create a new service. Navigate to Services > Service Directory and click +New Service.
On the next screen, give your new service a name:
After you get to step 4, search for “jfrog” and select JFrog Artifactory Notifications. You’ll then click on the Create Service button.
You’ll now see the following information. Please copy the Integration URL as you’ll be using it to create your webhooks in the JFrog Platform:
Once, you have created a service inside PagerDuty, you’ll need to login to your JFrog instance to create webhooks. These webhooks will send event data to PagerDuty an serve as the basis for your alerts.
First, please login to your JFrog Platform instance.
Under the administration panel, click on General > Webhooks. Next, select + New Webhook from the top-right corner.
Next, provide a name to your new webhook. After providing the name, please copy the Integration URL from PagerDuty and paste it where it says URL here:
Then, select the types of events to include. In this example, we’re creating a Build webhook notification:
Now, select the repositories to include in this webhook notification:
Hit Save.
At the bottom of the main screen, you can Test the notification, by selecting the Test button.
This will send your webhook event to your PagerDuty integration. After you have tested your webhook, hit Create and you’re done!
Once you have tested and finish creating your webhooks, you can see them as recent changes in PagerDuty:
- Find the integration to delete by navigating to Services and selecting Service Directory
- Select the service with your integration and navigate to Integrations tab
- Navigate to the integration by clicking on the integration name (JFrog Artifactory Notifications)
- Click on the Delete Integration button on the top right corner