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

# Usa il driver di registro awslogs
<a name="using_awslogs"></a>

Per impostazione predefinita, AWS Batch consente al driver di `awslogs` registro di inviare informazioni di registro a CloudWatch Logs. È possibile utilizzare questa funzionalità per visualizzare diversi registri dei contenitori in un'unica comoda posizione ed evitare che i registri dei contenitori occupino spazio su disco sulle istanze del contenitore. Questo argomento consente di configurare il driver di `awslogs` registro nelle definizioni dei processi.

**Nota**  
Nella AWS Batch console, è possibile configurare il driver di `awslogs` registro nella sezione **Configurazione della registrazione** quando si crea una definizione di processo.

**Nota**  
Il tipo di informazioni registrate dai contenitori del processo dipende principalmente dal loro `ENTRYPOINT` comando. Per impostazione predefinita, i log acquisiti mostrano l'output del comando che normalmente si vede in un terminale interattivo se il contenitore viene eseguito localmente, ovvero i flussi `STDOUT` and `STDERR` I/O . Il driver di `awslogs` registro passa semplicemente questi log da Docker a Logs. CloudWatch Per ulteriori informazioni su come vengono elaborati i log Docker, inclusi metodi alternativi per acquisire diversi flussi o dati di file, consulta l'articolo relativo alla [visualizzazione di log per un container o servizio](https://docs.docker.com/config/containers/logging/) nella documentazione di Docker.

Per inviare i log di sistema dalle istanze del contenitore a Logs, vedi. CloudWatch [Utilizzo dei CloudWatch registri con AWS Batch](using_cloudwatch_logs.md) Per ulteriori informazioni sui CloudWatch log, consulta [Monitoring Log Files](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/WhatIsCloudWatchLogs.html) e [CloudWatch Logs quote](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/cloudwatch_limits_cwl.html) nella *Amazon CloudWatch Logs* User Guide.

## awslogs registra le opzioni del driver nel tipo di dati AWS Batch JobDefiniton
<a name="create_awslogs_logdriver_options"></a>

Il driver di `awslogs` registro supporta le seguenti opzioni nelle AWS Batch definizioni dei processi. Per ulteriori informazioni, consulta [CloudWatch Logs logging driver](https://docs.docker.com/config/containers/logging/awslogs/) nella documentazione Docker.

`awslogs-region`  
Obbligatorio: no  
Specificate la regione in cui il driver di `awslogs` registro deve inviare i log Docker. Per impostazione predefinita, la regione utilizzata è la stessa di quella per il lavoro. Puoi scegliere di inviare tutti i log dei lavori in diverse regioni a una singola regione in CloudWatch Logs. In questo modo, saranno visibili tutti da un'unica posizione. In alternativa, puoi separarli per regione per un approccio più granulare. Tuttavia, quando scegliete questa opzione, assicuratevi che i gruppi di log specificati esistano nella regione specificata.

`awslogs-group`  
Obbligatorio: facoltativo  
Con l'`awslogs-group`opzione, è possibile specificare il gruppo di log a cui il driver di `awslogs` log invia i propri flussi di log. Se questo non è specificato, `aws/batch/job` viene utilizzato.

`awslogs-stream-prefix`  
Obbligatorio: facoltativo  
Con l'`awslogs-stream-prefix`opzione, puoi associare un flusso di log al prefisso specificato e all'ID attività Amazon ECS del AWS Batch lavoro a cui appartiene il contenitore. Se specifichi un prefisso con questa opzione, il flusso di log assume il formato seguente:  

```
prefix-name/default/ecs-task-id
```

`awslogs-datetime-format`  
Obbligatorio: no  
Questa opzione definisce un modello di inizio multilinea nel formato `strftime` Python. Un messaggio di log è costituito da una riga che corrisponde allo schema e da tutte le righe successive che non corrispondono allo schema. In questo modo la riga associata è il delimitatore tra i messaggi di log.  
Un esempio di un caso d'uso per l'utilizzo di questo formato è per l'analisi di output, ad esempio uno dump dello stack, che potrebbe altrimenti essere registrato in più voci. Il modello corretto consente di acquisirlo in una sola voce.  
Per ulteriori informazioni, consulta [awslogs-datetime-format](https://docs.docker.com/config/containers/logging/awslogs/#awslogs-datetime-format).  
Questa opzione è sempre prioritaria nel caso in cui siano configurati sia `awslogs-datetime-format` che `awslogs-multiline-pattern`.  
Il logging multilinea esegue un'espressione regolare per l'analisi e il confronto di tutti i messaggi di log. L'operazione potrebbe avere ripercussioni negative sulle prestazioni del logging.

`awslogs-multiline-pattern`  
Obbligatorio: no  
Questa opzione definisce un modello di inizio multilinea utilizzando un'espressione regolare. Un messaggio di registro è costituito da una riga che corrisponde allo schema e da tutte le righe successive che non corrispondono allo schema. Pertanto, la riga corrispondente è il delimitatore tra i messaggi di registro.  
Per ulteriori informazioni, consulta la documentazione di [awslogs-multiline-pattern](https://docs.docker.com/config/containers/logging/awslogs/#awslogs-multiline-pattern)Docker.  
Questa opzione viene ignorata se anche `awslogs-datetime-format` è configurato.  
Il logging multilinea esegue un'espressione regolare per l'analisi e il confronto di tutti i messaggi di log. L'operazione potrebbe avere ripercussioni negative sulle prestazioni del logging.

`awslogs-create-group`  
Obbligatorio: no  
Specifica se desideri che il gruppo di log venga creato automaticamente. Se questa opzione non è specificata, viene impostata in modo predefinito su `false`.  
Questa opzione non è consigliata. Si consiglia di creare il gruppo di log in anticipo utilizzando l'azione CloudWatch Logs [CreateLogGroup](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_CreateLogGroup.html)API ogni volta che ogni job tenta di creare il gruppo di log, aumentando la probabilità che il processo non riesca.
La policy IAM per il tuo ruolo di esecuzione deve includere l'`logs:CreateLogGroup`autorizzazione prima di tentare di `awslogs-create-group` utilizzarla.

## Specificate una configurazione di registro nella definizione del lavoro
<a name="specify-log-config"></a>

Per impostazione predefinita, AWS Batch abilita il driver di `awslogs` registro. Questa sezione descrive come personalizzare la configurazione del `awslogs` registro per un lavoro. Per ulteriori informazioni, consulta [Creare una definizione di processo a nodo singolo](create-job-definition.md).

I seguenti frammenti JSON di configurazione del registro hanno un `logConfiguration` oggetto specificato per ogni processo. Uno è per un WordPress processo che invia i log a un gruppo di log chiamato `awslogs-wordpress` e un altro è per un contenitore MySQL che invia i log a un gruppo di log chiamato. `awslogs-mysql` Entrambi i container utilizzano il prefisso `awslogs-example` per il flusso di log.

```
"logConfiguration": {
    "logDriver": "awslogs",
    "options": {
        "awslogs-group": "awslogs-wordpress",
        "awslogs-stream-prefix": "awslogs-example"
    }
}
```

```
"logConfiguration": {
    "logDriver": "awslogs",
    "options": {
        "awslogs-group": "awslogs-mysql",
        "awslogs-stream-prefix": "awslogs-example"
    }
}
```

Nella AWS Batch console, la configurazione del registro per la definizione del `wordpress` processo viene specificata come mostrato nell'immagine seguente. 

![\[Log configuration interface showing awslogs driver with group and stream prefix options.\]](http://docs.aws.amazon.com/it_it/batch/latest/userguide/images/awslogs-console-config.png)


Dopo aver registrato una definizione di attività con il driver di `awslogs` registro in una configurazione del registro delle definizioni del processo, è possibile inviare un lavoro con tale definizione di processo per iniziare a inviare i log ai CloudWatch registri. Per ulteriori informazioni, consulta [Tutorial: invia un lavoro](submit_job.md).