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](https://console.aws.amazon.com/billing/home?#/) potrebbero includere una o più richieste di accesso che non compaiono nelle metriche di esecuzione.
### 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 [SampleCount](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Statistics-definitions.html)statistica 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.
1. Accedi Console di gestione AWS e apri la console. CloudWatch
1. 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**
1. 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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/working_with_metrics.html) 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
1. Accedi a Console di gestione AWS e apri la CloudWatch console.
1. Scegli una o più metriche da visualizzare, quindi scegli Metriche **grafiche.**
1. **Scegli l'icona a forma di campana accanto a una metrica nell'elenco per visualizzare la pagina Crea allarme.**
1. 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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/AlarmThatSendsEmail.html) 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 **ExecutionLimitExceeded**errori durante le chiamate o per i flussi di lavoro standard. `StartExecution` `RedriveExecution` `OpenExecutionCount` è un numero approssimativo di flussi di lavoro aperti. Questa metrica sarà inferiore al numero di flussi di lavoro in esecuzione osservato. L'esecuzione di un numero di flussi di lavoro aperti inferiore a 10.000 può mostrare zero esecuzioni aperte. Affinché un allarme venga notificato quando si avvicina al tuo`OpenExecutionLimit`, ti consigliamo di utilizzare la statistica [Maximum](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Statistics-definitions.html) con una soglia di 100.000 o superiore, poiché il limite predefinito del flusso di lavoro aperto è di 1.000.000 di esecuzioni. |
| OpenExecutionLimit | Numero massimo di esecuzioni aperte. Per ulteriori informazioni, consulta [Quote relative agli account](service-quotas.md#service-limits-accounts). *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](service-quotas.md#service-limits-api-state-throttling). |
| 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 [redrive](redrive-executions.md)una 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 | [L'Amazon Resource Name (ARN) della macchina a stati la cui esecuzione è stata avviata da una versione.](concepts-state-machine-version.md) |
| 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.](concepts-state-machine-alias.md) |
| 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](service-quotas.md#service-limits-accounts). |
| ApproximateMapRunBacklogSize | Numero approssimativo di [Map Run che sono](concepts-examine-map-run.md) in *backlog*. Le Map Run backloggate attendono l'[MapRunStarted](https://docs.aws.amazon.com/step-functions/latest/apireference/API_MapRunStartedEventDetails.html)evento 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](concepts-state-machine-alias.md) creati per la macchina a stati. È possibile [creare](concepts-state-machine-alias.md#procedure-create-aliases) fino a 100 alias per ogni macchina a stati. |
| VersionCount | Numero di [versioni](concepts-state-machine-version.md) pubblicate per la macchina a stati. È possibile [pubblicare](concepts-state-machine-version.md#procedure-create-versions) 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](connect-lambda.md).
## 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](integrate-services.md).
| 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. |