IoT SiteWise -Konnektor - AWS IoT Greengrass
VoraussetzungenParameterEingabedatenAusgabedatenEinschränkungenLizenzenÄnderungsprotokollWeitere Informationen finden Sie auch unter

AWS IoT Greengrass Version 1 trat am 30. Juni 2023 in die erweiterte Lebensphase ein. Weitere Informationen finden Sie in der AWS IoT Greengrass V1 Wartungsrichtlinie. Nach diesem Datum AWS IoT Greengrass V1 werden keine Updates mehr veröffentlicht, die Funktionen, Verbesserungen, Bugfixes oder Sicherheitspatches bieten. Geräte, die auf laufen, werden AWS IoT Greengrass V1 nicht gestört und funktionieren weiterhin und stellen eine Verbindung zur Cloud her. Wir empfehlen Ihnen dringend, zu migrieren AWS IoT Greengrass Version 2, da dies wichtige neue Funktionen und Unterstützung für zusätzliche Plattformen bietet.

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 -Konnektor

Der IoT SiteWise -Konnektor sendet lokale Geräte- und Gerätedaten an Komponenteneigenschaften in AWS IoT SiteWise. Sie können diesen Konnektor verwenden, um Daten von mehreren OPC-UA-Servern zu sammeln und sie in IoT SiteWise zu veröffentlichen. Der Konnektor sendet die Daten an Komponenteneigenschaften im aktuellen AWS-Konto und in der Region.

Anmerkung

IoT SiteWise ist ein vollständig verwalteter Service, der Daten von Industriegeräten und Geräten sammelt, verarbeitet und visualisiert. Sie können Komponenteneigenschaften konfigurieren, die Rohdaten verarbeiten, die von diesem Konnektor an die Messeigenschaften Ihrer Komponenten gesendet werden. Sie können beispielsweise eine Transformationseigenschaft definieren, die die Celsius-Temperaturdatenpunkte eines Geräts in Fahrenheit konvertiert. Sie können auch eine Metrikeigenschaft definieren, die die durchschnittliche stündliche Temperatur berechnet. Weitere Informationen finden Sie unter Was ist AWS IoT SiteWise? im AWS IoT SiteWise-Benutzerhandbuch.

Der Konnektor sendet Daten an IoT SiteWise mit den OPC-UA-Datenstrompfaden, die von den OPC-UA-Servern gesendet werden. Beispielsweise könnte der Datenstream-Pfad /company/windfarm/3/turbine/7/temperature den Temperatursensor der Turbine #7 im Windpark #3 darstellen. Wenn der AWS IoT Greengrass Kern die Verbindung zum Internet verliert, speichert der Konnektor Daten zwischen, bis er erfolgreich eine Verbindung zum herstellen kannAWS Cloud. Sie können die maximale Datenträgerpuffergröße konfigurieren, die zum Zwischenspeichern von Daten verwendet wird. Wenn die Cachegröße die maximale Datenträgerpuffergröße überschreitet, verwirft der Konnektor die ältesten Daten aus der Warteschlange.

Nachdem Sie den IoT SiteWise -Konnektor konfiguriert und bereitgestellt haben, können Sie ein Gateway und OPC-UA-Quellen in der IoT SiteWise -Konsole hinzufügen. Wenn Sie eine Quelle in der Konsole konfigurieren, können Sie die vom IoT SiteWise -Konnektor gesendeten OPC-UA-Datenstrompfade filtern oder ihr ein Präfix voranstellen. Anweisungen zum Abschluss der Einrichtung des Gateways und der Quellen finden Sie unter Hinzufügen des Gateways im AWS IoT SiteWise-Benutzerhandbuch.

IoT SiteWise empfängt Daten nur aus Datenströmen, die Sie den Messungseigenschaften von IoT SiteWise -Komponenten zugeordnet haben. Um Datenstreams Objekteigenschaften zuzuordnen, können Sie den Alias einer Eigenschaft so einstellen, dass er einem OPC-UA-Datenstream-Pfad entspricht. Weitere Informationen zum Definieren von Komponentenmodellen und zum Erstellen von Komponenten finden Sie unter Modellieren von industriellen Komponenten im AWS IoT SiteWise-Benutzerhandbuch.

