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 con Amazon CloudWatch Logs
Configura AWS IoT SiteWise per registrare le informazioni in CloudWatch Logs per monitorare e risolvere i problemi del servizio.
Quando usi la AWS IoT SiteWise console, AWS IoT SiteWise crea un ruolo collegato al servizio che consente al servizio di registrare le informazioni per tuo conto. Se non utilizzi la AWS IoT SiteWise console, devi creare manualmente un ruolo collegato al servizio per ricevere i log. Per ulteriori informazioni, consulta [Crea un ruolo collegato al servizio per AWS IoT SiteWise](create-service-linked-role.md).
È necessario disporre di una politica delle risorse che AWS IoT SiteWise consenta di inserire gli eventi di registro negli stream. CloudWatch Per creare e aggiornare una politica delle risorse per CloudWatch Logs, esegui il comando seguente. Sostituisci *logging-policy-name* con il nome della politica da creare.
```
aws logs put-resource-policy --policy-name logging-policy-name --policy-document "{ \"Version\": \"2012-10-17\", \"Statement\": [ { \"Sid\": \"IoTSiteWiseToCloudWatchLogs\", \"Effect\": \"Allow\", \"Principal\": { \"Service\": [ \"iotsitewise.amazonaws.com\" ] }, \"Action\":\"logs:PutLogEvents\", \"Resource\": \"*\" } ] }"
```
CloudWatch Logs supporta anche le chiavi di contesto [aws: SourceArn](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-sourcearn) [e aws: SourceAccount](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-ke-sourceaccount) condition. Queste chiavi di contesto delle condizioni sono opzionali.
Per creare o aggiornare una politica delle risorse che AWS IoT SiteWise consenta di inserire solo i log associati alla AWS IoT SiteWise risorsa specificata negli CloudWatch stream, esegui il comando ed esegui quanto segue:
+ Sostituisci *logging-policy-name* con il nome della politica da creare.
+ Sostituisci *source-ARN* con l'ARN della tua AWS IoT SiteWise risorsa, ad esempio un modello o un asset di asset. Per trovare l'ARN per ogni tipo di AWS IoT SiteWise risorsa, vedere [Tipi di risorse definiti da AWS IoT SiteWise](https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsiotsitewise.html#awsiotsitewise-resources-for-iam-policies) nel *Service Authorization* Reference.
+ Sostituisci *account-ID* con l'ID AWS dell'account associato alla AWS IoT SiteWise risorsa specificata.
```
aws logs put-resource-policy --policy-name logging-policy-name --policy-document "{ \"Version\": \"2012-10-17\", \"Statement\": [ { \"Sid\": \"IoTSiteWiseToCloudWatchLogs\", \"Effect\": \"Allow\", \"Principal\": { \"Service\": [ \"iotsitewise.amazonaws.com\" ] }, \"Action\":\"logs:PutLogEvents\", \"Resource\": \"*\", \"Condition\":{\"StringLike\":{\"aws:SourceArn\":[\"source-ARN\"],\"aws:SourceAccount\":[\"account-ID\"]}}}]}"
```
Per impostazione predefinita, AWS IoT SiteWise non registra le informazioni CloudWatch nei registri. Per attivare la registrazione, scegliete un livello di registrazione diverso da **Disabilitato** (). `OFF` AWS IoT SiteWise supporta i seguenti livelli di registrazione:
+ `OFF`— La registrazione è disattivata.
+ `ERROR`— Gli errori vengono registrati.
+ `INFO`— Gli errori e i messaggi informativi vengono registrati.
È possibile configurare i gateway SiteWise Edge per registrare le informazioni su Logs through. CloudWatch AWS IoT Greengrass Per ulteriori informazioni, consulta [Monitora i log del gateway SiteWise Edge](monitor-gateway-logs.md).
È inoltre possibile configurare AWS IoT Core la registrazione delle informazioni nei CloudWatch registri se si sta risolvendo un'azione relativa a una AWS IoT SiteWise regola. Per ulteriori informazioni, consulta [Risolvere i problemi relativi a un' AWS IoT SiteWise azione delle regole](troubleshoot-rule.md).
**Contents**
+ [Gestisci l'accesso AWS IoT SiteWise](#manage-cloudwatch-logs)
+ [Trova il tuo livello di registrazione](#find-logging-level)
+ [Cambia il tuo livello di registrazione](#change-logging-level)
+ [Esempio: voci dei file di AWS IoT SiteWise registro](#sitewise-log-format)
## Gestisci l'accesso AWS IoT SiteWise
Utilizza la AWS IoT SiteWise console o AWS CLI per le seguenti attività di configurazione della registrazione.
### Trova il tuo livello di registrazione
------
#### [ Console ]
Utilizza la procedura seguente per trovare il livello di registrazione corrente nella console AWS IoT SiteWise .
**Per trovare il tuo attuale livello di AWS IoT SiteWise registrazione**
1. Passare alla [console AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).
1. Nel riquadro di navigazione a sinistra, scegliere **Logging options (Opzioni di registrazione)**.
Lo stato di registrazione corrente viene visualizzato in **Logging status (Stato di registrazione)**. Se la registrazione è attivata, il livello di registrazione corrente viene visualizzato in **Livello** di dettaglio.
------
#### [ AWS CLI ]
Esegui il comando seguente per trovare il tuo attuale livello di AWS IoT SiteWise registrazione con. AWS CLI
```
aws iotsitewise describe-logging-options
```
L'operazione restituisce una risposta contenente il livello di registrazione nel formato seguente.
```
{
"loggingOptions": {
"level": "String"
}
}
```
------
### Cambia il tuo livello di registrazione
Utilizzare la procedura seguente per modificare il livello di registrazione nella AWS IoT SiteWise console o in uso. AWS CLI
------
#### [ Console ]
**Per modificare il livello di AWS IoT SiteWise registrazione**
1. Passare alla [console AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).
1. Nel riquadro di navigazione a sinistra, scegliere **Logging options (Opzioni di registrazione)**.
1. Scegli **Modifica**.
1. Scegli il **livello di verbosità** da attivare.
1. Seleziona **Salva**.
------
#### [ AWS CLI ]
Esegui il AWS CLI comando seguente per modificare il livello di AWS IoT SiteWise registrazione. Sostituisci *logging-level* con il livello di registrazione desiderato.
```
aws iotsitewise put-logging-options --logging-options level=logging-level
```
------
## Esempio: voci dei file di AWS IoT SiteWise registro
Ogni voce di AWS IoT SiteWise registro include informazioni sull'evento e risorse pertinenti per quell'evento, in modo da poter comprendere e analizzare i dati di registro.
L'esempio seguente mostra una voce CloudWatch Logs che AWS IoT SiteWise registra quando si crea correttamente un modello di asset.
```
{
"eventTime": "2020-05-05T00:10:22.902Z",
"logLevel": "INFO",
"eventType": "AssetModelCreationSuccess",
"message": "Successfully created asset model.",
"resources": {
"assetModelId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE"
}
}
```