View a markdown version of this page

Erfassen Sie Alarme von APMs mit direkter Amazon SNS-Integration - AWS-Benutzerhandbuch zur Erkennung und Reaktion von Vorfällen
Option 1: Verwenden CloudFormationOption 2: Manuelle Integration

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Erfassen Sie Alarme von APMs mit direkter Amazon SNS-Integration

Wenn Ihr APM das Senden von Alarmen an Amazon SNS-Themen unterstützt, können Sie dieser Anleitung folgen, um Ihre APM-Alarme in AWS Incident Detection and Response zu integrieren.

Sie können die bereitgestellte CloudFormation Vorlage bereitstellen oder diese Integration manuell einrichten. Stellen Sie vor dem Einrichten der Integration sicher, dass die AWS Service-Linked Role (SLR) AWSServiceRoleForHealth_EventProcessor in Ihren Konten erstellt wurde.

Option 1: Verwenden CloudFormation

Eine CloudFormation Vorlage ist verfügbar, um den Prozess der Erstellung der Integrationsinfrastruktur zu vereinfachen, die erforderlich ist, um Alarme von Ihrem APM mit Amazon SNS-Integration in AWS Incident Detection and Response aufzunehmen.

Anmerkung

  • Zusätzliche Kosten fallen für Ressourcen an, die über diese CloudFormation Vorlage bereitgestellt werden (z. B. Lambda und). EventBridge Weitere Informationen zur Preisgestaltung dieser Dienste finden Sie unter AWS Preisgestaltung.

  • Diese CloudFormation Vorlage muss in jedem AWS Konto und jeder Region bereitgestellt werden, aus der Alarme von AWS Incident Detection and Response aufgenommen werden müssen.

  • Die Beispiele in diesem Dokument beziehen sich auf Grafana. Diese Vorlage kann jedoch für jedes APM verwendet werden, das eine direkte Integration mit Amazon Simple Notification Service hat.

  • Aus Sicherheitsgründen AWS empfiehlt, logger.info() Anweisungen aus dem zu entfernen, TransformLambdaFunction um zu verhindern, dass die Payload in Amazon Logs protokolliert wird. CloudWatch

Voraussetzungen für die Bereitstellung dieser CloudFormation Vorlage:

  • Für den Empfang von Alarmereignissen von Ihrem APM muss ein Standardthema für Amazon Simple Notification Service erstellt werden. Erstellen Sie ein SNS-Thema in der Amazon Simple Notification Service-Konsole.

  • Der TransformLambdaFunction in der Vorlage muss so geändert werden, dass er je ["detail"]["incident-detection-response-identifier"] nach verwendetem APM auf den gewünschten Wert eingestellt wird.

Voraussetzung für den Abschluss:

  1. Öffnen Sie die Amazon SNS-Konsole und wählen Sie dann Themen aus. Kopieren Sie den ARN des Amazon SNS-Standardthemas, das für den Empfang von Alarmereignissen von Ihrem APM erstellt wurde.

    • Beispiel: arn:aws:sns:eu-west-1:012345678912:<your-apm-name>-sns

  2. Laden Sie die Vorlage herunter und öffnen Sie sie CloudFormation

    • Suchen Sie das TransformLambdaFunction in der Vorlage

      • Unter event["detail"]["incident-detection-response-identifier"] auf den JSON-Pfad def lambda_handler(event, context) gesetzt, in dem der Alarmname in der JSON-Nutzlast des SNS-Eintrags erscheint.

        • Jedes Ereignis, das TransformLambdaFunction über SNS an den Server gesendet wird, hat eine übergeordnete Nutzlaststruktur als. event["Records"][n]["Sns"]["Message"] Der eigentliche Ursprung der Nutzdaten aus der Quelle (APM) ist in die übergeordnete Struktur eingebettet.

        • Beispiel für Grafana: event["Records"][n]["Sns"]["Message"]["alerts"][n]["labels"]["alertname"]

Bereitstellung der CloudFormation Vorlage:

  1. Navigieren Sie zur CloudFormation Konsole in dem Konto und der Region, in der Sie die Integration einrichten möchten.

  2. Navigiere zu CloudFormation.

    • Wählen Sie Stapel erstellen, Mit neuen Ressourcen (Standard)

      • Wählen Sie „Bestehende Vorlage auswählen“, „Eine Vorlagendatei hochladen“, „Datei auswählen“ und laden Sie dann die lokal gespeicherte CloudFormation Vorlage hoch.

  3. Geben Sie die Stack-Details an:

    • Geben Sie einen Stacknamen ein. Beispiel: <your-apm-name>IntegrationForIDR

    • Geben Sie die Parameterwerte an, die Sie bei der Fertigstellung der Voraussetzungen erhalten haben

      • APMNameParameterBeispiel: Grafana

      • TriggerSNSsParter-Beispiel: arn:aws:sns:eu-west-1:012345678912:<your-apm-name>-sns

    • Wählen Sie Weiter aus.

  4. Konfigurieren Sie die Stack-Optionen:

    • Scrollen Sie zum Ende der Seite und bestätigen Sie das Kontrollkästchen, um die Erstellung von IAM-Ressourcen mit benutzerdefinierten Namen CloudFormation zu ermöglichen.

  5. Überprüfen und erstellen

    • Vergewissern Sie sich, dass die Parameterwerte richtig konfiguriert sind, und wählen Sie dann Senden aus.

  6. Der CloudFormation Stack stellt die Ressourcen bereit, die zur Integration Ihrer APM-Ereignisse in AWS Incident Detection and Response erforderlich sind. Warten Sie, bis der CloudFormation Stack-Status CREATE_COMPLETE lautet.

  7. Der CloudFormation Stack erstellt die folgenden Ressourcen unter der Annahme, dass die Beispielwerte in die Parameter für Grafana eingegeben und in der Region ausgeführt wurden. EU-WEST-1

    • CustomEventBus: Grafana-AWSIncidentDetectionResponse-EventBus

    • SNS-Abonnement: arn:aws:sns:eu-west-1:012345678912:grafana-sns: [random_string]

    • TransformLambdaExecutionRole: IDR-TransformLambdaExecutionRole-eu-west-1

    • TransformLambdaFunction: Grafana-AWSIncidentDetectionResponse-Lambda-Transform

    • TransformLambdaPermission GrafanaIntegrationForIDR-TransformLambdaPermission: - [zufällige Zeichenfolge]

