View a markdown version of this page

SiteWise Editore IoT - AWS IoT Greengrass
VersioniTipoSistema operativoRequisitiDipendenzeConfigurazioneDati di inputFile di registro localeRisoluzione dei problemi e debugLicenzeChangelogConsulta anche

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

SiteWise Editore IoT

Il componente IoT SiteWise Publisher (aws.iot.SiteWiseEdgePublisher) consente ai AWS IoT SiteWise gateway di esportare dati dall'edge al. Cloud AWS

Per ulteriori informazioni sui AWS IoT SiteWise gateway, vedere Using AWS IoT SiteWise at the edge nella Guida per l'AWS IoT SiteWise utente.

Versioni

Questo componente ha le seguenti versioni:

  • 4.1.x

  • 4.0.x

  • 3.2.x

  • 3.1.x

  • 3.0.x

  • 2.4.x

  • 2.3.x

  • 2.2.x

  • 2.1.x

  • 2.0.x

Tipo

Questo componente è un componente generico ()aws.greengrass.generic. Il nucleo di Greengrass esegue gli script del ciclo di vita del componente.

Per ulteriori informazioni, consulta Tipi di componenti.

Sistema operativo

Questo componente può essere installato sui dispositivi principali che eseguono i seguenti sistemi operativi:

  • Linux

  • Windows

Requisiti

Questo componente ha i seguenti requisiti:

  • Il dispositivo principale di Greengrass deve funzionare su una delle seguenti piattaforme:

    • sistema operativo: Ubuntu 18.04 o successivo

      architettura: x86_64 (AMD64) o ARMv8 (Aarch64)

    • Sistema operativo: Red Hat Enterprise Linux (RHEL) 8

      architettura: x86_64 (AMD64) o ARMv8 (Aarch64)

    • sistema operativo: Amazon Linux 2

      architettura: x86_64 (AMD64) o ARMv8 (Aarch64)

    • sistema operativo: Debian 11

      architettura: x86_64 (AMD64) o ARMv8 (Aarch64)

    • sistema operativo: Windows Server 2019 o successivo

      architettura: x86_64 (AMD64)

  • Il dispositivo principale di Greengrass deve connettersi a Internet.

  • Il dispositivo principale di Greengrass deve essere autorizzato a eseguire l'azioneiotsitewise:BatchPutAssetPropertyValue. Per ulteriori informazioni, consulta Autorizzare i dispositivi principali a interagire con AWS i servizi.

    Esempio policy di autorizzazioni
    JSON
    {
    "Version":"2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "iotsitewise:BatchPutAssetPropertyValue",
            "Resource": "*"
        }
    ]
}

Endpoint e porte

Questo componente deve essere in grado di eseguire richieste in uscita ai seguenti endpoint e porte, oltre agli endpoint e alle porte necessari per il funzionamento di base. Per ulteriori informazioni, consulta Consenti il traffico dei dispositivi tramite un proxy o un firewall.

Endpoint Porta Richiesto Description

data.iotsitewise.region.amazonaws.com

 443 Sì

Pubblica dati su. AWS IoT SiteWise

Dipendenze

Quando distribuisci un componente, distribuisce AWS IoT Greengrass anche versioni compatibili delle sue dipendenze. Ciò significa che è necessario soddisfare i requisiti del componente e tutte le sue dipendenze per distribuire correttamente il componente. Questa sezione elenca le dipendenze per le versioni rilasciate di questo componente e i vincoli semantici della versione che definiscono le versioni dei componenti per ciascuna dipendenza. È inoltre possibile visualizzare le dipendenze per ciascuna versione del componente nella console. AWS IoT Greengrass Nella pagina dei dettagli del componente, cerca l'elenco delle dipendenze.

La tabella seguente elenca le dipendenze per le versioni da 2.0.x a 2.2.x di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Nucleo Greengrass > =2.3.0<3.0.0 Rigidi
Stream manager =2,3.0 =2.0.10<3.0.0 Rigidi

Per ulteriori informazioni sulle dipendenze dei componenti, consultate il riferimento alla composizione dei componenti. ComponentDependencies

Configurazione

Questo componente non ha parametri di configurazione.

Puoi utilizzare la AWS IoT SiteWise console o l'API per configurare il componente IoT SiteWise Publisher. Per ulteriori informazioni, consulta la Fase 3: Configurazione dell'editore - opzionale nella Guida per l'AWS IoT SiteWise utente.

Dati di input

Questo componente legge PutAssetPropertyValueEntry i messaggi dallo AWS IoT Greengrass stream manager. Per ulteriori informazioni, consulta PutAssetPropertyValueEntry nella documentazione di riferimento dell’API AWS IoT SiteWise .

File di registro locale

Questo componente utilizza il seguente file di registro.

