View a markdown version of this page

Procedure consigliate per Step Functions - AWS Step Functions

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Procedure consigliate per Step Functions

Gestione dello stato e trasformazione dei dati

I seguenti argomenti sono le best practice per aiutarvi a gestire e ottimizzare i flussi di lavoro di Step Functions.

Ottimizzazione dei costi utilizzando Express Workflows

Step Functions determina i prezzi per i flussi di lavoro Standard ed Express in base al tipo di flusso di lavoro utilizzato per creare le macchine a stati. Per ottimizzare il costo dei flussi di lavoro serverless, puoi seguire uno o entrambi i seguenti consigli:

Per informazioni su come la scelta di un tipo di flusso di lavoro Standard o Express influisce sulla fatturazione, consulta AWS Step Functions Prezzi.

Flussi di lavoro Nest Express all'interno dei flussi di lavoro standard

Step Functions esegue flussi di lavoro con una durata e un numero di passaggi limitati. Alcuni flussi di lavoro possono completare l'esecuzione entro un breve periodo di tempo. Altri possono richiedere una combinazione di flussi di lavoro di lunga durata e ad alta frequenza di eventi. Con Step Functions, puoi creare flussi di lavoro grandi e complessi partendo da più flussi di lavoro più piccoli e semplici.

Ad esempio, per creare un flusso di lavoro di elaborazione degli ordini, puoi includere tutte le azioni non idempotenti in un flusso di lavoro standard. Ciò potrebbe includere azioni, come l'approvazione dell'ordine tramite l'interazione umana e l'elaborazione dei pagamenti. È quindi possibile combinare una serie di azioni idempotenti, come l'invio di notifiche di pagamento e l'aggiornamento dell'inventario dei prodotti, in un flusso di lavoro Express. È possibile inserire questo flusso di lavoro Express nel flusso di lavoro Standard. In questo esempio, il flusso di lavoro Standard è noto come macchina a stato principale. Il flusso di lavoro Express annidato è noto come macchina a stato figlio.

Migra i flussi di lavoro standard ai flussi di lavoro Express

Dovresti prendere in considerazione la migrazione dei tuoi flussi di lavoro Standard ai flussi di lavoro Express se soddisfano i seguenti requisiti:

  • L'esecuzione del flusso di lavoro deve essere completata entro cinque minuti.

  • Il tuo flusso di lavoro è conforme a almeno una volta modello di esecuzione, il che significa che ogni fase del flusso di lavoro può essere eseguita più di una volta esatta.

  • Il tuo flusso di lavoro lo fa non usa il .waitForTaskToken o .sync modelli di integrazione dei servizi.

Importante

I flussi di lavoro Express utilizzano Amazon CloudWatch Registri per registrare le cronologie delle esecuzioni. Dovrai sostenere costi aggiuntivi durante l'utilizzo CloudWatch Registri.

Per migrare un flusso di lavoro standard a un flusso di lavoro Express utilizzando la console
  1. Aprire il Console Step Functions.

  2. Sul Macchine statali pagina, scegli una macchina a stati di tipo Standard per aprirla.

    Suggerimento

    Dal Qualsiasi tipo elenco a discesa, scegli Standard per filtrare l'elenco delle macchine a stati e visualizzare solo i flussi di lavoro Standard.

  3. Scegli Copia in nuovo.

    Workflow Studio si apre in Modalità di progettazione visualizzazione del flusso di lavoro della macchina a stati selezionata.

  4. (Facoltativo) Aggiornare il design del flusso di lavoro.

  5. Specificate un nome per la vostra macchina a stati. Per fare ciò, scegliete l'icona di modifica accanto al nome della macchina a stati predefinita di MyStateMachine. Poi, nel Configurazione della macchina a stati, specificare un nome nel Indicare il nome della macchina scatola.

  6. (Facoltativo) In Configurazione della macchina a stati, specifica altre impostazioni del flusso di lavoro, come il tipo di macchina a stati e il relativo ruolo di esecuzione.

    Assicurati che per Digitare, scegli tu Express. Mantieni attive tutte le altre selezioni predefinite Impostazioni della macchina di stato.

    Nota

    Se stai migrando un flusso di lavoro standard precedentemente definito in AWS CDK o AWS SAM, è necessario modificare il valore di Type e Resource nome.

  7. Nel Conferma la creazione del ruolo finestra di dialogo, scegli Confermare per continuare.

    Puoi anche scegliere Visualizza le impostazioni dei ruoli per tornare a Configurazione della macchina a stati.

    Nota

    Se elimini il ruolo IAM creato da Step Functions, Step Functions non può ricrearlo in un secondo momento. Analogamente, se modifichi il ruolo (ad esempio, rimuovendo Step Functions dai principali nella policy IAM), Step Functions non può ripristinare le impostazioni originali in un secondo momento.

