View a markdown version of this page

SiteWise Processore IoT - AWS IoT Greengrass
VersioniTipoSistema operativoRequisitiDipendenzeConfigurazioneFile di registro localeLicenzeChangelogConsulta 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 Processore IoT

Il componente SiteWise del processore IoT (aws.iot.SiteWiseEdgeProcessor) consente ai flussi AWS IoT SiteWise classici, ai gateway V2 di elaborare i dati all'edge.

Con questo componente, i AWS IoT SiteWise gateway possono utilizzare modelli e risorse di asset per elaborare i dati sui dispositivi gateway. Per ulteriori informazioni sui AWS IoT SiteWise gateway, consulta Using AWS IoT SiteWise at the edge nella Guida per l'AWS IoT SiteWise utente.

Nota

La funzionalità del pacchetto di elaborazione dati (DPP) non sarà più aperta ai nuovi clienti a partire dal 7 novembre 2025. Se desideri utilizzare il DPP, registrati prima di tale data. I clienti esistenti possono continuare a utilizzare il servizio normalmente. Per ulteriori informazioni, vedere Modifica della disponibilità dei pacchetti di elaborazione dati nella Guida per l'AWS IoT SiteWise utente.

Versioni

Questo componente ha le seguenti versioni:

  • 3.5.x

  • 3.4.x

  • 3.3.x

  • 3.2.x

  • 3.1.x

  • 3.0.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 20.04 o successivo

      architettura: x86_64 (AMD64)

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

      architettura: x86_64 (AMD64)

    • sistema operativo: Amazon Linux 2

      architettura: x86_64 (AMD64)

    • sistema operativo: Windows Server 2019 o successivo

      architettura: x86_64 (AMD64)

    • os: Debian 11 (Bullseye) o successivo

      architettura: x86_64 (AMD64)

  • Il dispositivo principale Greengrass deve consentire il traffico in entrata sulla porta 443.

  • Il dispositivo principale Greengrass deve consentire il traffico in uscita sulle porte 443 e 8883.

  • Le seguenti porte sono riservate all'uso da AWS IoT SiteWise: 80, 443, 3001, 4569, 4572, 8000, 8081, 8082, 8084, 8085, 8086, 8445, 9000, 9500, 11080 e 50010. L'utilizzo di una porta riservata per il traffico può causare l'interruzione della connessione.

    Nota

    La porta 8087 è richiesta solo per la versione 2.0.15 e successive di questo componente.

  • Il ruolo del dispositivo Greengrass deve disporre delle autorizzazioni che consentano di utilizzare AWS IoT SiteWise i gateway sui dispositivi. AWS IoT Greengrass V2 Per ulteriori informazioni, consulta Requisiti nella Guida per l'AWS IoT SiteWise utente.

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

model.iotsitewise.region.amazonaws.com

 443 Sì

Ottieni informazioni sulle tue AWS IoT SiteWise risorse e sui tuoi modelli di asset.

edge.iotsitewise.region.amazonaws.com

 443 Sì

Ottieni informazioni sulla configurazione del AWS IoT SiteWise gateway del dispositivo principale.

ecr.region.amazonaws.com

 443 Sì

Scarica le immagini Docker di AWS IoT SiteWise Edge Gateway da Amazon Elastic Container Registry.

iot.region.amazonaws.com

 443 Sì

Ottieni gli endpoint dei dispositivi per il tuo. Account AWS

sts.region.amazonaws.com

 443 Sì

Ottieni l'ID del tuo Account AWS.

monitor.iotsitewise.region.amazonaws.com

 443 No

Obbligatorio se accedi ai AWS IoT SiteWise Monitor portali sul dispositivo principale.

Dipendenze

Quando si distribuisce un componente, vengono distribuite AWS IoT Greengrass anche versioni compatibili delle relative 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.1.x di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Servizio di scambio di token > =2.0.3 <3.0.0 Rigidi
Stream manager =2.0.3 =2.0.10 <3.0.0 Rigidi
Interfaccia a riga di comando di Greengrass > =2.3.0 <3.0.0 Rigidi

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

Configurazione

Questo componente non ha parametri di configurazione.

File di registro locale

Questo componente utilizza il seguente file di registro.

