Edge-Anschluss für Kinesis Video Streams - AWS IoT Greengrass
VersionenTypBetriebssystemVoraussetzungenAbhängigkeitenKonfigurationLizenzenVerwendungLokale ProtokolldateiÄ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.

Edge-Anschluss für Kinesis Video Streams

Der Edge-Connector für die Kinesis Video Streams-Komponente (aws.iot.EdgeConnectorForKVS) liest Video-Feeds von lokalen Kameras und veröffentlicht die Streams in Kinesis Video Streams. Sie können diese Komponente so konfigurieren, dass sie Video-Feeds von IP-Kameras (Internet Protocol) liest, die das Real Time Streaming Protocol (RTSP) verwenden. Anschließend können Sie Dashboards in Amazon Managed Grafana oder lokalen Grafana-Servern einrichten, um die Videostreams zu überwachen und mit ihnen zu interagieren.

Sie können diese Komponente integrieren AWS IoT TwinMaker , um Videostreams in Grafana-Dashboards anzuzeigen und zu steuern. AWS IoT TwinMaker ist ein AWS Service, mit dem Sie betriebsbereite digitale Zwillinge physischer Systeme erstellen können. Sie können AWS IoT TwinMaker damit Daten von Sensoren, Kameras und Unternehmensanwendungen visualisieren, sodass Sie Ihre physischen Fabriken, Gebäude oder Industrieanlagen verfolgen können. Sie können diese Daten auch verwenden, um Abläufe zu überwachen, Fehler zu diagnostizieren und Fehler zu reparieren. Weitere Informationen finden Sie unter Was ist AWS IoT TwinMaker? im AWS IoT TwinMaker Benutzerhandbuch.

Diese Komponente speichert ihre Konfiguration in AWS IoT SiteWise. Dabei handelt es sich um einen AWS Dienst, der Industriedaten modelliert und speichert. AWS IoT SiteWise In stehen Anlagen für Objekte wie Geräte, Ausrüstung oder Gruppen anderer Objekte. Um diese Komponente zu konfigurieren und zu verwenden, erstellen Sie ein AWS IoT SiteWise Asset für jedes Greengrass-Core-Gerät und für jede IP-Kamera, die mit jedem Core-Gerät verbunden ist. Jedes Asset verfügt über Eigenschaften, die Sie konfigurieren, um Funktionen wie Live-Streaming, On-Demand-Upload und lokales Caching zu steuern. Um die URL für jede Kamera anzugeben, erstellen Sie ein Geheimnis AWS Secrets Manager , das die URL der Kamera enthält. Wenn für die Kamera eine Authentifizierung erforderlich ist, geben Sie in der URL auch einen Benutzernamen und ein Passwort an. Anschließend geben Sie dieses Geheimnis in einer Asset-Eigenschaft für die IP-Kamera an.

Diese Komponente lädt den Videostream jeder Kamera in einen Kinesis-Videostream hoch. Sie geben den Namen des Kinesis-Ziel-Videostreams in der AWS IoT SiteWise Asset-Konfiguration für jede Kamera an. Wenn der Kinesis-Videostream nicht existiert, erstellt diese Komponente ihn für Sie.

AWS IoT TwinMaker stellt ein Skript bereit, das Sie ausführen können, um diese AWS IoT SiteWise Assets und Secrets Manager zu erstellen. Weitere Informationen zur Erstellung dieser Ressourcen und zur Installation, Konfiguration und Verwendung dieser Komponente finden Sie unter AWS IoT TwinMaker Videointegration im AWS IoT TwinMaker Benutzerhandbuch.

Anmerkung

Der Edge-Connector für die Kinesis Video Streams Streams-Komponente ist nur in den folgenden AWS-Regionen Fällen verfügbar:

  • USA Ost (Nord-Virginia)

  • USA West (Oregon)

  • Europe (Frankfurt)

  • Europa (Irland)

  • Asien-Pazifik (Singapur)

Versionen

Diese Komponente hat die folgenden Versionen:

  • 1.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 nur auf Linux-Core-Geräten installiert werden.

Voraussetzungen

Für diese Komponente gelten die folgenden Anforderungen:

  • Sie können diese Komponente nur auf Single-Core-Geräten bereitstellen, da die Komponentenkonfiguration für jedes Core-Gerät eindeutig sein muss. Sie können diese Komponente nicht für Gruppen von Kerngeräten bereitstellen.

  • GStreamer 1.18.4 oder höher ist auf dem Kerngerät installiert. Weitere Informationen finden Sie unter GStreamer installieren.

    Auf einem Gerät mit können Sie die folgenden Befehle ausführenapt, um GStreamer zu installieren.

    sudo apt install -y libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev gstreamer1.0-plugins-base-apps