Hinweise

Sie können den Stream-Manager verwenden, um Daten aus anderen Quellen als OPC-UA-Servern in IoT SiteWise hochzuladen. Stream Manager bietet auch anpassbare Unterstützung für Persistenz und Bandbreitenmanagement. Weitere Informationen finden Sie unter Verwalten von Daten-Streams auf dem AWS IoT Greengrass Core.

Dieser Konnektor wird im Modus Keine Containerisolierung ausgeführt, sodass Sie ihn in einer Greengrass-Gruppe bereitstellen können, die in einem Docker-Container ausgeführt wird.

Dieser Konnektor hat die folgenden Versionen.

Version

ARN

12 (empfohlen)

arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/12

11

arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/11

10

arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/10

9

arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/9

8

arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/8

7

arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/7

6

arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/6

5

arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/5

4

arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/4

3

arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/3

2

arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/2

1

arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/1

Informationen über Versionsänderungen finden Sie im Änderungsprotokoll.

Voraussetzungen

Dieser Konnektor hat die folgenden Anforderungen:

Version 9, 10, 11, and 12
Wichtig

Diese Version führt neue Anforderungen ein: AWS IoT Greengrass Core-Software v1.10.2 und Stream Manager .

  • AWS IoT Greengrass Core-Software v1.10.2.

  • Stream-Manager muss für die Greengrass-Gruppe aktiviert sein.

  • Java 8 auf dem Core-Gerät installiert und der Umgebungsvariablen PATH hinzugefügt.

  • Dieser Konnektor kann nur in Amazon Web Services-Regionen verwendet werden, in denen AWS IoT Greengrass sowohl als auch IoT SiteWise unterstützt werden.

  • Eine IAM-Richtlinie, die der Greengrass-Gruppenrolle hinzugefügt wurde. Diese Rolle ermöglicht der AWS IoT Greengrass-Gruppe den Zugriff auf die iotsitewise:BatchPutAssetPropertyValue-Aktion für die Zielstammkomponente und die untergeordneten Elemente, wie im folgenden Beispiel gezeigt. Sie können die Condition aus der Richtlinie entfernen, um dem Konnektor den Zugriff auf alle Ihre IoT SiteWise -Komponenten zu ermöglichen.

    {
    "Version": "2012-10-17",
    "Statement": [
        {
             "Effect": "Allow",
             "Action": "iotsitewise:BatchPutAssetPropertyValue",
             "Resource": "*",
             "Condition": {
                 "StringLike": {
                     "iotsitewise:assetHierarchyPath": [
                         "/root node asset ID",
                         "/root node asset ID/*"
                     ]
                 }
             }
        }
    ]
}

    Weitere Informationen finden Sie unter Hinzufügen und Entfernen von IAM-Richtlinien im IAM-Benutzerhandbuch.

Versions 6, 7, and 8
Wichtig

Mit dieser Version werden neue Anforderungen eingeführt: AWS IoT Greengrass Core-Software v1.10.0 und Stream-Manager.

  • AWS IoT Greengrass Core-Software v1.10.0.

  • Stream-Manager muss für die Greengrass-Gruppe aktiviert sein.

  • Java 8 auf dem Core-Gerät installiert und der Umgebungsvariablen PATH hinzugefügt.

  • Dieser Konnektor kann nur in Amazon Web Services-Regionen verwendet werden, in denen AWS IoT Greengrass sowohl als auch IoT SiteWise unterstützt werden.

  • Eine IAM-Richtlinie, die der Greengrass-Gruppenrolle hinzugefügt wurde. Diese Rolle ermöglicht der AWS IoT Greengrass-Gruppe den Zugriff auf die iotsitewise:BatchPutAssetPropertyValue-Aktion für die Zielstammkomponente und die untergeordneten Elemente, wie im folgenden Beispiel gezeigt. Sie können die Condition aus der Richtlinie entfernen, um dem Konnektor den Zugriff auf alle Ihre IoT SiteWise -Komponenten zu ermöglichen.

    {
    "Version": "2012-10-17",
    "Statement": [
        {
             "Effect": "Allow",
             "Action": "iotsitewise:BatchPutAssetPropertyValue",
             "Resource": "*",
             "Condition": {
                 "StringLike": {
                     "iotsitewise:assetHierarchyPath": [
                         "/root node asset ID",
                         "/root node asset ID/*"
                     ]
                 }
             }
        }
    ]
}

    Weitere Informationen finden Sie unter Hinzufügen und Entfernen von IAM-Richtlinien im IAM-Benutzerhandbuch.

