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à. # Risoluzione dei problemi AWS IoT SiteWise Utilizza le seguenti informazioni per risolvere i problemi relativi a. AWS IoT SiteWise **Topics** + [ # Risoluzione dei problemi di un gateway SiteWise Edge ](troubleshooting-gateway.md) + [ # Risolvere i problemi relativi a un portale AWS IoT SiteWise ](troubleshooting-portal.md) + [ # Risolvere i problemi relativi a un' AWS IoT SiteWise azione delle regole ](troubleshoot-rule.md) + [ # Risoluzione dei problemi relativi alle operazioni di importazione ed esportazione in blocco ](troubleshooting-bulk.md) # Risoluzione dei problemi di un gateway SiteWise Edge Risolvi i problemi comuni del gateway AWS IoT SiteWise Edge esplorando gli argomenti pertinenti. Puoi anche visualizzare le CloudWatch metriche riportate dai tuoi gateway SiteWise Edge per risolvere problemi di connettività o flussi di dati. Per ulteriori informazioni, consulta [Monitoraggio AWS IoT SiteWise con i CloudWatch parametri di Amazon](monitor-cloudwatch-metrics.md). **Topics** + [ ## Configura e accedi ai log del gateway Edge SiteWise ](#configure-gateway-logs) + [ ## Risoluzione dei problemi relativi SiteWise al gateway Edge ](#troubleshoot-gateway-issues) + [ ## Risoluzione dei problemi relativi all'applicazione AWS IoT SiteWise Edge su Siemens Industrial Edge ](#troubleshoot-siemens-app) + [ ## Risoluzione dei problemi di integrazioni open source su Edge ](#open-source-troubleshooting) + [ ## Risoluzione dei problemi AWS IoT Greengrass ](#troubleshoot-greengrass-issues) ## Configura e accedi ai log del gateway Edge SiteWise Prima di poter visualizzare i log del gateway SiteWise Edge, devi configurare il gateway SiteWise Edge per inviare i log ad Amazon CloudWatch Logs o archiviare i log sul file system locale. + Usa CloudWatch Logs se desideri utilizzare il per visualizzare i file di log del Console di gestione AWS tuo gateway SiteWise Edge. Per ulteriori informazioni, consulta [Usa Amazon CloudWatch Logs](gateway-cloudwatch-logs.md). + Utilizza i log del file system locale se desideri utilizzare la riga di comando o il software locale per visualizzare i file di registro del gateway SiteWise Edge. Per ulteriori informazioni, consulta [Usa i log in del servizio AWS IoT SiteWise](gateway-local-logs.md). ## Risoluzione dei problemi relativi SiteWise al gateway Edge Utilizza le seguenti informazioni per risolvere i problemi relativi ai gateway SiteWise Edge. **Topics** + [ ### Impossibile distribuire i pacchetti sui gateway Edge SiteWise ](#gateway-issue-ggv2-packs) + [ ### AWS IoT SiteWise non riceve dati dai server OPC UA ](#gateway-issue-data-streams) + [ ### Nessun dato viene visualizzato nella dashboard ](#gateway-issue-no-data) + [ ### «Impossibile trovare o caricare la classe principale» visualizzato in aws.iot. SiteWiseEdgePublisher registra in/error greengrass/v2/logs ](#troubleshoot-java-issues) + [ ### Vedo 'SESSION\$1TAKEN\$1OVER' o 'com.aws.greengrass.mqttclient. MqttClient: Impossibile pubblicare il messaggio tramite Spooler e riproverò. ' nei log ](#sa-troubleshoot-multiple-use) + [ ### Vedo 'com.aws.greengrass.deployment. IotJobsHelper: Nessun processo di distribuzione trovato. ' o 'Risultato della distribuzione già segnalato'. nei registri ](#sa-troubleshoot-reuse) + [ ### Vedo lo stato «SYNC\$1FAILED» quando tento di configurare l'impostazione del timestamp in un gruppo di proprietà su una fonte di dati OPC UA ](#troubleshoot-gateway-sync-failed-timestamp) + [ ### I tipi di dati convertiti non sono inclusi ](#troubleshoot-data-conversion) + [ ### Problemi relativi al Trust Store ](#troubleshoot-trust-stores) + [ ### Problemi di installazione con proxy ](#troubleshoot-proxy-during-installation) ### Impossibile distribuire i pacchetti sui gateway Edge SiteWise Se il componente AWS IoT Greengrass nucleus (`aws.greengrass.Nucleus`) non è aggiornato, potresti non essere in grado di distribuire i pacchetti sul tuo SiteWise gateway Edge. Puoi usare la AWS IoT Greengrass V2 console per aggiornare il componente AWS IoT Greengrass nucleus. **Per aggiornare il componente AWS IoT Greengrass nucleus (console)** 1. Passare alla [console AWS IoT Greengrass](https://console.aws.amazon.com/greengrassIntro). 1. Nel riquadro di navigazione, sotto **AWS IoT Greengrass**, scegli **Distribuzioni**. 1. Nell'elenco **Distribuzioni**, seleziona la distribuzione che desideri modificare. 1. **Scegli Rivedi.** 1. Nella pagina **Specificare la destinazione**, scegli **Avanti**. 1. Nella pagina **Seleziona componenti**, in Componenti **pubblici**, nella casella di ricerca**aws.greengrass.Nucleus**, inserisci e quindi seleziona **AWS.GreenGrass.Nucleus**. 1. Scegli **Next (Successivo)**. 1. **Nella pagina **Configura componenti, scegli Avanti**.** 1. Nella pagina **Configura impostazioni avanzate**, scegli **Avanti**. 1. Nella pagina **Review (Verifica)**, scegli **Deploy (Distribuisci)**. ### AWS IoT SiteWise non riceve dati dai server OPC UA Se le tue AWS IoT SiteWise risorse non ricevono i dati inviati dai tuoi server OPC UA, puoi cercare nei log del tuo gateway SiteWise Edge per risolvere i problemi. Cerca i `swPublisher` log a livello di informazioni che contengono il seguente messaggio. ``` Emitting diagnostic name=PublishError.SomeException ``` *SomeException*In base al tipo di registro, utilizza i seguenti tipi di eccezioni e i problemi corrispondenti per risolvere i problemi del gateway Edge: SiteWise + **ResourceNotFoundException**— I vostri server OPC UA inviano dati che non corrispondono a un alias di proprietà per nessuna risorsa. Questa eccezione può verificarsi in due casi: + Gli alias delle proprietà non corrispondono esattamente alle variabili OPC UA, incluso il prefisso sorgente che hai definito. Verificare che gli alias delle proprietà e i prefissi di origine siano corretti. + Non hai mappato le variabili OPC UA alle proprietà degli asset. Per ulteriori informazioni, consulta [Gestisci i flussi di dati per AWS IoT SiteWise](manage-data-streams.md). Se hai già mappato tutte le variabili OPC UA che desideri inserire AWS IoT SiteWise, puoi filtrare le variabili OPC UA inviate dal gateway Edge. SiteWise Per ulteriori informazioni, consulta [Usa i filtri dei nodi OPC UA in Edge SiteWise](opc-ua-node-filters.md). + **InvalidRequestException**— I tipi di dati delle variabili OPC UA non corrispondono ai tipi di dati relativi alle proprietà degli asset. Ad esempio, se una variabile OPC UA ha un tipo di dati intero, la proprietà dell'asset corrispondente deve essere di tipo intero. Una proprietà di asset di tipo doppio non può ricevere valori interi OPC UA. Per risolvere questo problema, definire nuove proprietà con i tipi di dati corretti. + **TimestampOutOfRangeException**— Il gateway SiteWise Edge invia dati che non rientrano nell'intervallo consentito. AWS IoT SiteWise AWS IoT SiteWise rifiuta tutti i punti dati con timestamp precedenti a 7 giorni o più recenti di 5 minuti nel futuro. Se il gateway SiteWise Edge ha perso l'alimentazione o la connessione al AWS Cloud, potrebbe essere necessario cancellare la cache del gateway SiteWise Edge. + **ThrottlingException**oppure **LimitExceededException**: la richiesta ha superato una quota di AWS IoT SiteWise servizio, ad esempio la velocità di acquisizione dei punti dati o la frequenza di richiesta per le operazioni API relative ai dati relativi alle proprietà degli asset. Verificare che la configurazione non superi il valore [AWS IoT SiteWise quote](endpoints-and-quotas.md#quotas). ### Nessun dato viene visualizzato nella dashboard Se nella dashboard non vengono visualizzati dati, la **configurazione di Publisher** e l'**origine dati** del gateway SiteWise Edge potrebbero non essere sincronizzate. Se non sono sincronizzati, l'aggiornamento del nome dell'origine dati può accelerare la sincronizzazione dal cloud all'edge, correggendo l'errore Out of sync. **Per aggiornare il nome di una fonte di dati** 1. Passare alla [console AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/). 1. Nel riquadro di navigazione, scegli **Edge gateway**. 1. Seleziona il gateway SiteWise Edge connesso alla dashboard. 1. In **Origini dati**, seleziona **Modifica**. 1. Seleziona un nuovo **nome** di origine e seleziona **Salva** per confermare la modifica. 1. Verifica le modifiche confermando che il nome dell'origine dati è stato aggiornato nella tabella **Origini dati**. ### «Impossibile trovare o caricare la classe principale» visualizzato in aws.iot. SiteWiseEdgePublisher registra in/error greengrass/v2/logs Se viene visualizzato questo errore, potrebbe essere necessario aggiornare la versione java del gateway Edge. SiteWise + Da un terminale, esegui il comando seguente: ``` java -version ``` La versione di java con cui è in esecuzione il gateway SiteWise Edge verrà visualizzata sotto`OpenJDK Runtime Environment`. Vedrai una risposta simile alla seguente: ``` openjdk version "11.0.20" 2023-07-18 LTS OpenJDK Runtime Environment Corretto011.0.20.8.1 (build 11.0.20+8-LTS OpenJDK 64-Bit Server VM Corretto-11.0.20.8.1 (build 11.0.20+8-LTS, mixed node) ``` Se si utilizza la versione Java 11.0.20.8.1, è necessario aggiornare il pacchetto IoT SiteWise Publisher alla versione 2.4.1 o successiva. È interessata solo la versione java 11.0.20.8.1, gli ambienti con altre versioni di Java possono continuare a utilizzare versioni precedenti del componente SiteWise IoT Publisher. Per ulteriori informazioni sull'aggiornamento di un pacchetto di componenti, vedere. [Cambia la versione dei pacchetti di componenti del gateway SiteWise Edge](manage-gateways-ggv2.md#manage-gateway-update-packs) ### Vedo 'SESSION\$1TAKEN\$1OVER' o 'com.aws.greengrass.mqttclient. MqttClient: Impossibile pubblicare il messaggio tramite Spooler e riproverò. ' nei log Se viene visualizzato un avviso che include `SESSION_TAKEN_OVER` o un errore incluso `com.aws.greengrass.mqttclient.MqttClient: Failed to publish the message via Spooler and will retry.` nei registri all'indirizzo`/greengrass/v2/logs/greengrass.log`, è possibile che si stia tentando di utilizzare lo stesso file di configurazione per più gateway SiteWise Edge su più dispositivi. Ogni gateway SiteWise Edge necessita di un file di configurazione unico per connettersi all'account AWS . ### Vedo 'com.aws.greengrass.deployment. IotJobsHelper: Nessun processo di distribuzione trovato. ' o 'Risultato della distribuzione già segnalato'. nei registri Se vedi `com.aws.greengrass.deployment.IotJobsHelper: No deployment job found.` o `Deployment result already reported.` nei tuoi log all'indirizzo`/greengrass/v2/logs/greengrass.log`, potresti provare a riutilizzare lo stesso file di configurazione. Esistono diverse soluzioni: + Se desideri riutilizzare il file di configurazione, procedi come segue: 1. Passare alla [console AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/). 1. Nel riquadro di navigazione, scegli **Edge gateway**. 1. Scegli il gateway SiteWise Edge che desideri riutilizzare. 1. Scegli la scheda **Aggiornamenti**. 1. Seleziona una versione diversa di Publisher e scegli **Distribuisci.** Segui i passaggi indicati [Crea un gateway per Siemens Industrial Edge](sa-create-config.md) per creare un nuovo file di configurazione. ### Vedo lo stato «SYNC\$1FAILED» quando tento di configurare l'impostazione del timestamp in un gruppo di proprietà su una fonte di dati OPC UA Quando è AWS IoT SiteWise stato aggiornato il componente OPC UA Collector per AWS IoT Greengrass la versione 2.5.0, abbiamo introdotto una nuova opzione di configurazione del timestamp. Puoi utilizzare il timestamp del tuo dispositivo o il timestamp del server. Le versioni precedenti del componente OPC UA Collector non supportano questa opzione e non riescono a sincronizzarsi. Esistono due modi per risolvere un errore di sincronizzazione dell'origine dati. Il metodo consigliato è quello di aggiornare il componente IoT SiteWise OPC UA collector alla versione 2.5.0 o successiva. In alternativa, puoi continuare a utilizzare la versione precedente del componente OPC UA Collector, se hai impostato il timestamp su. `Source` Per informazioni su come aggiornare il componente IoT SiteWise OPC UA Collector, vedere. [Aggiorna la versione di un componente AWS IoT SiteWise](manage-gateways-ggv2.md#update-component-version) Si consiglia di utilizzare le versioni più recenti di tutti i componenti. **Nota** Non si verifica alcuna interruzione dei dati quando lo stato di sincronizzazione di un'origine dati fallisce. I dati di origine continuano a AWS IoT SiteWise fluire. La configurazione semplicemente non si sincronizza con il componente IoT SiteWise OPC UA collector durante l'implementazione. AWS IoT Greengrass V2 **Per modificare la configurazione del timestamp per un gruppo di proprietà** 1. Passare alla [console AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/). 1. Nel pannello di navigazione, scegli **Edge** gateway. 1. Seleziona il gateway da modificare. 1. Nella sezione **Origini dati**, seleziona l'origine dati con lo stato di sincronizzazione non riuscita e scegli **Modifica**. 1. Espandi **Configurazione avanzata**, quindi espandi **Impostazioni di gruppo**. 1. **In **Timestamp**, seleziona Sorgente.** La selezione **di Source** rimuove la `timestampToReturn` proprietà dalla configurazione. Questa impostazione consente la raccolta del timestamp dell'origine dati dal dispositivo per impostazione predefinita, consentendo la sincronizzazione dell'origine dati con il componente di raccolta IoT SiteWise OPC UA. 1. Scegli **Save** (Salva). ### I tipi di dati convertiti non sono inclusi Se visualizzi un errore durante la conversione di tipi di dati OPC UA non supportati in stringhe AWS IoT SiteWise, ci sono alcuni possibili motivi: + Il tipo di dati che stai tentando di convertire è un tipo di dati complesso. I tipi di dati complessi non sono supportati. + Quando si utilizza **Destinations** as **AWS IoT SiteWise Buffered con Amazon** S3, il valore completo della stringa viene conservato nei file inviati a un bucket Amazon S3. Quando successivamente si inseriscono dati in un secondo momento AWS IoT SiteWise, i valori di stringa completi più lunghi di 1024 byte vengono rifiutati. ### Problemi relativi al Trust Store Se riscontri problemi relativi ai trust stores in SiteWise Edge, prendi in considerazione i seguenti passaggi per la risoluzione dei problemi: + Verifica che il certificato CA AWS IoT Greengrass principale sia presente e formattato correttamente negli archivi attendibili appropriati + Assicurati che la KeyStore password Java sia impostata correttamente e accessibile ai componenti SiteWise Edge + Verifica che tutti i certificati personalizzati (ad esempio per i proxy HTTPS) siano nel formato corretto (in genere PEM) e importati correttamente negli archivi affidabili + Verifica che gli archivi attendibili dispongano delle autorizzazioni di file corrette e siano accessibili ai processi Edge SiteWise + Esamina i log di SiteWise Edge per eventuali errori SSL/TLS correlati, che potrebbero indicare problemi di trust store + Testa SSL/TLS le connessioni in modo indipendente utilizzando strumenti come `openssl` la verifica della funzionalità del trust store ### Problemi di installazione con proxy Se riscontri problemi durante il processo di configurazione del proxy, considera i seguenti passaggi per la risoluzione dei problemi: + Verifica che l'URL del proxy sia formattato correttamente e includa lo schema corretto (`http://`o`https://`) + Assicurati che tutte le credenziali del proxy siano codificate come URL se contengono caratteri speciali + Verifica che l'elenco senza proxy includa tutti gli indirizzi locali e gli endpoint di servizio necessari AWS + Per i proxy HTTPS, verifica che il certificato CA fornito sia in formato PEM + Esamina i log di installazione per eventuali messaggi di errore specifici che potrebbero indicare l'origine del problema + Verifica la connessione proxy in modo indipendente per assicurarti che funzioni correttamente ## Risoluzione dei problemi relativi all'applicazione AWS IoT SiteWise Edge su Siemens Industrial Edge Per risolvere i problemi relativi AWS IoT SiteWise all'applicazione Edge sul Siemens Industrial Edge dispositivo, è possibile accedere ai registri dell'applicazione tramite i portali Siemens Industrial Edge Management o Siemens Industrial Edge Device (IED). Per ulteriori informazioni, consulta la sezione [Download dei registri nella documentazione](https://docs.eu1.edge.siemens.cloud/build_a_device/device_building/concepts/howto-download-edge-device-logs.html) di Siemens. ### I miei dati non vengono visualizzati in AWS IoT SiteWise + Assicurati che non vi siano problemi con Databus gli utenti e che l'icona del segno di spunta per **Databus\$1Configuration** sia verde anziché grigia. + È possibile che non sia in esecuzione una versione Siemens Industrial Edge Management che contiene. Secure Storage Aggiorna la tua versione del sistema operativo Siemens. Per ulteriori informazioni, consulta [Siemens Secure Storagee l'applicazione AWS IoT SiteWise Edge](sitewise-edge-on-siemens.md#sa-secure-storage). ### Vedo «File di configurazione mancante AWS\$1REGION» nei log Se vedi `Config file missing AWS_REGION` nei log Siemens, il codice JSON del file di configurazione è danneggiato. Dovrai creare un nuovo file di configurazione. Segui i passaggi indicati [Crea un gateway per Siemens Industrial Edge](sa-create-config.md) per creare un nuovo file di configurazione. ### Viene visualizzato un messaggio di errore «Non sincronizzato» nella configurazione del gateway Edge Se viene visualizzato un messaggio `Out of sync` di errore sul Siemens Industrial Edge gateway dopo il completamento dell'implementazione, significa che il componente IoT SiteWise Publisher non è sincronizzato con il gateway. Il componente IoT SiteWise Publisher funziona in background sui Siemens Industrial Edge gateway per fornire funzionalità tematiche MQTT. Abbiamo aggiornato i Siemens Industrial Edge gateway per utilizzare lo spazio dei nomi delle funzionalità anziché. `iotsitewise:publisher:3` `iotsitewise:publisher:2` Puoi eseguire l'aggiornamento alla versione più recente dell'editore per risolvere questo problema. **Per eseguire l'aggiornamento alla versione più recente di IoT SiteWise Publisher** 1. Passare alla [console AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/). 1. Nel riquadro di navigazione, scegli **Edge gateway**. 1. Seleziona il Siemens Industrial Edge gateway da modificare. 1. Nella sezione **Funzionalità di Edge**, seleziona **Visualizza versioni del software**. 1. Seleziona l'ultima versione dell' SiteWise editore IoT nel menu a discesa **Publisher**. 1. Seleziona **Fatto**. ## Risoluzione dei problemi di integrazioni open source su Edge Questa sezione fornisce soluzioni ai problemi più comuni che potresti riscontrare durante l'integrazione di strumenti open source con Edge. SiteWise **Nota** Node-RED®, InfluxDB® e Grafana® non sono fornitori o fornitori di Edge. SiteWise ### Problemi di connessione Node-RED non può connettersi al broker MQTT Verifica che il broker MQTT sia in esecuzione e accessibile sulla porta specificata. Controlla la configurazione della rete e assicurati che l'indirizzo del broker sia corretto. Per verificare lo stato del broker MQTT, esegui: ``` docker ps | grep emqx ``` Errori di connessione InfluxDB Assicurati che il tuo token di autenticazione sia valido e di aver specificato l'organizzazione e i nomi dei bucket corretti. Verifica che InfluxDB sia funzionante e accessibile. Per verificare lo stato di InfluxDB, esegui: ``` curl -I http://localhost:8086 ``` Grafana non riesce a connettersi a InfluxDB Verifica che la configurazione dell'origine dati InfluxDB in Grafana sia corretta, inclusi l'URL, il token di autenticazione, l'organizzazione e il bucket. ### Problemi relativi al flusso di dati Nessun dato visualizzato in AWS IoT SiteWise Verifica che l'alias della tua proprietà nel flusso Node-RED corrisponda al formato previsto. Verificate che la struttura degli argomenti MQTT sia corretta e che il gateway SiteWise Edge sia configurato correttamente per ricevere dati dal broker MQTT. Nessun dato SiteWise Edge memorizzato in InfluxDB Verifica che il flusso di ritenzione Node-RED sia configurato correttamente e che il nodo writer InfluxDB abbia il bucket e le impostazioni di misurazione corretti. Controlla l'output di debug di Node-RED per eventuali errori. Errori di formato dei dati Assicurati che le funzioni di trasformazione dei dati convertano correttamente i dati tra i formati. Usa i nodi di debug Node-RED per ispezionare i dati in ogni fase del flusso. ### Problemi di prestazioni Utilizzo elevato della CPU o della memoria Monitora l'utilizzo delle risorse e regola la configurazione dei componenti in base alle esigenze. Prendi in considerazione la possibilità di ridurre la frequenza di raccolta dei dati o di implementare il filtraggio dei dati per ridurre il carico di elaborazione. Per monitorare l'utilizzo delle risorse, esegui: ``` docker stats ``` Caricamento lento della dashboard Grafana Ottimizza le tue query su InfluxDB e prendi in considerazione l'aggiunta di limiti di intervallo di tempo ai pannelli della dashboard. Riduci il numero di punti dati visualizzati utilizzando le funzioni di aggregazione appropriate. ### Registrazione e diagnostica Per risolvere i problemi, controlla i log di ogni componente: Registri Node-RED Visualizza i log nella console Node-RED o esegui: ``` docker logs node-red ``` Registri di InfluxDB Accedi ai log eseguendo: ``` docker logs influxdb ``` Tronchi Grafana Visualizza i log eseguendo: ``` docker logs grafana ``` SiteWise Registri Edge Controllate i log del gateway SiteWise Edge per eventuali problemi di connessione MQTT e di elaborazione dei dati. Per ulteriori informazioni, consulta [Risoluzione dei problemi di un gateway SiteWise Edge](#troubleshooting-gateway). ## Risoluzione dei problemi AWS IoT Greengrass *Per trovare soluzioni a molti problemi relativi alla configurazione o all'implementazione del gateway SiteWise Edge AWS IoT Greengrass, consulta [Risoluzione dei problemi AWS IoT Greengrass](https://docs.aws.amazon.com/greengrass/v1/developerguide/gg-troubleshooting.html) nella Guida per gli sviluppatori.AWS IoT Greengrass * # Risolvere i problemi relativi a un portale AWS IoT SiteWise Risolvi i problemi più comuni con i tuoi AWS IoT SiteWise portali. ## Gli utenti e gli amministratori non possono accedere al portale AWS IoT SiteWise Se gli utenti o gli amministratori non possono accedere AWS IoT SiteWise al tuo portale, potresti avere autorizzazioni limitate nelle policy allegate AWS Identity and Access Management (IAM) che impediscono il successo degli accessi. Guarda i seguenti esempi di politiche IAM che comporteranno errori di accesso: **Nota** Qualsiasi policy IAM allegata che includa un `"Condition"` elemento causerà un errore di accesso. **Esempio 1**: la condizione qui è un IP limitato e ciò causerà un errore di accesso. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "iotsitewise:DescribePortal" ], "Resource": "*", "Condition": { "IpAddress": { "aws:SourceIp": [ "203.0.113.0/24" ] } } } ] } ``` ------ **Esempio 2**: la condizione qui è un tag incluso e ciò causerà un errore di accesso. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "iotsitewise:DescribePortal" ], "Resource": "*", "Condition": { "StringLike": { "aws:ResourceTag/project": "*" } } } ] } ``` ------ Quando aggiungi utenti o amministratori al portale, evita di creare policy IAM che limitino le autorizzazioni degli utenti, come l'IP limitato. Qualsiasi policy allegata con autorizzazioni limitate non sarà in grado di connettersi al portale. AWS IoT SiteWise # 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 # Risoluzione dei problemi relativi alle operazioni di importazione ed esportazione in blocco Per gestire e diagnosticare gli errori prodotti durante un processo di trasferimento, consulta l' AWS IoT TwinMaker **GetMetadataTransferJob**API: 1. Dopo aver creato ed eseguito un processo di trasferimento, chiama l'**GetMetadataTransferJob**API: ``` aws iottwinmaker get-metadata-transfer-job \ --metadata-transfer-job-id your_metadata_transfer_job_id \ --region us-east-1 ``` 1. Lo stato del lavoro cambia in uno dei seguenti stati: + COMPLETED + CANCELLED + ERRORE 1. L'**GetMetadataTransferJob**API restituisce un [ MetadataTransferJobProgress](https://docs.aws.amazon.com/iot-twinmaker/latest/apireference/API_MetadataTransferJobProgress.html)oggetto. 1. L'**MetadataTransferJobProgress**oggetto contiene i seguenti parametri: + **FailedCount**: indica il numero di asset che hanno avuto esito negativo durante il processo di trasferimento. + **SkippedCount**: indica il numero di asset che sono stati ignorati durante il processo di trasferimento. + **successeededCount**: indica il numero di asset che hanno avuto successo durante il processo di trasferimento. + **totalCount**: indica il numero totale di asset coinvolti nel processo di trasferimento. 1. Inoltre, la chiamata API restituisce un elemento **reportURL**, che contiene un URL prefirmato. Se il processo di trasferimento presenta errori che richiedono un'analisi, puoi scaricare un rapporto di errore completo a questo URL.