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 list page, specifying the topic in the panel: Select Create Subscription, and then select a Subscription Topic.
    1. On the Topics list page, select the topic that you want to work with. If you need help finding the list page or the topic, see Listing Topics.
    2. On the topic's details page, select Create Subscription.
    3. In the Create Subscription panel, for Protocol, select PagerDuty.
    4. 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.

    5. Select 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, select 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.