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

# Collettore IoT SiteWise OPC UA
<a name="iotsitewise-opcua-collector-component"></a>

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 ](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/gateways-ggv2.html) nella Guida per l'utente. *AWS IoT SiteWise *

**Topics**
+ [Versioni](#iotsitewise-opcua-collector-component-versions)
+ [Tipo](#iotsitewise-opcua-collector-component-type)
+ [Sistema operativo](#iotsitewise-opcua-collector-component-os-support)
+ [Requisiti](#iotsitewise-opcua-collector-component-requirements)
+ [Dipendenze](#iotsitewise-opcua-collector-component-dependencies)
+ [Configurazione](#iotsitewise-opcua-collector-component-configuration)
+ [Dati di input](#iotsitewise-opcua-collector-component-input-data)
+ [Dati di output](#iotsitewise-opcua-collector-component-output-data)
+ [File di registro locale](#iotsitewise-opcua-collector-component-log-file)
+ [Licenze](#iotsitewise-opcua-collector-component-licenses)
+ [Changelog](#iotsitewise-opcua-collector-component-changelog)
+ [Consulta anche](#iotsitewise-opcua-collector-component-see-also)

## Versioni
<a name="iotsitewise-opcua-collector-component-versions"></a>

Questo componente ha le seguenti versioni:
+ 3.1.x
+ 3.0.x
+ 2.6.x
+ 2.5.x
+ 2.4.x
+ 2.3.x
+ 2.2.x
+ 2.1.x
+ 2.0.x

## Tipo
<a name="iotsitewise-opcua-collector-component-type"></a>

<a name="public-component-type-generic"></a>Questo <a name="public-component-type-generic-phrase"></a> componente è un componente generico ()`aws.greengrass.generic`. Il nucleo di [ Greengrass ](greengrass-nucleus-component.md) esegue gli script del ciclo di vita del componente. 

<a name="public-component-type-more-information"></a>Per ulteriori informazioni, consulta [Tipi di componenti](develop-greengrass-components.md#component-types).

## Sistema operativo
<a name="iotsitewise-opcua-collector-component-os-support"></a>

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

## Requisiti
<a name="iotsitewise-opcua-collector-component-requirements"></a>

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) 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 Greengrass deve consentire la connettività di rete in uscita ai server OPC UA.

## Dipendenze
<a name="iotsitewise-opcua-collector-component-dependencies"></a>

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 ](#iotsitewise-opcua-collector-component-changelog) 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](https://console.aws.amazon.com/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 ](greengrass-nucleus-component.md) | > =2.3.0 <3.0.0 | Rigidi | 
| [Stream manager](stream-manager-component.md) | =2,3.0 2.0.10<3.0.0 | Rigidi | 
| [Gestore segreto](secret-manager-component.md) | 2,0,10 =2.0.8 <3.0.0 | Rigidi | 

Per ulteriori informazioni sulle dipendenze dei componenti, consultate il riferimento alla composizione dei componenti. [ComponentDependencies](component-recipe-reference.md#recipe-reference-component-dependencies)

## Configurazione
<a name="iotsitewise-opcua-collector-component-configuration"></a>

Questo componente non ha parametri di configurazione.

È possibile utilizzare la AWS IoT SiteWise console o l'API per configurare il componente del collettore IoT SiteWise OPC UA. Per ulteriori informazioni, consulta la [ Fase 4: Aggiungere fonti di dati - opzionale ](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/create-gateway-ggv2.html#add-data-sources-console) nella Guida per l'*AWS IoT SiteWise utente. *

## Dati di input
<a name="iotsitewise-opcua-collector-component-input-data"></a>

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`<br />`Guid`<br />`XmlElement` | Una stringa di lunghezza massima di 1024 byte. | 
| `INTEGER` | `SByte`<br />`Byte`<br />`Int16`<br />`UInt16`<br />`Int32`<br />`UInt32`\*<br />`Int64`\* | Un numero intero con segno a 32 bit con un intervallo da. `-2,147,483,648 to 2,147,483,647` | 
| `DOUBLE` | `UInt32`\*<br />`Int64`\*<br />`Float`<br />`Double` | Un numero in virgola mobile con intervallo da `–10^100 to 10^100` e precisione `IEEE 754` doppia. | 
| `BOOLEAN` | `Boolean` | `true` o `false`. | 

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

## Dati di output
<a name="iotsitewise-opcua-collector-component-output-data"></a>



Questo componente scrive `BatchPutAssetPropertyValue` messaggi nello AWS IoT Greengrass stream manager. Per ulteriori informazioni, consulta [BatchPutAssetPropertyValue](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchPutAssetPropertyValue.html) nella *documentazione di riferimento dell’API AWS IoT SiteWise *.

## File di registro locale
<a name="iotsitewise-opcua-collector-component-log-file"></a>

Questo componente utilizza il seguente file di registro.

------
#### [ Linux ]

```
{{/greengrass/v2}}/logs/aws.iot.SiteWiseEdgeCollectorOpcua.log
```

------
#### [ Windows ]

```
{{C:\greengrass\v2}}\logs\aws.iot.SiteWiseEdgeCollectorOpcua.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.SiteWiseEdgeCollectorOpcua.log
  ```

------
#### [ Windows (PowerShell) ]

  ```
  Get-Content {{C:\greengrass\v2}}\logs\aws.iot.SiteWiseEdgeCollectorOpcua.log -Tail 10 -Wait
  ```

------

## Licenze
<a name="iotsitewise-opcua-collector-component-licenses"></a>

<a name="component-core-software-license"></a>Questo componente è rilasciato in base al [ Greengrass Core Software License Agreement](https://greengrass-release-license.s3.us-west-2.amazonaws.com/greengrass-license-v1.pdf).

## Changelog
<a name="iotsitewise-opcua-collector-component-changelog"></a>

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


|  **Versione**  |  **Modifiche**  | 
| --- | --- | 
| 3.1.0 | **Nuove funzionalità**<br />   Aggiunge la configurabilità del processo di individuazione dei nodi per ogni origine dati.   Aggiunge la configurabilità del trigger di modifica dei dati predefinito per ciascuna origine dati.   <br />**Correzioni di bug e miglioramenti**<br />   Risolve le vulnerabilità di sicurezza.     | 
| 3.0.3 | **Correzioni di bug e miglioramenti**<br />   Risolve un problema che causava il troncamento e l'errore di sincronizzazione dei file durante la sincronizzazione di configurazioni di grandi dimensioni.   Risolve un problema che causava ritardi nel processo di avvio dovuti alla latenza dell'abbonamento. AWS IoT Core    Risolve un problema che provocava il rilevamento completo in caso di disconnessioni momentanee dai server OPC UA.     | 
| 3.0.2 | **Correzioni di bug e miglioramenti**<br />   Corregge la `OpcUaCollector.IncomingValuesCount` metrica per includere con precisione i punti delle istantanee nei calcoli.     | 
| 3.0.1 | **Correzioni di bug e miglioramenti**<br />   Risolve le vulnerabilità di sicurezza.   Risolve un problema con la gestione dei timestamp OPC UA. Aggiunge una selezione di timestamp preferiti e migliora la logica di fallback quando i timestamp preferiti non sono disponibili.   Risolve un problema a causa del quale le configurazioni dei collettori OPC UA di Classic Streams e gateway V2 non vengono impostate automaticamente su Stream Manager quando non viene specificata alcuna destinazione.     | 
| 3.0.0 | **Nuove funzionalità**<br /> È stato aggiunto il supporto per i gateway V3 MQTT-enabled, oltre agli stream classici, per i gateway V2 (precedentemente noti come gateway Edge self-hosted). SiteWise Per ulteriori informazioni, consulta Gateway V3 per Edge. [ MQTT-enabled AWS IoT SiteWise](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/mqtt-enabled-v3-gateway.html)   Consente la pubblicazione dei dati OPC UA sul broker AWS IoT Greengrass MQTT 5 (EMQX).   <br />**Correzioni di bug e miglioramenti**<br />   Risolve le vulnerabilità di sicurezza.     | 
| 2.6.0 | **Nuove funzionalità**<br />   È 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 ](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeStorageConfiguration.html) [ PutStorageConfiguration ](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_PutStorageConfiguration.html)     | 
| 2.5.1 | **Correzioni di bug e miglioramenti**<br />   Risolve un bug a causa del quale le future attività di snapshot vengono annullate se si verifica un errore durante l'esecuzione di un'operazione di snapshot.   Risolve un bug per cui gli aggiornamenti della configurazione dell'origine dati persistono solo dopo il riavvio di OPC UA Collector, in caso di interruzione della connessione al server OPC UA dell'origine dati.     | 
| 2.5.0 | **Nuove funzionalità**<br />   Aggiunge un'opzione di origine dati per convertire semplici matrici e valori in stringhe. DateTime    Aggiunge un'opzione di gruppo di proprietà per selezionare un timestamp di origine o del server durante la raccolta di dati da un server OPC UA.   <br />**Correzioni di bug e miglioramenti**<br />   Reimposta la configurazione di polling predefinita per utilizzare il timestamp di origine.     | 
| 2.4.2 | **Correzioni di bug e miglioramenti**<br />   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**<br />   Risolve i problemi relativi al supporto dei proxy.   Risolve il problema a causa del quale la pulizia del thread non riusciva e causava il blocco dei dati.    | 
| 2.4.0 | **Nuove funzionalità**<br />   Aggiunge un registro degli eventi per facilitare l'identificazione e la risoluzione dei problemi.   <br />**Correzioni di bug e miglioramenti**<br />   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à**<br />   Aggiunge il supporto per la configurazione del proxy HTTP Greengrass [ nucleus su Linux. ](https://docs.aws.amazon.com/greengrass/v2/developerguide/configure-greengrass-core-v2.html#configure-alpn-network-proxy)   <br />**Correzioni di bug e miglioramenti**<br />   Risolve un problema di sicurezza () [ CVE-2019-19135](https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2019-19135).    | 
| 2.2.0 |  **Nuove funzionalità**<br />   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      **Correzioni di bug e miglioramenti**<br />   Migliora la registrazione delle metriche nel processo di individuazione 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à**<br />   Aggiunge il supporto per Windows Server 2019 o versioni successive.    **Correzioni di bug e miglioramenti**<br />   Migliora i messaggi di errore quando si distribuisce questo componente su dispositivi non supportati.     | 
| 2.1.1 |  **Nuove funzionalità**<br />   Aggiunge il supporto per la configurazione delle seguenti proprietà dell'abbonamento:   [DataChangeTrigger](https://reference.opcfoundation.org/v104/Core/docs/Part4/7.17.2/)‐ È possibile definire la condizione che avvia un avviso di modifica dei dati.   [QueueSize](https://reference.opcfoundation.org/v104/Core/docs/Part4/7.16/)‐ La profondità della coda su un server OPC‐UA per una particolare metrica in cui sono in coda le notifiche per gli elementi monitorati.   [PublishingIntervalMilliseconds](https://reference.opcfoundation.org/v104/Core/docs/Part4/5.13.2/)‐ 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'inserimento di dati di `BAD` qualità e filtra i dati in base alle seguenti qualità dei dati:    `UNCERTAIN`dati di qualità   `BAD`dati di qualità     <br />**Correzioni di bug e miglioramenti**<br />   Miglioramenti alle metriche relative ai clienti.   Risolve la codifica di sicurezza che a volte causava problemi durante la connessione a server con la crittografia abilitata.   Risolve un problema a causa del quale il gruppo di proprietà non veniva aggiornato.     | 
| 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
<a name="iotsitewise-opcua-collector-component-see-also"></a>
+ [Che cos'è? AWS IoT SiteWise](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/what-is-sitewise.html)nella Guida *AWS IoT SiteWise per l'utente*.