View a markdown version of this page

Risoluzione dei problemi di un gateway Edge SiteWise - AWS IoT SiteWise
Configura e accedi ai log dei gateway Edge SiteWiseRisoluzione dei problemi relativi SiteWise al gateway EdgeRisoluzione dei problemi di AWS IoT SiteWise Applicazione Edge attiva Siemens Industrial EdgeRisoluzione dei problemi relativi alle integrazioni open source su EdgeRisoluzione dei problemi AWS IoT Greengrass problemi

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 di un gateway Edge SiteWise

Risolvi i problemi più comuni dei 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.

Configura e accedi ai log dei gateway Edge SiteWise

Prima di poter visualizzare i log del gateway SiteWise SiteWise Edge, devi configurarlo per inviare i log ad Amazon CloudWatch Logs o archiviarli nel file system locale.

  • Usa CloudWatch Logs se desideri utilizzare il Console di gestione AWS per visualizzare i file di registro del tuo gateway SiteWise Edge. Per ulteriori informazioni, consulta Usa Amazon CloudWatch Logs.

  • Utilizza i registri del file system locale se desideri utilizzare la riga di comando o il software locale per visualizzare i file di registro del tuo gateway SiteWise Edge. Per ulteriori informazioni, consulta Accedi al servizio di utilizzo AWS IoT SiteWise.

Risoluzione dei problemi relativi SiteWise al gateway Edge

Utilizza le seguenti informazioni per risolvere i problemi relativi ai gateway SiteWise Edge.

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. È possibile utilizzare la AWS IoT Greengrass V2 console per aggiornare il componente AWS IoT Greengrass nucleus.

Per aggiornare il AWS IoT Greengrass componente nucleus (console)

  1. Passare alla console AWS IoT Greengrass.

  2. Nel pannello di navigazione, in AWS IoT Greengrass, scegli Distribuzioni.

  3. Nell'elenco Distribuzioni, seleziona la distribuzione che desideri rivedere.

  4. Scegli Revisione.

  5. Nella pagina Specifica destinazione, scegliete Avanti.

  6. Nella pagina Seleziona componenti, in Componenti pubblici, nella casella di ricerca, inserisciaws.greengrass.Nucleus, quindi seleziona AWS.Greengrass.Nucleus.

  7. Scegli Avanti.

  8. Nella pagina Configura i componenti, scegli Avanti.

  9. Nella pagina Configura impostazioni avanzate, scegli Avanti.

  10. 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 informativo che contengano il seguente messaggio.

Emitting diagnostic name=PublishError.SomeException

SomeExceptionIn base al tipo di registro, utilizza i seguenti tipi di eccezione e i problemi corrispondenti per risolvere i problemi del tuo gateway Edge: SiteWise

  • ResourceNotFoundException— I tuoi 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 tue proprietà non corrispondono esattamente alle tue variabili OPC UA, incluso qualsiasi prefisso di origine che hai definito. Verificare che gli alias delle proprietà e i prefissi di origine siano corretti.

    • Non hai mappato le tue variabili OPC UA alle proprietà degli asset. Per ulteriori informazioni, consulta Gestisci i flussi di dati per AWS IoT SiteWise.

      Se avete già mappato tutte le variabili OPC UA desiderate AWS IoT SiteWise, potete filtrare le variabili OPC UA inviate dal gateway Edge. SiteWise Per ulteriori informazioni, consulta Usa i filtri dei nodi OPC UA in Edge SiteWise.

  • 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 accettato. AWS IoT SiteWise AWS IoT SiteWise rifiuta tutti i punti dati con timestamp precedenti a 7 giorni nel passato 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 svuotare la cache del gateway SiteWise Edge.

  • ThrottlingExceptionoppure LimitExceededException: la tua richiesta ha superato una quota di AWS IoT SiteWise servizio, ad esempio la frequenza di data point acquisiti o la frequenza di richiesta per le operazioni API relative ai dati di proprietà degli asset. Verificare che la configurazione non superi il valore AWS IoT SiteWise quote.

Nessun dato viene visualizzato nella dashboard

Se nella dashboard non sono 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 un'origine dati

  1. Passare alla console AWS IoT SiteWise.

  2. Nel riquadro di navigazione, scegli Edge Gateway.

  3. Seleziona il gateway SiteWise Edge connesso alla dashboard.

  4. In Fonti dati, seleziona Modifica.

  5. Seleziona un nuovo nome di origine e seleziona Salva per confermare la modifica.

  6. 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 l'errore greengrass/v2 //logs

