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.
Bewährte Methoden für Step Functions
Erfahren Sie mehr Übergeben von Daten zwischen Staaten mit Variablen und Daten mit JSonata transformieren.
Die folgenden Themen sind bewährte Methoden, die Ihnen bei der Verwaltung und Optimierung Ihrer Step Functions-Workflows helfen.
Liste der bewährten Methoden
Taggen von Zustandsautomaten und Aktivitäten in Step Functions
Verwenden Sie Timeouts, um festsitzende Step Functions-Workflow-Ausführungen zu vermeiden
Verwenden Sie Amazon S3-ARNs, anstatt große Nutzlasten in Step Functions zu übergeben
Vermeidung von Latenzen bei der Abfrage von Aktivitätsaufgaben
Vermeiden CloudWatch Größenbeschränkungen im Rahmen der Ressourcenpolitik
Kostenoptimierung mithilfe von Express Workflows
Step Functions bestimmt die Preise für Standard- und Express-Workflows auf der Grundlage des Workflowtyps, den Sie für die Erstellung Ihrer State Machines verwenden. Um die Kosten Ihrer serverlosen Workflows zu optimieren, können Sie eine oder beide der folgenden Empfehlungen befolgen:
Informationen dazu, wie sich die Wahl eines Standard- oder Express-Workflowtyps auf die Abrechnung auswirkt, finden Sie unter AWS Step Functions Preisgestaltung
Nest Express-Workflows innerhalb von Standard-Workflows
Step Functions führt Workflows aus, die eine begrenzte Dauer und Anzahl von Schritten haben. Einige Workflows können die Ausführung innerhalb kurzer Zeit abschließen. Andere erfordern möglicherweise eine Kombination aus Workflows mit langer Laufzeit und Workflows mit hoher Ereignisrate. Mit Step Functions können Sie große, komplexe Workflows aus mehreren kleineren, einfacheren Workflows erstellen.
Um beispielsweise einen Workflow für die Auftragsabwicklung zu erstellen, können Sie alle Aktionen, die nicht idemwirksam sind, in einen Standard-Workflow einbeziehen. Dies könnte Aktionen wie die Genehmigung von Bestellungen durch menschliche Interaktion und die Verarbeitung von Zahlungen beinhalten. Anschließend können Sie eine Reihe idempotenter Aktionen, wie das Senden von Zahlungsbenachrichtigungen und das Aktualisieren des Produktbestands, in einem Express-Workflow kombinieren. Sie können diesen Express-Workflow innerhalb des Standard-Workflows verschachteln. In diesem Beispiel ist der Standard-Workflow bekannt als übergeordneter Zustandsmaschine. Der verschachtelte Express-Workflow ist bekannt als untergeordneter Zustandsmaschine.
Migrieren Sie Standard-Workflows zu Express-Workflows
Sie sollten erwägen, Ihre Standard-Workflows zu Express-Workflows zu migrieren, wenn diese die folgenden Anforderungen erfüllen:
-
Ihr Workflow muss innerhalb von fünf Minuten abgeschlossen sein.
-
Ihr Arbeitsablauf entspricht einer mindestens einmal Ausführungsmodell, was bedeutet, dass jeder Schritt im Workflow mehr als genau einmal ausgeführt werden kann.
-
Ihr Arbeitsablauf tut nicht benutze den
.waitForTaskTokenoder.syncMuster der Serviceintegration.
Express-Workflows verwenden Amazon CloudWatch Protokolle zur Aufzeichnung von Ausführungsverläufen. Bei der Nutzung entstehen Ihnen zusätzliche Kosten CloudWatch Protokolle.
Um einen Standard-Workflow mithilfe der Konsole zu einem Express-Workflow zu migrieren
-
Öffnen Sie das Konsole „Step Functions“
. -
Auf der Staatliche Maschinen Seite, wählen Sie eine Zustandsmaschine vom Typ Standard, um sie zu öffnen.
TippAus dem Irgendein Typ Drop-down-Liste, wählen Standard um die Liste der Zustandsmaschinen zu filtern und nur Standard-Workflows anzuzeigen.
-
Wählen Sie In neue kopieren aus.
Workflow Studio wird geöffnet in Entwurfsmodus zeigt den Arbeitsablauf der von Ihnen ausgewählten Zustandsmaschine an.
-
(Optional) Aktualisieren Sie das Workflow-Design.
-
Geben Sie einen Namen für Ihre Zustandsmaschine an. Wählen Sie dazu das Bearbeitungssymbol neben dem Standard-State-Machine-Namen von MyStateMachine. Dann, in Konfiguration der Zustandsmaschine, geben Sie einen Namen in der Geben Sie den Computernamen an Kiste.
-
(Fakultativ) In Konfiguration der Zustandsmaschine, geben Sie andere Workflow-Einstellungen an, z. B. den Typ der Zustandsmaschine und ihre Ausführungsrolle.
Stellen Sie sicher, dass Typ, du wählst Express. Lassen Sie alle anderen Standardauswahlen aktiviert State-Machine-Einstellungen.
AnmerkungWenn Sie einen Standard-Workflow migrieren, der zuvor in definiert wurde AWS CDK oder AWS SAM, Sie müssen den Wert von ändern
TypeundResourceName. -
In der Bestätigen Sie die Rollenerstellung Dialogfeld, wählen Sie Bestätigen um fortzufahren.
Sie können auch wählen Rolleneinstellungen anzeigen um zurück zu gehen Konfiguration der Zustandsmaschine.
AnmerkungWenn Sie die von Step Functions erstellte IAM-Rolle löschen, kann Step Functions sie später nicht erneut erstellen. Ebenso kann Step Functions die ursprünglichen Einstellungen später nicht wiederherstellen, wenn Sie die Rolle ändern (z. B. indem Sie Step Functions aus den Principals in der IAM-Richtlinie entfernen).
Weitere Informationen zu bewährten Methoden und Richtlinien für die Kostenoptimierung Ihrer Workflows finden Sie unter Kostengünstiges Bauen AWS Step Functions Workflows
Taggen von Zustandsautomaten und Aktivitäten in Step Functions
AWS Step Functions unterstützt das Taggen von Zustandsautomaten (sowohl Standard als auch Express) und Aktivitäten. Mithilfe von Tags können Sie Ihre Ressourcen nachverfolgen und verwalten und sorgen für mehr Sicherheit in Ihrem AWS Identity and Access Management (IAM) -Richtlinien. Nachdem Sie die Ressourcen von Step Functions mit Tags versehen haben, können Sie sie wie folgt verwalten AWS -Ressourcengruppen. Wie das geht, erfahren Sie im AWS -Ressourcengruppen Benutzerleitfaden.
Bei der Tag-basierten Autorisierung erben die Ressourcen zur Ausführung von Zustandsmaschinen, wie im folgenden Beispiel gezeigt, die Tags, die einer Zustandsmaschine zugeordnet sind.
arn:partition:states:region:account-id:execution:<StateMachineName>:<ExecutionId>
Wenn Sie anrufen DescribeExecution oder andere APIs, in denen Sie den ARN der Ausführungsressource angeben, verwendet Step Functions Tags, die der Zustandsmaschine zugeordnet sind, um die Anforderung anzunehmen oder abzulehnen, während eine tagbasierte Autorisierung durchgeführt wird. Auf diese Weise können Sie den Zugriff auf State-Machine-Ausführungen auf State-Machine-Ebene zulassen oder verweigern.
Weitere Informationen zu Einschränkungen in Bezug auf das Markieren von Ressourcen finden Sie unter Einschränkungen im Zusammenhang mit dem Taggen.
Markieren für die Kostenzuordnung
Mithilfe von Tags zur Kostenzuweisung können Sie den Zweck eines Zustandsautomaten identifizieren und diese Organisation in Ihrem System widerspiegeln AWS Rechnung. Melde dich an, um deine zu erhalten AWS Kontorechnung mit den Tag-Schlüsseln und -Werten. siehe Einen monatlichen Kostenzuordnungsbericht einrichten in der AWS Billing Benutzerleitfaden für Einzelheiten zum Einrichten von Berichten.
Sie könnten beispielsweise wie folgt Stichwörter hinzufügen, die Ihre Kostenstelle und den Zweck Ihrer Step Functions-Ressourcen darstellen.
| Ressource | Schlüssel | Value (Wert) |
|---|---|---|
StateMachine1 |
Cost Center |
34567 |
Application |
Image processing |
|
StateMachine2 |
Cost Center |
34567 |
Application |
Rekognition processing |
Markieren für-Sicherheit
IAM unterstützt die Steuerung des Zugriffs auf Ressourcen anhand von Stichwörtern. Um den Zugriff anhand von Stichwörtern zu steuern, geben Sie im Bedingungselement einer IAM-Richtlinie Informationen zu Ihren Ressourcen-Tags an.
Beispielsweise könnten Sie den Zugriff auf alle Step Functions-Ressourcen einschränken, die ein Tag mit dem Schlüssel enthalten environment und der Wert production.
-
{ "Version":"2012-10-17", "Statement": [ { "Effect": "Deny", "Action": [ "states:TagResource", "states:DeleteActivity", "states:DeleteStateMachine", "states:StopExecution" ], "Resource": "*", "Condition": { "StringEquals": {"aws:ResourceTag/environment": "production"} } } ] }
Weitere Informationen finden Sie unter Zugriffssteuerung mit Tags im IAM-Benutzerhandbuch.
Verwaltung von Tags in der Step Functions-Konsole
Sie können die Tags für Ihre State Machines in der Step Functions-Konsole anzeigen und verwalten. Wählen Sie auf der Seite Details eines Zustandsautomaten die Option Tags aus.
Verwaltung von Tags mit den API-Aktionen von Step Functions
Verwenden Sie die folgenden API-Aktionen, um Tags mithilfe der Step Functions-API zu verwalten:
Verwenden Sie Timeouts, um festsitzende Step Functions-Workflow-Ausführungen zu vermeiden
Standardmäßig spezifiziert die Amazon States Language keine Timeouts für State-Machine-Definitionen. Ohne einen expliziten Timeout verlässt sich Step Functions oft ausschließlich auf die Antwort eines Aktivitätsarbeiters, um zu erfahren, dass eine Aufgabe abgeschlossen ist. Wenn etwas schief geht und TimeoutSeconds Das Feld ist nicht für eine Aktivität oder für eine Aufgabe angegeben, die auf eine .sync Job oder ein .waitForTaskToken Callback, eine Ausführung steckt fest und wartet auf eine Antwort, die niemals kommen wird. Für Request Response-Aufgaben gilt standardmäßig ein Timeout. Weitere Informationen finden Sie unter Timeouts für Request Response-Aufgaben.
Um diese Situation zu vermeiden, geben Sie beim Erstellen eines Task in Ihrer Zustandsmaschine. Beispiel:
"ActivityState": { "Type": "Task", "Resource": "arn:aws:states:region:account-id:activity:HelloWorld", "TimeoutSeconds": 300, "Next": "NextState" }
Wenn Sie eine verwenden Rückruf mit einem Task-Token (.waitForTaskToken), wir empfehlen Ihnen, Heartbeats zu verwenden und das hinzuzufügen HeartbeatSeconds Feld in Ihrem Task Definition des Bundesstaats. Sie können einstellen HeartbeatSeconds muss kleiner als das Task-Timeout sein. Wenn Ihr Workflow also aufgrund eines Heartbeat-Fehlers fehlschlägt, wissen Sie, dass dies am Fehlschlag der Aufgabe liegt und nicht daran, dass die Aufgabe lange dauert, bis sie abgeschlossen ist.
{ "StartAt": "Push to SQS", "States": { "Push to SQS": { "Type": "Task", "Resource": "arn:aws:states:::sqs:sendMessage.waitForTaskToken", "HeartbeatSeconds": 600, "Parameters": { "MessageBody": { "myTaskToken.$": "$$.Task.Token" }, "QueueUrl": "https://sqs.us-east-1.amazonaws.com/account-id/push-based-queue" }, "ResultPath": "$.SQS", "End": true } } }
Weitere Informationen finden Sie unter Workflow-Status der Aufgabe in der Amazon States Language-Dokumentation.
Sie können einen Timeout für Ihren State Machine festlegen, indem Sie den TimeoutSeconds Feld in Ihrer Sprachdefinition für Amazon States. Weitere Informationen finden Sie unter Zustandsmaschinenstruktur in Amazon States Language für Step Functions Functions-Workflows.
Verwenden Sie Amazon S3-ARNs, anstatt große Nutzlasten in Step Functions zu übergeben
Ausführungen, die große Datennutzlasten zwischen Zuständen übergeben, können beendet werden. Wenn die Daten, die Sie zwischen Bundesstaaten weitergeben, auf über 256 KiB anwachsen könnten, verwenden Sie Amazon Simple Storage Service (Amazon S3), um die Daten zu speichern, und analysieren Sie den Amazon-Ressourcennamen (ARN) des Buckets im Payload Parameter, um den Bucket-Namen und den Schlüsselwert abzurufen. Alternativ passen Sie Ihre Implementierung an, sodass Sie in Ihren Ausführungen kleinere Nutzlasten übergeben.
Im folgenden Beispiel übergibt eine Zustandsmaschine Eingaben an eine AWS Lambda Funktion, die eine JSON-Datei in einem Amazon S3-Bucket verarbeitet. Nachdem Sie diesen Zustandsmaschine ausgeführt haben, liest die Lambda-Funktion den Inhalt der JSON-Datei und gibt den Dateiinhalt als Ausgabe zurück.
So erstellen Sie die Lambda-Funktion:
Die folgende Lambda-Funktion heißt liest den Inhalt einer JSON-Datei, die in einem bestimmten Amazon S3-Bucket gespeichert ist.pass-large-payload
Nachdem Sie diese Lambda-Funktion erstellt haben, stellen Sie sicher, dass Sie ihrer IAM-Rolle die entsprechende Berechtigung zum Lesen aus einem Amazon S3-Bucket gewähren. Hängen Sie beispielsweise das an AmazonS3ReadOnlyAccess Genehmigung für die Rolle der Lambda-Funktion.
import json import boto3 import io import os s3 = boto3.client('s3') def lambda_handler(event, context): event = event['Input'] final_json = str() s3 = boto3.resource('s3') bucket = event['bucket'].split(':')[-1] filename = event['key'] directory = "/tmp/{}".format(filename) s3.Bucket(bucket).download_file(filename, directory) with open(directory, "r") as jsonfile: final_json = json.load(jsonfile) os.popen("rm -rf /tmp") return final_json
Erstellen Sie die Zustandsmaschine
Die folgende Zustandsmaschine ruft die Lambda-Funktion auf, die Sie zuvor erstellt haben.
{ "StartAt":"Invoke Lambda function", "States":{ "Invoke Lambda function":{ "Type":"Task", "Resource":"arn:aws:states:::lambda:invoke", "Parameters":{ "FunctionName":"arn:aws:lambda:us-east-2:123456789012:function:pass-large-payload", "Payload":{ "Input.$":"$" } }, "OutputPath": "$.Payload", "End":true } } }
Anstatt eine große Datenmenge in der Eingabe zu übergeben, könnten Sie diese Daten in einem Amazon S3-Bucket speichern und den Amazon-Ressourcennamen (ARN) des Buckets in der Payload Parameter, um den Bucket-Namen und den Schlüsselwert abzurufen. Ihre Lambda-Funktion kann dann diesen ARN verwenden, um direkt auf die Daten zuzugreifen. Im Folgenden finden Sie eine Beispieleingabe für die Ausführung der Zustandsmaschine, in der die Daten gespeichert werden data.json in einem Amazon S3-Bucket mit dem Namen .amzn-s3-demo-large-payload-json
{
"key": "data.json",
"bucket": "arn:aws:s3:::amzn-s3-demo-large-payload-json"
}
Neue Ausführungen starten, um zu vermeiden, dass das Verlaufskontingent in Step Functions erreicht wird
AWS Step Functions hat eine feste Quote von 25.000 Einträgen im Ausführungsereignisverlauf. Wenn eine Ausführung 24.999 Ereignisse erreicht, wartet sie darauf, dass das nächste Ereignis eintritt.
-
Wenn die Ereignisnummer 25.000 ist
ExecutionSucceeded, wird die Ausführung erfolgreich abgeschlossen. -
Wenn das Ereignis Nummer 25.000 nicht
ExecutionSucceeded, dasExecutionFailedEreignis wird protokolliert und die Ausführung der Zustandsmaschine schlägt fehl, weil das Verlaufslimit erreicht wird
Um zu vermeiden, dass dieses Kontingent für lang andauernde Ausführungen erreicht wird, können Sie eine der folgenden Problemumgehungen ausprobieren:
-
Verwenden Sie den Kartenstatus im Modus „Verteilt“. In diesem Modus ist der
Mapstate führt jede Iteration als untergeordnete Workflow-Ausführung aus, was eine hohe Parallelität von bis zu 10.000 parallelen untergeordneten Workflow-Ausführungen ermöglicht. Jede Ausführung eines untergeordneten Workflows hat eine eigene, von der des übergeordneten Workflows getrennte Ausführungshistorie. -
Starten Sie eine neue State-Machine-Ausführung direkt von der
TaskStatus einer laufenden Ausführung. Um solche verschachtelten Workflow-Ausführungen zu starten, verwenden Sie „Step Functions“StartExecutionAPI-Aktion in der übergeordneten State-Maschine zusammen mit den erforderlichen Parametern. Weitere Informationen zur Verwendung verschachtelter Workflows finden Sie unter Starten Sie Workflow-Ausführungen von einem Aufgabenstatus aus in Step Functions oder Verwenden einer Step Functions-API-Aktion, um eine neue Ausführung fortzusetzen Tutorial.TippInformationen zum Bereitstellen eines geschachtelten Beispielworkflows finden Sie unter Kosten optimieren
in Das AWS Step Functions Werkstatt. -
Implementieren Sie ein Muster, das eine verwendet AWS Lambda Funktion, die eine neue Ausführung Ihrer Zustandsmaschine starten kann, um die laufende Arbeit auf mehrere Workflow-Ausführungen aufzuteilen. Weitere Informationen finden Sie im Tutorial Verwenden einer Lambda-Funktion, um eine neue Ausführung in Step Functions fortzusetzen.
Behandeln Sie vorübergehende Lambda-Serviceausnahmen
AWS Lambda kann gelegentlich zu vorübergehenden Servicefehlern kommen. In diesem Fall führt das Aufrufen von Lambda zu einem 500-Fehler, z. B. ClientExecutionTimeoutException, ServiceException, AWSLambdaException, oder SdkClientException. Es hat sich bewährt, proaktiv mit diesen Ausnahmen in Ihrem State Machine umzugehen, um Retry Aufrufen Ihrer Lambda-Funktion oder Catch der Fehler.
Lambda-Fehler werden gemeldet als Lambda.. Um einen Lambda-Serviceausnahmefehler erneut zu versuchen, könnten Sie Folgendes verwenden ErrorNameRetry Code.
"Retry": [ { "ErrorEquals": [ "Lambda.ClientExecutionTimeoutException", "Lambda.ServiceException", "Lambda.AWSLambdaException", "Lambda.SdkClientException"], "IntervalSeconds": 2, "MaxAttempts": 6, "BackoffRate": 2 } ]
Unbehandelte Fehler in Lambda-Laufzeiten wurden in der Vergangenheit nur als gemeldet Lambda.Unknown. In neueren Laufzeiten werden Timeouts wie folgt gemeldet Sandbox.Timedout in der Fehlerausgabe.
Wenn Lambda die maximale Anzahl von Aufrufen überschreitet, wird der gemeldete Fehler wie folgt angezeigt Lambda.TooManyRequestsException.
Spiel weiter Lambda.Unknown, Sandbox.Timedout, und States.TaskFailed um mögliche Fehler zu behandeln. Sie können auch verwenden States.ALL, aber es muss alleine und am Ende der Liste stehen.
Für weitere Informationen über Lambda Handled und Unhandled Fehler, siehe FunctionError in der AWS Lambda Leitfaden für Entwickler.
Weitere Informationen finden Sie hier:
Vermeidung von Latenzen bei der Abfrage von Aktivitätsaufgaben
Die GetActivityTask-API ist so konzipiert, dass sie ein taskToken einmalig unterstützt. Wenn ein taskToken während der Kommunikation mit einem Aktivitäts-Worker verloren geht, können mehrere GetActivityTask-Anfragen für 60 Sekunden blockiert werden, die auf eine Antwort warten, bis ein Timeout für GetActivityTask stattfindet.
Wenn Sie nur eine kleine Anzahl von Abrufen haben, die auf eine Antwort warten, ist es möglich, dass alle Anforderungen hinter der blockierten Anforderung auflaufen und anhalten. Wenn Sie jedoch eine große Anzahl ausstehender Umfragen für jede Aktivität haben, Amazon Resource Name (ARN), und ein gewisser Prozentsatz Ihrer Anfragen warten muss, wird es noch viele weitere geben, für die es immer noch eine Antwort geben kann taskToken und beginnen Sie mit der Bearbeitung der Arbeit.
Für Produktionssysteme empfehlen wir mindestens 100 offene Abrufe pro Aktivitäts-ARN zu jedem Zeitpunkt. Wenn ein Abruf blockiert wird, und einen Teil dieser Abrufe dahinter auflaufen, gibt es nach wie vor viele weitere Anfragen, die ein taskToken erhalten, um weiterzuarbeiten, während die GetActivityTask-Anfrage blockiert ist.
So vermeiden Sie diese Art von Latenzproblemen beim Abrufen von Aufgaben
-
Implementieren Sie Ihre Poller als separate Threads aus der Arbeit in Ihrer Aktivitäts-Worker-Implementierung.
-
Verwenden Sie mindestens 100 offene Abrufe pro Aktivitäts-ARN zu jedem Zeitpunkt.
AnmerkungEine Skalierung auf 100 offene Abrufe pro ARN kann kostspielig sein. Beispielsweise ist die Abfrage von 100 Lambda-Funktionen pro ARN 100-mal teurer als eine einzelne Lambda-Funktion mit 100 Polling-Threads. Um beide die Latenz zu reduzieren und minimieren Sie die Kosten, verwenden Sie eine Sprache, die asynchron ist I/O, und implementieren Sie mehrere Polling-Threads pro Worker. Ein Beispiel für einen Aktivitäts-Worker, in dem die Poller-Threads unabhängig von der Arbeitsthreads sind, finden Sie unter Beispiel: Activity Worker in Ruby.
Weitere Informationen zu Aktivitäten und Aktivitäts-Workern finden Sie unter Erfahren Sie mehr über Aktivitäten in Step Functions.
Vermeiden CloudWatch Größenbeschränkungen im Rahmen der Ressourcenpolitik
Wenn Sie eine Zustandsmaschine mit Protokollierung erstellen oder eine vorhandene Zustandsmaschine aktualisieren, um die Protokollierung zu aktivieren, muss Step Functions Ihre aktualisieren CloudWatch Protokolliert die Ressourcenrichtlinie mit der von Ihnen angegebenen Protokollgruppe. CloudWatch Die Ressourcenrichtlinien für Protokolle sind auf 5.120 Zeichen begrenzt.
Wann CloudWatch Logs erkennt, dass sich eine Richtlinie der Größenbeschränkung nähert, CloudWatch Logs aktiviert automatisch die Protokollierung für Protokollgruppen, die mit beginnen /aws/vendedlogs/.
Sie können Ihr Präfix voranstellen CloudWatch Protokolliert Protokollgruppennamen mit /aws/vendedlogs/ um das zu vermeiden CloudWatch Die Größenbeschränkung der Ressourcenrichtlinie protokolliert. Wenn Sie in der Step Functions-Konsole eine Protokollgruppe erstellen, wird dem vorgeschlagenen Protokollgruppennamen bereits das Präfix vorangestellt /aws/vendedlogs/states.
CloudWatch Logs hat außerdem ein Kontingent von zehn Ressourcenrichtlinien pro Region und Konto. Wenn Sie versuchen, die Protokollierung auf einer Zustandsmaschine zu aktivieren, die bereits über zehn verfügt CloudWatch Protokolliert Ressourcenrichtlinien in einer Region für ein Konto, der State Machine wird weder erstellt noch aktualisiert. Weitere Informationen zu Protokollierungskontingenten finden Sie unter CloudWatch Protokolliert Kontingente.
Wenn Sie Probleme beim Senden von Protokollen haben CloudWatch Protokolle finden Sie unter Troubleshooting state machine logging to CloudWatch Logs.