

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à.

# Monitora l'esecuzione del workflow
<a name="cloudwatch-workflow"></a>

Amazon CloudWatch monitora AWS le tue risorse e le applicazioni che esegui Cloud AWS in tempo reale. Puoi usare Amazon CloudWatch per raccogliere e tenere traccia delle metriche, che sono variabili che puoi misurare per i tuoi flussi di lavoro. Puoi visualizzare le metriche del flusso di lavoro e i log consolidati utilizzando Amazon. CloudWatch

## CloudWatch registrazione per un flusso di lavoro
<a name="cloudwatch-workflow-logs"></a>

CloudWatch fornisce un controllo e una registrazione consolidati dell'avanzamento e dei risultati del flusso di lavoro.

AWS Transfer Family offre due modi per fornire i log di esecuzione dei flussi di lavoro gestiti ad Amazon: CloudWatch
+ **Un gruppo di log specificato da te (destinazione del log strutturato)**: specifichi un gruppo di CloudWatch log Logs come destinazione di log strutturata per il flusso di lavoro e Transfer Family fornisce i log di esecuzione del flusso di lavoro a quel gruppo di log per te. Questa opzione non richiede un ruolo di registrazione. Per utilizzarla, fornisci l'Amazon Resource Name (ARN) di un gruppo di log nel `StructuredLogDestinations` parametro quando crei il flusso di lavoro (vedi [ StructuredLogDestinations ](https://docs.aws.amazon.com/transfer/latest/APIReference/API_CreateWorkflow.html#TransferFamily-CreateWorkflow-request-StructuredLogDestinations) nell'*AWS Transfer Family API Reference*). Il gruppo di log deve appartenere allo stesso Account AWS e Regione AWS al flusso di lavoro.

  Per configurare una destinazione di log strutturata, la policy IAM per il principale che crea il flusso di lavoro deve contenere le seguenti autorizzazioni:
  + `logs:CreateLogDelivery`
  + `logs:DeleteLogDelivery`
  + `logs:DescribeLogGroups`
  + `logs:DescribeResourcePolicies`
  + `logs:GetLogDelivery`
  + `logs:ListLogDeliveries`
  + `logs:PutResourcePolicy`
  + `logs:UpdateLogDelivery`
+ **Un ruolo di registrazione**: si collega un ruolo di registrazione IAM al server a cui è collegato il flusso di lavoro. Transfer Family assume il ruolo di scrivere i log di esecuzione del flusso di lavoro in un gruppo di log denominato. `/aws/transfer/{{server-id}}` Per informazioni dettagliate, vedi [Configurare il CloudWatch ruolo di registrazione](configure-cw-logging-role.md).

Entrambi i meccanismi scrivono lo stesso contenuto del registro di esecuzione del flusso di lavoro nello stesso formato JSON. La differenza è solo dove vengono consegnati i log: al gruppo di log specificato o al gruppo di `/aws/transfer/{{server-id}}` log sul server tramite il ruolo di registrazione.

**Visualizza i CloudWatch log di Amazon per i flussi di lavoro**

1. Apri la CloudWatch console Amazon all'indirizzo. [ https://console.aws.amazon.com/cloudwatch/ ](https://console.aws.amazon.com/cloudwatch/)

1. Nel riquadro di navigazione a sinistra, scegli ** Logs**, quindi scegli ** Log groups**.

1. Nella ** pagina Gruppi di ** log, nella barra di navigazione, scegli la regione corretta per il tuo AWS Transfer Family server.

1. Scegli il gruppo di log che contiene i log del flusso di lavoro.
   + Se il flusso di lavoro utilizza una destinazione di registro strutturata, scegli il gruppo di log il cui ARN è stato specificato nel `StructuredLogDestinations` parametro del flusso di lavoro.
   + Se il flusso di lavoro utilizza un ruolo di registrazione sul server, scegli il gruppo di log che corrisponde al tuo server. Ad esempio, se l'ID del tuo server è`s-1234567890abcdef0`, il tuo gruppo di log lo è`/aws/transfer/s-1234567890abcdef0`.

