Konfiguration von Benachrichtigungen in Amazon OpenSearch Service

Konfigurieren Sie Benachrichtigungen in Amazon OpenSearch Service, um benachrichtigt zu werden, wenn Daten aus einem oder mehreren Indizes bestimmte Bedingungen erfüllen. Sie möchten beispielsweise eine E-Mail erhalten, wenn Ihre Anwendung mehr als fünf HTTP-503-Fehler pro Stunde protokolliert, oder Sie möchten ggf. einen Entwickler benachrichtigen, wenn in den letzten 20 Minuten keine neuen Dokumente indiziert wurden.

Alerting erfordert Elasticsearch 6.2 OpenSearch oder höher.

Anmerkung

Diese Dokumentation bietet einen kurzen Überblick über Warnmeldungen und zeigt auf, wie sich Warnmeldungen auf einer Amazon OpenSearch Service-Domain von Warnmeldungen auf einem Open-Source-Cluster unterscheiden. OpenSearch Eine vollständige Dokumentation zu Warnmeldungen, einschließlich einer umfassenden API-Referenz, einer Liste verfügbarer Anforderungsfelder für zusammengesetzte Monitore und Beschreibungen der verfügbaren Auslöser- und Aktionsvariablen, finden Sie in der Dokumentation unter Alerting. OpenSearch

Warnungsberechtigungen

Warnungen unterstützen die differenzierte Zugriffskontrolle. Einzelheiten zum Kombinieren und Abgleichen von Berechtigungen für Ihren Anwendungsfall finden Sie in der Dokumentation unter Alerting security. OpenSearch

Um in OpenSearch Dashboards auf die Seite „Benachrichtigungen“ zugreifen zu können, müssen Sie mindestens der alerting_read_access vordefinierten Rolle zugeordnet sein oder Ihnen müssen entsprechende Berechtigungen erteilt werden. Diese Rolle gewährt Berechtigungen zum Anzeigen von Benachrichtigungen, Zielen und Monitoren, jedoch nicht zum Bestätigen von Warnungen oder zum Ändern von Zielen oder Monitoren.

Erste Schritte mit Warnungen

Um eine Warnung zu erstellen, konfigurieren Sie einen Monitor. Dabei handelt es sich um einen Job, der nach einem definierten Zeitplan ausgeführt wird und OpenSearch Indizes abfragt. Sie konfigurieren auch einen oder mehrere Auslöser, die die Bedingungen definieren, unter denen Ereignisse generiert werden. Abschließend konfigurieren Sie Aktionen, die nach dem Auslösen einer Warnung geschehen.

Erste Schritte mit Warnungen

1. Wählen Sie im Hauptmenü der OpenSearch Dashboards die Option Alerting und dann Monitor erstellen aus.

2. Erstellen Sie eine Überwachung pro Abfrage, pro Bucket, pro Cluster-Metriken oder pro Dokument. Anweisungen finden Sie unter Eine Überwachung erstellen.

3. Erstellen Sie für Triggers (Auslöser) einen oder mehrere Auslöser. Anweisungen finden Sie unter Auslöser erstellen.

4. Legen Sie für Actions (Aktionen) einen Benachrichtigungskanal für die Warnung fest. Wählen Sie zwischen Slack, Amazon Chime, einem benutzerdefinierten Webhook oder Amazon SNS. Wie Sie sich vorstellen können, erfordern Benachrichtigungen eine Verbindung zum Kanal. Beispielsweise muss deine OpenSearch Service-Domain in der Lage sein, eine Verbindung zum Internet herzustellen, um einen Slack-Channel zu benachrichtigen oder einen benutzerdefinierten Webhook an einen Server eines Drittanbieters zu senden. Der benutzerdefinierte Webhook muss eine öffentliche IP-Adresse haben, damit eine OpenSearch Service-Domain Benachrichtigungen an ihn senden kann.

   Tipp

   Nachdem eine Aktion erfolgreich eine Nachricht gesendet hat, liegt die Zusicherung des Zugriffs auf diese Nachricht (z. B. den Zugriff auf einen Slack-Kanal) in Ihrer Verantwortung. Wenn Ihre Domain sensible Daten enthält, sollten Sie Auslöser ohne Aktionen verwenden und Dashboards regelmäßig auf Warnungen prüfen.

Benachrichtigungen

