Überblick über Benachrichtigungen

Mit dem Oracle Cloud Infrastructure Notifications-Service können Sie Kommunikationskanäle für das Veröffentlichen von Nachrichten mit Themen und Abonnements einrichten.

Mit dem Notifications-Service können Sie wissen, wann mit Ihren Ressourcen in Oracle Cloud Infrastructure etwas passiert. Mit Alarmen, Ereignisregeln und Connectors können Sie menschenlesbare Nachrichten über unterstützte Endpunkte abrufen, einschließlich E-Mail- und Textnachrichten (SMS). Sie können Aufgaben auch über benutzerdefinierte HTTPS-Endpunkte und Oracle Cloud Infrastructure Functions automatisieren. Sie können Nachrichten auch direkt veröffentlichen.

Tipp

Sehen Sie sich ein Einführungsvideo zum Service an.

So funktioniert Notifications

Mit dem Service Notifications können Sie Kommunikationskanäle für die Veröffentlichung von Nachrichten mit Themen und Abonnements einrichten. Bei der Veröffentlichung einer Nachricht in einem Thema sendet der Benachrichtigungsservice die Nachricht an alle Abonnements des Themas.

Standardheadermetadaten

Bei der Zustellung von Nachrichten hängt Notifications die folgenden Headermetadaten an.

Für alle Meldungen:

  • Content-Type
  • X-OCI-NS-MessageId
  • X-OCI-NS-TopicOcid
  • X-OCI-NS-TopicName
  • X-OCI-NS-MessageType
  • X-OCI-NS-UnsubscribeURL

Für Bestätigungsmeldungen:

  • X-OCI-NS-ConfirmationURL
  • X-OCI-NS-SubscriptionId

Für die Validierung der Nachrichtensignatur:

  • X-OCI-NS-Signature
  • X-OCI-NS-Timestamp
  • X-OCI-NS-SignatureVersion
  • X-OCI-NS-SigningCertURL

Wenn der Endpunkt eines Abonnenten den Empfang der Nachricht nicht bestätigt, wiederholt der Notifications-Service die Zustellung. Diese Situation kann auftreten, wenn der Endpunkt offline ist. Beispiel: Der E-Mail-Server für eine E-Mail-Adresse ist möglicherweise heruntergefahren.

Details der Zustellungswiederholung

Notifications wiederholt die Zustellung mithilfe dieser Schritte so lange, bis entweder (a) eine Bestätigung empfangen wird oder (b) die Wiederholungsdauer des Abonnements abgelaufen ist. Standardmäßig beträgt die Wiederholungsdauer zwei Stunden.

  1. Sofortige Wiederholung.
  2. Exponentielle Backoff-Wiederholung für den Zeitraum der Wiederholungsdauer des Abonnements mit folgenden Zeitabständen:
    1. 1 Minute
    2. 2 Minuten
    3. 4 Minuten
    4. 8 Minuten
    5. 16 Minuten
    6. 32 Minuten
  3. Verwerfen der Nachricht am Ende der Wiederholungsdauer.

Informationen zum Ändern der Wiederholungsdauer eines Abonnements finden Sie unter Abonnements aktualisieren.

Notifications - Konzepte

Die folgenden Konzepte sind für die Arbeit mit Notifications von wesentlicher Bedeutung.

Ansprechende Formatierung
Eine Einstellung zur Verbesserung der Lesbarkeit von Nachrichten durch den Menschen.

Unterstützte Abonnementprotokolle:

Unterstützte Nachrichtentypen:

Nachricht
Der Inhalt, der in einem Thema veröffentlicht wird. Jede Nachricht wird mindestens einmal pro Abonnement zugestellt. Jede als E-Mail versendete Nachricht enthält einen Link zum Aufheben des Abonnements des jeweiligen Themas.
Benachrichtigung
Eine Konfiguration zum Senden von Nachrichten, wie eine Alarm- oder Ereignisregel. Jede Nachricht wird an Abonnements im angegebenen Thema gesendet.
Die folgenden Benachrichtigungstypen sind verfügbar:
Nachdem Sie die Benachrichtigung erstellt haben, können Sie sie wie gewohnt verwalten. Beispiel: Wenn die Benachrichtigung ein Alarm ist, verwalten Sie sie auf der Seite Alarme in der Konsole.
Abonnement
Ein Endpunkt für ein Thema. Veröffentlichte Nachrichten werden an jedes Abonnement für ein Thema gesendet.
Unterstützte Abonnementprotokolle:
  • E-Mail:

    Sendet eine E-Mail-Nachricht, wenn Sie eine Nachricht  im übergeordneten Thema  des Abonnements veröffentlichen.

    Hinweis

    Befolgen Sie die Best Practices für die Integration mit Email Delivery. Siehe Positive Reputation eines E-Mail-Absenders erhalten.
    Nachrichteninhalt und -darstellung variieren je nach Nachrichtentyp. Siehe Alarmnachrichten, Ereignismeldungen und Connector-Nachrichten.

    Einige Nachrichtentypen verwenden Benutzerfreundliche Formatierung.

  • Funktion:
    Führt die angegebene Funktion aus, wenn Sie eine Nachricht im übergeordneten Topic des Abonnements veröffentlichen. Beispiel: Führt eine Funktion zur Skalierung von VMs aus, wenn ein zugehöriger Alarm ausgelöst wird.
  • HTTPS (Benutzerdefinierte URL):

    Sendet festgelegte Informationen, wenn Sie eine Nachricht  im übergeordneten Thema  des Abonnements veröffentlichen.

  • PagerDuty:
    Erstellt standardmäßig einen PagerDuty-Vorgang, wenn Sie eine Nachricht im übergeordneten Thema des Abonnements veröffentlichen.
  • Slack:
    Sendet standardmäßig eine Nachricht an den angegebenen Slack-Kanal, wenn Sie eine Nachricht  im übergeordneten Thema  des Abonnements veröffentlichen.
    Nachrichteninhalt und -darstellung variieren je nach Nachrichtentyp. Siehe Alarmnachrichten, Ereignisnachrichten und Connector-Nachrichten.
  • SMS:
    Sendet eine Textnachricht per Short Message Service (SMS) an die angegebene Telefonnummer, wenn Sie eine Nachricht  im übergeordneten Thema  des Abonnements veröffentlichen. Unterstützte Endpunktformate: E.164-Format.
    Hinweis

    Internationale SMS-Funktionen sind erforderlich, wenn SMS-Nachrichten von einer Telefonnummer in einem anderen Land stammen. Unterstützung für weitere Länder wird kontinuierlich hinzugefügt, damit mehr Nutzer SMS-Nachrichten von lokalen Telefonnummern erhalten können.

    SMS-Abonnements sind nur für Nachrichten aktiviert, die von den folgenden Oracle Cloud Infrastructure-Services gesendet werden: Ankündigungen, Monitoring und Connector Hub. SMS-Nachrichten, die von nicht unterstützten Services gesendet werden, werden verworfen. Siehe Ursache: Nicht unterstützte Ressource für SMS.

    Der Notifications-Service stellt SMS-Nachrichten aus einem vorkonfigurierten Nummernpool zu. Sie erhalten möglicherweise SMS-Nachrichten von mehreren Nummern.

    Nachrichteninhalt und -darstellung variieren je nach Nachrichtentyp. Siehe SMS-Alarmnachrichten und SMS-Connector-Nachrichten.

    Verfügbare Länder und Regionen

    Mit dem Notifications-Service können Sie SMS-Nachrichten an die folgenden Länder und Regionen senden:

    Land oder Region ISO-Code
    Australien AU
    Brasilien BR
    Kanada CA
    Chile CL
    China CN
    Costa Rica CR
    Kroatien HR
    Tschechien CZ
    Frankreich FR
    Deutschland DE
    Ungarn HU
    Indien IN
    Irland IE
    Israel IL
    Japan JP
    Litauen LT
    Mexiko MX
    Niederlande NL
    Neuseeland NZ
    Norwegen NO
    Philippinen PH
    Polen PL
    Portugal PT
    Rumänien RO
    Saudi-Arabien SA
    Singapur SG
    Südafrika ZA
    Südkorea KR
    Spanien ES
    Schweden SE
    Schweiz CH
    Ukraine UA
    USA AE
    Großbritannien GB
    USA US
Thema
Ein Kommunikationskanal zum Senden von Nachrichten an Abonnements. Jeder Themenname ist innerhalb des Mandanten eindeutig.
Hinweis

Nachrichten, die vom Oracle Cloud Infrastructure Notifications-Service als E-Mail gesendet werden, werden in US-basierten Regionen über Oracle-Ressourcen verarbeitet und zugestellt.

Ablauf der Veröffentlichung und Übermittlung von Nachrichten

Ressourcen veröffentlichen Nachrichten im konfigurierten Thema . Benachrichtigungen liefern dann Nachrichten an aktive Abonnements im Thema.

