EventBridge (CloudWatch Ereignisse) für Änderungen des Ausführungsstatus von Step Functions - AWS Step Functions

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.

EventBridge (CloudWatch Ereignisse) für Änderungen des Ausführungsstatus von Step Functions

Amazon EventBridge ist einAWS-Service, mit dessen Hilfe Sie auf Statusänderungen in einemAWSressource. Sie können verwendenAWS Step FunctionsStandard-Workflows mit EventBridge, während Express-Workflows keine Ereignisse ausgeben EventBridgeaus. Es gibt zwei Möglichkeiten, Step Functions Functions-Standard-Workflows mit EventBridgeaus.

Sie können konfigurieren EventBridge Regeln, um auf Ereignisse zu reagieren, die ausgelöst werden, wenn sich der Ausführungsstatus einer Step Functions Functions-Zustandsmaschine ändert. Auf diese Weise haben Sie die Möglichkeit, Ihre Workflows zu überwachen, ohne ständig abfragen zu müssen, indem Sie die DescribeExecution API verwenden. Basierend auf Änderungen bei Zustandsmaschinen-Ausführungen können Sie eine EventBridge Ziel, um neue State-Machine-Ausführungen zu starten, rufenAWS Lambda-Funktionen, veröffentlichen Sie Nachrichten für Amazon Simple Notification Service (Amazon SNS) -Themen und mehr.

Außerdem können Sie einen -Step-Functions-Zustandsautomaten als Ziel in EventBridgeaus. Auf diese Weise können Sie eine Ausführung eines Step Functions Functions-Workflows als Reaktion auf ein Ereignis aus einem anderenAWS-Service.

Weitere Informationen finden Sie im .Amazon EventBridge -Benutzerhandbuchaus.

EventBridge Nutzlasten

Importieren in &S3; EventBridge event kann eine Eingabeeigenschaft in seiner Definition enthalten. Bei einigen Veranstaltungen ist ein EventBridge-Ereignis kann in seiner Definition auch eine Output-Eigenschaft enthalten.

  • Wenn die kombinierte Escape-Eingabe und Escape-Ausgabe gesendet werden an EventBridge überschreitet 248 KB, dann wird die Eingabe ausgeschlossen. Wenn die maskierte Ausgabe 248 KB überschreitet, wird die Ausgabe ebenfalls ausgeschlossen. Dies ist ein Ergebnis der EventBridgeEreigniskontingente.

  • Sie können feststellen, ob eine Nutzlast gekürzt wurde, mit derinputDetailsundoutputDetailsEigenschaften. Weitere Informationen finden Sie im .CloudWatchEventsExecutionDataDetails-Datentypaus.

  • Für Standard-Workflows können Sie die vollständige Eingabe und Ausgabe anzeigen, indem SieDescribeExecutionaus.

  • DescribeExecutionist für Express-Workflows nicht verfügbar. Wenn Sie die vollständige Ein-/Ausgabe sehen möchten, können Sie Ihren Express-Workflow mit einem Standard-Workflow umschließen. Eine weitere Möglichkeit ist die Verwendung von Amazon S3 S3-ARNs. Weitere Informationen zur Verwendung von ARNs finden Sie unterVerwenden Sie Amazon S3 S3-ARNs, anstatt große Nutzlasten zu übergebenaus.

Step Functions Functions-

Es folgen Beispiele der Step Functions Functions-Ereignisse, die Ereignisse an EventBridge:

In jedem Fall bietet der Abschnitt detail in den Ereignisdaten die gleichen Informationen wie die DescribeExecution API. Das Feld status gibt den Status der Ausführung zu dem Zeitpunkt an, zu dem das Ereignis gesendet wurde, je nach ausgelöstem Ereignis werden folgende Status angezeigt: RUNNING, SUCCEEDED, FAILED, TIMED_OUT oder ABORTED.

Ausführung gestartet

{ "version": "0", "id": "315c1398-40ff-a850-213b-158f73e60175", "detail-type": "Step Functions Execution Status Change", "source": "aws.states", "account": "012345678912", "time": "2019-02-26T19:42:21Z", "region": "us-east-1", "resources": [ "arn:aws:states:us-east-1:012345678912:execution:state-machine-name:execution-name" ], "detail": { "executionArn": "arn:aws:states:us-east-1:012345678912:execution:state-machine-name:execution-name", "stateMachineArn": "arn:aws:states:us-east-1:012345678912:stateMachine:state-machine", "name": "execution-name", "status": "RUNNING", "startDate": 1551225271984, "stopDate": null, "input": "{}", "inputDetails": { "included": true }, "output": null, "outputDetails": null } }

Ausführung erfolgreich

{ "version": "0", "id": "315c1398-40ff-a850-213b-158f73e60175", "detail-type": "Step Functions Execution Status Change", "source": "aws.states", "account": "012345678912", "time": "2019-02-26T19:42:21Z", "region": "us-east-1", "resources": [ "arn:aws:states:us-east-1:012345678912:execution:state-machine-name:execution-name" ], "detail": { "executionArn": "arn:aws:states:us-east-1:012345678912:execution:state-machine-name:execution-name", "stateMachineArn": "arn:aws:states:us-east-1:012345678912:stateMachine:state-machine", "name": "execution-name", "status": "SUCCEEDED", "startDate": 1547148840101, "stopDate": 1547148840122, "input": "{}", "inputDetails": { "included": true }, "output": "\"Hello World!\"", "outputDetails": { "included": true } } }

Ausführung fehlgeschlagen

