IoT SiteWise -OPC-UA-Kollektor - AWS IoT Greengrass
VersionenTypBetriebssystemVoraussetzungenAbhängigkeitenKonfigurationEingabedatenAusgabedatenLokale ProtokolldateiFehlerbehebung und DebuggingLizenzenÄnderungsprotokollWeitere Informationen finden Sie auch unter

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.

IoT SiteWise -OPC-UA-Kollektor

Die IoT SiteWise -OPC-UA-Kollektorkomponente (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 unter Verwenden von AWS IoT SiteWise am Edge im AWS IoT SiteWise -Benutzerhandbuch.

Versionen

Diese Komponente hat die folgenden Versionen:

  • 2.4.x

  • 2.3.x

  • 2.2.x

  • 2.1.x

  • 2.0.x

Typ

Diese Komponente ist eine generische Komponente (aws.greengrass.generic). Der Greengrass-Kern führt die Lebenszyklusskripte der Komponente aus.

Weitere Informationen finden Sie unter Komponententypen.

Betriebssystem

Diese Komponente kann auf -Core-Geräten installiert werden, auf denen die folgenden Betriebssysteme ausgeführt werden:

  • Linux

  • Windows

Voraussetzungen

Für diese Komponente gelten die folgenden Anforderungen:

  • Das Greengrass-Core-Gerät muss auf einer der folgenden Plattformen ausgeführt werden:

    • Betriebssystem: Ubuntu 18.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 zulassen.

Abhängigkeiten

Wenn Sie eine Komponente bereitstellen, stellt AWS IoT Greengrass auch kompatible Versionen ihrer Abhängigkeiten bereit. 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 dieser Komponente und die semantischen Versionseinschränkungen aufgeführt, die die Komponentenversionen für jede Abhängigkeit definieren. Sie können auch die Abhängigkeiten für jede Version der Komponente in der AWS IoT Greengrass Konsole anzeigen. Suchen Sie auf der Seite mit den Komponentendetails nach der Liste Abhängigkeiten.

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

-Abhängigkeit Kompatible Versionen Abhängigkeitstyp
Greengrass-Kern >=2.3.0 <3.0.0 Hart
Stream-Manager >2.0.10<3.0.0 Hart
Geheimer Manager >=2.0.8 <3.0.0 Hart

Weitere Informationen zu Komponentenabhängigkeiten finden Sie in der Referenz zum Komponentenrezept .

Konfiguration

Diese Komponente hat keine Konfigurationsparameter.

Sie können die AWS IoT SiteWise Konsole oder API verwenden, um die IoT SiteWise -OPC-UA-Kollektorkomponente zu konfigurieren. Weitere Informationen finden Sie unter Schritt 4: Hinzufügen von Datenquellen – optional im AWS IoT SiteWise -Benutzerhandbuch.

Eingabedaten

Diese Komponente akzeptiert nur Daten in den folgenden Formaten, alle anderen werden ignoriert und verworfen. Die folgende Tabelle ordnet die OPC-UA-Datentypen ihrem SiteWise Äquivalent zu.

SiteWise Datentyp

OPC-UA-Datentyp

Beschreibung

STRING

String

Guid

XmlElement

Eine Zeichenfolge mit einer maximalen Länge von 1024 Byte.

INTEGER

SByte

Byte

Int16

UInt16

Int32

UInt32*

Int64*

Eine signierte 32-Bit-Ganzzahl mit einem Bereich von -2,147,483,648 to 2,147,483,647 .

DOUBLE

UInt32*

Int64*

Float

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 lautet der SiteWise Datentyp Int64, INTEGER wenn seinen Wert darstellen SiteWise kann, andernfalls ist er DOUBLE.

Ausgabedaten

Diese Komponente schreibt BatchPutAssetPropertyValue Nachrichten in den AWS IoT Greengrass Stream-Manager. Weitere Informationen finden Sie unter BatchPutAssetPropertyValue in der AWS IoT SiteWise -API-Referenz.

Lokale Protokolldatei

Diese Komponente verwendet die folgende Protokolldatei.

Linux
/greengrass/v2/logs/aws.iot.SiteWiseEdgeCollectorOpcua.log
Windows
C:\greengrass\v2\logs\aws.iot.SiteWiseEdgeCollectorOpcua.log
So zeigen Sie die Protokolle dieser Komponente an

  • Führen Sie den folgenden Befehl auf dem Core-Gerä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

Fehlerbehebung und Debugging

Diese Komponente enthält ein neues Ereignisprotokoll, das Kunden hilft, Probleme zu identifizieren und zu beheben. Die Protokolldatei ist von der lokalen Protokolldatei getrennt und befindet sich am folgenden Speicherort. Ersetzen Sie /greengrass/v2 oder C:\greengrass\v2 durch den Pfad zum AWS IoT Greengrass Stammordner.

Linux
/greengrass/v2/work/aws.iot.SiteWiseEdgeCollectorOpcua/logs/IotSiteWiseOpcUaCollectorEvents.log
Windows
C:\greengrass\v2\work\aws.iot.SiteWiseEdgeCollectorOpcua\logs\IotSiteWiseOpcUaCollectorEvents.log

Dieses Protokoll enthält detaillierte Informationen und Anweisungen zur Fehlerbehebung. Informationen zur Fehlerbehebung werden zusammen mit der Diagnose bereitgestellt, mit einer Beschreibung, wie das Problem behoben werden kann, und manchmal mit Links zu weiteren Informationen. Zu den Diagnoseinformationen gehören:

  • Schweregrad

  • Zeitstempel

  • Zusätzliche ereignisspezifische Informationen

Beispielprotokoll
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"'

Lizenzen

Diese Komponente wird gemäß dem Greengrass Core Software License Agreement veröffentlicht.

Änderungsprotokoll

In der folgenden Tabelle werden die Änderungen in jeder Version der Komponente beschrieben.

Version

Änderungen

2.4.2
Fehlerbehebungen und Verbesserungen

  • Behebt Probleme bei der Erkennung des OPC-UA-Servers, bei denen ein Knoten mehrmals 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

  • Behebt Probleme im Zusammenhang mit der Proxy-Unterstützung.

  • Behebt ein Problem, bei dem die Thread-Bereinigung fehlgeschlagen ist und eine Datenblockierung verursacht hat.

2.4.0
Neue Features

  • Fügt ein Ereignisprotokoll hinzu, um das Identifizieren und Beheben von Problemen zu erleichtern.

Fehlerbehebungen und Verbesserungen

  • Behebt ein Problem mit dem OPC-UA-Client, das beim Herstellen einer Verbindung mit einem OPC-UA-Server, der Version 1.05 der OPC-UA-Spezifikation verwendet, Zertifikatsfehler verursacht hat.

2.3.0
Neue Features

  • Fügt Unterstützung für die Greengrass-Kern-HTTP-Proxy-Konfiguration unter Linux hinzu.

Fehlerbehebungen und Verbesserungen

2.2.0
Neue Features

  • 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

  • Verbessert die Protokollierung von Metriken im Knotenerkennungsprozess.

  • Verbessert den Umgang mit nicht unterstützten Datentypen.

  • Verbessert die Protokollierung von Datenstromfehlern.

2.1.3
Neue Features

  • Fügt Unterstützung für Windows Server 2019 oder höher hinzu.

Fehlerbehebungen und Verbesserungen

  • Verbessert Fehlermeldungen, wenn Sie diese Komponente auf nicht unterstützten Geräten bereitstellen.

2.1.1
Neue Features

  • Fügt Unterstützung für die Konfiguration der folgenden Abonnementeigenschaften hinzu:

    • DataChangeTrigger – Sie können die Bedingung definieren, die eine Warnung über Datenänderungen auslöst.

    • QueueSize – Die Tiefe der Warteschlange auf einem OPC-UA-Server für eine bestimmte Metrik, bei der Benachrichtigungen für überwachte Elemente in die Warteschlange gestellt werden.

    • PublishingIntervalMilliseconds – Das Intervall (in Millisekunden) eines Veröffentlichungszyklus, das bei der Erstellung eines Abonnements angegeben wird.

    • SnapshotFrequencyMilliseconds – Sie können die Einstellung für das Snapshot-Frequenz-Timeout konfigurieren, um sicherzustellen, dass AWS IoT SiteWise Edge einen konstanten Datenstrom aufnimmt.

  • Diese Version unterstützt die Aufnahme von BAD Qualitätsdaten und filtert Daten basierend auf den folgenden Datenqualitäten:

    • UNCERTAIN Qualitätsdaten

    • BAD Qualitätsdaten

Fehlerbehebungen und Verbesserungen

  • Verbesserungen der Kundenmetriken.

  • Behebt die Sicherheitskodierung, die manchmal Probleme verursachte, wenn eine Verbindung zu Servern mit aktivierter Verschlüsselung hergestellt wurde.

  • Behebt ein Problem, bei dem die Eigenschaftsgruppe nicht aktualisiert werden konnte.

2.0.3

Fehlerbehebungen und Verbesserungen.

2.0.2

Fehlerbehebungen und Verbesserungen der Synchronisierung von Komponentenprioritäten mit Edge.

2.0.1

Erste Version

Weitere Informationen finden Sie auch unter