1. Nella pagina dei dettagli del gruppo di log, vengono visualizzati i flussi di log più recenti. Il nome del flusso di log per il workflow dipende dal meccanismo di registrazione utilizzato dal workflow:
   + Per una destinazione di log strutturata, viene denominato `{{workflowID}}/{{executionID}}` il flusso di log del flusso di lavoro. Ad esempio:

     ```
     w-abcdef01234567890/021345abcdef6789
     ```
   + Per un ruolo di registrazione, il gruppo di log del server contiene due flussi di log per l'utente che si sta esplorando: uno per ogni sessione di File Transfer Protocol (SFTP) Secure Shell (SSH) e uno per il flusso di lavoro in esecuzione. Il formato per il flusso di log del flusso di lavoro è. `{{username}}.{{workflowID}}.{{uniqueStreamSuffix}}`

   Ad esempio, se il tuo utente lo è`mary-major`, hai i seguenti flussi di log:

   ```
   mary-major-east.1234567890abcdef0
   mary.w-abcdef01234567890.021345abcdef6789
   ```
**Nota**  
 Gli identificatori alfanumerici a 16 cifre elencati in questo esempio sono fittizi. I valori che vedi in Amazon sono diversi. CloudWatch 

La ** pagina degli eventi di ** registro per un flusso di log del flusso di lavoro contiene i dettagli per l'esecuzione del flusso di lavoro. Se il flusso di lavoro utilizza un ruolo di registrazione, lo `mary-major-usa-east.1234567890abcdef0` stream visualizza i dettagli per ogni sessione utente e `mary.w-abcdef01234567890.021345abcdef6789` lo stream contiene i dettagli del flusso di lavoro. Se il flusso di lavoro utilizza una destinazione di registro strutturata, lo `w-abcdef01234567890/021345abcdef6789` stream contiene i dettagli del flusso di lavoro. 

 Di seguito è riportato un esempio di flusso di log per`mary.w-abcdef01234567890.021345abcdef6789`, basato su un workflow (`w-abcdef01234567890`) che contiene una fase di copia. 

```
{
    "type": "ExecutionStarted",
    "details": {
        "input": {
            "initialFileLocation": {
                "bucket": "amzn-s3-demo-bucket",
                "key": "mary/workflowSteps2.json",
                "versionId": "{{version-id}}",
                "etag": "{{etag-id}}"
            }
        }
    },
    "workflowId":"w-abcdef01234567890",
    "executionId":"{{execution-id}}",
    "transferDetails": {
        "serverId":"s-{{server-id}}",
        "username":"mary",
        "sessionId":"{{session-id}}"
    }
},
{
    "type":"StepStarted",
    "details": {
        "input": {
            "fileLocation": {
                "backingStore":"S3",
                "bucket":"amzn-s3-demo-bucket",
                "key":"mary/workflowSteps2.json",
                "versionId":"{{version-id}}",
                "etag":"{{etag-id}}"
            }
        },
        "stepType":"COPY",
        "stepName":"copyToShared"
    },
    "workflowId":"w-abcdef01234567890",
    "executionId":"{{execution-id}}",
    "transferDetails": {
        "serverId":"s-{{server-id}}",
        "username":"mary",
        "sessionId":"{{session-id}}"
    }
},
{
    "type":"StepCompleted",
    "details":{
        "output":{},
        "stepType":"COPY",
        "stepName":"copyToShared"
    },
    "workflowId":"w-abcdef01234567890",
    "executionId":"{{execution-id}}",
    "transferDetails":{
        "serverId":"{{server-id}}",
        "username":"mary",
        "sessionId":"{{session-id}}"
    }
},
{
    "type":"ExecutionCompleted",
    "details": {},
    "workflowId":"w-abcdef01234567890",
    "executionId":"{{execution-id}}",
    "transferDetails":{
        "serverId":"s-{{server-id}}",
        "username":"mary",
        "sessionId":"{{session-id}}"
    }
}
```

## CloudWatch metriche per i flussi di lavoro
<a name="cloudwatch-workflows-metrics"></a>

AWS Transfer Family fornisce diverse metriche per i flussi di lavoro. È possibile visualizzare le metriche relative al numero di esecuzioni dei flussi di lavoro avviate, completate con successo e non riuscite nel minuto precedente. Tutte le CloudWatch metriche per Transfer Family sono descritte in. [Utilizzo CloudWatch delle metriche per i server Transfer Family](metrics.md)