Version 5

  • AWS IoT Greengrass Core-Software v1.9.4.

  • Java 8 auf dem Core-Gerät installiert und der Umgebungsvariablen PATH hinzugefügt.

  • Dieser Konnektor kann nur in Amazon Web Services-Regionen verwendet werden, in denen AWS IoT Greengrass sowohl als auch IoT SiteWise unterstützt werden.

  • Eine IAM-Richtlinie, die der Greengrass-Gruppenrolle hinzugefügt wurde. Diese Rolle ermöglicht der AWS IoT Greengrass-Gruppe den Zugriff auf die iotsitewise:BatchPutAssetPropertyValue-Aktion für die Zielstammkomponente und die untergeordneten Elemente, wie im folgenden Beispiel gezeigt. Sie können die Condition aus der Richtlinie entfernen, um dem Konnektor den Zugriff auf alle Ihre IoT SiteWise -Komponenten zu ermöglichen.

    {
    "Version": "2012-10-17",
    "Statement": [
        {
             "Effect": "Allow",
             "Action": "iotsitewise:BatchPutAssetPropertyValue",
             "Resource": "*",
             "Condition": {
                 "StringLike": {
                     "iotsitewise:assetHierarchyPath": [
                         "/root node asset ID",
                         "/root node asset ID/*"
                     ]
                 }
             }
        }
    ]
}

    Weitere Informationen finden Sie unter Hinzufügen und Entfernen von IAM-Richtlinien im IAM-Benutzerhandbuch.

Version 4

  • AWS IoT Greengrass Core-Software v1.10.0.

  • Java 8 auf dem Core-Gerät installiert und der Umgebungsvariablen PATH hinzugefügt.

  • Dieser Konnektor kann nur in Amazon Web Services-Regionen verwendet werden, in denen AWS IoT Greengrass sowohl als auch IoT SiteWise unterstützt werden.

  • Eine IAM-Richtlinie, die der Greengrass-Gruppenrolle hinzugefügt wurde. Diese Rolle ermöglicht der AWS IoT Greengrass-Gruppe den Zugriff auf die iotsitewise:BatchPutAssetPropertyValue-Aktion für die Zielstammkomponente und die untergeordneten Elemente, wie im folgenden Beispiel gezeigt. Sie können die Condition aus der Richtlinie entfernen, um dem Konnektor den Zugriff auf alle Ihre IoT SiteWise -Komponenten zu ermöglichen.

    {
    "Version": "2012-10-17",
    "Statement": [
        {
             "Effect": "Allow",
             "Action": "iotsitewise:BatchPutAssetPropertyValue",
             "Resource": "*",
             "Condition": {
                 "StringLike": {
                     "iotsitewise:assetHierarchyPath": [
                         "/root node asset ID",
                         "/root node asset ID/*"
                     ]
                 }
             }
        }
    ]
}

    Weitere Informationen finden Sie unter Hinzufügen und Entfernen von IAM-Richtlinien im IAM-Benutzerhandbuch.