Per ulteriori informazioni sulle best practice e sulle linee guida per la gestione dell'ottimizzazione dei costi per i flussi di lavoro, consulta Costruire a costi contenuti AWS Step Functions flussi di lavoro.

Etichettatura delle macchine a stati e delle attività in Step Functions

AWS Step Functions supporta la codifica delle macchine a stato (sia Standard che Express) e delle attività. I tag possono aiutarti a tracciare e gestire le tue risorse e a fornire una maggiore sicurezza AWS Identity and Access Management politiche (IAM). Dopo aver etichettato le risorse di Step Functions, puoi gestirle con AWS Resource Groups. Per sapere come fare, consulta la AWS Resource Groups Guida per l'utente.

Per l'autorizzazione basata su tag, le risorse di esecuzione di una macchina a stati, come mostrato nell'esempio seguente, ereditano i tag associati a una macchina a stati.

arn:partition:states:region:account-id:execution:<StateMachineName>:<ExecutionId>

Quando chiami DescribeExecution o altre API in cui si specifica la risorsa di esecuzione ARN, Step Functions utilizza i tag associati alla macchina a stati per accettare o rifiutare la richiesta durante l'esecuzione dell'autorizzazione basata su tag. Ciò consente di consentire o negare l'accesso alle esecuzioni di macchine a stati a livello di macchina a stati.

Per esaminare le limitazioni correlate la tagging delle risorse, consultare Restrizioni relative all'etichettatura.

Tagging per l'allocazione dei costi

È possibile utilizzare i tag di allocazione dei costi per identificare lo scopo di una macchina a stati e rispecchiare tale organizzazione nella propria AWS fattura. Registrati per ottenere il tuo AWS fattura dell'account che includa le chiavi e i valori del tag. Vedi Impostazione di un rapporto mensile sull'allocazione dei costi nel AWS Billing Guida per l'utente per informazioni dettagliate sull'impostazione dei report.

Ad esempio, puoi aggiungere tag che rappresentano il centro di costo e lo scopo delle risorse di Step Functions, come segue.

Risorsa Chiave Valore
StateMachine1 Cost Center 34567
Application Image processing
StateMachine2 Cost Center 34567
Application Rekognition processing

Tagging per la sicurezza

IAM supporta il controllo dell'accesso alle risorse in base ai tag. Per controllare l'accesso in base ai tag, fornisci informazioni sui tag delle risorse nell'elemento condition di una policy IAM.

Ad esempio, puoi limitare l'accesso a tutte le risorse di Step Functions che includono un tag con la chiave environment e il valore production.

{ "Version":"2012-10-17", "Statement": [ { "Effect": "Deny", "Action": [ "states:TagResource", "states:DeleteActivity", "states:DeleteStateMachine", "states:StopExecution" ], "Resource": "*", "Condition": { "StringEquals": {"aws:ResourceTag/environment": "production"} } } ] }

Per ulteriori informazioni, consulta Controllo dell'accesso tramite tag nella Guida per l'utente di IAM.

Gestione dei tag nella console Step Functions

È possibile visualizzare e gestire i tag per le macchine a stati nella console Step Functions. Dalla pagina Details (Dettagli) di una macchina a stati, seleziona Tags (Tag).

Gestione dei tag con Step Functions API Actions

Per gestire i tag utilizzando l'API Step Functions, utilizza le seguenti azioni API:

Utilizzo dei timeout per evitare il blocco delle esecuzioni del flusso di lavoro di Step Functions

Per impostazione predefinita, Amazon States Language non specifica i timeout per le definizioni delle macchine a stati. Senza un timeout esplicito, Step Functions spesso si basa esclusivamente sulla risposta di un activity worker per sapere che un'attività è completa. Se qualcosa va storto e TimeoutSeconds il campo non è specificato per un'attività o per un'attività in attesa di .sync lavoro o un .waitForTaskToken callback, un'esecuzione è bloccata in attesa di una risposta che non arriverà mai. Le attività di Request Response hanno un timeout predefinito. Per ulteriori informazioni, consulta Timeout per le attività di richiesta e risposta.

Per evitare questa situazione, specifica un timeout ragionevole quando crei un Task nella vostra macchina a stati. Ad esempio:

