SiteWise Editore IoT - AWS IoT Greengrass
VersioniTypeSistema 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:

  • 3.1.x

  • 3.0.x

  • 2.4.x

  • 2.3.x

  • 2.2.x

  • 2.1.x

  • 2,0x

Type

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

Per ulteriori informazioni, consulta Tipi di componenti.

Sistema operativo

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

  • Linux

  • Windows

Requisiti

Questo componente presenta i seguenti requisiti:

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

    • Sistema operativo: Ubuntu 18.04 o versione successiva

      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 versione successiva

      Architettura: x86_64 (AMD64)

  • Il dispositivo principale Greengrass deve connettersi a Internet.

  • Il dispositivo principale 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
    {
    "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 verso i seguenti endpoint e porte, oltre agli endpoint e alle porte necessari per le operazioni di base. Per ulteriori informazioni, consulta Consenti il traffico dei dispositivi tramite un proxy o un firewall.

Endpoint Porta Richiesto Descrizione

data.iotsitewise.region.amazonaws.com

 443 Sì

Pubblica dati su. AWS IoT SiteWise

Dipendenze

Quando si distribuisce un componente, distribuisce AWS IoT Greengrass anche versioni compatibili delle relative dipendenze. Ciò significa che è necessario soddisfare i requisiti per il 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 di versione semantica che definiscono le versioni dei componenti per ogni dipendenza. È inoltre possibile visualizzare le dipendenze per ogni 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,010<3,00 Rigidi

Per ulteriori informazioni sulle dipendenze dei componenti, vedere il riferimento alla ricetta dei componenti.

Configurazione

Questo componente non ha parametri di configurazione.

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

Dati di input

Questo componente legge i PutAssetPropertyValueEntry messaggi dallo AWS IoT Greengrass stream manager. Per ulteriori informazioni, consulta PutAssetPropertyValueEntryl'AWS IoT SiteWise API Reference.

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. Sostituire /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. Oltre alla diagnostica, vengono fornite informazioni sulla risoluzione dei problemi, con una descrizione di come risolvere il problema e, a volte, con collegamenti a ulteriori informazioni. Le informazioni diagnostiche includono quanto segue:

  • Livello di gravità

  • Timestamp

  • 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 del software Greengrass Core.

Changelog

La tabella seguente descrive le modifiche apportate a ciascuna versione del componente.

Versione

Modifiche

3.1.3
Correzioni di bug e miglioramenti

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

  • Sono state aggiunte 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 AWS IoT Greengrass Version 2 Gateway Metrics.

  • È stato risolto un problema per cui l'BatchCreateJobAPI veniva comunque chiamata anche se il caricamento di un file parquet su S3 non funzionava.

3.1.2
Correzioni di bug e miglioramenti

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

3.1.1
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 dell' AWS IoT SiteWise API sull'età dei dati acquisiti.

  • Risolve il problema per cui Publisher confonde i checkpoint degli StreamManager stream quando ci sono più destinazioni Amazon S3.

  • Risolve il problema delle prestazioni legato al modo in cui Publisher legge gli 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' AWS IoT SiteWise ingestione bufferizzata.

3.0.0
Correzioni di bug e miglioramenti

  • Risolve i problemi relativi al supporto proxy.

Nuove funzionalità

  • Abilita il supporto per l'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 quando vengono utilizzate con la versione 11.0.20.8.1 di Java Corretto.

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 del 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 specifiche equivalenti

2.2.3
Correzioni di bug e miglioramenti

  • Rimuove i tentativi per un'eccezione generica che non era presente 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 reintroducono il supporto per questa funzionalità.

Nuove funzionalità

  • Aggiunge il supporto a questo componente per attivare 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 reintroducono 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 a questo componente di avviarsi quando il file di checkpoint è danneggiato.

2.1.4
Correzioni di bug e miglioramenti

  • Risolve la compatibilità con la versione Java 8.

2.1.3
avvertimento

Questa versione non è più disponibile, tranne nelle regioni Stati Uniti orientali (Ohio), Canada (Centrale) e AWS GovCloud (Stati Uniti orientali). Questa versione del componente richiede la versione Java 11 o successiva 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.

  • Si aggiorna 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 innanzitutto il supporto per la pubblicazione dei dati più recenti sul 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 l'I/O del disco e la latenza corrispondente.

2.0.2

Correzioni di bug e miglioramenti.

2.0.1

Versione iniziale.

Consulta anche