Zu den Ressourcen, die Nachrichten senden können, gehören Alarme, Ankündigungsabonnements, Ereignisregeln, Connectors und kontextbezogene Benachrichtigungen (Alarme und Ereignisregeln). (Ein Benutzer, ein Service oder eine App kann auch eine Nachricht über die Direktveröffentlichung senden.)

Beispiel: Ein Alarm, der zum Senden von Nachrichten an ein Thema konfiguriert ist. Dieses Thema enthält E-Mail-, Slack- und SMS-Abonnements. Wenn die Alarmtriggerregel verletzt wird, veröffentlicht der Alarm eine Nachricht im Thema. Notifications übermittelt die Nachricht dann an die aktiven Abonnements des Themas. In diesem Beispiel steht das Slack-Abonnement aus, weil es noch nicht bestätigt wurde. Notifications übermittelt die Nachricht nur an die E-Mail- und SMS-Abonnements, da dies die einzigen aktiven Abonnements im Thema sind.

Metriken, die veröffentlichte und zugestellte Nachrichten verfolgen, finden Sie unter Verfügbare Metriken: oci_notification.

Alarm

Wenn die Triggerregel eines Alarms verletzt wird, sendet der Alarm eine Alarmnachricht an das konfigurierte Thema . Notifications übermittelt die Nachricht dann an aktive Abonnements in diesem Thema. Siehe Alarme verwalten.

Eine kontextbezogene Benachrichtigung kann einen Alarm enthalten.

Diese Abbildung zeigt Notifications im Kontext von Alarmen.

Ankündigungsabonnements

Ein Ankündigungsabonnement sendet Konsolenankündigungsnachrichten an das konfigurierte Thema . Notifications übermittelt die Nachricht dann an aktive Abonnements in diesem Thema.

Diese Abbildung zeigt Notifications im Kontext von Ankündigungsabonnements.

Ereignisregeln

Wenn sie ausgelöst wird, sendet eine Ereignisregel eine Ereignisnachricht an das konfigurierte Thema . Notifications übermittelt die Nachricht dann an aktive Abonnements in diesem Thema. Siehe Regeln für Ereignisse verwalten.

Eine kontextbezogene Benachrichtigung kann eine Ereignisregel enthalten.

Diese Abbildung zeigt Notifications im Kontext von Ereignisregeln.

Connector

Ein Connector sendet eine Connector-Nachricht an das konfigurierte Thema . Notifications übermittelt die Nachricht dann an aktive Abonnements in diesem Thema. Siehe Connectors verwalten.

Diese Abbildung zeigt Notifications im Kontext von Connectors.

Direkte Veröffentlichung

Ein Benutzer (oder ein Service oder eine App) sendet eine Nachricht an das konfigurierte Thema . Notifications übermittelt die Nachricht dann an aktive Abonnements in diesem Thema. Siehe Nachrichten in einem Thema veröffentlichen.

Diese Abbildung zeigt, wie eine Nachricht mit Notifications direkt veröffentlicht wird.

Automatisierung mit Funktionen und Ereignissen erstellen

Sie können Automatisierungen erstellen, indem Sie Nachrichten in Themen veröffentlichen, die Funktionsabonnements enthalten. Ein Beispiel für ein FunktionsAbonnement finden Sie unter Szenario A: VMs automatisch skalieren.

Sie können auch Automatisierung auf Basis von Statusänderungen von Themen und Abonnements (Benachrichtigungsressourcen) erstellen, indem Sie Ereignistypen, Regeln und Aktionen verwenden.

Verfügbarkeit

Der Notifications Service ist in allen kommerziellen Oracle Cloud Infrastructure-Regionen verfügbar. Unter Informationen zu Regionen und Availability-Domains finden Sie die Liste der verfügbaren Regionen sowie zugehörige Standorte, Regions-IDs, Regionsschlüssel und Availability-Domains.

Vergleich der Services zum Senden von E-Mail-Nachrichten

Beachten Sie die folgenden Servicefeatures bei der Entscheidung, ob Sie den Notifications-Service oder den Email-Delivery-Service zum Senden Ihrer E-Mail-Nachrichten verwenden möchten. Weitere Informationen zum Email-Delivery-Service finden Sie unter Überblick über den Email-Delivery-Service.

Servicefeature Notifications Service Email-Delivery-Service
Erfordert Bestätigung vor dem Senden von E-Mails. Ja Nein
Lässt E-Mail-Zusätze (wie Signaturen) zu. Ja Nein
Ermöglicht Raw-E-Mail-Nachrichten. Nein Ja
Unterstützt MIME-Anhänge. Nein

