

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

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

Die SiteWise IoT-OPC-UA-Collector-Komponente (`aws.iot.SiteWiseEdgeCollectorOpcua`) ermöglicht es AWS IoT SiteWise Gateways, Daten von lokalen OPC-UA-Servern zu sammeln.

Mit dieser Komponente können AWS IoT SiteWise Gateways eine Verbindung zu mehreren OPC-UA-Servern herstellen. Weitere Informationen zu AWS IoT SiteWise Gateways finden Sie [ im Benutzerhandbuch ](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/gateways-ggv2.html) unter AWS IoT SiteWise Using at the Edge. *AWS IoT SiteWise *

**Topics**
+ [Versionen](#iotsitewise-opcua-collector-component-versions)
+ [Typ](#iotsitewise-opcua-collector-component-type)
+ [Betriebssystem](#iotsitewise-opcua-collector-component-os-support)
+ [Voraussetzungen](#iotsitewise-opcua-collector-component-requirements)
+ [Abhängigkeiten](#iotsitewise-opcua-collector-component-dependencies)
+ [Konfiguration](#iotsitewise-opcua-collector-component-configuration)
+ [Eingabedaten](#iotsitewise-opcua-collector-component-input-data)
+ [Ausgabedaten](#iotsitewise-opcua-collector-component-output-data)
+ [Lokale Protokolldatei](#iotsitewise-opcua-collector-component-log-file)
+ [Lizenzen](#iotsitewise-opcua-collector-component-licenses)
+ [Änderungsprotokoll](#iotsitewise-opcua-collector-component-changelog)
+ [Weitere Informationen finden Sie auch unter](#iotsitewise-opcua-collector-component-see-also)

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

Diese Komponente hat die folgenden Versionen:
+ 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

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

<a name="public-component-type-generic"></a>Diese <a name="public-component-type-generic-phrase"></a> Komponente ist eine generische Komponente (`aws.greengrass.generic`). Der [ Greengrass-Kern ](greengrass-nucleus-component.md) führt die Lifecycle-Skripte der Komponente aus. 

<a name="public-component-type-more-information"></a>Weitere Informationen finden Sie unter [Komponententypen](develop-greengrass-components.md#component-types).

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

Diese Komponente kann auf Kerngeräten installiert werden, auf denen die folgenden Betriebssysteme ausgeführt werden:
+ Linux
+ Windows

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

Für diese Komponente gelten die folgenden Anforderungen:
+ Das Greengrass-Core-Gerät muss auf einer der folgenden Plattformen laufen:
  + Betriebssystem: Ubuntu 20.04 oder höher

    Architektur: x86\_64 (AMD64) oder ARMv8 (Aarch64)
  + Betriebssystem: Red Hat Enterprise Linux (RHEL) 8

    Architektur: x86\_64 (AMD64) oder ARMv8 (Aarch64)
  + Betriebssystem: Amazon Linux 2

    Architektur: x86\_64 (AMD64) oder ARMv8 (Aarch64)
  + Betriebssystem: Debian 11

    Architektur: x86\_64 (AMD64) oder ARMv8 (Aarch64)
  + Betriebssystem: Windows Server 2019 oder höher

    Architektur: x86\_64 (AMD64)
+ Das Greengrass-Core-Gerät muss ausgehende Netzwerkkonnektivität zu OPC-UA-Servern ermöglichen.

## Abhängigkeiten
<a name="iotsitewise-opcua-collector-component-dependencies"></a>

Wenn Sie eine Komponente bereitstellen, werden AWS IoT Greengrass auch kompatible Versionen ihrer Abhängigkeiten bereitgestellt. Das bedeutet, dass Sie die Anforderungen für die Komponente und alle ihre Abhängigkeiten erfüllen müssen, um die Komponente erfolgreich bereitzustellen. In diesem Abschnitt werden die Abhängigkeiten für die [ veröffentlichten Versionen ](#iotsitewise-opcua-collector-component-changelog) dieser Komponente sowie die semantischen Versionseinschränkungen aufgeführt, die die Komponentenversionen für jede Abhängigkeit definieren. Sie können die Abhängigkeiten für jede Version der Komponente auch in der [AWS IoT Greengrass Konsole ](https://console.aws.amazon.com/greengrass) anzeigen. Suchen Sie auf der Seite mit den Komponentendetails nach der ** Liste der ** Abhängigkeiten.

In der folgenden Tabelle sind die Abhängigkeiten für alle Versionen dieser Komponente aufgeführt.


| -Abhängigkeit | Kompatible Versionen | Typ der Abhängigkeit | 
| --- | --- | --- | 
| [Nukleus von Greengrass ](greengrass-nucleus-component.md) | > =2,3,0 <3,0,0 | Hart | 
| [Stream-Manager](stream-manager-component.md) | =2,3,0 2.0.10<3.0.0 | Hart | 
| [Geheimer Manager](secret-manager-component.md) | 20,10 =2,0,8 <3,0,0 | Hart | 

Weitere Informationen zu Komponentenabhängigkeiten finden Sie in der [ Komponentenrezeptreferenz. ](component-recipe-reference.md#recipe-reference-component-dependencies)

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

Diese Komponente hat keine Konfigurationsparameter.

Sie können die AWS IoT SiteWise Konsole oder die API verwenden, um die IoT SiteWise OPC UA Collector-Komponente zu konfigurieren. Weitere Informationen finden Sie unter [ Schritt 4: Datenquellen hinzufügen — optional ](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/create-gateway-ggv2.html#add-data-sources-console) im *AWS IoT SiteWise Benutzerhandbuch*.

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

Diese Komponente akzeptiert nur Daten in den folgenden Formaten, alle anderen werden ignoriert und verworfen. In der folgenden Tabelle werden die OPC UA-Datentypen ihren entsprechenden Datentypen zugeordnet. SiteWise 


|  **SiteWise Datentyp **  |  **OPC UA-Datentyp **  |  **Beschreibung**  | 
| --- | --- | --- | 
| `STRING` | `String`<br />`Guid`<br />`XmlElement` | Eine Zeichenfolge mit einer maximalen Länge von 1024 Byte. | 
| `INTEGER` | `SByte`<br />`Byte`<br />`Int16`<br />`UInt16`<br />`Int32`<br />`UInt32`\*<br />`Int64`\* | Eine 32-Bit-Ganzzahl mit Vorzeichen und einem Bereich von`-2,147,483,648 to 2,147,483,647`. | 
| `DOUBLE` | `UInt32`\*<br />`Int64`\*<br />`Float`<br />`Double` | Eine Gleitkommazahl mit einem Bereich von `–10^100 to 10^100` und `IEEE 754` doppelter Genauigkeit. | 
| `BOOLEAN` | `Boolean` | `true` oder `false`. | 

\* Für OPC UA-Datentypen `UInt32` und SiteWise gilt der SiteWise Datentyp`Int64`, `INTEGER` wenn er seinen Wert darstellen kann, andernfalls. `DOUBLE`

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



Diese Komponente schreibt `BatchPutAssetPropertyValue` Nachrichten in den AWS IoT Greengrass Stream-Manager. Weitere Informationen finden Sie unter [BatchPutAssetPropertyValue](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchPutAssetPropertyValue.html) in der *AWS IoT SiteWise -API-Referenz*.

## Lokale Protokolldatei
<a name="iotsitewise-opcua-collector-component-log-file"></a>

Diese Komponente verwendet die folgende Protokolldatei.

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

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

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

```
{{C:\greengrass\v2}}\logs\aws.iot.SiteWiseEdgeCollectorOpcua.log
```

------

**Um die Protokolle dieser Komponente einzusehen**
+ Führen Sie den folgenden Befehl auf dem Kerngerät aus, um die Protokolldatei dieser Komponente in Echtzeit anzuzeigen. Ersetzen Sie `{{/greengrass/v2}}` oder {{C:\\greengrass\\v2}} durch den Pfad zum AWS IoT Greengrass Stammordner.

------
#### [ 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
  ```

------

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

<a name="component-core-software-license"></a>Diese Komponente wird im Rahmen der [ Greengrass Core-Softwarelizenzvereinbarung ](https://greengrass-release-license.s3.us-west-2.amazonaws.com/greengrass-license-v1.pdf) veröffentlicht.

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

In der folgenden Tabelle werden die Änderungen in den einzelnen Versionen der Komponente beschrieben.


|  **Version**  |  **Änderungen**  | 
| --- | --- | 
| 3.1.0 | **Neue Features**<br />   Fügt die Konfigurierbarkeit des Knotenerkennungsprozesses für jede Datenquelle hinzu.   Fügt die Konfigurierbarkeit des Standard-Datenänderungs-Triggers für jede Datenquelle hinzu.   <br />**Fehlerbehebungen und Verbesserungen**<br />   Behebt Sicherheitslücken.     | 
| 3.0.3 | **Fehlerbehebungen und Verbesserungen**<br />   Behebt ein Problem, das beim Synchronisieren großer Konfigurationen zum Abschneiden und Synchronisieren von Dateien führte.   Behebt ein Problem, das aufgrund der AWS IoT Core Abonnementlatenz zu Verzögerungen beim Startvorgang führte.   Behebt ein Problem, das bei kurzzeitigen Verbindungsabbrüchen von OPC UA-Servern eine vollständige Erkennung auslöste.     | 
| 3.0.2 | **Fehlerbehebungen und Verbesserungen**<br />   Korrigiert die `OpcUaCollector.IncomingValuesCount` Metrik, sodass Snapshot-Punkte korrekt in Berechnungen einbezogen werden.     | 
| 3.0.1 | **Fehlerbehebungen und Verbesserungen**<br />   Behebt Sicherheitslücken.   Behebt ein Problem mit der Verarbeitung von OPC UA-Zeitstempeln. Fügt eine bevorzugte Zeitstempelauswahl hinzu und verbessert die Fallback-Logik, wenn die bevorzugten Zeitstempel nicht verfügbar sind.   Behebt ein Problem, bei dem OPC UA-Collector-Konfigurationen für klassische Streams und V2-Gateway nicht standardmäßig auf Stream Manager eingestellt werden, wenn kein Ziel angegeben wurde.     | 
| 3.0.0 | **Neue Features**<br /> Unterstützung für MQTT-enabled V3-Gateways wurde zusätzlich zu den klassischen Streams und V2-Gateways (früher bekannt als selbst gehostete SiteWise Edge-Gateways) hinzugefügt. Weitere Informationen finden Sie unter V3-Gateways für [ MQTT-enabled Edge. AWS IoT SiteWise](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/mqtt-enabled-v3-gateway.html)   Ermöglicht die Veröffentlichung von OPC UA-Daten auf dem AWS IoT Greengrass MQTT 5-Broker (EMQX).   <br />**Fehlerbehebungen und Verbesserungen**<br />   Behebt Sicherheitslücken.     | 
| 2.6.0 | **Neue Features**<br />   Unterstützung für die Aufnahme von Null- und NaN-Werten hinzugefügt, wenn die Aufnahme aktiviert ist. AWS IoT SiteWise Informationen zum Anzeigen oder Ändern der Null- und NaN-Konfiguration finden Sie in den AWS IoT SiteWise APIs und. [ 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 | **Fehlerbehebungen und Verbesserungen**<br />   Behebt einen Fehler, bei dem zukünftige Snapshot-Aufgaben abgebrochen werden, wenn während der Ausführung einer Snapshot-Aufgabe ein Fehler auftritt.   Behebt einen Fehler, bei dem Aktualisierungen der Datenquellenkonfiguration erst nach einem Neustart des OPC UA Collectors bestehen bleiben, wenn die Verbindung zum OPC UA-Server der Datenquelle unterbrochen wird.     | 
| 2.5.0 | **Neue Features**<br />   Fügt eine Datenquellenoption hinzu, um einfache Arrays und Werte in Zeichenketten zu konvertieren. DateTime    Fügt eine Eigenschaftsgruppenoption hinzu, mit der entweder ein Quell- oder ein Serverzeitstempel ausgewählt werden kann, wenn Daten von einem OPC UA-Server erfasst werden.   <br />**Fehlerbehebungen und Verbesserungen**<br />   Setzt die Standard-Polling-Konfiguration zurück, um den Quellzeitstempel zu verwenden.     | 
| 2.4.2 | **Fehlerbehebungen und Verbesserungen**<br />   Behebt Probleme bei der OPC UA-Servererkennung, bei denen ein Knoten mehrfach erkannt werden kann.   Korrigiert die Snapshot-Funktion, um sicherzustellen, dass der Zeitstempel für jeden Snapshot-Datenpunkt neu ist.    | 
| 2.4.1 | **Fehlerbehebungen und Verbesserungen**<br />   Behebt Probleme im Zusammenhang mit der Proxyunterstützung.   Behebt ein Problem, bei dem die Thread-Bereinigung fehlschlug und eine Datenblockierung verursachte.    | 
| 2.4.0 | **Neue Features**<br />   Fügt ein Ereignisprotokoll hinzu, um die Identifizierung und Behebung von Problemen zu erleichtern.   <br />**Fehlerbehebungen und Verbesserungen**<br />   Behebt ein Problem mit dem OPC UA-Client, das Zertifikatsfehler verursachte, wenn eine Verbindung zu einem OPC UA-Server hergestellt wurde, der Version 1.05 der OPC UA-Spezifikation verwendet.     | 
| 2.3.0 | **Neue Features**<br />   Fügt Unterstützung für die Greengrass Nucleus [ HTTP-Proxykonfiguration unter Linux hinzu. ](https://docs.aws.amazon.com/greengrass/v2/developerguide/configure-greengrass-core-v2.html#configure-alpn-network-proxy)   <br />**Fehlerbehebungen und Verbesserungen**<br />   Behebt ein Sicherheitsproblem ([CVE-2019-19135](https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2019-19135)).    | 
| 2.2.0 |  **Neue Features**<br />   Fügt Unterstützung für die Installation von Data Collection Pack auf der Linux ARMv8-Architektur hinzu.   Mindestanforderungen für Linux ARMv8:   Arbeitsspeicher: 4 GB   CPU: ARM Cortex-A72 oder gleichwertige Spezifikation      **Fehlerbehebungen und Verbesserungen**<br />   Verbessert die Protokollierung von Metriken im Node-Discovery-Prozess.   Verbessert den Umgang mit nicht unterstützten Datentypen.   Verbessert die Protokollierung von Datenstromfehlern.     | 
| 2.1.3 |  **Neue Features**<br />   Fügt Unterstützung für Windows Server 2019 oder höher hinzu.    **Fehlerbehebungen und Verbesserungen**<br />   Verbessert Fehlermeldungen, wenn Sie diese Komponente auf nicht unterstützten Geräten bereitstellen.     | 
| 2.1.1 |  **Neue Features**<br />   Fügt Unterstützung für die Konfiguration der folgenden Abonnementeigenschaften hinzu:   [DataChangeTrigger](https://reference.opcfoundation.org/v104/Core/docs/Part4/7.17.2/)‐ Sie können die Bedingung definieren, die eine Datenänderungswarnung auslöst.   [QueueSize](https://reference.opcfoundation.org/v104/Core/docs/Part4/7.16/)‐ Die Tiefe der Warteschlange auf einem OPC-UA-Server für eine bestimmte Metrik, in der Benachrichtigungen für überwachte Elemente in die Warteschlange gestellt werden.   [PublishingIntervalMilliseconds](https://reference.opcfoundation.org/v104/Core/docs/Part4/5.13.2/)‐ Das Intervall (in Millisekunden) eines Veröffentlichungszyklus, das bei der Erstellung eines Abonnements angegeben wird.   SnapshotFrequencyMilliseconds ‐ Sie können die Timeout-Einstellung für die Snapshot-Frequenz konfigurieren, um sicherzustellen, dass AWS IoT SiteWise Edge einen stetigen Datenstrom aufnimmt.      Diese Version unterstützt die Aufnahme von `BAD` Qualitätsdaten und filtert Daten auf der Grundlage der folgenden Datenqualitäten:    `UNCERTAIN`Qualitätsdaten   `BAD`Qualitätsdaten     <br />**Fehlerbehebungen und Verbesserungen**<br />   Verbesserungen der Kundenkennzahlen.   Korrigiert die Sicherheitskodierung, die manchmal zu Problemen bei der Verbindung zu Servern mit aktivierter Verschlüsselung führte.   Behebt ein Problem, bei dem die Eigenschaftsgruppe nicht aktualisiert werden konnte.     | 
| 2.0.3 | Fehlerbehebungen und Verbesserungen. | 
| 2.0.2 | Fehlerbehebungen und Verbesserungen bei der Synchronisierung der Asset-Prioritäten mit Edge. | 
| 2.0.1 | Erste Version | 

## Weitere Informationen finden Sie auch unter
<a name="iotsitewise-opcua-collector-component-see-also"></a>
+ [Was ist AWS IoT SiteWise? ](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/what-is-sitewise.html)im *AWS IoT SiteWise Benutzerhandbuch*.