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à.
# Risolvere i problemi relativi a un' AWS IoT SiteWise azione delle regole
Per risolvere i problemi relativi all'azione della AWS IoT SiteWise regola in AWS IoT Core, è possibile eseguire una delle seguenti procedure:
+ Configurazione di Amazon CloudWatch Logs
+ Configurare un'azione di ripubblicazione dell'errore per la regola
Quindi, confrontare i messaggi di errore con gli errori presenti in questo argomento per risolvere il problema.
**Topics**
+ [Configura i log AWS IoT Core](#configure-iot-logs)
+ [Configura un'azione di errore di ripubblicazione](#configure-republish-error-action)
+ [Risolvi i problemi relativi alle regole](#troubleshoot-rule-issues)
+ [Risolvere i problemi relativi a una regola ()AWS IoT SiteWise](#rule-tutorial-troubleshoot-rule)
+ [Risoluzione dei problemi relativi a una regola (DynamoDB)](#dynamodb-tutorial-troubleshoot-rule)
## Configura i log AWS IoT Core
È possibile AWS IoT configurare la registrazione di vari livelli di informazioni nei CloudWatch registri.
**Per configurare e accedere ai registri CloudWatch**
1. *Per configurare la registrazione per AWS IoT Core, consulta [Monitoring with CloudWatch Logs](https://docs.aws.amazon.com/iot/latest/developerguide/cloud-watch-logs.html) nella Developer Guide.AWS IoT *
1. Passare alla [console CloudWatch ](https://console.aws.amazon.com/cloudwatch/).
1. Nel pannello di navigazione, selezionare **Log groups (Gruppi di log)**.
1. Scegli il gruppo **AWSIotLogs**.
1. Scegliere un flusso di log recente. Per impostazione predefinita, CloudWatch visualizza per primo il flusso di log più recente.
1. Scegliere una voce di log per espandere il messaggio di log. La voce di log potrebbe essere simile allo screenshot seguente.
![\[CloudWatch Schermata «AWS IoT Logs».\]](http://docs.aws.amazon.com/it_it/iot-sitewise/latest/userguide/images/rule-ingestion/troubleshoot-rule-logs-console.png)
1. Confrontare i messaggi di errore con gli errori in questo argomento per risolvere il problema.
## Configura un'azione di errore di ripubblicazione
Puoi configurare un'azione di errore sulla regola per gestire i messaggi di errore. In questa procedura, è possibile configurare l'azione regola di ripubblicazione come azione di errore per visualizzare i messaggi di errore nel client di test MQTT.
**Nota**
L'azione di ripubblicazione dell'errore genera solo un output equivalente ai log a livello di `ERROR`. [Se desideri registri più dettagliati, devi configurare i registri. CloudWatch ](#configure-iot-logs)
**Per aggiungere un'azione di errore di ripubblicazione a una regola**
1. Passare alla [console AWS IoT](https://console.aws.amazon.com/iot/).
1. Nel riquadro di navigazione sinistro scegliere **Atti** e quindi **Regole**.
1. Scegliere la regola.
1. In **Azione errore**, scegliere **Aggiungi azione**.
1. Scegli **Ripubblica un messaggio su un argomento**. AWS IoT
![\[AWS IoT Core Schermata della pagina «Seleziona un'azione» con l'azione Ripubblica evidenziata.\]](http://docs.aws.amazon.com/it_it/iot-sitewise/latest/userguide/images/rule-ingestion/rule-choose-republish-action-console.png)
1. Scegliere **Configura azione** nella parte inferiore della pagina.
1. In **Argomento**, inserisci un argomento unico (ad esempio,**sitewise/windfarm/rule/error**). AWS IoT Core ripubblicherà i messaggi di errore relativi a questo argomento.
1. Scegli **Seleziona** per concedere AWS IoT Core l'accesso per eseguire l'azione di errore.
1. Scegliere **Select (Seleziona)** accanto al ruolo creato per la regola.
1. Scegliere **Aggiorna ruolo** per aggiungere le autorizzazioni aggiuntive al ruolo.
1. Selezionare **Add action** (Aggiungi operazione).
L'azione di errore della regola è simile allo screenshot seguente.
![\[AWS IoT Core Pagina «Regola» Ripubblica lo screenshot dell'azione di errore.\]](http://docs.aws.amazon.com/it_it/iot-sitewise/latest/userguide/images/rule-ingestion/rule-confirm-republish-error-action-console.png)
1. Scegli la freccia rivolta verso il basso nella parte superiore sinistra della console per tornare alla home page della AWS IoT console.
Dopo aver impostato l'azione di ripubblicazione dell'errore, è possibile visualizzare i messaggi di errore nel client di test MQTT in AWS IoT Core.
Nella procedura seguente, si sottoscrive l'argomento di errore nel client di test MQTT. Nel client di test MQTT, è possibile ricevere i messaggi di errore della regola per risolvere il problema.
**Per sottoscrivere l'argomento dell'azione di errore**
1. Passare alla [console AWS IoT](https://console.aws.amazon.com/iot/).
1. Nel riquadro di navigazione a sinistra, scegliere **Test** per aprire il client di test MQTT.
1. Nel campo **Subscription topic (Argomento sottoscrizione)** immettere l'argomento di errore configurato in precedenza (ad esempio **sitewise/windfarm/rule/error**) e scegliere **Subscribe to topic (Effettua sottoscrizione all'argomento)**.
![\[AWS IoT Core Schermata della pagina «MQTT client» con il pulsante «Iscriviti all'argomento» evidenziato.\]](http://docs.aws.amazon.com/it_it/iot-sitewise/latest/userguide/images/rule-ingestion/troubleshoot-rule-subscribe-error-topic-console.png)
1. Controllare se vengono visualizzati messaggi di errore e quindi espandere l'array `failures` in qualsiasi messaggio di errore.
Confronta i messaggi di errore con gli errori presenti in questo argomento per risolvere il problema.
## Risolvi i problemi relativi alle regole
Utilizzare le seguenti informazioni per risolvere i problemi relativi alle regole.
**Topics**
+ [Errore: il membro deve trovarsi entro 604800 secondi prima e 300 secondi dopo il timestamp corrente](#rule-error-timestamp-out-of-range)
+ [Errore: il valore della proprietà non corrisponde al tipo di dati ](#rule-error-invalid-data-type)
+ [Errore: Utente: non autorizzato a eseguire: iotsitewise: on resource BatchPutAssetPropertyValue](#rule-error-role-not-authorized)
+ [Errore: iot.amazonaws.com non è in grado di eseguire: sts: on resource: AssumeRole ](#rule-error-unable-to-assume-role)
+ [Informazioni: non è stata inviata alcuna richiesta. PutAssetPropertyValueEntries era vuoto dopo aver eseguito i modelli sostitutivi.](#rule-info-request-was-empty)
### Errore: il membro deve trovarsi entro 604800 secondi prima e 300 secondi dopo il timestamp corrente
Il timestamp è più vecchio di 7 giorni o più recente di 5 minuti, rispetto all'ora attuale di Unix. Esegui quanto segue:
+ Controllare che il timestamp sia nell'ora in formato epoch Unix (UTC). Se si fornisce un timestamp con un fuso orario diverso, si riceve questo errore.
+ Verifica che il timestamp sia espresso in secondi. AWS IoT SiteWise prevede che i timestamp siano suddivisi in secondi (in epoca Unix) e offset in nanosecondi.
+ Verifica di caricare dati con data e ora non più tardi di 7 giorni nel passato.
### Errore: il valore della proprietà non corrisponde al tipo di dati
Una voce nell'azione di regola ha un tipo di dati diverso dalla proprietà dell'asset di destinazione. Ad esempio, la proprietà dell'asset di destinazione è di tipo `DOUBLE` ed è stato selezionato il tipo di dati **Integer** o è stato passato il valore `integerValue`. Esegui quanto segue:
+ Se configuri la regola dalla AWS IoT console, verifica di aver scelto il **tipo di dati** corretto per ogni immissione.
+ Se configuri la regola dall'API o AWS Command Line Interface (AWS CLI), verifica che l'`value`oggetto utilizzi il campo di tipo corretto (ad esempio, `doubleValue` per una `DOUBLE` proprietà).
### Errore: Utente: non autorizzato a eseguire: iotsitewise: on resource BatchPutAssetPropertyValue
La regola non è autorizzata ad accedere alla proprietà dell'asset di destinazione oppure la proprietà dell'asset di destinazione non esiste. Esegui quanto segue:
+ Verificare che l'alias della proprietà sia corretto e che si disponga di una proprietà dell'asset con l'alias di proprietà specificato. Per ulteriori informazioni, consulta [Gestisci i flussi di dati per AWS IoT SiteWise](manage-data-streams.md).
+ Verificare che la regola abbia un ruolo e che il ruolo conceda l'autorizzazione `iotsitewise:BatchPutAssetPropertyValue` alla proprietà dell'asset di destinazione, ad esempio tramite la gerarchia dell'asset di destinazione. Per ulteriori informazioni, consulta [Concedi AWS IoT l'accesso richiesto](grant-rule-access.md).
### Errore: iot.amazonaws.com non è in grado di eseguire: sts: on resource: AssumeRole
Il tuo utente non è autorizzato ad assumere il ruolo previsto dalla tua regola in (IAM). AWS Identity and Access Management
Verifica che al tuo utente sia concessa l'`iam:PassRole`autorizzazione per il ruolo in base alla tua regola. Per ulteriori informazioni, consulta [Pass role permissions](https://docs.aws.amazon.com/iot/latest/developerguide/pass-role.html) nella *AWS IoT Developer Guide*.
### Informazioni: non è stata inviata alcuna richiesta. PutAssetPropertyValueEntries era vuoto dopo aver eseguito i modelli sostitutivi.
**Nota**
Questo messaggio è un log a livello di `INFO`.
La richiesta deve includere almeno una voce con tutti i parametri richiesti.
Verificare che i parametri della regola, inclusi i modelli di sostituzione, restituiscano valori non vuoti. I modelli di sostituzione non possono accedere ai valori definiti nelle clausole `AS` dell'istruzione della query della regola. *Per ulteriori informazioni, consulta [Modelli sostitutivi](https://docs.aws.amazon.com/iot/latest/developerguide/iot-substitution-templates.html) nella Guida per gli sviluppatori.AWS IoT *
## Risolvere i problemi relativi a una regola ()AWS IoT SiteWise
Segui i passaggi di questa procedura per risolvere la regola se i dati sull'utilizzo della CPU e della memoria non vengono visualizzati come previsto. AWS IoT SiteWise In questa procedura, è possibile configurare l'azione regola di ripubblicazione come azione di errore per visualizzare i messaggi di errore nel client di test MQTT. Puoi anche configurare la registrazione su Logs per la risoluzione dei problemi. CloudWatch Per ulteriori informazioni, consulta [Risolvere i problemi relativi a un' AWS IoT SiteWise azione delle regole](#troubleshoot-rule).
**Per aggiungere un'azione di errore di ripubblicazione a una regola**
1. Passare alla [console AWS IoT](https://console.aws.amazon.com/iot/).
1. **Nel riquadro di navigazione a sinistra, scegli **Routing dei messaggi, quindi** scegli Regole.**
1. Scegli la regola che hai creato in precedenza e scegli **Modifica**.
1. In **Azione di errore - *facoltativa***, scegli **Aggiungi azione di errore**.
1. Scegli **Ripubblica un messaggio su un AWS IoT argomento**.
1. In **Argomento**, inserisci il percorso dell'errore (ad esempio,**sitewise/rule/tutorial/error**). AWS IoT Core ripubblicherà i messaggi di errore relativi a questo argomento.
1. Scegliete il ruolo che avete creato in precedenza (ad esempio, **SiteWiseTutorialDeviceRuleRole**).
1. Scegliere **Aggiorna**.
Dopo aver impostato l'azione di ripubblicazione dell'errore, è possibile visualizzare i messaggi di errore nel client di test MQTT in AWS IoT Core.
Nella procedura seguente, si sottoscrive l'argomento di errore nel client di test MQTT.
**Per sottoscrivere l'argomento dell'azione di errore**
1. Passare alla [console AWS IoT](https://console.aws.amazon.com/iot/).
1. Nella pagina di navigazione a sinistra, scegliete **MQTT test client** per aprire il client di test MQTT.
1. **Nel campo **Filtro argomento**, inserisci **sitewise/rule/tutorial/error** e scegli Iscriviti.**
Quando vengono visualizzati messaggi di errore, visualizzare l'array `failures` in qualsiasi messaggio di errore per diagnosticare i problemi. Per ulteriori informazioni sui possibili problemi e su come risolverli, consultare [Risolvere i problemi relativi a un' AWS IoT SiteWise azione delle regole](#troubleshoot-rule).
Se non vengono visualizzati errori, verificare che la regola sia abilitata e che sia stato sottoscritto lo stesso argomento configurato nell'azione errore di ripubblicazione. Se dopo questa operazione ancora non vengono visualizzati gli errori, verificare che lo script del dispositivo sia in esecuzione e aggiornare correttamente la shadow del dispositivo.
**Nota**
Puoi anche iscriverti all'argomento Shadow Update del tuo dispositivo per visualizzare il payload analizzato dalla tua AWS IoT SiteWise azione. A tale scopo, eseguire la sottoscrizione al seguente argomento.
```
$aws/things/+/shadow/update/accepted
```
## Risoluzione dei problemi relativi a una regola (DynamoDB)
Segui i passaggi di questa procedura per risolvere i problemi relativi alla regola se i dati dell'asset demo non vengono visualizzati nella tabella DynamoDB come previsto. In questa procedura, è possibile configurare l'azione regola di ripubblicazione come azione di errore per visualizzare i messaggi di errore nel client di test MQTT. Puoi anche configurare la registrazione su Logs per risolvere i problemi. CloudWatch Per ulteriori informazioni, consulta la sezione [Monitoraggio con i registri CloudWatch ](https://docs.aws.amazon.com/iot/latest/developerguide/cloud-watch-logs.html) nella *Guida per gli sviluppatori di AWS IoT *.
**Per aggiungere un'azione di errore di ripubblicazione a una regola**
1. Passare alla [console AWS IoT](https://console.aws.amazon.com/iot/).
1. Nel riquadro di navigazione sinistro scegliere **Atti** e quindi **Regole**.
1. Scegliere la regola creata in precedenza.
![\[AWS IoT Schermata principale della pagina «Regole».\]](http://docs.aws.amazon.com/it_it/iot-sitewise/latest/userguide/images/interact-dynamo-db/rule-choose-rule-console.png)
1. In **Azione errore**, scegliere **Aggiungi azione**.
1. Scegli **Ripubblica un messaggio su un argomento**. AWS IoT
![\[AWS IoT Schermata principale della pagina «Seleziona un'azione» con l'azione Ripubblica evidenziata.\]](http://docs.aws.amazon.com/it_it/iot-sitewise/latest/userguide/images/interact-dynamo-db/rule-choose-republish-action-console.png)
1. Scegliere **Configura azione** nella parte inferiore della pagina.
1. In **Topic (Argomento)**, inserisci **windspeed/error**. AWS IoT Core ripubblicherà i messaggi di errore su questo argomento.
![\[AWS IoT Schermata principale della pagina «Configura l'azione di ripubblicazione» con l' "Argomento» evidenziato.\]](http://docs.aws.amazon.com/it_it/iot-sitewise/latest/userguide/images/interact-dynamo-db/rule-configure-republish-action-console.png)
1. Scegli **Seleziona** per concedere a AWS IoT Core l'accesso per eseguire l'azione di errore utilizzando il ruolo che hai creato in precedenza.
1. Scegli **Seleziona** accanto al tuo ruolo.
![\[AWS IoT Schermata principale della pagina «Configura l'azione di ripubblicazione» con il pulsante di selezione del ruolo evidenziato.\]](http://docs.aws.amazon.com/it_it/iot-sitewise/latest/userguide/images/interact-dynamo-db/rule-select-role-console.png)
1. Scegliere **Aggiorna ruolo** per aggiungere le autorizzazioni aggiuntive al ruolo.
![\[AWS IoT Schermata principale della pagina «Configura l'azione di ripubblicazione» con il pulsante di aggiornamento del ruolo evidenziato.\]](http://docs.aws.amazon.com/it_it/iot-sitewise/latest/userguide/images/interact-dynamo-db/rule-update-role-console.png)
1. Scegliere **Aggiungi azione** per completare l'aggiunta dell'azione di errore.
1. Scegli la freccia indietro nella parte superiore sinistra della console per tornare alla home page della console AWS IoT Core.
Dopo aver impostato l'azione di errore di ripubblicazione, è possibile visualizzare i messaggi di errore nel client di test MQTT in AWS IoT Core.
Nella procedura seguente, si sottoscrive l'argomento di errore nel client di test MQTT.
**Per sottoscrivere l'argomento dell'azione di errore**
1. **Nella pagina di navigazione a sinistra della console AWS IoT Core, scegli Test.**
1. Nel campo **Argomento della sottoscrizione** immettere **windspeed/error** e scegliere **Iscriviti all'argomento**.
![\[AWS IoT Schermata principale della pagina «MQTT client» con il pulsante «Iscriviti all'argomento» evidenziato.\]](http://docs.aws.amazon.com/it_it/iot-sitewise/latest/userguide/images/interact-dynamo-db/rule-subscribe-error-topic-console.png)
1. Controlla la visualizzazione dei messaggi di errore ed esplora l'array `failures` in un messaggio di errore per diagnosticare i seguenti problemi comuni:
+ Errori di battitura nell'istruzione query regola
+ Autorizzazioni ruolo insufficienti
Se non vengono visualizzati errori, verificare che la regola sia abilitata e che sia stato sottoscritto lo stesso argomento configurato nell'azione errore di ripubblicazione. Se ancora non vengono visualizzati errori, verificare che le risorse del parco eolico dimostrativo esistano ancora e che siano state abilitate le notifiche sulle proprietà della velocità del vento. Se le tue risorse demo sono scadute e sono scomparse da AWS IoT SiteWise, puoi creare una nuova demo e aggiornare l'istruzione di interrogazione delle regole in modo che rifletta il modello e la proprietà dell'asset aggiornati. IDs