Linux
/greengrass/v2/logs/aws.iot.SiteWiseEdgePublisher.log
Windows
C:\greengrass\v2\logs\aws.iot.SiteWiseEdgePublisher.log
Per visualizzare i log di questo componente

  • Esegui il seguente comando sul dispositivo principale per visualizzare il file di registro di questo componente in tempo reale. Sostituisci /greengrass/v2 o C:\greengrass\v2 con il percorso della cartella AWS IoT Greengrass principale.

    Linux
    sudo tail -f /greengrass/v2/logs/aws.iot.SiteWiseEdgePublisher.log
    Windows (PowerShell)
    Get-Content C:\greengrass\v2\logs\aws.iot.SiteWiseEdgePublisher.log -Tail 10 -Wait

Risoluzione dei problemi e debug

Questo componente include un nuovo registro degli eventi per aiutare i clienti a identificare e risolvere i problemi. Il file di registro è separato dal file di registro locale e si trova nella seguente posizione. Sostituisci /greengrass/v2 o C:\greengrass\v2 con il percorso della cartella AWS IoT Greengrass principale.

Linux
/greengrass/v2/work/aws.iot.SiteWiseEdgePublisher/logs/IotSiteWisePublisherEvents.log
Windows
C:\greengrass\v2\work\aws.iot.SiteWiseEdgePublisher\logs\IotSiteWisePublisherEvents.log

Questo registro include informazioni dettagliate e istruzioni per la risoluzione dei problemi. Le informazioni sulla risoluzione dei problemi vengono fornite insieme alla diagnostica, con una descrizione di come risolvere il problema e talvolta con collegamenti a ulteriori informazioni. Le informazioni diagnostiche includono quanto segue:

  • Livello di gravità

  • Time stamp

  • Informazioni aggiuntive specifiche sull'evento

Esempio Log di esempio
accountBeingThrottled:
  Summary: Data upload speed slowed due to quota limits
  Level: WARN
  Timestamp: '2023-06-09T21:30:24.654Z'
  Description: The IoT SiteWise Publisher is limited to the "Rate of data points ingested"
    quota for a customers account. See the associated documentation and associated
    metric for the number of requests that were limited for more information. Note
    that this may be temporary and not require any change, although if the issue continues
    you may need to request an increase for the mentioned quota.
  FurtherInformation:
  - https://docs.aws.amazon.com/iot-sitewise/latest/userguide/quotas.html
  - https://docs.aws.amazon.com/iot-sitewise/latest/userguide/troubleshooting-gateway.html#gateway-issue-data-streams
  AssociatedMetrics:
  - Name: TotalErrorCount
    Description: The total number of errors of this type that occurred.
    Value: 327724.0
  AssociatedData:
  - Name: AggregatePropertyAliases
    Description: The aggregated property aliases of the throttled data.
    FileLocation: /greengrass/v2/work/aws.iot.SiteWiseEdgePublisher/./logs/data/AggregatePropertyAliases_1686346224654.log

Licenze

Questo componente è rilasciato in base al contratto di licenza software Greengrass Core.

Changelog

La tabella seguente descrive le modifiche in ciascuna versione del componente.

Versione

Modifiche

4.1.4
Correzioni di bug e miglioramenti

  • L' SiteWise editore IoT ora riporta le metriche sullo stato del sistema, come l'utilizzo della memoria e della CPU da parte dell' SiteWise editore IoT a. CloudWatch

  • Segnalazione degli errori aggiornata AWS IoT Greengrass in modo che IoT SiteWise Publisher venga riavviato se il flusso di lavoro di avvio presenta un errore parziale.

4.1.3
Correzioni di bug e miglioramenti

  • Risolve una perdita di memoria nel processo di controllo dei dati.

  • Risolve le vulnerabilità di sicurezza.

4.1.2
Correzioni di bug e miglioramenti

  • Risolve un problema relativo alla sincronizzazione di configurazioni di grandi dimensioni.

  • I ritardi nell'abbonamento AWS IoT Core non influiscono più sul processo di avvio.

  • I ritardi nell'inizializzazione dei checkpoint non influiscono più sul processo di avvio.

4.1.1
Correzioni di bug e miglioramenti

  • Risolve un problema che causa un elevato utilizzo della CPU e della memoria negli stream classici e nei gateway V2 quando si inviano dati tramite una destinazione AWS IoT SiteWise bufferizzata utilizzando Amazon S3 dopo il riavvio del publisher.

  • Aggiunge il supporto per sovrascrivere il comportamento predefinito di registrazione dei componenti creando un file opzionale che si trova in:. /greengrass/v2/work/aws.iot.SiteWiseEdgePublisher/log4j2.xml