{ "version": "0", "id": "315c1398-40ff-a850-213b-158f73e60175", "detail-type": "Step Functions Execution Status Change", "source": "aws.states", "account": "012345678912", "time": "2019-02-26T19:42:21Z", "region": "us-east-1", "resources": [ "arn:aws:states:us-east-1:012345678912:execution:state-machine-name:execution-name" ], "detail": { "executionArn": "arn:aws:states:us-east-1:012345678912:execution:state-machine-name:execution-name", "stateMachineArn": "arn:aws:states:us-east-1:012345678912:stateMachine:state-machine", "name": "execution-name", "status": "FAILED", "startDate": 1551225146847, "stopDate": 1551225151881, "input": "{}", "inputDetails": { "included": true }, "output": null, "outputDetails": null } }

Zeitüberschreitung für Ausführung überschritten

{ "version": "0", "id": "315c1398-40ff-a850-213b-158f73e60175", "detail-type": "Step Functions Execution Status Change", "source": "aws.states", "account": "012345678912", "time": "2019-02-26T19:42:21Z", "region": "us-east-1", "resources": [ "arn:aws:states:us-east-1:012345678912:execution:state-machine-name:execution-name" ], "detail": { "executionArn": "arn:aws:states:us-east-1:012345678912:execution:state-machine-name:execution-name", "stateMachineArn": "arn:aws:states:us-east-1:012345678912:stateMachine:state-machine", "name": "execution-name", "status": "TIMED_OUT", "startDate": 1551224926156, "stopDate": 1551224927157, "input": "{}", "inputDetails": { "included": true }, "output": null, "outputDetails": null } }

Ausführung abgebrochen

{ "version": "0", "id": "315c1398-40ff-a850-213b-158f73e60175", "detail-type": "Step Functions Execution Status Change", "source": "aws.states", "account": "012345678912", "time": "2019-02-26T19:42:21Z", "region": "us-east-1", "resources": [ "arn:aws:states:us-east-1:012345678912:execution:state-machine-name:execution-name" ], "detail": { "executionArn": "arn:aws:states:us-east-1:012345678912:execution:state-machine-name:execution-name", "stateMachineArn": "arn:aws:states:us-east-1:012345678912:stateMachine:state-machine", "name": "execution-name", "status": "ABORTED", "startDate": 1551225014968, "stopDate": 1551225017576, "input": "{}", "inputDetails": { "included": true }, "output": null, "outputDetails": null } }

Weiterleiten eines Step-Funktions-Ereignisses EventBridge im EventBridge Konsole

Verwenden Sie die folgenden Anweisungen, um zu erfahren, wie Sie die Ausführung einer Step Functions-Zustandsmaschine auslösen, wenn eine bestimmte Step Functions Functions-Zustandsmaschine erfolgreich ausgeführt Sie nutzen das Amazon EventBridge -Konsole, um den Zustandsautomaten anzugeben, dessen Ausführung Sie auslösen möchten.

  1. Auf der-Details-Seite eines Zustandsautomaten, wählen SieAktionenund wählen Sie dann aus.Geben Sie einen Namen für den Benutzer ein und klicken Sie dann auf EventBridge (CloudWatch -Ereignisregelnaus.

    
            Geben Sie einen Namen für den Benutzer ein und klicken Sie dann auf EventBridge -Ereignisregel

    Alternativ öffnen Sie das EventBridge -Konsole beihttps://console.aws.amazon.com/events/aus. Wählen Sie im Navigationsbereich und dann aus.RegelnunterEventsaus.

  2. Wählen Sie Create rule (Regel erstellen).

  3. Geben Sie ein.Namefür Ihre Regel (zum BeispielStepFunctionsEventRule) und geben Sie optional einBeschreibungfür die Regel.

  4. FürEreignisbusundRegeltypverwenden Sie die Standardoption bei.

  5. Wählen Sie Next (Weiter).

  6. UnderEreignisquelleverwenden Sie die Standardoption bei.AWSevents oder EventBridge Partnerveranstaltungenaus.

  7. UnderEreignismusterwie folgt:

    1. In derEreignisquelleDropdown-Liste, behalten Sie die Standardoption bei.AWSDienstleistungenaus.

    2. From dasAWSBedienungDropdown-Liste, wählenSchrittfunktionenaus.

    3. From dasEreignistypDropdown-Liste, wählenStep Functions Functions-Ausführungsstatusaus.

    4. (Optional) Konfigurieren Sie einen bestimmten Status, einen Zustandsautomaten Amazon Resource namen (ARN) oder Ausführungs-ARN. Wählen Sie für dieses Verfahren wählen SieSpezifischer Status (e)und wählen Sie dann aus.GELUNGENaus der Dropdown-Liste.

  8. Wählen Sie Next (Weiter).

  9. Auf derWählen Sie Ziel (s)die Standardoption bei.AWSBedienungaus.

  10. From dasWählen Sie ein Ziel ausDrop-Down-Liste, wählen Sie einAWS-Service. Beispiel: Sie könnten eine Lambda-Funktion oder einen -Step-Functions-Zustandsautomaten ausführen. Wählen Sie für dieses Verfahren wählen SieStep Functions Functions-aus.

  11. From dasState Machine (Zustandsautomat)einen Zustandsautomaten aus.

  12. UnderAusführungsrolleverwenden Sie die Standardoption bei.Erstellen Sie eine neue Rolle für diese bestimmte -Ressourceaus.

  13. Klicken Sie aufWeiterund wählen Sie dann aus.Weiter.

  14. Auf derÜberprüfen und erstellendie Details der Regel und wählen Sie dann aus.Regel erstellenaus.

    Die Regel wird erstellt und dieRegelnwird angezeigt und listet alle Amazon EventBridge Regeln.