Alerting ist in Notifications integriert, ein einheitliches System für OpenSearch Benachrichtigungen. Mit Benachrichtigungen können Sie konfigurieren, welchen Kommunikationsservice Sie verwenden möchten, und relevante Statistiken und Informationen zur Fehlerbehebung anzeigen. Eine umfassende Dokumentation finden Sie in der OpenSearch Dokumentation unter Benachrichtigungen.

Auf Ihrer Domain muss OpenSearch Version 2.3 oder höher ausgeführt werden, um Benachrichtigungen verwenden zu können.

Anmerkung

OpenSearch Benachrichtigungen sind unabhängig von OpenSearch Dienstbenachrichtigungen, die Einzelheiten zu Service-Software-Updates, Auto-Tune-Verbesserungen und anderen wichtigen Informationen auf Domänenebene enthalten. OpenSearch Benachrichtigungen sind Plugin-spezifisch.

Benachrichtigungskanäle haben ab Version 2.0 die Benachrichtigungsziele ersetzt. OpenSearch Ziele wurden offiziell als veraltet eingestuft und alle Warnmeldungen werden künftig über Kanäle verwaltet.

Wenn Sie Ihre Domains auf Version 2.3 oder höher aktualisieren (da die OpenSearch Serviceunterstützung für 2.x mit 2.3 beginnt), werden Ihre vorhandenen Ziele automatisch auf Benachrichtigungskanäle migriert. Wenn ein Ziel nicht migriert werden kann, wird es vom Monitor weiterhin verwendet, bis der Monitor zu einem Benachrichtigungskanal migriert wird. Weitere Informationen finden Sie in der Dokumentation unter Fragen zu Zielen. OpenSearch

Um mit Benachrichtigungen zu beginnen, melden Sie sich bei OpenSearch Dashboards an und wählen Sie Benachrichtigungen, Kanäle und Kanal erstellen aus.

Amazon Simple Notification Service (Amazon SNS) ist ein unterstützter Kanaltyp für Benachrichtigungen. Um Benutzer zu authentifizieren, müssen Sie dem Benutzer entweder vollen Zugriff auf Amazon SNS gewähren oder ihn eine IAM-Rolle übernehmen lassen, die Berechtigungen für den Zugriff auf Amazon SNS hat. Anweisungen finden Sie unter Amazon SNS als Kanaltyp.

Unterschiede

Im Vergleich zur Open-Source-Version von OpenSearch weist die Alarmierung in Amazon OpenSearch Service einige bemerkenswerte Unterschiede auf.

Warneinstellungen

OpenSearch Mit Service können Sie die folgenden Alarmeinstellungen ändern:

• plugins.scheduled_jobs.enabled

• plugins.alerting.alert_history_enabled

• plugins.alerting.alert_history_max_age

• plugins.alerting.alert_history_max_docs

• plugins.alerting.alert_history_retention_period

• plugins.alerting.alert_history_rollover_period

• plugins.alerting.filter_by_backend_roles

Alle anderen Einstellungen verwenden die Standardwerte, die Sie nicht ändern können.

Um Warnungen zu deaktivieren, senden Sie die folgende Anforderung:

PUT _cluster/settings
{
  "persistent" : {
    "plugins.scheduled_jobs.enabled" : false
  }
}

Mit der folgenden Anforderung werden Benachrichtigungen so konfiguriert, dass Verlaufsindizes automatisch nach sieben Tagen und nicht nach den standardmäßigen 30 Tagen gelöscht werden:

PUT _cluster/settings
{
  "persistent": {
    "plugins.alerting.alert_history_retention_period": "7d"
  }
}

Wenn Sie zuvor Monitore erstellt haben und die Erstellung von Indizes für tägliche Warnmeldungen beenden möchten, löschen Sie alle Indizes für den Warnungsverlauf:

DELETE .plugins-alerting-alert-history-*

Um die Anzahl der Shards für Verlaufsindizes zu reduzieren, erstellen Sie eine Indexvorlage. Die folgende Anforderung legt Verlaufsindizes für Warnungen auf einen Shard und ein Replikat fest:

PUT _index_template/template-name
{
  "index_patterns": [".opendistro-alerting-alert-history-*"],
  "template": {
    "settings": {
      "number_of_shards": 1,
      "number_of_replicas": 1
    }
  }
}

Abhängig von Ihrer Toleranz für Datenverlust können Sie sogar die Verwendung von Null-Replikaten in Erwägung ziehen. Weitere Informationen zum Erstellen und Verwalten von Indexvorlagen finden Sie in der OpenSearch Dokumentation unter Indexvorlagen.