Oracle Cloud Infrastructure Documentation

Creating a PagerDuty Subscription

Create a PagerDuty subscription in Notifications.

Before You Begin

To create a PagerDuty subscription, you must have a PagerDuty endpoint. See Create a PagerDuty Endpoint in PagerDuty Integration Walkthrough. The walkthrough page also includes information about testing PagerDuty subscriptions and automatically triggering PagerDuty incidents.

  • These steps show how to open the Create Subscription panel from the details page for the topic that you want to add the subscription to. You can also open this panel from the Subscriptions page, specifying the topic in the panel: Click Create Subscription, and then select a Subscription Topic.

    1. Open the navigation menu and click Developer Services. Under Application Integration, click Notifications.
    2. On the Topics page, select the compartment that contains the topic that you want.
    3. Click the name of the topic that you want to add the subscription to.
    4. On the Topic Details page, click Create Subscription.
    5. In the Create Subscription panel, for Protocol, select PagerDuty.
    6. Enter the integration key portion of the URL (PagerDuty endpoint).

      The other portions of the URL are hard-coded. Full endpoint format:

      https://events.pagerduty.com/integration/<integrationkey>/enqueue

      Query parameters aren't permitted in URLs.

    7. Click Create.

    Notifications creates the PagerDuty subscription and sends a confirmation URL to its endpoint. The subscription is pending until confirmation is received.

  • Use the oci ons subscription create command and required parameters to create a PagerDuty subscription:

    oci ons subscription create --protocol "PAGERDUTY" --subscription-endpoint <URL> [...]

    For a complete list of parameters and values for CLI commands, see the Command Line Reference for Notifications.

  • Run the CreateSubscription operation to create an HTTPS (Custom URL) subscription.

What's Next

To activate the new subscription, click the Confirmation URL link in the confirmation incident that was sent to PagerDuty.

Although a new subscription must be in the same compartment as its parent topic, you can move it to another compartment after creation. See Moving a Subscription.