4.1.0
Nuove funzionalità

  • Aggiunge uno strumento da riga di comando per gestire gli utenti del broker EMQX MQTT integrato. Questa interfaccia consente la gestione degli account utente e configura le politiche di controllo degli accessi per la pubblicazione di argomenti MQTT e le autorizzazioni di sottoscrizione.

Correzioni di bug e miglioramenti

  • Corregge il calcolo che determina quanti alias univoci possono essere contenuti in un singolo file Parquet di ingestione di Buffered.

4.0.3
Correzioni di bug e miglioramenti

  • Aggiorna il numero massimo di alias univoci per file di inserimento nel AWS IoT SiteWise buffer in modo che corrisponda al limite del cloud di 10.000.

  • Risolve un problema di AWS IoT Greengrass registrazione che segnala erroneamente stati di servizio non validi.

  • Aggiunge la convalida per evitare la duplicazione dei nomi di flusso nelle configurazioni di destinazione di Amazon S3 nei flussi classici, gateway V2.

  • Risolve un problema di compatibilità con l'inserimento nel buffer in partizioni non standard. AWS IoT SiteWise AWS

  • Risolve un problema che causa l'inserimento di dati duplicati.

4.0.2
Correzioni di bug e miglioramenti

  • Risolve un problema che impedisce il caricamento dei dati dopo la scadenza del tempo di attesa del batch.

  • Aggiunge la convalida per verificare che ogni destinazione nelle MQTT-enabled configurazioni del gateway V3 sia unica.

4.0.1
Correzioni di bug e miglioramenti

  • Risolve un problema che impedisce il caricamento dei dati AWS IoT SiteWise quando si disabilita la configurazione del tempo massimo di attesa in batch.

  • Risolve un problema a causa del quale la IoTSiteWisePublisher.NumberOfSubscriptionsToMqttBroker metrica riporta erroneamente il numero di argomenti unici sottoscritti al broker MQTT.

4.0.0
Nuove funzionalità

Aggiunge il supporto per i gateway V3 oltre agli stream classici MQTT-enabled, per i gateway V2 (precedentemente noti come gateway Edge self-hosted). SiteWise

Correzioni di bug e miglioramenti

  • Risolve un problema a causa del quale la PublishSuccessCount metrica riporta valori negativi.

  • Risolve un problema a causa del quale il publisher non si avvia entro 100 secondi ed entra nello stato. BROKEN

  • Risolve le vulnerabilità di sicurezza.

3.2.0
Nuove funzionalità
Correzioni di bug e miglioramenti

  • Risolve i problemi che causavano il danneggiamento dei file del database dei checkpoint.

  • Risolve i problemi relativi alla generazione di metriche duplicate.

3.1.4
avvertimento

La versione 3.1.4 è stata interrotta il 20 febbraio 2025. I miglioramenti di questa versione sono disponibili nelle versioni successive di questo componente.

Correzioni di bug e miglioramenti

  • Risolve i problemi che potrebbero causare tempi di avvio più lunghi del previsto dopo la modalità offline.

3.1.3
Correzioni di bug e miglioramenti

  • Risolve un problema a causa del quale il file di registro degli eventi che si trova in /greengrass/v2/work/aws.iot.SiteWiseEdgePublisher/logs/IoTSiteWisePublisherEvents.log veniva creato ma non veniva registrato alcun evento.

  • Aggiunge le seguenti CloudWatch metriche per il monitoraggio della connessione con il broker MQTT:

    • IoTSiteWisePublisher.IsConnectedToMqttBroker

    • IoTSiteWisePublisher.NumberOfSubscriptionsToMqttBroker

    • IoTSiteWisePublisher.NumberOfUniqueMqttTopicsReceived

    • IoTSiteWisePublisher.MqttMessageReceivedSuccessCount

    • IoTSiteWisePublisher.MqttReceivedSuccessBytes

    Per ulteriori informazioni su queste metriche, consulta Gateway Metrics. AWS IoT Greengrass Version 2

  • Risolve un problema per cui l'BatchCreateJobAPI viene ancora chiamata anche se il caricamento di un file parquet su S3 non riesce.

3.1.2
Correzioni di bug e miglioramenti

  • Risolve il problema dell'elevato utilizzo della CPU introdotto nella versione 3.1.1.

3.1.1
avvertimento

La versione 3.1.1 è stata interrotta il 12 marzo 2024. I miglioramenti di questa versione sono disponibili nelle versioni successive di questo componente.

Correzioni di bug e miglioramenti

  • Aggiunge una registrazione aggiuntiva che identifica gli alias di dati interessati quando si verifica un errore.

  • Aggiunge l'applicazione locale dei limiti delle AWS IoT SiteWise API sull'età dei dati acquisiti.

  • Risolve il problema a causa del quale Publisher confonde i checkpoint degli StreamManager stream quando sono presenti più destinazioni Amazon S3.

  • Risolve il problema delle prestazioni dovute al modo in cui l'editore legge dagli stream. StreamManager

