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à.
# Metriche di Amazon SWF per CloudWatch
Amazon SWF ora fornisce parametri CloudWatch che puoi utilizzare per tenere traccia dei flussi di lavoro e delle attività e impostare allarmi sui valori di soglia che scegli. Puoi visualizzare le metriche utilizzando. Console di gestione AWS Per ulteriori informazioni, consulta [Visualizzazione delle metriche di Amazon SWF per l'utilizzo di CloudWatch Console di gestione AWS](cw-metrics-console.md).
**Topics**
+ [Unità di reporting per le metriche di Amazon SWF](#swf-reporting-units)
+ [Parametri di eventi API e di decisione](#swf-throttling-metrics)
+ [Metriche di Amazon SWF](#cloudwatch-swf-metrics)
+ [Nomi e dimensioni delle risorse non ASCII di Amazon SWF CloudWatch](#cloudwatch-swf-non-ascii)
## Unità di reporting per le metriche di Amazon SWF
### Parametri che indicano un intervallo di tempo
Alcune delle metriche di Amazon SWF CloudWatch sono gli *intervalli di tempo*, sempre misurati in millisecondi. L'unità è riportata come. CloudWatch `Time` Questi parametri corrispondono generalmente alle fasi dell'esecuzione del flusso di lavoro, per le quali è possibile impostare timeout per attività e flussi di lavoro, e hanno nomi simili.
Ad esempio, il parametro `DecisionTaskStartToCloseTime` misura il tempo necessario per il completamento del task di decisione dal momento in cui viene eseguito, che è lo stesso periodo di tempo per il quale è possibile impostare un valore `DecisionTaskStartToCloseTimeout`.
Per un diagramma di ognuna di queste fasi e per informazioni su quando si verificano nei cicli di vita di flussi di lavoro e attività, consulta [Tipi di timeout di Amazon SWF](swf-timeout-types.md).
### Parametri che indicano un numero
*Conteggio di alcune metriche di Amazon SWF per i risultati dei CloudWatch report.* Ad esempio, `WorkflowsCanceled` registra un risultato che può essere *uno* o *zero* per indicare se il flusso di lavoro è stato annullato o meno. Il valore zero non indica che il parametro non è stato fornito, ma che la condizione descritta dal parametro non si è verificata.
Alcune delle metriche di Amazon SWF per CloudWatch quel rapporto a `Count` in CloudWatch sono un *conteggio* al secondo. Ad esempio`ProvisionedRefillRate`, che viene riportato come un `Count` in CloudWatch, rappresenta una *frequenza* `Count` delle richieste al secondo.
Per i parametri di numero, minimo e massimo saranno sempre zero o uno, ma la media sarà un valore che va da zero a uno.
## Parametri di eventi API e di decisione
Puoi monitorare sia gli eventi dell'API che quelli decisionali CloudWatch per fornire informazioni dettagliate sull'utilizzo e sulla capacità. Consulta [i decisori](swf-dev-actors.md#swf-dev-actors-deciders) nella [Concetti di base sul flusso di lavoro in Amazon SWF](swf-dg-basic.md) sezione e l'argomento [Decisione](https://docs.aws.amazon.com/amazonswf/latest/apireference/API_Decision.html) nel [riferimento alle API di Amazon Simple Workflow Service](https://docs.aws.amazon.com/amazonswf/latest/apireference/).
Puoi anche monitorare questi limiti per generare allarmi quando ti avvicini ai limiti di limitazione di Amazon SWF. Per una descrizione di questi limiti e delle relative impostazioni di default, consulta [Quote di limitazione di Amazon SWF](swf-dg-limits.md#swf-throttling-limits). Questi limiti impediscono ai flussi di lavoro non corretti di utilizzare risorse di sistema eccessive. Per richiedere un aumento di tali limiti, consulta [Richiesta di aumento delle quote](swf-dg-limits.md#swf-dg-limits-how-to-increase).
Come best practice, dovresti configurare gli CloudWatch allarmi a circa il 60% della capacità delle tue API o degli eventi decisionali. Ciò ti consentirà di modificare il flusso di lavoro o richiedere un aumento del limite di servizio prima che la limitazione di Amazon SWF sia abilitata. A seconda del [burstiness](https://en.wikipedia.org/wiki/Burstiness) delle chiamate, puoi configurare vari allarmi per segnalare quando i limiti del servizio stanno per essere superati:
+ Se il traffico presenta picchi importanti, imposta un allarme al 60% dei limiti `ProvisionedBucketSize`.
+ Se la frequenza delle chiamate è regolare, imposta un allarme al 60% del limite `ProvisionedRefillRate` per gli eventi API e di decisione correlati.
## Metriche di Amazon SWF
Le seguenti metriche sono disponibili per Amazon SWF:
| Metrica | Description |
| --- | --- |
| `DecisionTaskScheduleToStartTime` | L'intervallo di tempo, in millisecondi, tra il momento in cui il task di decisione è stato pianificato e quello in cui è stato acquisito da un lavoratore e avviato. CloudWatch Unità: `Time` Dimensioni: `Domain, WorkflowTypeName, WorkflowTypeVersion` Statistiche valide: `Average, Minimum, Maximum` |
| `DecisionTaskStartToCloseTime` | L'intervallo di tempo, in millisecondi, tra il momento in cui il task di decisione è stato avviato e quello in cui è stato chiuso. CloudWatch Unità: `Time` Dimensioni: `Domain, WorkflowTypeName, WorkflowTypeVersion` Statistiche valide: `Average, Minimum, Maximum` |
| `DecisionTasksCompleted` | Il numero di task di decisione completati. CloudWatch Unità: `Count` Dimensioni: `Domain, WorkflowTypeName, WorkflowTypeVersion` Statistiche valide: `Sum` |
| PendingTasks | Il conteggio delle attività in sospeso in un intervallo di 1 minuto per un determinato elenco di attività. CloudWatch Unità: `Count` Dimensioni: `Domain, TaskListName` Statistiche valide: `Sum` |
| `StartedDecisionTasksTimedOutOnClose` | Il numero di task di decisione iniziati ma scaduti alla chiusura. CloudWatch Unità: `Count` Dimensioni: `Domain, WorkflowTypeName, WorkflowTypeVersion` Statistiche valide: `Sum` |
| `WorkflowStartToCloseTime` | L'intervallo di tempo, in millisecondi, tra il momento in cui il flusso di lavoro è stato avviato e quello in cui è stato chiuso. CloudWatch Unità: `Time` Dimensioni: `Domain, WorkflowTypeName, WorkflowTypeVersion` Statistiche valide: `Average, Minimum, Maximum` |
| `WorkflowsCanceled` | Il numero di flussi di lavoro che sono stati annullati. CloudWatch Unità: `Count` Dimensioni: `Domain, WorkflowTypeName, WorkflowTypeVersion` Statistiche valide: `Sum` |
| `WorkflowsCompleted` | Il numero di flussi di lavoro che sono stati completati. CloudWatch Unità: `Count` Dimensioni: `Domain, WorkflowTypeName, WorkflowTypeVersion` Statistiche valide: `Sum` |
| `WorkflowsContinuedAsNew` | Il numero di flussi di lavoro che sono continuati come nuovi. CloudWatch Unità: `Count` Dimensioni: `Domain, WorkflowTypeName, WorkflowTypeVersion` Statistiche valide: `Sum` |
| `WorkflowsFailed` | Il numero di flussi di lavoro non riusciti. CloudWatch Unità: `Count` Dimensioni: `Domain, WorkflowTypeName, WorkflowTypeVersion` Statistiche valide: `Sum` |
| `WorkflowsTerminated` | Il numero di flussi di lavoro che sono stati terminati. CloudWatch Unità: `Count` Dimensioni: `Cause, Domain, WorkflowTypeName, WorkflowTypeVersion` Statistiche valide: `Sum` |
| `WorkflowsTimedOut` | Il numero di esecuzioni che sono scadute (per qualsiasi motivo). CloudWatch Unità: `Count` Dimensioni: `Domain, WorkflowTypeName, WorkflowTypeVersion` Statistiche valide: `Sum` |
| `ActivityTaskScheduleToCloseTime` | L'intervallo di tempo, in millisecondi, tra il momento in cui l'attività è stata pianificata e quello in cui è stata chiusa. CloudWatch Unità: `Time` Dimensioni: `Domain, ActivityTypeName, ActivityTypeVersion` Statistiche valide: `Average, Minimum, Maximum` |
| `ActivityTaskScheduleToStartTime` | L'intervallo di tempo, in millisecondi, tra il momento in cui l'attività è stata pianificata e quello in cui è stata avviata. CloudWatch Unità: `Time` Dimensioni: `Domain, ActivityTypeName, ActivityTypeVersion` Statistiche valide: `Average, Minimum, Maximum` |
| `ActivityTaskStartToCloseTime` | L'intervallo di tempo, in millisecondi, tra il momento in cui il task di attività è stato avviato e quello in cui è stato chiuso. CloudWatch Unità: `Time` Dimensioni: `Domain, ActivityTypeName, ActivityTypeVersion` Statistiche valide: `Average, Minimum, Maximum` |
| `ActivityTasksCanceled` | Il numero di attività che sono state annullate. CloudWatch Unità: `Count` Dimensioni: `Domain, ActivityTypeName, ActivityTypeVersion` Statistiche valide: `Sum` |
| `ActivityTasksCompleted` | Il numero di attività che sono state completate. CloudWatch Unità: `Count` Dimensioni: `Domain, ActivityTypeName, ActivityTypeVersion` Statistiche valide: `Sum` |
| `ActivityTasksFailed` | Il numero di attività che non sono andate a buon fine. CloudWatch Unità: `Count` Dimensioni: `Domain, ActivityTypeName, ActivityTypeVersion` Statistiche valide: `Sum` |
| `ScheduledActivityTasksTimedOutOnClose` | Il numero di attività che sono state pianificate ma sono scadute alla chiusura. CloudWatch Unità: `Count` Dimensioni: `Domain, ActivityTypeName, ActivityTypeVersion` Statistiche valide: `Sum` |
| `ScheduledActivityTasksTimedOutOnStart` | Il numero di attività che sono state pianificate ma sono scadute all'avvio. CloudWatch Unità: `Count` Dimensioni: `Domain, ActivityTypeName, ActivityTypeVersion` Statistiche valide: `Sum` |
| `StartedActivityTasksTimedOutOnClose` | Il numero di attività che sono iniziate ma sono scadute alla chiusura. CloudWatch Unità: `Count` Dimensioni: `Domain, ActivityTypeName, ActivityTypeVersion` Statistiche valide: `Sum` |
| `StartedActivityTasksTimedOutOnHeartbeat` | Il numero di attività che sono iniziate ma sono scadute a causa di un timeout di heartbeat. CloudWatch Unità: `Count` Dimensioni: `Domain, ActivityTypeName, ActivityTypeVersion` Statistiche valide: `Sum` |
| `ThrottledEvents` | Il numero di richieste che sono state limitate. CloudWatch Unità: `Count` Dimensioni: `APIName, DecisionName, ThrottlingScope` Statistiche valide: `Sum` |
| `ProvisionedBucketSize` | Il numero di richieste disponibili al secondo. Dimensioni: `APIName, DecisionName` Statistiche valide: `Minimum` |
| `ConsumedCapacity` | Il numero di richieste al secondo. CloudWatch Unità: `Count` Dimensioni: `APIName, DecisionName` Statistiche valide: `Sum` |
| ConsumedLimit | L'importo del limite generale che è stato consumato. Dimensioni: `GeneralLimitType` |
| `ProvisionedRefillRate` | Il numero di richieste al secondo consentite nel bucket. Dimensioni: `APIName, DecisionName` Statistiche valide: `Minimum` |
| ProvisionedLimit | L'importo del limite generale assegnato all'account. Dimensioni: `GeneralLimitType` |
| Dimensione | Description |
| --- | --- |
| `Domain` | Filtra i dati nel dominio Amazon SWF in cui è in esecuzione il flusso di lavoro o l'attività. |
| `ActivityTypeName` | Filtra i dati in base al nome del tipo di attività. |
| `ActivityTypeVersion` | Filtra i dati in base alla versione del tipo di attività. |
| `WorkflowTypeName` | Filtra i dati in base al nome del tipo di flusso di lavoro per l'esecuzione di flusso di lavoro corrente. |
| `WorkflowTypeVersion` | Filtra i dati in base alla versione del tipo di flusso di lavoro per l'esecuzione di flusso di lavoro corrente. |
| `APIName` | Filtra i dati in base a un'API con il nome API specificato. |
| `DecisionName` | Filtra i dati in base al nome di decisione specificato. |
| `TaskListName` | Filtra i dati in base al nome dell'elenco di attività specificato. |
| `TaskListClassification` | Filtra i dati in base alla classificazione dell'elenco delle attività. Il valore è «D» per gli elenchi delle attività decisionali e «A» per gli elenchi delle attività. |
| `ThrottlingScope` | Filtra i dati in base all'ambito di limitazione specificato. Il valore è «Account» quando si supera la quota a livello di account o «Workflow» quando si supera la quota a livello di flusso di lavoro. |
## Nomi e dimensioni delle risorse non ASCII di Amazon SWF CloudWatch
Amazon SWF consente caratteri non ASCII nei nomi di risorse come e. TaskList DomainName Tuttavia, i valori delle dimensioni delle CloudWatch metriche possono contenere solo caratteri ASCII stampabili. Per garantire che Amazon SWF utilizzi valori di dimensione compatibili con i [CloudWatch requisiti, i](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_Dimension.html) nomi delle risorse Amazon SWF che non soddisfano questi requisiti vengono convertiti e avranno un checksum aggiunto come segue:
+ Qualsiasi carattere non ASCII viene sostituito con. `?`
+ La stringa di input o la stringa convertita, se necessario, verrà troncata. Ciò garantisce che quando viene aggiunto il checksum, la nuova lunghezza della stringa non superi il valore massimo. CloudWatch
+ Poiché tutti i caratteri non ASCII vengono convertiti in`?`, alcuni valori delle dimensioni CloudWatch metriche che erano diversi prima della conversione potrebbero sembrare gli stessi dopo la conversione. Per aiutarli a distinguerli, al nome della risorsa viene aggiunto un trattino basso (`_`) seguito dai primi 16 caratteri del SHA256 checksum del nome della risorsa originale.
Esempi di conversione:
+ `test àpple`verrebbe convertito in `test ?pple_82cc5b8e3a771d12`
+ `àòà`verrebbe convertito in`???_2fec5edbb2c05c22`.
+ I TaskList nomi `àpplé` e `âpplè` verrebbero entrambi convertiti `?ppl?` in e sarebbero identici. L'aggiunta del checksum restituisce valori distinti e`?ppl?_f39a36df9d85a69d`. `?ppl?_da3efb4f11dd0f7f`
**Suggerimento**
È possibile generare il proprio checksum. SHA256 Ad esempio, per utilizzare lo strumento da riga di `shasum` comando:
**echo -n "" \$1 shasum -a 256 \$1 cut -c1-16**