sudo apt install -y gstreamer1.0-libav
sudo apt install -y gstreamer1.0-plugins-bad gstreamer1.0-plugins-good gstreamer1.0-plugins-ugly gstreamer1.0-tools

  • Ein AWS IoT SiteWise Asset für jedes Kerngerät. Dieses AWS IoT SiteWise Asset stellt das Kerngerät dar. Weitere Informationen zur Erstellung dieses Assets finden Sie im AWS IoT TwinMaker Benutzerhandbuch unter AWS IoT TwinMaker Videointegration.

  • Ein AWS IoT SiteWise Asset für jede IP-Kamera, die Sie mit jedem Kerngerät verbinden. Diese AWS IoT SiteWise Ressourcen stellen die Kameras dar, die Videos auf jedes Kerngerät streamen. Das Asset jeder Kamera muss dem Asset für das Kerngerät zugeordnet werden, das mit der Kamera verbunden ist. Kamera-Assets verfügen über Eigenschaften, die Sie konfigurieren können, um einen Kinesis-Videostream, ein Authentifizierungsgeheimnis und Videostreaming-Parameter anzugeben. Weitere Informationen zum Erstellen und Konfigurieren von Kameraobjekten finden Sie im AWS IoT TwinMaker Benutzerhandbuch unter AWS IoT TwinMaker Videointegration.

  • Ein AWS Secrets Manager Geheimnis für jede IP-Kamera. Dieses Geheimnis muss ein Schlüssel-Wert-Paar definieren, wobei sich der Schlüssel befindet RTSPStreamUrl und der Wert die URL für die Kamera ist. Wenn für die Kamera eine Authentifizierung erforderlich ist, geben Sie den Benutzernamen und das Passwort in diese URL ein. Sie können ein Skript verwenden, um ein Geheimnis zu erstellen, wenn Sie die Ressourcen erstellen, die diese Komponente benötigt. Weitere Informationen finden Sie im AWS IoT TwinMaker Benutzerhandbuch unter AWS IoT TwinMaker Videointegration.

    Sie können auch die Secrets Manager Manager-Konsole und die API verwenden, um zusätzliche Geheimnisse zu erstellen. Weitere Informationen finden Sie im AWS Secrets Manager Benutzerhandbuch unter Create a Secret.

  • Die Greengrass-Token-Austauschrolle muss die folgenden AWS Secrets Manager AWS IoT SiteWise, und Kinesis Video Streams Streams-Aktionen zulassen, wie in der folgenden IAM-Beispielrichtlinie gezeigt.

    Anmerkung

    Diese Beispielrichtlinie ermöglicht es dem Gerät, den Wert von Geheimnissen mit dem Namen und abzurufen. IPCamera1Url IPCamera2Url Wenn Sie jede IP-Kamera konfigurieren, geben Sie ein Geheimnis an, das die URL für diese Kamera enthält. Wenn für die Kamera eine Authentifizierung erforderlich ist, geben Sie in der URL auch einen Benutzernamen und ein Passwort an. Die Token-Austauschfunktion des Kerngeräts muss den Zugriff auf das Geheimnis ermöglichen, damit jede IP-Kamera eine Verbindung herstellen kann.

    {
  "Version": "2012-10-17",
  "Statement": [
    {
      "Action": [
        "secretsmanager:GetSecretValue"
      ],
      "Effect": "Allow",
      "Resource": [
        "arn:aws:secretsmanager:region:account-id:secret:IPCamera1Url",
        "arn:aws:secretsmanager:region:account-id:secret:IPCamera2Url"
      ]
    },
    {
      "Action": [
        "iotsitewise:BatchPutAssetPropertyValue",
        "iotsitewise:DescribeAsset",
        "iotsitewise:DescribeAssetModel",
        "iotsitewise:DescribeAssetProperty",
        "iotsitewise:GetAssetPropertyValue",
        "iotsitewise:ListAssetRelationships",
        "iotsitewise:ListAssets",
        "iotsitewise:ListAssociatedAssets",
        "kinesisvideo:CreateStream",
        "kinesisvideo:DescribeStream",
        "kinesisvideo:GetDataEndpoint",
        "kinesisvideo:PutMedia",
        "kinesisvideo:TagStream"
      ],
      "Effect": "Allow",
      "Resource": [
        "*"
      ]
    }
  ]
}
    Anmerkung

    Wenn Sie einen vom Kunden verwalteten AWS Key Management Service Schlüssel zum Verschlüsseln von Geheimnissen verwenden, muss die Geräterolle die kms:Decrypt Aktion ebenfalls zulassen.