Linux
/greengrass/v2/logs/aws.iot.SiteWiseEdgeProcessor.log
Windows
C:\greengrass\v2\logs\aws.iot.SiteWiseEdgeProcessor.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.SiteWiseEdgeProcessor.log
    Windows (PowerShell)
    Get-Content C:\greengrass\v2\logs\aws.iot.SiteWiseEdgeProcessor.log -Tail 10 -Wait

Licenze

Questo componente include le seguenti terze parti software/licensing:

  • Apache-2.0

  • MIT

  • BSD-2-Clause

  • BSD-3-Clause

  • CDDL-1.0

  • CDDL-1.1

  • DISCO

  • Zlib

  • GPL-3.0-with-GCC-exception

  • Dominio pubblico

  • Python-2.0

  • Unicode-DFS-2015

  • BSD-1-Clause

  • OpenSSL

  • EPL-1.0

  • EPL-2.0

  • GPL-2.0-with-classpath-exception

  • MPL-2.0

  • CC0-1.0

  • JSON

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

Changelog

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

Versione

Modifiche

3.5.1
Nuove funzionalità

È stato aggiunto il supporto per l'inserimento di valori Null e NaN se l'ingestione è abilitata. AWS IoT SiteWise Per visualizzare o modificare la configurazione Null e NaN in AWS IoT SiteWise, consulta le API and. DescribeStorageConfiguration PutStorageConfiguration

Correzioni di bug e miglioramenti

Dipendenze aggiornate per risolvere potenziali vulnerabilità di sicurezza.

3.4.0
Nuove funzionalità
Miglioramenti in termini di prestazioni

È stato ridotto il tempo necessario affinché i dati in ingresso raggiungano lo spazio di archiviazione del dispositivo edge da 5 secondi a meno di 1 secondo. La latenza per il caricamento dei dati rimane invariata. AWS IoT SiteWise

3.3.1
Nuova funzionalità

  • È stato aggiunto il supporto CORS opzionale alle API SiteWise Edge, migliorando le funzionalità di condivisione delle risorse tra origini. Questa funzionalità migliora la flessibilità per le applicazioni web che interagiscono con le API.

3.3.0
Miglioramenti in termini di prestazioni

  • Meccanismo di aggiornamento della cache ottimizzato per ridurre I/O l'utilizzo tra le AWS IoT SiteWise sincronizzazioni delle risorse aggiornando solo le voci per le risorse nuove o aggiornate.

  • Ingombro di memoria ridotto per mantenere una cache con un gran numero di proprietà delle risorse sincronizzate.

Correzioni di bug e miglioramenti

  • Registri soppressi per l'inserimento dei valori delle singole proprietà in assenza di errori di inserimento, con conseguente riduzione del rumore dei log in caso di tassi di inserimento elevati.

  • Migliore leggibilità dei log utilizzando una formattazione leggibile dall'uomo per determinate voci di registro.

  • È stato aggiunto il supporto per Java 17 e versioni successive.

3.2.1
Correzioni di bug e miglioramenti

  • Risolve il problema a causa del quale le chiamate AWS IoT SiteWise API non vengono impaginate in modo sincrono con Edge. SiteWise

  • Risolve il problema di non pubblicare più la MessageRemaining.SiteWise_Edge_Stream metrica.

  • Sono state aggiunte le seguenti CloudWatch metriche per monitorare la connessione con il broker MQTT.

    • IoTSiteWiseProcessor.IsConnectedToMqttBroker

    • IoTSiteWiseProcessor.NumberOfSubscriptionsToMqttBroker

    • IoTSiteWiseProcessor.NumberOfUniqueMqttTopicsReceived

    • IoTSiteWiseProcessor.MqttMessageReceivedSuccessCount

    • IoTSiteWiseProcessor.MqttReceivedSuccessBytes

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

3.2.0
Miglioramenti in termini di prestazioni

  • Ottimizza i servizi API per ridurre l'ingombro di memoria e richiedere meno spazio su disco per l'installazione

    • Ciò comporta una riduzione di 2 GB nell'utilizzo iniziale della memoria (ora utilizza 7,5 GB di memoria all'avvio, tuttavia sono comunque consigliati 16 GB) e una riduzione di 500 MB delle dimensioni di download (ora richiede un download di 1,4 GB) per l'intero componente.