3.1.0
Nuove funzionalità

  • Aggiunge il supporto per la pubblicazione di dati come file parquet su Amazon S3.

  • Aggiunge il supporto per l'inserimento nel AWS IoT SiteWise buffer.

3.0.0
Correzioni di bug e miglioramenti

  • Risolve i problemi relativi al supporto dei proxy.

Nuove funzionalità

  • Consente il supporto dell'inserimento di dati da un broker MQTT.

2.4.1
Correzioni di bug e miglioramenti

  • Abilita il componente per funzionare con Java Corretto 11 versioni 11.0.20.8.1 e successive. Le versioni dei componenti 2.4.0 e 2.3.3 mostrano il messaggio di "Could not find or load main class" errore se utilizzati con la versione Java Corretto 11.0.20.8.1.

2.4.0
Nuove funzionalità

  • Aggiunge un nuovo registro degli eventi per facilitare l'identificazione e la risoluzione dei problemi.

Correzioni di bug e miglioramenti

  • Migliora il ripristino dei checkpoint di Publisher.

2.3.3
Correzioni di bug e miglioramenti

  • Migliora la capacità di supportare un throughput elevato.

2.3.2
Correzioni di bug e miglioramenti

  • Risolve il supporto del proxy HTTP durante il download della configurazione di Publisher.

2.3.1
Nuove funzionalità

  • Aggiunge il supporto per l'installazione di Data Collection Pack sull'architettura Linux ARMv8.

  • Requisiti minimi per Linux ARMv8:

    • Memoria: 4 GB

    • CPU: ARM Cortex-A72 o specifica equivalente

2.2.3
Correzioni di bug e miglioramenti

  • Rimuove il tentativo per un'eccezione generica che non era nell'elenco delle eccezioni recuperabili.

2.2.2
Correzioni di bug e miglioramenti

  • Reintroduce il supporto per il caricamento dei dati AWS IoT SiteWise tramite un server proxy HTTP.

2.2.1
Nota

Questa versione non supporta la configurazione del proxy HTTP. La versione 2.2.2 e successive reintroduce il supporto per questa funzionalità.

Nuove funzionalità

  • Aggiunge il supporto a questo componente per attivare o disattivare la compressione durante il caricamento dei dati su. AWS IoT SiteWise

2.2.0
Nota

Questa versione non supporta la configurazione del proxy HTTP. La versione 2.2.2 e successive reintroduce il supporto per questa funzionalità.

Nuove funzionalità

  • Aggiorna questo componente per comprimere i dati prima di inviarli al servizio. AWS IoT SiteWise

    • Nella maggior parte dei casi, questa modifica riduce l'utilizzo della larghezza di banda del 75% rispetto alle versioni precedenti di questo componente.

    • Nella maggior parte dei casi, questa modifica aumenta l'utilizzo della CPU fino al 5%. Sui gateway che elaborano grandi quantità di dati, questa modifica può aumentare l'utilizzo della CPU fino al 15%.

    • Questa modifica non influisce sui costi di AWS IoT SiteWise servizio o sull'utilizzo delle quote di servizio.

    • Aggiunge il supporto per Windows Server 2019 o versioni successive.

Correzioni di bug e miglioramenti

  • Risolve un problema che impedisce l'avvio di questo componente quando il file di checkpoint è danneggiato.

2.1.4
Correzioni di bug e miglioramenti

  • Corregge la compatibilità con la versione 8 di Java.

2.1.3
avvertimento

Questa versione non è più disponibile, tranne nelle regioni Stati Uniti orientali (Ohio), Canada (centrali) e AWS GovCloud (US-East). Questa versione del componente richiede la versione 11 o successiva di Java per funzionare. I miglioramenti di questa versione sono disponibili nelle versioni successive di questo componente.

Correzioni di bug e miglioramenti

  • Migliora i messaggi di errore quando si distribuisce questo componente su dispositivi non supportati.

  • Aggiornamenti per registrare gli errori quando il caricamento dei dati non riesce.

2.1.2
Correzioni di bug e miglioramenti

  • Aggiornamenti per richiamare la funzionalità di esportazione dei dati scaduti non appena i dati scadono.

2.1.1

Correzioni di bug e miglioramenti.

2.1.0
Nuove funzionalità

  • Aggiunge il supporto per la pubblicazione prioritaria dei dati più recenti nel cloud.

  • Aggiunge il supporto per non pubblicare dati scaduti nel cloud.

  • Aggiunge il supporto per l'archiviazione locale dei dati scaduti.

Correzioni di bug e miglioramenti

  • Riduce il disco I/O e la latenza corrispondente.

2.0.2

Correzioni di bug e miglioramenti.

2.0.1

Versione iniziale.

Consulta anche