Tutorial: Amazon S3 S3-Operationen auf Objektebene protokollieren mit EventBridge - Amazon EventBridge
Schritt 1: Konfiguriere deinen Trail AWS CloudTrailSchritt 2: Erstellen einer AWS Lambda -FunktionSchritt 3: Erstellen einer RegelSchritt 4: Testen der RegelSchritt 5: Bestätigen des ErfolgsSchritt 6: Bereinigen Ihrer Ressourcen

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.

Tutorial: Amazon S3 S3-Operationen auf Objektebene protokollieren mit EventBridge

Sie können die API Operationen auf Objektebene in Ihren Amazon S3 S3-Buckets protokollieren. Bevor Amazon diese Ereignisse zuordnen EventBridge kann, AWS CloudTrailmüssen Sie einen Trail einrichten und konfigurieren, um diese Ereignisse zu empfangen.

In diesem Tutorial erstellen Sie einen CloudTrail Trail, eine AWS LambdaFunktion und anschließend eine Regel in der EventBridge Konsole, die diese Funktion als Reaktion auf ein S3-Datenereignis aufruft.

Schritt 1: Konfiguriere deinen Trail AWS CloudTrail

Um Datenereignisse für einen S3-Bucket in AWS CloudTrail und zu protokollieren EventBridge, erstellen Sie zunächst einen Trail. Ein Trail erfasst API Anrufe und zugehörige Ereignisse in Ihrem Konto und übermittelt dann die Protokolldateien an einen von Ihnen angegebenen S3-Bucket. Sie können einen vorhandenen Trail aktualisieren oder einen Trail erstellen.

Weitere Informationen finden Sie unter Datenereignisse im Benutzerhandbuch für AWS CloudTrail .

Sie erstellen einen Trail wie folgt:

  1. Öffnen Sie die CloudTrail Konsole unter https://console.aws.amazon.com/cloudtrail/.

  2. Wählen Sie Trails, Create trail (Trail erstellen).

  3. Geben Sie unter Trail name einen Namen für den Trail ein.

  4. Wählen Sie für Speicherort die Option Neuen S3-Bucket erstellen aus.

  5. Geben Sie AWS KMS unter Alias einen Alias für den KMS Schlüssel ein.

  6. Wählen Sie Weiter aus.

  7. Wählen Sie für Ereignistyp die Option Datenereignisse aus.

  8. Führen Sie für Datenereignisse eine der folgenden Aktionen aus:

    • Um Datenereignisse für alle Amazon S3-Objekte in einem Bucket zu protokollieren, geben Sie einen S3-Bucket und ein leeres Präfix an. Wenn ein Ereignis auf einem Objekt in diesem -Bucket eintritt, wird das Ereignis vom Trail verarbeitet und protokolliert.

    • Geben Sie einen S3-Bucket und das Objektpräfix an, um Datenereignisse für bestimmte Amazon-S3-Objekte in einem Bucket zu protokollieren. Tritt ein Ereignis auf einem Objekt in dem -Bucket auf und das Objekt beginnt mit dem angegebenen Präfix, wird das Ereignis vom Trail verarbeitet und protokolliert.

  9. Wählen Sie für jede Ressource aus, ob Lese-Ereignisse, Schreib-Ereignisse oder beide protokolliert werden sollen.

  10. Wählen Sie Weiter aus.

  11. Wählen Sie Create Trail (Trail erstellen) aus.

Schritt 2: Erstellen einer AWS Lambda -Funktion

Erstellen Sie eine Lambda-Funktion, um Datenereignisse für die S3 Buckets zu protokollieren.

Eine Lambda-Funktion erstellen

  1. Öffnen Sie die AWS Lambda Konsole unter https://console.aws.amazon.com/lambda/.

  2. Wählen Sie Funktion erstellen.

  3. Wählen Sie Von Grund auf neu schreiben aus.

  4. Geben Sie einen Namen und eine Beschreibung für die Lambda-Funktion ein. Geben Sie der Funktion beispielsweise den Namen LogS3DataEvents.

  5. Behalten Sie die übrigen Optionen als Standardwerte bei und wählen Sie Funktion erstellen aus.

  6. Doppelklicken Sie auf der Registerkarte Code der Funktionsseite auf index.js.

  7. Ersetzen Sie den vorhandenen Code mit folgendem Code.

    'use strict';

exports.handler = (event, context, callback) => {
    console.log('LogS3DataEvents');
    console.log('Received event:', JSON.stringify(event, null, 2));
    callback(null, 'Finished');
};

  8. Wählen Sie Bereitstellen.

Schritt 3: Erstellen einer Regel

Erstellen Sie eine Regel, um die Lambda-Funktion auszuführen, die Sie in Schritt 2 erstellt haben. Diese Regel wird als Antwort auf ein Amazon-S3-Datenereignis ausgeführt.