Nuove funzionalità

  • GetAssetPropertyValueAggregatesL'API ora supporta finestre di aggregazione di 15 minuti sull'edge.

  • Le porte 8081 e 8082 non devono più essere disponibili per il corretto funzionamento di questo componente.

    Nota

    L'endpoint locale per le API del piano AWS IoT SiteWise dati, ad esempioget-asset-property-value, viene modificato da a. http://localhost:8081 http://localhost:11080/data L'endpoint locale per le API AWS IoT SiteWise del piano di controllo, ad esempiolist-asset-models, viene modificato da a. http://localhost:11080 http://localhost:11080/control AWS consiglia sempre di utilizzare gli endpoint HTTPS di SiteWise Edge Gateway. Questi endpoint non sono cambiati.

Correzioni di bug e miglioramenti

  • La sincronizzazione da ora AWS IoT SiteWise trasferirà le risorse in uno stato valido se la sincronizzazione precedente è stata interrotta. Ciò risolverà i problemi relativi al danneggiamento di alcune risorse dopo un riavvio forzato.

  • Risolve una rara condizione in cui una risorsa può essere danneggiata all'edge se viene modificata durante la sincronizzazione. La sincronizzazione ora fallirà se viene rilevata questa condizione e la risorsa verrà ritentata nella sincronizzazione successiva.

  • Risolve un problema che avrebbe potuto consentire la chiamata esterna dell'endpoint HTTP per le API. Ora è possibile utilizzare solo HTTPS per chiamare le API al di fuori dell'indirizzo di loopback locale.

  • ListAssetsL'API ora mostra le gerarchie degli asset per gli asset archiviati all'edge.

  • Risolve un problema a causa del quale il Data Processing Pack non riusciva a riavviarsi, eseguire l'aggiornamento o il downgrade su Windows.

  • Risolve un bug nel Data Processing Pack per il sistema operativo Windows che impediva ai clienti di utilizzare le credenziali per connettersi a un broker MQTT.

3.1.3
Correzioni di bug e miglioramenti

  • Risolve il problema per cui il Data Processing Pack segnalava erroneamente una sincronizzazione riuscita quando alcune risorse non funzionavano effettivamente.

  • Consenti a più risorse di avere lo stesso nome purché non abbiano lo stesso genitore.

3.1.1
Correzioni di bug e miglioramenti

  • Risolve il problema in cui la richiesta SIGv4 fallisce a causa di una mancata corrispondenza del fuso orario.

  • Risolve il problema a causa del quale le proprietà di trasformazione e metrica smettono di essere calcolate quando si basano sugli attributi dopo il riavvio.

  • Abilita il supporto della configurazione personalizzata delle porte di Stream Manager.

  • Risolve un problema a causa del quale le proprietà sincronizzate con l'edge potrebbero non essere aggiornate.

3.1.0
Correzioni di bug e miglioramenti

  • Risolve il problema a causa del quale ListAssetModels l'API non riesce a generare il token successivo.

3.0.0
Nuove funzionalità

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

2.2.1
Correzioni di bug e miglioramenti

  • Modifica il processo di sincronizzazione per rendere l'archiviazione dei dati sul piano di controllo più coerente con il funzionamento del cloud. Ciò influisce leggermente sull'aggiornamento.

    Nota

    I dati del piano di controllo sincronizzati nella versione 2.2.1 o successiva non saranno compatibili con le versioni precedenti. Per effettuare il downgrade alle versioni precedenti, dovrai completare una nuova installazione. Ciò non influisce sugli aggiornamenti, i dati sincronizzati nelle versioni precedenti funzioneranno con la versione 2.2.1.

  • Modifiche aggiuntive alla catena delle credenziali per dare priorità alle AWS credenziali. AWS IoT Greengrass V2

2.1.37
Correzioni di bug e miglioramenti

  • Elimina il processo dependency-routing-service e sposta la sua funzionalità nel processo property-state-service per ridurre l'utilizzo delle risorse dei processi di comunicazione.

  • Aumenta il limite massimo di risultati per l'API a 20.000 in modo che corrisponda al limite utilizzato da. get-asset-property-value-history AWS IoT SiteWise

  • Risolve un problema per cui il token successivo non veniva fornito nei risultati paginati per l'get-asset-property-value-historyAPI quando non era specificato alcun limite massimo di risultati.

2.1.35
Correzioni di bug e miglioramenti

  • Modifica la catena delle AWS credenziali per dare priorità alle credenziali. AWS IoT Greengrass

  • Risolve un problema relativo al rilevamento degli account durante la distribuzione come parte di un gruppo di oggetti. AWS IoT

