Versioni Type Sistema operativo Requisiti Dipendenze Configurazione Dati di input Dati di output File di registro locale Risoluzione dei problemi e debug Licenze Changelog Consulta anche

Collettore IoT SiteWise OPC-UA

Il componente di raccolta IoT SiteWise OPC-UA (aws.iot.SiteWiseEdgeCollectorOpcua) consente ai AWS IoT SiteWise gateway di raccogliere dati dai server OPC-UA locali.

Con questo componente, i AWS IoT SiteWise gateway possono connettersi a più server OPC-UA. Per ulteriori informazioni sui AWS IoT SiteWise gateway, vedere Using AWS IoT SiteWise at the edge nella Guida per l'utente.AWS IoT SiteWise

Versioni

Questo componente ha le seguenti versioni:

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 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 versione successiva
  
  Architettura: x86_64 (AMD64)
Il dispositivo principale Greengrass deve consentire la connettività di rete in uscita ai server OPC-UA.

Dipendenze

Quando si distribuisce un componente, distribuisce AWS IoT Greengrass anche versioni compatibili delle sue 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 tutte le versioni 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
Gestore segreto	>2,0,10 =2,0,8 <3,0,0	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 del collettore IoT SiteWise OPC-UA. Per ulteriori informazioni, consulta Passaggio 4: Aggiungere fonti di dati, facoltativo nella Guida per l'AWS IoT SiteWise utente.

Dati di input

Questo componente accetta solo dati nei seguenti formati, tutti gli altri verranno ignorati e scartati. La tabella seguente associa i tipi di dati OPC UA ai loro equivalenti. SiteWise

SiteWise tipo di dati	tipo di dati OPC UA	Descrizione
`STRING`	`String` `Guid` `XmlElement`	Una stringa di lunghezza massima di 1024 byte.
`INTEGER`	`SByte` `Byte` `Int16` `UInt16` `Int32` `UInt32`* `Int64`*	Un numero intero con segno a 32 bit con un intervallo da. `-2,147,483,648 to 2,147,483,647`
`DOUBLE`	`UInt32`* `Int64`* `Float` `Double`	Un numero a virgola mobile con intervallo `–10^100 to 10^100` e `IEEE 754` precisione doppia.
`BOOLEAN`	`Boolean`	`true` o `false`.

* Per i tipi di dati OPC UA UInt32 eInt64, il suo tipo di SiteWise dati sarà INTEGER se SiteWise è in grado di rappresentarne il valore, altrimenti lo sarà. DOUBLE

Dati di output

Questo componente scrive BatchPutAssetPropertyValue messaggi nello AWS IoT Greengrass stream manager. Per ulteriori informazioni, consulta BatchPutAssetPropertyValue nella documentazione di riferimento dell'API AWS IoT SiteWise .

File di registro locale

Questo componente utilizza il seguente file di registro.

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.SiteWiseEdgeCollectorOpcua.log
```
Windows (PowerShell)
```
Get-Content C:\greengrass\v2\logs\aws.iot.SiteWiseEdgeCollectorOpcua.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.

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


dataSourceConnectionSuccess:
  Summary: Successfully connected to OpcUa server
  Level: INFO
  Timestamp: '2023-06-15T21:04:16.303Z'
  Description: Successfully connected to the data source.
  AssociatedMetrics:
  - Name: FetchedDataStreams
    Description: The number of fetched data streams for this data source
    Value: 1.0
    Namespace: IoTSiteWise
    Dimensions:
    - Name: SourceName
      Value: SourceName{value=OPC-UA Server}
    - Name: ThingName
      Value: test-core
  AssociatedData:
  - Name: DataSourceTrace
    Description: Name of the data source
    Data:
    - OPC-UA Server
  - Name: EndpointUri
    Description: The endpoint to which the connection was attempted.
    Data:
    - '"opc.tcp://10.0.0.1:1234"'

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
2.4.2	Correzioni di bug e miglioramenti Risolve i problemi durante il rilevamento del server OPC UA in cui un nodo può essere scoperto più volte. Corregge la funzionalità di istantanea per garantire che il timestamp sia nuovo per ogni punto dati dell'istantanea.
2.4.1	Correzioni di bug e miglioramenti Risolve i problemi relativi al supporto proxy. Risolve il problema in cui la pulizia del thread non riusciva e causava un blocco dei dati.
2.4.0	Nuove funzionalità Aggiunge un registro degli eventi per facilitare l'identificazione e la risoluzione dei problemi. Correzioni di bug e miglioramenti Risolve un problema con il client OPC-UA che causava errori di certificato durante la connessione a un server OPC-UA che utilizza la versione 1.05 della specifica OPC-UA.
2.3.0	Nuove funzionalità Aggiunge il supporto per la configurazione del proxy HTTP Greengrass nucleus su Linux. Correzioni di bug e miglioramenti Risolve un problema di sicurezza (CVE-2019-19135).
2.2.0	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 Correzioni di bug e miglioramenti Migliora la registrazione delle metriche nel processo di scoperta dei nodi. Migliora la gestione dei tipi di dati non supportati. Migliora la registrazione degli errori del flusso di dati.
2.1.3	Nuove funzionalità Aggiunge il supporto per Windows Server 2019 o versioni successive. Correzioni di bug e miglioramenti Migliora i messaggi di errore quando si distribuisce questo componente su dispositivi non supportati.
2.1.1	Nuove funzionalità Aggiunge il supporto per la configurazione delle seguenti proprietà di sottoscrizione: DataChangeTrigger‐ È possibile definire la condizione che avvia un avviso di modifica dei dati. QueueSize‐ La profondità della coda su un server OPC‐UA per una particolare metrica in cui sono messe in coda le notifiche per gli elementi monitorati. PublishingIntervalMilliseconds‐ L'intervallo (in millisecondi) di un ciclo di pubblicazione specificato al momento della creazione di un abbonamento. SnapshotFrequencyMilliseconds ‐ È possibile configurare l'impostazione del timeout della frequenza delle istantanee per garantire che AWS IoT SiteWise Edge acquisisca un flusso costante di dati. Questa versione supporta l'ingestione di dati di `BAD` qualità e filtra i dati in base alle seguenti qualità di dati: `UNCERTAIN`dati di qualità `BAD`dati di qualità Correzioni di bug e miglioramenti Miglioramenti alle metriche dei clienti. Risolve la codifica di sicurezza che a volte causava problemi durante la connessione a server con crittografia abilitata. Risolve un problema a causa del quale il gruppo di proprietà non riusciva ad aggiornarsi.
2.0.3	Correzioni di bug e miglioramenti.
2.0.2	Correzioni di bug e miglioramenti alla sincronizzazione delle priorità delle risorse con Edge.
2.0.1	Versione iniziale.

Consulta anche

Che cos'è? AWS IoT SiteWise nella Guida AWS IoT SiteWise per l'utente.

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

Servizio di scambio di token

Simulatore di sorgenti dati IoT SiteWise OPC-UA