So erstellen Sie eine Regel

  1. Öffnen Sie die EventBridge Amazon-Konsole unter https://console.aws.amazon.com/events/.

  2. Wählen Sie im Navigationsbereich Rules aus.

  3. Wählen Sie Regel erstellen aus.

  4. Geben Sie einen Namen und eine Beschreibung für die Regel ein. Nennen Sie die Regel beispielsweise TestRule.

  5. Wählen Sie für Event Bus den Event Bus aus, den Sie dieser Regel zuordnen möchten. Wenn Sie möchten, dass diese Regel mit Ereignissen aus Ihrem eigenen Konto übereinstimmt, wählen Sie Standard aus. Wenn ein AWS -Service in Ihrem Konto ein Ereignis ausgibt, wird es stets an den Standard-Event-Bus Ihres Kontos weitergeleitet.

  6. Bei Rule type (Regeltyp) wählen Sie Rule with an event pattern (Regel mit einem Ereignismuster) aus.

  7. Wählen Sie Weiter aus.

  8. Als Event source (Ereignisquelle) wählen Sie AWS -Services aus.

  9. Gehen Sie bei Event pattern (Ereignismuster) wie folgt vor:

    1. Wählen Sie für Ereignisquelle die Option Simple Storage Service (S3) aus der Dropdown-Liste aus.

    2. Wählen Sie als Ereignistyp aus der Drop-down-Liste die Option API Aufruf auf Objektebene über CloudTrail aus.

    3. Wählen Sie Bestimmte Operation (en) und wählen Sie dann. PutObject

    4. Standardmäßig gilt die Regel für Datenereignisse in allen Buckets in der Region. Damit die Datenereignisse für bestimmte Buckets gelten, wählen Sie Specify bucket(s) by name (Bucket(s) nach Name angeben) aus und geben dann einen oder mehrere Buckets ein.

  10. Wählen Sie Weiter aus.

  11. Bei Target types (Zieltypen) wählen Sie AWS -Service aus.

  12. Wählen Sie für Ziel auswählen die Option Lambda-Funktion aus der Dropdown-Liste aus.

  13. Wählen Sie für Funktion die LogS3DataEvents-Lambda-Funktion aus, die Sie in Schritt 1 erstellt haben.

  14. Wählen Sie Weiter.

  15. Wählen Sie Weiter.

  16. Überprüfen Sie die Details der Regel und wählen Sie dann Create rule (Regel erstellen) aus.

Schritt 4: Testen der Regel

Um die Regel zu testen, fügen Sie ein Objekt in Ihrem S3-Bucket ein. Sie können überprüfen, ob die Lambda-Funktion aufgerufen wurde.

So zeigen Sie die Protokolle für die Lambda-Funktion an

  1. Öffnen Sie die CloudWatch Konsole unter https://console.aws.amazon.com/cloudwatch/.

  2. Wählen Sie im Navigationsbereich Protokolle aus.

  3. Wählen Sie den Namen der Protokollgruppe für Ihre Lambda-Funktion aus (/aws/lambda/function-name).

  4. Wählen Sie den Namen des Protokoll-Streams aus, um die von der Funktion für die von Ihnen gestartete Instance bereitgestellten Daten anzuzeigen.

Sie können Ihre CloudTrail Logs auch in dem S3-Bucket überprüfen, den Sie für Ihren Trail angegeben haben. Weitere Informationen finden Sie im AWS CloudTrail Benutzerhandbuch unter Abrufen und Anzeigen Ihrer CloudTrail Protokolldateien.

Schritt 5: Bestätigen des Erfolgs

Wenn Sie das Lambda-Ereignis in den CloudWatch Protokollen sehen, haben Sie dieses Tutorial erfolgreich abgeschlossen. Wenn das Ereignis nicht in Ihren CloudWatch Protokollen enthalten ist, beginnen Sie mit der Fehlerbehebung, indem Sie überprüfen, ob die Regel erfolgreich erstellt wurde. Wenn die Regel korrekt aussieht, überprüfen Sie, ob der Code Ihrer Lambda-Funktion korrekt ist.

Schritt 6: Bereinigen Ihrer Ressourcen

Sie können jetzt die Ressourcen, die Sie für dieses Tutorial erstellt haben, löschen, es sei denn, Sie möchten sie behalten. Indem Sie AWS Ressourcen löschen, die Sie nicht mehr verwenden, verhindern Sie, dass Ihr AWS Konto unnötig belastet wird.

Um die EventBridge Regel (n) zu löschen

  1. Öffnen Sie die Seite Regeln der EventBridge Konsole.

  2. Wählen Sie die Regel(n) aus, die Sie erstellt haben.

  3. Wählen Sie Delete (Löschen).

  4. Wählen Sie Delete (Löschen).

So löschen Sie die Lambda-Funktion(en)

  1. Öffnen Sie die Seite Funktionen der Lambda-Konsole.

  2. Wählen Sie die Funktion(en) aus, die Sie erstellt haben.

  3. Wählen Sie Aktionen, Löschen aus.

  4. Wählen Sie Delete (Löschen) aus.

Um die CloudTrail Spur (en) zu löschen

  1. Öffnen Sie die Trails-Seite der CloudTrail Konsole.

  2. Wählen Sie den/die Trail(s) aus, den/die Sie erstellt haben.

  3. Wählen Sie Delete (Löschen).

  4. Wählen Sie Löschen.