"ActivityState": { "Type": "Task", "Resource": "arn:aws:states:region:account-id:activity:HelloWorld", "TimeoutSeconds": 300, "Next": "NextState" }

Se usi un callback con un token di attività (.wait)ForTaskToken), ti consigliamo di utilizzare i battiti cardiaci e aggiungere HeartbeatSeconds campo nel tuo Task definizione di stato. È possibile impostare HeartbeatSeconds deve essere inferiore al timeout dell'attività, quindi se il flusso di lavoro non riesce con un errore di battito cardiaco, sai che è a causa dell'errore dell'attività invece che del completamento dell'attività che richiede molto tempo.

{ "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 } } }

Per ulteriori informazioni, consulta Stato del flusso di lavoro delle attività nella documentazione di Amazon States Language.

Nota

Puoi impostare un timeout per la tua macchina a stati usando il TimeoutSeconds campo nella tua definizione di Amazon States Language. Per ulteriori informazioni, consulta Struttura della macchina a stati nei flussi di lavoro di Amazon States Language for Step Functions.

Utilizzo di Amazon S3 ARN invece di trasferire payload di grandi dimensioni in Step Functions

Le esecuzioni che trasmettono payload di dati di grandi dimensioni da uno stato all'altro si possono terminare. Se i dati che stai passando da uno stato all'altro potrebbero superare i 256 KiB, utilizza Amazon Simple Storage Service (Amazon S3) per archiviarli e analizzare l'Amazon Resource Name (ARN) del bucket nel Payload parametro per ottenere il nome del bucket e il valore della chiave. In alternativa modifica la tua applicazione in modo da trasferire nelle esecuzioni payload di dimensioni più contenute.

Nel seguente esempio, una macchina a stati passa l'input a un AWS Lambda funzione, che elabora un file JSON in un bucket Amazon S3. Dopo aver eseguito questa macchina a stati, la funzione Lambda legge il contenuto del file JSON e restituisce il contenuto del file come output.

Creazione della funzione Lambda

La seguente funzione Lambda denominata pass-large-payload legge il contenuto di un file JSON archiviato in uno specifico bucket Amazon S3.

Nota

Dopo aver creato questa funzione Lambda, assicurati di fornire al ruolo IAM dell'autorizzazione appropriata per leggere da un bucket Amazon S3. Ad esempio, allega AmazonS3ReadOnlyAccess autorizzazione al ruolo della funzione Lambda.

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
Crea la macchina a stati

La seguente macchina a stati richiama la funzione Lambda creata in precedenza.

{ "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 } } }

Invece di passare una grande quantità di dati in input, puoi salvarli in un bucket Amazon S3 e passare l'Amazon Resource Name (ARN) del bucket nel Payload parametro per ottenere il nome del bucket e il valore della chiave. La tua funzione Lambda può quindi utilizzare quell'ARN per accedere direttamente ai dati. Di seguito è riportato un esempio di input per l'esecuzione della macchina a stati, in cui i dati vengono archiviati in data.json in un bucket Amazon S3 denominato amzn-s3-demo-large-payload-json.

{ "key": "data.json", "bucket": "arn:aws:s3:::amzn-s3-demo-large-payload-json" }

Avvio di nuove esecuzioni per evitare di raggiungere la quota della cronologia in Step Functions

AWS Step Functions ha una quota fissa di 25.000 voci nella cronologia degli eventi di esecuzione. Quando un'esecuzione raggiunge 24.999 eventi, attende che si verifichi l'evento successivo.

  • Se l'evento numero 25.000 è ExecutionSucceeded, l'esecuzione termina con successo.

  • Se l'evento numero 25.000 non lo è ExecutionSucceeded, il ExecutionFailed l'evento viene registrato e l'esecuzione della macchina a stati non riesce a causa del raggiungimento del limite della cronologia

Per evitare di raggiungere questa quota per le esecuzioni di lunga durata, puoi provare una delle seguenti soluzioni alternative:

Gestisci le eccezioni transitorie del servizio Lambda

AWS Lambda occasionalmente possono verificarsi errori di servizio transitori. In questo caso, richiamando Lambda si ottiene un errore 500, ad esempio ClientExecutionTimeoutException, ServiceException, AWSLambdaException, o SdkClientException. Come best practice, gestite in modo proattivo queste eccezioni nel vostro computer a stati per Retry invocando la tua funzione Lambda, o per Catch l'errore.

Gli errori Lambda sono segnalati come Lambda.ErrorName. Per riprovare un errore di eccezione del servizio Lambda, puoi usare quanto segue Retry codice.

"Retry": [ { "ErrorEquals": [ "Lambda.ClientExecutionTimeoutException", "Lambda.ServiceException", "Lambda.AWSLambdaException", "Lambda.SdkClientException"], "IntervalSeconds": 2, "MaxAttempts": 6, "BackoffRate": 2 } ]
Nota

Gli errori non gestiti nei runtime Lambda venivano storicamente segnalati solo come Lambda.Unknown. Nei runtime più recenti, i timeout sono riportati come Sandbox.Timedout nell'output dell'errore.

Quando Lambda supera il numero massimo di chiamate, l'errore segnalato sarà Lambda.TooManyRequestsException.

Partita in corso Lambda.Unknown, Sandbox.Timedout, e States.TaskFailed per gestire eventuali errori. Puoi anche usare States.ALL, ma deve essere solo e alla fine della lista.

Per ulteriori informazioni su Lambda Handled e Unhandled errori, vedi FunctionError nel AWS Lambda Guida per gli sviluppatori.

Per ulteriori informazioni, consulta gli argomenti seguenti:

Evitare la latenza durante il polling delle attività

L'API GetActivityTask è stata progettata per fornire un taskToken un'unica volta. Se un taskToken viene rimosso durante la comunicazione con un lavoratore di attività, un numero di richieste di GetActivityTask può rimanere bloccato per 60 secondi in attesa di risposta finché non si verifica un timeout del GetActivityTask.

Se hai solo un numero ridotto di poll in attesa di risposta, è possibile che tutte le richieste si accodino alla richiesta bloccata e si arrestino. Tuttavia, se hai un gran numero di sondaggi in sospeso per ogni attività Amazon Resource Name (ARN) e una percentuale delle tue richieste è bloccata in attesa, ce ne saranno molte altre che possono ancora ottenere un taskToken e inizia a elaborare il lavoro.

Per i sistemi di produzione, consigliamo almeno 100 poll aperti per ARN di attività in ogni momento. Se un poll si blocca e una parte di quei poll vi si accoda, rimangono ancora molte altre richieste che otterranno un taskToken per elaborare il lavoro mentre la richiesta di GetActivityTask è bloccata.

Per evitare questo tipo di problemi di latenza durante il polling dei task:

  • Implementa i tuoi poller come thread separati dal lavoro nella tua implementazione del lavoratore di attività.

  • Fai in modo di avere almeno 100 poll aperti per ARN di attività in ogni momento.

    Nota

    Il ridimensionamento a 100 poll aperti per ARN può essere costoso. Ad esempio, il polling di 100 funzioni Lambda per ARN è 100 volte più costoso rispetto a una singola funzione Lambda con 100 thread di polling. Per entrambi ridurre la latenza e minimizza i costi, usa un linguaggio asincrono I/Oe implementa più thread di polling per lavoratore. Per vedere un esempio di lavoratore di attività in cui i thread dei poller sono distinti dai thread del lavoro, consultare Esempio: Activity Worker in Ruby.

Per ulteriori informazioni sulle attività e sui lavoratori di attività, consultare Scopri di più su Activities in Step Functions.

Evitare CloudWatch limiti relativi alle dimensioni delle politiche relative alle risorse

Quando si crea una macchina a stati con registrazione o si aggiorna una macchina a stati esistente per abilitare la registrazione, Step Functions deve aggiornare la CloudWatch Registra la politica delle risorse con il gruppo di log specificato. CloudWatch Le politiche relative alle risorse dei log sono limitate a 5.120 caratteri.

Quando CloudWatch Logs rileva che una policy si avvicina al limite di dimensione, CloudWatch Logs abilita automaticamente la registrazione per i gruppi di log che iniziano con /aws/vendedlogs/.

Puoi aggiungere il prefisso al tuo CloudWatch Registra i nomi dei gruppi con /aws/vendedlogs/ per evitare CloudWatch Registra il limite di dimensione delle politiche relative alle risorse. Se si crea un gruppo di log nella console Step Functions, il nome del gruppo di log suggerito sarà già preceduto da /aws/vendedlogs/states.

CloudWatch Logs ha anche una quota di dieci politiche relative alle risorse per regione e per account. Se si tenta di abilitare la registrazione su una macchina a stati che ne ha già dieci CloudWatch Registra le politiche relative alle risorse in una regione per un account, la macchina a stati non verrà creata o aggiornata. Per ulteriori informazioni sulla registrazione delle quote, vedere CloudWatch Registra le quote.

In caso di problemi con l'invio dei log a CloudWatch Registri, vedi Troubleshooting state machine logging to CloudWatch Logs.