What subscription protocols does OCI Notifications support?

OCI Notifications supports email, SMS (through Oracle-approved carriers), HTTPS webhooks (for custom integrations), PagerDuty (native integration), Slack (via incoming webhooks), OCI Functions (for serverless processing), and custom protocols via HTTPS endpoints. Each topic can have multiple subscriptions across different protocols, so a single notification can simultaneously page an engineer, send a Slack message, create a ticket via webhook, and trigger a remediation function.

How do Notifications integrate with OCI Monitoring Alarms?

OCI Monitoring Alarms trigger notification actions when metric conditions are met. Each alarm can specify notification topics for three states: Firing (condition is true), OK (condition cleared), and Repeat (condition remains true). When an alarm fires, it publishes a structured message to the configured topic, which then delivers to all subscribers. This creates a complete monitoring-to-alerting pipeline: Monitoring collects metrics, Alarms evaluate conditions, and Notifications distribute alerts.

OCI Notification Topic Builder

MonitoringOCI

Build OCI Notifications topic and subscription configs with multi-channel delivery.

OCI Notifications Configuration

Build OCI Notifications topic and subscription configurations with email, Slack, PagerDuty, and webhook delivery.

Required Fields

compartmentIdtopicsubscriptions

{
  "compartmentId": "ocid1.compartment.oc1..aaaaaaaexample",
  "topic": {
    "name": "critical-alerts-topic",
    "description": "Notification topic for critical infrastructure alerts and incidents",
    "apiEndpoint": "https://cell1.notification.us-ashburn-1.oci.oraclecloud.com"
  },
  "subscriptions": [
    {
      "protocol": "EMAIL",
      "endpoint": "sre-team@example.com",
      "displayName": "SRE Team Email",
      "retryDuration": 7200
    },
    {
      "protocol": "SLACK",
      "endpoint": "https://hooks.slack.com/services/T00000/B00000/XXXXXXXXXXXX",
      "displayName": "Slack #incidents Channel",
      "retryDuration": 7200
    },
    {
      "protocol": "PAGERDUTY",
      "endpoint": "https://events.pagerduty.com/integration/abc123/enqueue",
      "displayName": "PagerDuty Critical Service",
      "retryDuration": 7200
    },
    {
      "protocol": "HTTPS",
      "endpoint": "https://api.example.com/webhooks/oci-notifications",
      "displayName": "Custom Webhook",
      "retryDuration": 3600
    },
    {
      "protocol": "ORACLE_FUNCTIONS",
      "endpoint": "ocid1.fnfunc.oc1.iad.aaaaaaaexample",
      "displayName": "Auto-Remediation Function",
      "retryDuration": 7200
    }
  ],
  "messageFormat": {
    "defaultFormat": "ONS_OPTIMIZED",
    "availableFormats": ["RAW_TEXT", "JSON", "ONS_OPTIMIZED"]
  },
  "freeformTags": {
    "severity": "critical",
    "team": "sre",
    "environment": "production"
  }
}

Generated Output

Output will appear here...

About This Tool

OCI Notifications provides a publish-subscribe messaging service for sending alerts and messages to multiple endpoints simultaneously. Topics define the subject of notifications, and subscriptions deliver messages to email addresses, SMS numbers, Slack webhooks, PagerDuty, OCI Functions, and HTTPS endpoints. This builder helps you configure notification topics with subscription endpoints, message formatting, filter policies, and integration with OCI Events and Alarms for automated alerting.

When to Use This Tool

•Creating a notification topic for production alerts that delivers to PagerDuty for on-call engineers and email for the broader team simultaneously
•Building a topic with multiple subscription protocols — email for human review, HTTPS webhook for automated ticketing, and Function for remediation
•Configuring notification topics for OCI Alarm actions that escalate based on severity — warning alarms to Slack, critical alarms to PagerDuty
•Setting up a topic for budget alerts that notifies finance stakeholders via email when compartment spending exceeds defined thresholds

Frequently Asked Questions

What subscription protocols does OCI Notifications support?: OCI Notifications supports email, SMS (through Oracle-approved carriers), HTTPS webhooks (for custom integrations), PagerDuty (native integration), Slack (via incoming webhooks), OCI Functions (for serverless processing), and custom protocols via HTTPS endpoints. Each topic can have multiple subscriptions across different protocols, so a single notification can simultaneously page an engineer, send a Slack message, create a ticket via webhook, and trigger a remediation function.
How do Notifications integrate with OCI Monitoring Alarms?: OCI Monitoring Alarms trigger notification actions when metric conditions are met. Each alarm can specify notification topics for three states: Firing (condition is true), OK (condition cleared), and Repeat (condition remains true). When an alarm fires, it publishes a structured message to the configured topic, which then delivers to all subscribers. This creates a complete monitoring-to-alerting pipeline: Monitoring collects metrics, Alarms evaluate conditions, and Notifications distribute alerts.

Related Learning Guides

OCI Streaming & Events22 min read

Disclaimer: This tool runs entirely in your browser. No data is sent to our servers. Always verify outputs before using them in production. AWS, Azure, and GCP are trademarks of their respective owners.