2.1.34
Correzioni di bug e miglioramenti

  • Regola i metric/transform calcoli per utilizzare il multithreading su Linux. Windows continua a eseguire calcoli a thread singolo per motivi di compatibilità.

  • Risolve un problema a causa del quale mancavano i calcoli delle metriche per alcune finestre di calcolo.

2.1.33
Correzioni di bug e miglioramenti

  • Risolve un problema relativo alla segnalazione dello stato di errore nella console di Greengrass.

2.1.32
Correzioni di bug e miglioramenti

  • Aggiunge il supporto per nomi utente e gruppi personalizzati.

2.1.31
Correzioni di bug e miglioramenti

  • Aggiunge il supporto per il calcolo della media ponderata nel tempo e della deviazione standard ponderata nel tempo per i dati modellati. AWS IoT SiteWise

2.1.29
Correzioni di bug e miglioramenti

  • Aggiunge il supporto per filtrare le risorse sulla funzionalità edge.

2.1.28
Correzioni di bug e miglioramenti

  • Ottimizza la sincronizzazione delle risorse per consentire la sincronizzazione di un gran numero di risorse dall'edge Cloud AWS all'edge.

2.1.24
Correzioni di bug e miglioramenti

  • Risolve un problema che causava la scomparsa della dashboard durante la seconda sincronizzazione di una risorsa.

2.1.23
Correzioni di bug e miglioramenti

  • È stato aggiunto un timeout per il processo di aws.iot.SiteWiseEdgeProcessor installazione per evitare errori di installazione se la connettività Internet è lenta.

  • Sincronizzazione delle risorse ottimizzata per migliorare l'efficienza della sincronizzazione tra cloud ed edge.

2.1.21
avvertimento

L'aggiornamento da 2.0.x a 2.1.x comporterà la perdita di dati locali.

Nuove funzionalità

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

  • Rimuove docker per i sistemi Linux-based operativi.

2.0.16

Questa versione contiene correzioni di bug e miglioramenti.

2.0.15
Correzioni di bug e miglioramenti

  • Cambia la porta utilizzata da questo componente per le operazioni dell'API di sincronizzazione delle risorse da 8085 a 8087. Di conseguenza, questo componente ora richiede la disponibilità della porta 8087. Questo componente richiede ancora la disponibilità della porta 8085.

  • Aggiorna AWS OpsHub l'autenticazione per negare l'accesso agli utenti non autorizzati anziché quando un utente tenta di chiamare le operazioni API.

2.0.14

Questa versione contiene correzioni di bug e miglioramenti.

2.0.13
Correzioni di bug e miglioramenti

  • Risolve un problema in modo che quando questo componente riporta i dati alle CloudWatch metriche di Amazon, ora indichi correttamente quali dati non sono modellati.

2.0.9
Correzioni di bug e miglioramenti

  • Migliora l'affidabilità nella creazione e nell'aggiornamento AWS IoT SiteWise delle risorse sul dispositivo principale.

  • Aggiunge ulteriori operazioni API locali che è possibile utilizzare per monitorare quali componenti sono installati sul dispositivo principale, la versione di ciascun componente e lo stato di ciascun componente. È possibile visualizzare queste informazioni nella scheda Impostazioni dell' AWS IoT SiteWise applicazione AWS OpsHub for sul dispositivo principale.

  • Aggiunge uno stato di integrità per i contenitori Docker eseguiti da questo componente. È possibile eseguire il docker ps comando per visualizzare lo stato di integrità dei contenitori.

2.0.7
Correzioni di bug e miglioramenti

  • Risolve il supporto per la visualizzazione dei AWS IoT SiteWise Monitor portali sul dispositivo principale.

2.0.6
Correzioni di bug e miglioramenti

  • Corregge le latest() funzioni AWS IoT SiteWise statetime()earliest(), e che questo componente calcola sul dispositivo principale.

2.0.5
Correzioni di bug e miglioramenti

  • Aggiunge il supporto per la AWS IoT SiteWise pretrigger() funzione nelle trasformazioni che questo componente calcola sul dispositivo principale.

  • Cambia il percorso in cui questo componente memorizza la configurazione LDAP (Lightweight Directory Access Protocol) per l'autenticazione.

2.0.2

Versione iniziale.

Consulta anche