Se viene visualizzato questo errore, potrebbe essere necessario aggiornare la versione java del gateway SiteWise Edge.

  • Da un terminale, esegui il comando seguente:

    java -version

    La versione di java con cui è in esecuzione il gateway SiteWise Edge verrà visualizzata sottoOpenJDK Runtime Environment. Vedrai una risposta come la 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 utilizzi la versione Java 11.0.20.8.1, devi 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 IoT Publisher. SiteWise Per ulteriori informazioni sull'aggiornamento di un pacchetto di componenti, vedere. Cambia la versione dei pacchetti di componenti del gateway SiteWise Edge

Vedo 'SESSION_TAKEN_OVER' o 'com.aws.greengrass.mqttclient. MqttClient: Impossibile pubblicare il messaggio tramite Spooler e riproverò. ' nei log

Se vedi un avviso che include SESSION_TAKEN_OVER o un errore che include com.aws.greengrass.mqttclient.MqttClient: Failed to publish the message via Spooler and will retry. nei tuoi log at/greengrass/v2/logs/greengrass.log, è possibile che tu 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 univoco per connettersi al tuo AWS account.

Vedo «com.aws.greengrass.deployment». IotJobsHelper: non è stato trovato alcun processo di distribuzione. ' 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, è possibile che tu stia tentando di 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.

    2. Nel riquadro di navigazione, scegli Edge gateway.

    3. Scegli il gateway SiteWise Edge che desideri riutilizzare.

    4. Scegli la scheda Aggiornamenti.

    5. Seleziona una versione diversa di Publisher e scegli Distribuisci.

Segui i passaggi indicati Crea un gateway per Siemens Industrial Edge per creare un nuovo file di configurazione.

Vedo lo stato «SYNC_FAILED» quando tento di configurare l'impostazione del timestamp in un gruppo di proprietà su un'origine dati OPC UA

Quando abbiamo AWS IoT SiteWise aggiornato il componente del collettore OPC UA per AWS IoT Greengrass la versione 2.5.0, abbiamo introdotto una nuova opzione di configurazione del timestamp. È possibile utilizzare il timestamp del dispositivo o il timestamp del server. Le versioni precedenti del componente di raccolta OPC UA 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 di raccolta IoT SiteWise OPC UA alla versione 2.5.0 o successiva. In alternativa, puoi continuare a utilizzare la versione precedente del componente del raccoglitore OPC UA, se imposti il timestamp su. Source Per sapere come aggiornare il componente del collettore IoT SiteWise OPC UA, consulta. Aggiorna la versione di un componente AWS IoT SiteWise Consigliamo di utilizzare le versioni più recenti di tutti i componenti.

Nota

Non vi è alcuna interruzione dei dati quando lo stato di sincronizzazione di un'origine dati non riesce. I dati di origine continuano a fluire in AWS IoT SiteWise. La configurazione semplicemente non si sincronizza con il componente di raccolta IoT SiteWise OPC UA presente nella distribuzione. AWS IoT Greengrass V2

Per modificare la configurazione del timestamp per un gruppo di proprietà

  1. Passare alla console AWS IoT SiteWise.

  2. Nel riquadro di navigazione, scegli Edge gateway.

  3. Seleziona il gateway da modificare.

  4. Nella sezione Origini dati, seleziona l'origine dati con lo stato di sincronizzazione non riuscita e scegli Modifica.

  5. Espandi Configurazione avanzata, quindi espandi le impostazioni del gruppo.

  6. In Timestamp, seleziona Sorgente. Selezionando Source si rimuove la timestampToReturn proprietà dalla configurazione. Per impostazione predefinita, questa impostazione abilita la raccolta del timestamp dell'origine dati dal dispositivo, consentendo la sincronizzazione dell'origine dati con il componente di raccolta IoT SiteWise OPC UA.

  7. Selezionare 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 in AWS IoT SiteWise, ci sono alcune possibili ragioni:

  • Il tipo di dati che stai tentando di convertire è un tipo di dati complesso. I tipi di dati complessi non sono supportati.

  • Quando si utilizzano le destinazioni come AWS IoT SiteWise bufferizzate utilizzando Amazon S3, il valore completo della stringa viene conservato nei file inviati a un bucket Amazon S3. Quando successivamente si inseriscono dati in AWS IoT SiteWise, i valori di stringa completi più lunghi di 1024 byte vengono rifiutati.

Problemi con Trust Store

Se riscontri problemi relativi ai trust store 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 di fiducia 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 nei trust store

  • Verificate che i trust store 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 con i trust store

  • Testa SSL/TLS le connessioni in modo indipendente utilizzando strumenti come openssl la verifica della funzionalità del trust store