Endpunkte und Ports

Diese Komponente muss in der Lage sein, ausgehende Anfragen an die folgenden Endpunkte und Ports auszuführen, zusätzlich zu den Endpunkten und Ports, die für den Basisbetrieb erforderlich sind. Weitere Informationen finden Sie unter Zulassen von Gerätedatenverkehr über einen Proxy oder eine Firewall.

Endpunkt Port Erforderlich Beschreibung

kinesisvideo.region.amazonaws.com

 443 Ja

Laden Sie Daten in Kinesis Video Streams hoch.

data.iotsitewise.region.amazonaws.com

 443 Ja

Veröffentlichen Sie Videostream-Metadaten auf AWS IoT SiteWise.

secretsmanager.region.amazonaws.com

 443 Ja

Laden Sie die Geheimnisse der Kamera-URL auf das Kerngerät herunter.

Abhängigkeiten

Wenn Sie eine Komponente bereitstellen, stellt sie AWS IoT Greengrass auch kompatible Versionen ihrer Abhängigkeiten bereit. Das bedeutet, dass Sie die Anforderungen für die Komponente und all ihre Abhängigkeiten erfüllen müssen, um die Komponente erfolgreich bereitstellen zu können. In diesem Abschnitt werden die Abhängigkeiten für die veröffentlichten Versionen dieser Komponente sowie 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 der Abhängigkeiten.

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

-Abhängigkeit Kompatible Versionen Art der Abhängigkeit
Token-Austauschdienst >=2.0.3 Hart
Stream-Manager >=2.0.9 Hart

Weitere Informationen zu Komponentenabhängigkeiten finden Sie in der Referenz zu den Komponentenrezepten.

Konfiguration

Diese Komponente stellt die folgenden Konfigurationsparameter bereit, die Sie bei der Bereitstellung der Komponente anpassen können.

SiteWiseAssetIdForHub

Die ID des AWS IoT SiteWise Assets, das dieses Kerngerät darstellt. Weitere Informationen darüber, wie Sie dieses Asset erstellen und es für die Interaktion mit dieser Komponente verwenden, finden Sie im AWS IoT TwinMaker Benutzerhandbuch unter AWS IoT TwinMaker Videointegration.

Beispiel: Aktualisierung der Zusammenführung von Konfigurationen
{
  "SiteWiseAssetIdForHub": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"
}

Lizenzen

Diese Komponente umfasst die folgende Software/Lizenzierung von Drittanbietern:

Verwendung

Um diese Komponente zu konfigurieren und mit ihr zu interagieren, können Sie Eigenschaften für die Komponenten festlegen, die das Kerngerät und AWS IoT SiteWise die IP-Kameras repräsentieren, mit denen es verbunden ist. Sie können auch Videostreams in Grafana-Dashboards über visualisieren und mit ihnen interagieren. AWS IoT TwinMaker Weitere Informationen finden Sie unter AWS IoT TwinMaker Videointegration im AWS IoT TwinMaker Benutzerhandbuch.

Lokale Protokolldatei

Diese Komponente verwendet die folgende Protokolldatei.

/greengrass/v2/logs/aws.iot.EdgeConnectorForKVS.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. /greengrass/v2Ersetzen Sie es durch den Pfad zum AWS IoT Greengrass Stammordner.

    sudo tail -f /greengrass/v2/logs/aws.iot.EdgeConnectorForKVS.log

Änderungsprotokoll

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

Version

Änderungen

1.0.5

Allgemeine Fehlerbehebungen und Verbesserungen.

1.0.4
Fehlerkorrekturen und Verbesserungen

  • Behebt ein Problem, das dazu führte, dass das Live-Hochladen gestoppt wurde.

1.0.3

Allgemeine Fehlerbehebungen und Verbesserungen.

1.0.1

Allgemeine Fehlerbehebungen und Verbesserungen.

1.0.0

Erste Version

Weitere Informationen finden Sie auch unter