Version 3

  • AWS IoT Greengrass Core-Software v1.9.4.

  • Java 8 auf dem Core-Gerät installiert und der Umgebungsvariablen PATH hinzugefügt.

  • Dieser Konnektor kann nur in Amazon Web Services-Regionen verwendet werden, in denen AWS IoT Greengrass sowohl als auch IoT SiteWise unterstützt werden.

  • Eine IAM-Richtlinie, die der Greengrass-Gruppenrolle hinzugefügt wurde. Diese Rolle ermöglicht der AWS IoT Greengrass-Gruppe den Zugriff auf die iotsitewise:BatchPutAssetPropertyValue-Aktion für die Zielstammkomponente und die untergeordneten Elemente, wie im folgenden Beispiel gezeigt. Sie können die Condition aus der Richtlinie entfernen, um dem Konnektor den Zugriff auf alle Ihre IoT SiteWise -Komponenten zu ermöglichen.

    {
    "Version": "2012-10-17",
    "Statement": [
        {
             "Effect": "Allow",
             "Action": "iotsitewise:BatchPutAssetPropertyValue",
             "Resource": "*",
             "Condition": {
                 "StringLike": {
                     "iotsitewise:assetHierarchyPath": [
                         "/root node asset ID",
                         "/root node asset ID/*"
                     ]
                 }
             }
        }
    ]
}

    Weitere Informationen finden Sie unter Hinzufügen und Entfernen von IAM-Richtlinien im IAM-Benutzerhandbuch.

Versions 1 and 2

  • AWS IoT Greengrass Core-Software v1.9.4.

  • Java 8 auf dem Core-Gerät installiert und der Umgebungsvariablen PATH hinzugefügt.

  • Dieser Konnektor kann nur in Amazon Web Services-Regionen verwendet werden, in denen AWS IoT Greengrass sowohl als auch IoT SiteWise unterstützt werden.

  • Eine IAM-Richtlinie, die der Greengrass-Gruppenrolle hinzugefügt wurde und den Zugriff auf AWS IoT Core und die -iotsitewise:BatchPutAssetPropertyValueAktion für die Ziel-Root-Komponente und ihre untergeordneten Elemente ermöglicht, wie im folgenden Beispiel gezeigt. Sie können die Condition aus der Richtlinie entfernen, um dem Konnektor den Zugriff auf alle Ihre IoT SiteWise -Komponenten zu ermöglichen.

    {
    "Version": "2012-10-17",
    "Statement": [
        {
             "Effect": "Allow",
             "Action": "iotsitewise:BatchPutAssetPropertyValue",
             "Resource": "*",
             "Condition": {
                 "StringLike": {
                     "iotsitewise:assetHierarchyPath": [
                         "/root node asset ID",
                         "/root node asset ID/*"
                     ]
                 }
             }
        },
        {
            "Effect": "Allow",
            "Action": [
                 "iot:Connect",
                 "iot:DescribeEndpoint",
                 "iot:Publish",
                 "iot:Receive",
                 "iot:Subscribe"
            ],
            "Resource": "*"
        }
    ]
}

    Informationen finden Sie im Abschnitt Hinzufügen und Entfernen von IAM-Identitätsberechtigungen im -IAM-Benutzerhandbuch.

Parameter

Versions 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, and 12
SiteWiseLocalStoragePath

Das Verzeichnis auf dem AWS IoT Greengrass Host, in das der IoT SiteWise -Konnektor persistente Daten schreiben kann. Standardeinstellung: /var/sitewise.

Anzeigename in der AWS IoT Konsole: Lokaler Speicherpfad

Erforderlich: false

Typ: string

Gültiges Muster: ^\s*$|\/.

AWSSecretsArnList

Eine Liste von Secrets in AWS Secrets Manager, die jeweils ein OPC-UA-Schlüssel-Wert-Paar aus Benutzername und Passwort enthalten. Alle Secrets müssen vom Typ Schlüssel-Wert-Paar sein.

Anzeigename in der AWS IoT Konsole: Liste der ARNs für Benutzernamen-/Passwortgeheimnisse von OPC-UA

Erforderlich: false

Typ: JsonArrayOfStrings

