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à.
Monitoraggio delle metriche di Step Functions tramite Amazon CloudWatch
Il monitoraggio è una parte importante per mantenere l'affidabilità, la disponibilità e le prestazioni delle AWS Step Functions tue AWS soluzioni. È possibile raccogliere dati dai AWS servizi utilizzati per eseguire il debug di errori multipunto.
Prima di iniziare a monitorare Step Functions, è necessario creare un piano di monitoraggio che risponda alle seguenti domande:
-
Quali sono gli obiettivi del monitoraggio?
-
Di quali risorse si intende eseguire il monitoraggio?
-
Con quale frequenza sarà eseguito il monitoraggio di queste risorse?
-
Quali strumenti di monitoraggio verranno utilizzati?
-
Chi eseguirà i processi di monitoraggio?
-
Chi deve ricevere una notifica quando si verifica un problema?
Il passaggio successivo consiste nello stabilire una baseline per le prestazioni normali di nel tuo ambiente. A questo proposito, misura le prestazioni in diversi orari e in diverse condizioni di carico. Durante il monitoraggio di Step Functions, valuta la possibilità di archiviare i dati di monitoraggio storici. Tali dati possono servire come baseline per il confronto con i dati relativi sulle prestazioni correnti, per identificare modelli di prestazioni normali e anomalie nelle prestazioni nonché elaborare metodi mediante i quali risolvere i problemi.
Ti consigliamo di monitorare le attività e gli errori delle attività per stabilire una linea di base. Quando le prestazioni non rientrano nella metrica di base, imposta un avviso in modo da poter ricercare la causa principale.
Per stabilire una baseline, devi monitorare almeno i seguenti parametri:
-
ExecutionsStarted -
ExecutionsTimedOut -
Facoltativo (se utilizzi le attività) -
ActivitiesStarted -
Facoltativo (se utilizzi le attività) -
ActivitiesTimedOut
Tipi di metriche Step Functions per CloudWatch
Step Functions fornisce i seguenti tipi di metriche ad Amazon CloudWatch. Puoi utilizzare questi parametri per monitorare le macchine a stati e le attività e per impostare allarmi sui valori di soglia. Puoi visualizzare le metriche utilizzando. Console di gestione AWS
Le metriche sono raggruppate in base a uno spazio dei nomi, un contenitore per le metriche, in modo che le CloudWatch metriche di diverse applicazioni non vengano aggregate per errore.
Nomi e log non ASCII
Step Functions accetta nomi per macchine a stati, esecuzioni, attività ed etichette che contengono caratteri non ASCII. Poiché tali caratteri impediranno ad Amazon CloudWatch di registrare i dati, consigliamo di utilizzare solo caratteri ASCII per tenere traccia delle metriche di Step Functions.
CloudWatch distribuzione delle metriche
I parametri di CloudWatch vengono distribuiti sulla base del miglior tentativo.
La completezza e la tempestività dei parametri non è garantita. È possibile che il data point per una richiesta specifica venga restituito con un timestamp successivo a quello del momento effettivo di elaborazione della richiesta. Il data point potrebbe subire un ritardo di un minuto prima di essere disponibile oppure potrebbe non essere consegnato affatto. CloudWatch CloudWatchle metriche di richiesta ti danno un'idea delle esecuzioni delle macchine a stati in tempo quasi reale. Non è pensato per essere una contabilità completa di tutte le metriche relative all'esecuzione.
Poiché questa funzionalità richiede il massimo impegno, i report disponibili nella dashboard di Billing & Cost Management
Metriche che segnalano un intervallo di tempo
Alcune delle CloudWatch metriche di Step Functions sono intervalli di tempo, misurati sempre in millisecondi. Queste metriche generalmente corrispondono alle fasi dell'esecuzione per le quali è possibile impostare i timeout della macchina a stati, dell'attività e della funzione Lambda, con nomi descrittivi.
Ad esempio, il parametro ActivityRunTime misura il tempo necessario per il completamento di un'attività dopo che ne viene avviata l'esecuzione. Puoi impostare un valore di timeout per lo stesso periodo di tempo.
Nella CloudWatch console, puoi ottenere i risultati migliori se scegli la media come statistica di visualizzazione per le metriche degli intervalli di tempo.
Metriche che riportano un conteggio
Alcune CloudWatch metriche di Step Functions riportano i risultati sotto forma di conteggio. Ad esempio, ExecutionsFailed registra il numero di esecuzioni di macchina di stato che hanno esito negativo.
Da notare che Step Functions emette due ExecutionsStarted metriche per ogni esecuzione di una macchina a stati. Di conseguenza, la SampleCountstatistica della ExecutionsStarted metrica mostrerà il valore di 2 per ogni esecuzione di una macchina a stati. La SampleCount statistica viene visualizzata ExecutionStarted=1 e quindi ExecutionStarted=0 dopo il completamento dell'esecuzione.
Allo stesso modo, altre metriche sullo stato di esecuzione possono essere emesse più di una volta a causa della massima disponibilità at-least-once delle metriche. CloudWatch
Suggerimento
Ti consigliamo di utilizzare Sum come statistica di visualizzazione per le metriche che riportano un conteggio nella console. CloudWatch
Visualizzazione delle metriche di Step Functions in CloudWatch
Puoi utilizzare la CloudWatch console per visualizzare le metriche di Step Functions per esecuzioni, attività, funzioni e integrazioni di servizi.
-
Accedi Console di gestione AWS e apri la console. CloudWatch
-
Scegliere Metrics (Parametri) e nella scheda All Metrics (Tutti i parametri), scegliere States (Stati).
Se hai eseguito esecuzioni di recente, vedrai fino a quattro tipi di metriche:
-
Parametri di esecuzione
-
Parametri di funzioni di attività
-
Metriche della funzione Lambda
-
Metriche di integrazione dei servizi
-
-
Scegliere un tipo di parametro per visualizzare un elenco di parametri.
-
Per visualizzare grafici per un parametro, selezionare la casella accanto al parametro nell'elenco. È possibile modificare i parametri del grafico utilizzando i controlli degli intervalli di tempo sopra il grafico.
È possibile scegliere intervalli di tempo personalizzati utilizzando valori assoluti o relativi (giorni e ore specifici). È anche possibile utilizzare l'elenco a discesa per visualizzare i valori come linee, aree impilate o numeri (valori).
-
Per visualizzare i dettagli di un grafico, passa il mouse sul codice cromatico metrico che appare sotto il grafico per visualizzare i dettagli delle metriche.
-
Per ulteriori informazioni sull'utilizzo dei CloudWatch parametri, consulta Using Amazon CloudWatch Metrics nella Amazon CloudWatch User Guide.
Impostazione degli allarmi per le metriche di Step Functions in CloudWatch
Puoi utilizzare gli CloudWatch allarmi Amazon per eseguire azioni. Ad esempio, se desideri sapere quando viene raggiunta una soglia di allarme, puoi impostare un allarme per inviare una notifica a un argomento di Amazon SNS o inviare un'e-mail quando la StateMachinesFailed metrica supera una determinata soglia.
Per impostare un allarme per un parametro
-
Accedi a Console di gestione AWS e apri la CloudWatch console.
-
Scegli una o più metriche da visualizzare, quindi scegli Metriche grafiche.
-
Scegli l'icona a forma di campana accanto a una metrica nell'elenco per visualizzare la pagina Crea allarme.
-
Immettere i valori in Alarm threshold (Soglia allarme) e Actions (Operazioni), quindi scegliere Create Alarm (Crea allarme).
Per ulteriori informazioni sull'impostazione e l'utilizzo degli CloudWatch allarmi, consulta Creating Amazon CloudWatch Alarms nella Amazon CloudWatch User Guide.
Metriche di utilizzo a livello di account
Il AWS/Usage namespace include le seguenti metriche Step Functions.
Le seguenti metriche sono adimensionali e si applicano a tutto il tuo account in una regione.
| Metrica | Description |
|---|---|
StateMachineCount |
Numero di macchine a stati attualmente attive nel tuo account. Potrebbe essere necessario aggiungere o eliminare una State Machine nel tuo account e attendere qualche minuto per attivare questa metrica per il tuo account. |
ActivityCount |
Numero di attività attualmente attive nel tuo account. Potrebbe essere necessario aggiungere o eliminare un'Attività nel tuo account e attendere qualche minuto per attivare questa metrica per il tuo account. |
OpenExecutionCountPerStateMachine |
Apri le esecuzioni per macchina a stati nel tuo account. |
Parametri di esecuzione
Il AWS/States namespace include le seguenti metriche per tutte le esecuzioni di Step Functions.
Le seguenti metriche sono adimensionali e si applicano a tutto il tuo account in una regione.
| Metrica | Description |
|---|---|
OpenExecutionCount |
Numero approssimativo di esecuzioni attualmente aperte, ossia flussi di lavoro attualmente in corso nel tuo account. L'intento è quello di fornire informazioni dettagliate su quando i flussi di lavoro si avvicinano al limite massimo di esecuzione, per evitare ExecutionLimitExceedederrori durante le chiamate o per i flussi di lavoro standard.
|
OpenExecutionLimit |
Numero massimo di esecuzioni aperte. Per ulteriori informazioni, consulta Quote relative agli account. Questo limite non si applica ai flussi di lavoro Express. |
Metriche di esecuzione per tutte le macchine a stati
Tutte le macchine a stati emettono metriche. La ExecutionThrottled metrica verrà emessa solo in caso di esecuzione limitata.
Le seguenti metriche possono essere filtrate con a per identificare una macchina StateMachineArn a stati specifica.
Metriche a livello di account
Senza un ARN per una macchina a stati, le seguenti metriche vengono riportate a livello di account. Fornisci un ARN per la macchina a stati per generare report a livello di macchina a stati.
| Metrica | Description |
|---|---|
ExecutionsAborted |
Numero di esecuzioni interrotte o terminate. |
ExecutionsFailed |
Numero di esecuzioni fallite. |
ExecutionsStarted |
Numero di esecuzioni iniziate. |
ExecutionsSucceeded |
Numero di esecuzioni completate con successo. |
ExecutionsTimedOut |
Numero di esecuzioni scadute per qualsiasi motivo. |
ExecutionThrottled |
Numero di StateEntered eventi e tentativi che sono stati limitati. Questo si riferisce al throttling di StateTransition. Per ulteriori informazioni, consulta Quote relative alla limitazione statale. |
ExecutionTime |
Intervallo, in millisecondi, tra l'inizio dell'esecuzione e il momento in cui viene chiusa. |
Metriche di esecuzione per Express Workflows
Il AWS/States namespace include le seguenti metriche per le esecuzioni di Step Functions Express Workflows.
Metriche a livello di account
Senza un ARN della macchina a stati, il ExpressExecutionBilledMemory report ExpressExecutionBilledDuration and viene eseguito a livello di account. Fornisci un ARN per la macchina a stati per generare report a livello di macchina a stati.
| Metrica | Description |
|---|---|
ExpressExecutionBilledDuration |
La durata per la quale viene addebitato un Express Workflow. |
ExpressExecutionBilledMemory |
La quantità di memoria consumata per la quale viene addebitato un Express Workflow. |
ExpressExecutionMemory
|
La memoria totale consumata da uno specifico Express Workflow. |
Redrivemetriche di esecuzione per i flussi di lavoro standard
Quando si esegue redriveuna macchina a stati, Step Functions emette le seguenti metriche.
Per tutte le redriven esecuzioni, viene emessa la Executions* metrica. Ad esempio, supponiamo che un'esecuzione si interromparedriven. Questa esecuzione emetterà punti dati diversi da zero per entrambi e. RedrivenExecutionsAborted ExecutionsAborted
| Metrica | Description |
|---|---|
ExecutionsRedriven |
redrivenNumero di esecuzioni. |
RedrivenExecutionsAborted |
Numero di redriven esecuzioni annullate o terminate. |
RedrivenExecutionsTimedOut |
Numero di redriven esecuzioni scadute per qualsiasi motivo. |
RedrivenExecutionsSucceeded |
Numero di redriven esecuzioni completate con successo. |
RedrivenExecutionsFailed |
Numero di redriven esecuzioni non riuscite. |
Metriche di esecuzione di Dimension for Step Functions
| Dimensione | Description |
|---|---|
StateMachineArn
|
L'Amazon Resource Name (ARN) della macchina a stati per l'esecuzione in questione. |
Dimensioni per le esecuzioni con versione
| Dimensione | Description |
|---|---|
StateMachineArn
|
|
Version |
Versione della macchina a stati utilizzata per avviare l'esecuzione. |
Dimensioni per le esecuzioni con un alias
| Dimensione | Description |
|---|---|
StateMachineArn
|
L'Amazon Resource Name (ARN) della macchina a stati la cui esecuzione è stata avviata da un alias. |
Alias |
Alias della macchina a stati utilizzato per avviare l'esecuzione. |
Map Run Metrics
Il AWS/States namespace include le seguenti metriche per tutte le esecuzioni di mappe Step Functions. Si tratta di metriche adimensionali che si applicano a tutto il tuo account in una regione.
| Metrica | Description |
|---|---|
| ApproximateOpenMapRunCount |
Numero approssimativo di Map Run attualmente aperte in corso nel tuo account. Con questa metrica, puoi intervenire quando ti avvicini al Map Run OpenMapRunLimit, per evitare che le Map Run si accumulino. Affinché un allarme ti avvisi se ti stai avvicinando alla tua OpenMapRunLimit, ti consigliamo di utilizzare la statistica Maximum con una soglia pari o superiore a 900, poiché l'impostazione predefinita è 1.000 esecuzioni di mappe. OpenManRunLimit |
| OpenMapRunLimit |
Numero massimo di mappe aperte. Per ulteriori informazioni, consulta Quote relative agli account. |
| ApproximateMapRunBacklogSize |
Numero approssimativo di Map Run che sono in backlog. Le Map Run backloggate attendono l'MapRunStartedevento finché il numero totale di Map Run aperte non sarà inferiore alla quota. Il conteggio degli elementi sarà pari a zero mentre Map Run è in arretrato. Il conteggio aumenterà dopo che Map Run si aprirà e inizierà a leggerne l'input. |
Metriche relative alla versione e agli alias
Lo spazio dei AWS/States nomi include le seguenti metriche per il conteggio delle versioni e degli alias di una macchina a stati.
| Metrica | Description |
|---|---|
| AliasCount |
Numero di alias creati per la macchina a stati. È possibile creare fino a 100 alias per ogni macchina a stati. |
| VersionCount |
Numero di versioni pubblicate per la macchina a stati. È possibile pubblicare fino a 1000 versioni di una macchina a stati. |
Dimensione per le metriche del conteggio delle risorse per versioni e alias
| Dimensione | Description |
|---|---|
ResourceArn
|
L'Amazon Resource Name (ARN) della macchina a stati con una versione o un alias. |
Parametri delle attività
Il AWS/States namespace include le seguenti metriche per le attività di Step Functions.
Metriche a livello di account
Senza un ARN per una macchina a stati, le seguenti metriche vengono riportate a livello di account. Fornisci un ARN per la macchina a stati per generare report a livello di macchina a stati.
| Metrica | Description |
|---|---|
ActivitiesFailed |
Numero di attività non riuscite. |
ActivitiesHeartbeatTimedOut |
Numero di attività che scadono a causa di un timeout del battito cardiaco. |
ActivitiesScheduled |
Numero di attività programmate. |
ActivitiesStarted |
Numero di attività avviate. |
ActivitiesSucceeded |
Numero di attività completate con successo. |
ActivitiesTimedOut |
Numero di attività che scadono alla chiusura. |
ActivityRunTime
|
Intervallo, in millisecondi, tra l'inizio dell'attività e la sua chiusura. |
ActivityScheduleTime |
Intervallo, in millisecondi, per il quale l'attività rimane nello stato di pianificazione. |
ActivityTime |
Intervallo, in millisecondi, tra il momento in cui l'attività è pianificata e l'ora di chiusura. |
Metriche delle attività di Dimension for Step Functions
| Dimensione | Description |
|---|---|
ActivityArn |
L'ARN dell'attività. |
Parametri della funzione Lambda
Lo spazio dei AWS/States nomi include le seguenti metriche per le funzioni Lambda a cui si fa riferimento direttamente nel campo Risorsa di una definizione dello stato dell'attività. È possibile trovare queste metriche nelle macchine a stati legacy. Nelle moderne macchine a stati, consigliamo di utilizzare l'integrazione Optimized Lambda che emette metriche di integrazione dei servizi.
| Metrica | Description |
|---|---|
LambdaFunctionRunTime |
Intervallo, in millisecondi, tra l'inizio e la chiusura della funzione Lambda. |
LambdaFunctionScheduleTime |
Intervallo, in millisecondi, per il quale la funzione Lambda rimane nello stato di pianificazione. |
LambdaFunctionTime |
Intervallo, in millisecondi, tra il momento in cui la funzione Lambda è pianificata e l'ora di chiusura. |
LambdaFunctionsFailed |
Numero di funzioni Lambda non riuscite. |
LambdaFunctionsScheduled |
Numero di funzioni Lambda pianificate. |
LambdaFunctionsStarted |
Numero di funzioni Lambda avviate. |
LambdaFunctionsSucceeded |
Numero di funzioni Lambda completate con successo. |
LambdaFunctionsTimedOut |
Numero di funzioni Lambda che scadono alla chiusura. |
Metriche della funzione Lambda di Dimension for Step Functions
| Dimensione | Description |
|---|---|
LambdaFunctionArn |
ARN della funzione Lambda. |
Nota
Le metriche delle funzioni Lambda vengono emesse per gli stati delle attività che specificano l'ARN della funzione Lambda nel campo.
Resource Stati di attività che utilizzano invece "Resource": "arn:aws:states:::lambda:invoke" emit Service Integration Metrics. Per ulteriori informazioni, consulta Invoca una AWS Lambda funzione con Step Functions.
Parametri di integrazione del servizio
Il AWS/States namespace include le seguenti metriche per le integrazioni dei servizi Step Functions. Per ulteriori informazioni, consulta Integrazione dei servizi con Step Functions.
| Parametro | Description |
|---|---|
ServiceIntegrationRunTime |
Intervallo, in millisecondi, tra l'inizio del Service Task e il momento in cui viene chiuso. |
ServiceIntegrationScheduleTime |
Intervallo, in millisecondi, durante il quale il Service Task rimane nello stato di pianificazione. |
ServiceIntegrationTime |
Intervallo, in millisecondi, tra il momento in cui il Service Task è pianificato e l'ora di chiusura. |
ServiceIntegrationsFailed |
Numero di attività di servizio non riuscite. |
ServiceIntegrationsScheduled |
Numero di attività di assistenza pianificate. |
ServiceIntegrationsStarted |
Numero di attività di servizio avviate. |
ServiceIntegrationsSucceeded |
Numero di attività di assistenza completate con successo. |
ServiceIntegrationsTimedOut |
Numero di attività di servizio scadute alla chiusura. |
Metriche di integrazione dei servizi Dimension for Step Functions
| Dimensione | Description |
|---|---|
ServiceIntegrationResourceArn |
L’ARN della risorsa del servizio integrato. |
Parametri servizio
Il AWS/States namespace include le seguenti metriche per le metriche del servizio Step Functions.
Metriche a livello di account
Senza un ARN per una macchina a stati, le seguenti metriche vengono riportate a livello di account. Fornisci un ARN per la macchina a stati per generare report a livello di macchina a stati.
| Metrica | Description |
|---|---|
ConsumedCapacity |
Numero di richieste al secondo. |
ProvisionedBucketSize |
Numero di richieste disponibili al secondo. |
ProvisionedRefillRate |
Numero di richieste al secondo consentite nel bucket. |
ThrottledEvents
|
Numero di richieste che sono state limitate. |
Metriche del servizio Dimension for Step Functions
| Dimensione | Description |
|---|---|
ServiceMetric |
Filtra i dati da mostrare StateTransition. |
StateMachineArn |
Filtra i dati per mostrare le transizioni per una macchina a stati specifica. |
Metriche di utilizzo delle API
Il AWS/States namespace include le seguenti metriche per l'API Step Functions.
| Metrica | Description |
|---|---|
ThrottledEvents
|
Numero di richieste che sono state limitate. |
ProvisionedBucketSize |
Numero di richieste disponibili al secondo. |
ProvisionedRefillRate |
Numero di richieste al secondo consentite nel bucket. |
ConsumedCapacity |
Numero di richieste al secondo. |
Metriche dell'API Dimension for Step Functions
| Dimensione | Description |
|---|---|
APIName |
Filtra i dati in base a un'API con il nome API specificato. |