Ja

Unterstützt besonderen Umgang mit nicht zugestellten E-Mails. Nein

Ja

Preisgestaltung für kleine Nachrichten (kleiner als 32 KB, mit einem Limit von 64 KB). Ja Nein
Preisgestaltung für große Nachrichten (größer als 32 KB, mit einem Limit von 2 MB). Nein Ja

Ressourcen-IDs

Die meisten Typen von Oracle Cloud Infrastructure-Ressourcen besitzen eine eindeutige, von Oracle zugewiesene ID, die als Oracle Cloud-ID (OCID) bezeichnet wird. Informationen zum OCID-Format und andere Möglichkeiten zur Identifizierung der Ressourcen finden Sie unter Ressourcen-IDs.

Möglichkeiten für den Zugriff auf Notifications

Sie können über die Konsole oder die Benachrichtigungs-REST-API auf Notifications zugreifen. Anweisungen für die Konsole, CLI und API sind in dieser Dokumentation enthalten. Eine Liste der verfügbaren SDKs finden Sie unter Software Development Kits und Befehlszeilenschnittstelle (CLI).

Konsole: Um auf Notifications über die Konsole zuzugreifen, müssen Sie einen unterstützten Browser verwenden. Um zur Anmeldeseite der Konsole zu wechseln, öffnen Sie das Navigationsmenü oben auf dieser Seite, und wählen Sie Infrastrukturkonsole aus. Dort werden Sie aufgefordert, Ihren Cloud-Mandanten, Benutzernamen und Ihr Kennwort einzugeben. Öffnen Sie das Navigationsmenü , und wählen Sie Entwicklerservices aus. Wählen Sie unter Anwendungsintegration die Option Benachrichtigungen aus.

API: Um auf Notifications über die API zuzugreifen, verwenden Sie die Notifications-API.

CLI: siehe Command Line Reference for Notifications.

Authentifizierung und Autorisierung

Jeder Service in Oracle Cloud Infrastructure lässt sich mit IAM zur Authentifizierung und Autorisierung für alle Schnittstellen (Konsole, SDK oder CLI und REST-API) integrieren.

Ein Administrator in einer Organisation muss Gruppen , Compartments und Policys einrichten, die den Zugriffstyp sowie den Zugriff der Benutzer auf Services und Ressourcen steuern. Beispiel: Die Policys steuern, wer neue Benutzer erstellen, das Cloud-Netzwerk erstellen und verwalten, Instanzen erstellen, Buckets erstellen, Objekte herunterladen kann usw. Weitere Informationen finden Sie unter Identitätsdomains verwalten. Einzelheiten zum Schreiben von Policys für die einzelnen Services finden Sie in der Policy-Referenz.

Wenn Sie ein regulärer Benutzer sind (nicht ein Administrator), der die Oracle Cloud Infrastructure-Ressourcen verwenden muss, für die das Unternehmen verantwortlich ist, bitten Sie einen Administrator, eine Benutzer-ID für Sie einzurichten. Der Administrator kann festlegen, welche Compartments Sie verwenden können.

Administratoren: Allgemeine Policys, die Gruppen Zugriff auf Notifications-Ressourcen erteilen, finden Sie unter IAM-Policys (auf der Seite "Benachrichtigungen sichern").

Benachrichtigungslimits

Eine Liste der jeweiligen Limits sowie Anweisungen dazu, wie Sie eine Erhöhung beantragen finden Sie unter Servicelimits. Um compartment-spezifische Grenzwerte für eine Ressource oder Ressourcenfamilie festzulegen, können Administratoren Compartment-Quotas verwenden.

Limits für die Veröffentlichung von Nachrichten (PublishMessage-Vorgang)

Alle Grenzwerte gelten pro Mandant.

Grenzwerttyp Grenzwert
Nachrichtengröße pro Anforderung 64 KB
Nachrichtenzustellungsrate pro Endpunkt für HTTP-basierte Protokolle (Endpunkte, die mit "http:" oder "https:" beginnen) 60 Nachrichten pro Minute
Nachrichtenzustellungsrate pro Endpunkt für E-Mail-Protokoll 10 Nachrichten pro Minute
Nachrichten pro Minute (auch als Transaktionen pro Minute oder TPM bezeichnet) 60 pro Thema

Sicherheit

Informationen zur Sicherheit für Notifications.

Zugriff auf Themen und Abonnements erteilen. Siehe Notifications sichern.