Integrationstests

Nachdem der CloudFormation Stack erfolgreich bereitgestellt wurde, können Sie die Integration validieren, indem Sie eine Testnutzlast von Ihrem APM senden. Sobald die Test-Payload von Ihrem APM gesendet wurde:

  1. Navigieren Sie zur Lambda-Konsole und wählen Sie die Funktion aus. APMNameParameter-AWSIncidentDetectionResponse-Lambda-Transform Wählen Sie dann die Registerkarte Monitor.

  2. Ein erfolgreicher Aufruf sollte in den Metrikdiagrammen beobachtet werden.

  3. Wählen Sie CloudWatch Amazon-Protokolle anzeigen aus. Sie können anhand der Protokollereignisse in den Log-Streams überprüfen, ob die von Ihrem APM gesendete Testnutzlast vorhanden ist oder ob Fehler aufgetreten sind.

Weitergabe Ihres Event Bus-ARN an AWS Incident Detection and Response

  1. Navigieren Sie zur EventBridge Amazon-Konsole. Wählen Sie Eventbusse aus.

  2. Notieren Sie den ARN des benutzerdefinierten Event-Busses, der als Teil des CloudFormation Stacks bereitgestellt wird, zum Beispiel:arn:aws:events:eu-west-1:012345678912:event-bus/Grafana-AWSIncidentDetectionResponse-EventBus.

  3. Während des Onboarding-Prozesses erstellt AWS Incident Detection and Response eine verwaltete EventBridge Regel auf diesem benutzerdefinierten Event-Bus, um Ihre APM-Alarme aufzunehmen.

Option 2: Manuelle Integration

Diagramm, das ein Beispiel für eine Integration mit Amazon SNS zeigt.

  1. Öffnen Sie die Amazon SNS-Konsole und erstellen Sie ein Amazon SNS-Standardthema mit dem Namen [apm_name]-sns Empfangen von Alarmereignissen von Ihrem APM. Stellen Sie sicher, dass Sie Standard (nicht FIFO) als Thementyp auswählen. Notieren Sie sich den ARN des erstellten Amazon SNS-Themas.

  2. Führen Sie einen der folgenden Schritte aus:

    • (Empfohlen) Erstellen Sie einen EventBridge benutzerdefinierten Event-Bus mit dem Namen[apm_name]-AWSIncidentDetectionResponse-EventBus.

    • (Alternative) Verwenden Sie den EventBridge Standard-Event-Bus anstelle eines benutzerdefinierten Event-Bus.

    AWS Incident Detection and Response installiert über die AWSServiceRoleForHealth_EventProcessor Spiegelreflexkamera eine verwaltete Regel (AWSHealthEventProcessorEventSource-DO-NOT-DELETE) auf dem benutzerdefinierten oder standardmäßigen Event-Bus. Die Regelquelle ist der benutzerdefinierte oder standardmäßige Event-Bus, das Regelziel ist AWS Incident Detection and Response, und die Regel entspricht dem Muster für die Aufnahme von APM-Ereignissen von Drittanbietern.

  3. Erstellen Sie eine https://docs.aws.amazon.com/lambda/latest/dg/welcome.html Lambda-Funktion mit dem Namen „Transformieren“ Ihrer $YourApmName-AWSIncidentDetectionResponse-LambdaFunction SNS-Payloads.

  4. Legen Sie das SNS-Thema als Auslöser für Ihre Lambda-Funktion fest. $YourApmName-AWSIncidentDetectionResponse-LambdaFunction

    • Suchen Sie auf der Seite „Trigger hinzufügen“ nach „SNS“.

    • Fügen Sie den ARN Ihres speziellen SNS-Themas hinzu, das in Schritt 1 erstellt wurde.

    • Wählen Sie „Hinzufügen“.

  5. Folgen Sie Ihrer APM-Dokumentation, um ein SNS-Ziel für Ihre APM-Payloads einzurichten, die von AWS Incident Detection and Response aufgenommen werden müssen.

AWS Incident Detection and Response installiert eine verwaltete Regel (AWSHealthEventProcessorEventSource-DO-NOT-DELETE) auf dem benutzerdefinierten oder standardmäßigen Event-Bus über die Spiegelreflexkamera. AWSServiceRoleForHealth_EventProcessor Die Regelquelle ist der benutzerdefinierte oder standardmäßige Event-Bus, das Regelziel ist AWS Incident Detection and Response, und die Regel entspricht dem Muster für die Aufnahme von APM-Ereignissen von Drittanbietern.