Proxy-enabled problemi di installazione

Se riscontri problemi durante il processo di configurazione del proxy, prendi in considerazione 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 le credenziali del proxy contengano caratteri speciali URL-encoded

  • Verifica che l'elenco senza proxy includa tutti gli indirizzi locali e AWS gli endpoint di servizio necessari

  • Per i proxy HTTPS, verifica che il certificato CA fornito sia in formato PEM

  • Esamina i log di installazione per individuare 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 di AWS IoT SiteWise Applicazione Edge attiva 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, consultate Download dei log nella documentazione Siemens.

I miei dati non vengono visualizzati in AWS IoT SiteWise

  • Assicurati che non ci siano problemi con i tuoi Databus utenti e che l'icona del segno di spunta Databus_Configuration sia verde anziché grigia.

  • È possibile che non sia Siemens Industrial Edge Management in esecuzione una versione che contieneSecure Storage. Aggiorna la tua versione del sistema operativo Siemens. Per ulteriori informazioni, consulta Siemens Secure Storage e il AWS IoT SiteWise Applicazione Edge.

Vedo «File di configurazione mancante AWS_REGION» nei log

Se vedi Config file missing AWS_REGION nei log di Siemens, il JSON del file di configurazione è danneggiato. Dovrai creare un nuovo file di configurazione. Segui i passaggi indicati Crea un gateway per Siemens Industrial Edge per creare un nuovo file di configurazione.

Viene visualizzato un messaggio di errore «Out of sync» nella configurazione del gateway Edge

Se viene visualizzato un messaggio Out of sync di errore sul Siemens Industrial Edge gateway dopo il completamento della distribuzione, significa che il componente SiteWise Publisher IoT non è sincronizzato con il gateway. Il componente SiteWise publisher IoT funziona in background sui Siemens Industrial Edge gateway per fornire funzionalità relative agli argomenti MQTT. Abbiamo aggiornato i Siemens Industrial Edge gateway in modo da utilizzare il namespace delle funzionalità anziché. iotsitewise:publisher:3 iotsitewise:publisher:2 Puoi eseguire l'aggiornamento alla versione più recente del publisher per risolvere questo problema.

Per effettuare l'aggiornamento alla versione più recente del SiteWise publisher IoT

  1. Passare alla console AWS IoT SiteWise.

  2. Nel riquadro di navigazione, scegli Edge Gateway.

  3. Seleziona il Siemens Industrial Edge gateway da modificare.

  4. Nella sezione Funzionalità di Edge, seleziona Visualizza le versioni del software.

  5. Seleziona la versione più recente di IoT SiteWise Publisher nel menu a discesa Publisher.

  6. Seleziona Fatto.

Risoluzione dei problemi relativi alle 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 impossibile 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 token di autenticazione sia valido e di aver specificato i nomi corretti dell'organizzazione e dei bucket. Verifica che InfluxDB sia in esecuzione 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 appare in AWS IoT SiteWise

Verifica che l'alias della tua proprietà nel Node-RED flusso corrisponda al formato previsto. Verifica 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 Node-RED ritenzione sia configurato correttamente e che il nodo writer InfluxDB abbia le impostazioni di bucket e misurazione corrette. Controlla l'output di Node-RED debug per eventuali errori.

Errori di formato dei dati

Assicurati che le tue funzioni di trasformazione dei dati convertano correttamente i dati tra formati. Usa i nodi di Node-RED debug 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. Valuta la possibilità di ridurre la frequenza di raccolta dei dati o di implementare il filtro dei dati per ridurre il carico di elaborazione.

Per monitorare l'utilizzo delle risorse, esegui:

docker stats
Caricamento lento della dashboard di Grafana

Ottimizza le tue query su InfluxDB e valuta la possibilità di aggiungere 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 ciascun componente:

Node-RED registri

Visualizza i log nella Node-RED console o esegui:

docker logs node-red
I log di InfluxDB

Accedi ai log eseguendo:

docker logs influxdb
Registri di Grafana

Visualizza i log eseguendo:

docker logs grafana
SiteWise Log di Edge

Controlla i log del gateway SiteWise Edge per eventuali problemi di connessione MQTT ed elaborazione dei dati. Per ulteriori informazioni, consulta Risoluzione dei problemi di un gateway Edge SiteWise.

Risoluzione dei problemi AWS IoT Greengrass problemi

Per trovare soluzioni a molti problemi di configurazione o distribuzione del gateway SiteWise Edge su AWS IoT Greengrass, consulta Risoluzione dei problemi AWS IoT Greengrass nella Guida per gli sviluppatori. AWS IoT Greengrass