Gültiges Muster: \[( ?,? ?\"(arn:(aws(-[a-z]+)*):secretsmanager:[a-z0-9\\-]+:[0-9]{12}:secret:([a-zA-Z0-9\\\\]+\/)*[a-zA-Z0-9\/_+=,.@\\-]+-[a-zA-Z0-9]+)*\")*\]

MaximumBufferSize

Die maximale Größe in GB für die IoT SiteWise -Festplattennutzung. Standardmäßig 10 GB.

Anzeigename in der AWS IoT Konsole: Maximale Größe des Festplattenpuffers

Erforderlich: false

Typ: string

Gültiges Muster: ^\s*$|[0-9]+

Version 1
SiteWiseLocalStoragePath

Das Verzeichnis auf dem AWS IoT Greengrass Host, in das der IoT SiteWise -Konnektor persistente Daten schreiben kann. Standardeinstellung: /var/sitewise.

Anzeigename in der AWS IoT Konsole: Lokaler Speicherpfad

Erforderlich: false

Typ: string

Gültiges Muster: ^\s*$|\/.

SiteWiseOpcuaUserIdentityTokenSecretArn

Das Secret in AWS Secrets Manager, das das OPC-UA-Benutzernamen- und Passwort-Schlüssel-Wert-Paar enthält. Dieses Secret muss ein Schlüssel-Wert-Paar-Typ-Secret sein.

Anzeigename in der AWS IoT Konsole: ARN des geheimen OPC-UA-Benutzernamens/Passworts

Erforderlich: false

Typ: string

Gültiges Muster: ^$|arn:(aws(-[a-z]+)*):secretsmanager:[a-z0-9\\-]+:[0-9]{12}:secret:([a-zA-Z0-9\\\\]+/)*[a-zA-Z0-9/_+=,.@\\-]+-[a-zA-Z0-9]+

SiteWiseOpcuaUserIdentityTokenSecretArn-ResourceId

Die geheime Ressource in der AWS IoT Greengrass-Gruppe, die auf ein OPC-UA-Benutzernamen- und Passwort-Secret verweist.

Anzeigename in der AWS IoT Konsole: geheime Ressource für OPC-UA-Benutzername/Passwort

Erforderlich: false

Typ: string

Gültiges Muster: ^$|.+

MaximumBufferSize

Die maximale Größe in GB für die IoT SiteWise -Festplattennutzung. Standardmäßig 10 GB.

Anzeigename in der AWS IoT Konsole: Maximale Größe des Festplattenpuffers

Erforderlich: false

Typ: string

Gültiges Muster: ^\s*$|[0-9]+

Beispiel für das Erstellen eines Konnektors (AWS CLI)

Der folgende AWS CLI Befehl erstellt eine ConnectorDefinition mit einer Anfangsversion, die den IoT SiteWise -Konnektor enthält.

aws greengrass create-connector-definition --name MyGreengrassConnectors --initial-version '{
    "Connectors": [
        {
            "Id": "MyIoTSiteWiseConnector",
            "ConnectorArn": "arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/11"
        }
    ]
}'
Anmerkung

Die Lambda-Funktionen in diesem Konnektor haben einen langlebigen Lebenszyklus.

In der AWS IoT Greengrass -Konsole können Sie einen Connector über die Seite Connectors der Gruppe hinzufügen. Weitere Informationen finden Sie unter Erste Schritte mit Greengrass-Konnektoren (Konsole).

Eingabedaten

Dieser Konnektor akzeptiert keine MQTT-Nachrichten als Eingabedaten.

Ausgabedaten

Dieser Konnektor veröffentlicht keine MQTT-Nachrichten als Ausgabedaten.

Einschränkungen

Dieser Konnektor unterliegt den folgenden Einschränkungen, die von IoT SiteWise auferlegt werden, einschließlich der folgenden. Weitere Formate finden Sie unter -AWS IoT SiteWiseEndpunkte und -Kontingente im Allgemeine AWS-Referenz.

  • Maximale Anzahl von Gateways pro AWS-Konto.

  • Maximale Anzahl von OPC-UA-Quellen pro Gateway.

  • Maximale Rate von timestamp-quality-value (TQV)-Datenpunkten, die pro gespeichert werdenAWS-Konto.

  • Maximale Rate der pro Objekteigenschaft gespeicherten TQV-Datenpunkte.

Lizenzen

Version 9, 10, 11, and 12

Der IoT SiteWise -Konnektor enthält die folgende Software/Lizenzierung von Drittanbietern:

Dieser Konnektor wurde gemäß der Greengrass Core Software License Agreement veröffentlicht.

Versions 6, 7, and 8

Der IoT SiteWise -Konnektor enthält die folgende Software/Lizenzierung von Drittanbietern:

Dieser Konnektor wurde gemäß der Greengrass Core Software License Agreement veröffentlicht.

Versions 1, 2, 3, 4, and 5

Der IoT SiteWise -Konnektor enthält die folgende Software/Lizenzierung von Drittanbietern:

Dieser Konnektor wurde gemäß der Greengrass Core Software License Agreement veröffentlicht.

Änderungsprotokoll

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

Version

Änderungen

Datum

12

  • Diese Version enthält Fehlerbehebungen.

22. Dezember 2021

11

  • Unterstützung für Zeichenfolgen, die versteckte oder nicht darstellbare Zeichen enthalten. Ausgeblendete und nicht darstellbare Zeichen werden automatisch entfernt, bevor die Zeichenfolgen an den gesendet werdenAWS Cloud.

  • Es wurde ein Problem behoben, das dazu führte, dass das IoT SiteWise -Gateway ungültige Anforderungen unendlich erneut versuchte.

  • Es wurde ein Problem behoben, das zu einem beschädigten Checkpoint führte, wenn das IoT SiteWise -Gateway mit einer Hochfrequenz-Datenquelle verbunden war.

  • Verbesserte Fehlermeldungen zur Fehlerbehebung bei der Gateway-Konfiguration.

24. März 2021

10

Konfiguriert StreamManager für die Verbesserung der Handhabung, wenn die Quellverbindung unterbrochen und wieder hergestellt wird. Diese Version akzeptiert auch OPC-UA-Werte mit einem , ServerTimestamp wenn kein verfügbar SourceTimestamp ist.

22. Januar 2021

9

Unterstützung für benutzerdefinierte Greengrass-StreamManagerStream-Ziele, OPC-UA-Deadbanding, benutzerdefinierten Scanmodus und benutzerdefinierte Scanrate gestartet. Bietet auch eine verbesserte Leistung bei Konfigurationsaktualisierungen, die vom IoT SiteWise -Gateway durchgeführt wurden.

15. Dezember 2020

8

Verbesserte Stabilität, wenn der Konnektor zeitweilige Netzwerkkonnektivität aufweist.

19. November 2020

7

Es wurde ein Problem mit Gateway-Metriken behoben.

14. August 2020

6

Unterstützung für CloudWatch Metriken und automatische Erkennung neuer OPC-UA-Tags hinzugefügt. Diese Version erfordert Stream-Manager und AWS IoT Greengrass Core-Software v1.10.0 oder höher.

29. April 2020

5

Ein Kompatibilitätsproblem mit AWS IoT Greengrass Core-Software v1.9.4 wurde behoben.

12. Februar 2020

4

Ein Problem mit der erneuten Verbindung des OPC-UA Servers wurde behoben.

7. Februar 2020

3

Die iot:*-Berechtigungsanforderung wurde entfernt.

17. Dezember 2019

2

Unterstützung für mehrere OPC-UA-Secret-Ressourcen hinzugefügt.

10. Dezember 2019

1

Erstversion.

02. Dezember 2019

Eine Greengrass-Gruppe kann jeweils nur eine Version des Connectors enthalten. Weitere Informationen zum Aktualisieren einer Konnektorversion finden Sie unter Aktualisieren von Konnektorversionen.

Weitere Informationen finden Sie auch unter