Ü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.
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.
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.
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.
- Sofortige Wiederholung.
- Exponentielle Backoff-Wiederholung für den Zeitraum der Wiederholungsdauer des Abonnements mit folgenden Zeitabständen:
- 1 Minute
- 2 Minuten
- 4 Minuten
- 8 Minuten
- 16 Minuten
- 32 Minuten
- 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.
- 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.
- Abonnement
- Ein Endpunkt für ein Thema. Veröffentlichte Nachrichten werden an jedes Abonnement für ein Thema gesendet.
- Thema
- Ein Kommunikationskanal zum Senden von Nachrichten an Abonnements. Jeder Themenname ist innerhalb des Mandanten eindeutig.
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.
Ankündigungsabonnements
Ein Ankündigungsabonnement sendet Konsolenankündigungsnachrichten an das konfigurierte Thema . Notifications übermittelt die Nachricht dann an aktive Abonnements in diesem Thema.
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.
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.
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.
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.