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.
SageMaker Edge-Manager
Wichtig
SageMaker Edge Manager wurde am 26. April 2024 eingestellt. Weitere Informationen zur weiteren Bereitstellung Ihrer Modelle auf Edge-Geräten finden Sie unter Ende der Nutzungsdauer von SageMaker Edge Manager.
Die Amazon SageMaker Edge Manager-Komponente (aws.greengrass.SageMakerEdgeManager
) installiert die SageMaker Edge Manager-Agent-Binärdatei.
SageMaker Edge Manager bietet Modellmanagement für Edge-Geräte, sodass Sie Modelle für maschinelles Lernen auf Flotten von Edge-Geräten optimieren, sichern, überwachen und verwalten können. Die SageMaker Edge Manager-Komponente installiert und verwaltet den Lebenszyklus des SageMaker Edge Manager-Agenten auf Ihrem Kerngerät. Sie können SageMaker Edge Manager auch verwenden, um SageMaker NEO-kompilierte Modelle als Modellkomponenten auf Greengrass-Kerngeräten zu verpacken und zu verwenden. Weitere Informationen zur Verwendung SageMaker des Edge Manager-Agenten auf Ihrem Kerngerät finden Sie unter. Verwenden Sie Amazon SageMaker Edge Manager auf Greengrass-Kerngeräten
SageMaker Die Edge Manager-Komponente v1.3.x installiert die Edge Manager-Agent-Binärdatei v1.20220822.836f3023. Weitere Informationen zu den Binärversionen des Edge Manager-Agents finden Sie unter Edge Manager Agent.
Anmerkung
Die SageMaker Edge Manager-Komponente ist nur in den folgenden Versionen verfügbar AWS-Regionen:
-
US East (Ohio)
-
USA Ost (Nord-Virginia)
-
USA West (Oregon)
-
EU (Frankfurt)
-
EU (Irland)
-
Asien-Pazifik (Tokio)
Themen
Versionen
Diese Komponente hat die folgenden Versionen:
-
1.3.x
-
1.2.x
-
1.1.x
-
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 auf Kerngeräten installiert werden, auf denen die folgenden Betriebssysteme ausgeführt werden:
Linux
Windows
Voraussetzungen
Für diese Komponente gelten die folgenden Anforderungen:
-
Ein Greengrass-Core-Gerät, das auf Amazon Linux 2, einer Debian-basierten Linux-Plattform (x86_64 oder Armv8) oder Windows (x86_64) läuft. Falls Sie noch keines haben, beachten Sie die Informationen unter Tutorial: Erste Schritte mit AWS IoT Greengrass V2.
-
Python
3.6 oder höher, auch pip
für Ihre Version von Python, die auf Ihrem Kerngerät installiert ist. -
Die Greengrass-Geräterolle wurde wie folgt konfiguriert:
-
Eine Vertrauensbeziehung, die es
sagemaker.amazonaws.com
ermöglichtcredentials.iot.amazonaws.com
und die Übernahme der Rolle ermöglicht, wie im folgenden IAM Richtlinienbeispiel dargestellt.{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "credentials.iot.amazonaws.com" }, "Action": "sts:AssumeRole" }, { "Effect": "Allow", "Principal": { "Service": "sagemaker.amazonaws.com" }, "Action": "sts:AssumeRole" } ] }
-
Die AmazonSageMakerEdgeDeviceFleetPolicy
IAMverwaltete Richtlinie. -
Die
s3:PutObject
Aktion, wie im folgenden IAM Richtlinienbeispiel dargestellt.{ "Version": "2012-10-17", "Statement": [ { "Action": [ "s3:PutObject" ], "Resource": [ "*" ], "Effect": "Allow" } ] }
-
-
Ein Amazon S3 S3-Bucket, der im selben AWS-Konto und AWS-Region wie Ihr Greengrass-Core-Gerät erstellt wurde. SageMaker Edge Manager benötigt einen S3-Bucket, um eine Edge-Geräteflotte zu erstellen und Beispieldaten aus laufenden Inferenzen auf Ihrem Gerät zu speichern. Informationen zum Erstellen von S3-Buckets finden Sie unter Erste Schritte mit Amazon S3.
-
Eine SageMaker Edge-Geräteflotte, die denselben AWS IoT Rollenalias wie Ihr Greengrass-Core-Gerät verwendet. Weitere Informationen finden Sie unter Erstellen Sie eine Flotte von Edge-Geräten.
-
Ihr Greengrass Core-Gerät ist als Edge-Gerät in Ihrer SageMaker Edge-Geräteflotte registriert. Der Name des Edge-Geräts muss mit dem AWS IoT Dingnamen für Ihr Core-Gerät übereinstimmen. Weitere Informationen finden Sie unter Registrieren Sie Ihr Greengrass Core-Gerät.
Endpunkte und Anschlüsse
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 |
---|---|---|---|
|
443 | Ja |
Überprüfen Sie den Status der Geräteregistrierung und senden Sie Messdaten an. SageMaker |
|
443 | Ja |
Laden Sie die Erfassungsdaten in den von Ihnen angegebenen S3-Bucket hoch. Sie können es |
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 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 die Abhängigkeiten für jede Version der Komponente auch in der AWS IoT Greengrass Konsole
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.
Anmerkung
In diesem Abschnitt werden die Konfigurationsparameter beschrieben, die Sie in der Komponente festlegen. Weitere Informationen zur entsprechenden SageMaker Edge Manager-Konfiguration finden Sie unter Edge Manager Agent im Amazon SageMaker Developer Guide.
DeviceFleetName
-
Der Name der SageMaker Edge Manager-Geräteflotte, die Ihr Greengrass-Core-Gerät enthält.
Sie müssen im Konfigurationsupdate einen Wert für diesen Parameter angeben, wenn Sie diese Komponente bereitstellen.
BucketName
-
Der Name des S3-Buckets, in den Sie erfasste Inferenzdaten hochladen. Der Bucket-Name muss die Zeichenfolge
sagemaker
enthalten.Wenn Sie
CaptureDataDestination
aufCloud
oder wenn SieCaptureDataPeriodicUpload
auf setzentrue
, müssen Sie bei der Bereitstellung dieser Komponente im Konfigurationsupdate einen Wert für diesen Parameter angeben.Anmerkung
Daten erfassen ist eine SageMaker Funktion, mit der Sie Inferenzeingaben, Inferenzergebnisse und zusätzliche Inferenzdaten für future Analysen in einen S3-Bucket oder ein lokales Verzeichnis hochladen. Weitere Informationen zur Verwendung von Erfassungsdaten mit SageMaker Edge Manager finden Sie unter Modell verwalten im Amazon SageMaker Developer Guide.
CaptureDataBatchSize
-
(Optional) Die Größe eines Stapels von Anfragen zur Erfassung von Daten, die der Agent bearbeitet. Dieser Wert muss kleiner als die Puffergröße sein, die Sie in angeben
CaptureDataBufferSize
. Wir empfehlen, die Hälfte der Puffergröße nicht zu überschreiten.Der Agent verarbeitet einen Anforderungsstapel, wenn die Anzahl der Anfragen im Puffer der
CaptureDataBatchSize
Anzahl entspricht, oder wenn dasCaptureDataPushPeriodSeconds
Intervall abgelaufen ist, je nachdem, was zuerst eintritt.Standard:
10
CaptureDataBufferSize
-
(Optional) Die maximale Anzahl von Erfassungsdatenanforderungen, die im Puffer gespeichert sind.
Standard:
30
CaptureDataDestination
-
(Optional) Das Ziel, an dem Sie die erfassten Daten speichern. Dieser Parameter kann die folgenden Werte haben:
-
Cloud
— Lädt erfasste Daten in den von Ihnen angegebenen S3-Bucket hoch.BucketName
-
Disk
— Schreibt die erfassten Daten in das Arbeitsverzeichnis der Komponente.
Wenn Sie dies angeben
Disk
, können Sie die erfassten Daten auch regelmäßig in Ihren S3-Bucket hochladen, indem SieCaptureDataPeriodicUpload
auftrue
einstellen.Standard:
Cloud
-
CaptureDataPeriodicUpload
-
(Optional) Zeichenkettenwert, der angibt, ob die erfassten Daten regelmäßig hochgeladen werden sollen. Unterstützte Werte sind
true
undfalse
.Setzen Sie diesen Parameter auf,
true
wenn SieCaptureDataDestination
auf festlegen und Sie möchtenDisk
, dass der Agent die erfassten Daten regelmäßig in Ihren S3-Bucket hochlädt.Standard:
false
CaptureDataPeriodicUploadPeriodSeconds
-
(Optional) Das Intervall in Sekunden, in dem der SageMaker Edge Manager-Agent die erfassten Daten in den S3-Bucket hochlädt. Verwenden Sie diesen Parameter, wenn Sie
CaptureDataPeriodicUpload
auftrue
einstellen.Standard:
8
CaptureDataPushPeriodSeconds
-
(Optional) Das Intervall in Sekunden, in dem der SageMaker Edge Manager-Agent einen Stapel von Erfassungsdatenanforderungen aus dem Puffer verarbeitet.
Der Agent verarbeitet einen Anforderungsstapel, wenn die Anzahl der Anfragen im Puffer der
CaptureDataBatchSize
Anzahl entspricht, oder wenn dasCaptureDataPushPeriodSeconds
Intervall abgelaufen ist, je nachdem, was zuerst eintritt.Standard:
4
CaptureDataBase64EmbedLimit
-
(Optional) Die maximale Größe der erfassten Daten in Byte, die der SageMaker Edge Manager-Agent hochlädt.
Standard:
3072
FolderPrefix
-
(Optional) Der Name des Ordners, in den der Agent die erfassten Daten schreibt. Wenn Sie
CaptureDataDestination
auf festlegenDisk
, erstellt der Agent den Ordner in dem Verzeichnis, das von angegeben istCaptureDataDiskPath
. Wenn SieCaptureDataDestination
aufCloud
oder wenn SieCaptureDataPeriodicUpload
auf festlegentrue
, erstellt der Agent den Ordner in Ihrem S3-Bucket.Standard:
sme-capture
CaptureDataDiskPath
-
Diese Funktion ist in Version 1.1.0 und späteren Versionen der SageMaker Edge Manager-Komponente verfügbar.
(Optional) Der Pfad zu dem Ordner, in dem der Agent den Ordner mit den erfassten Daten erstellt. Wenn Sie
CaptureDataDestination
auf festlegenDisk
, erstellt der Agent den Ordner mit den erfassten Daten in diesem Verzeichnis. Wenn Sie diesen Wert nicht angeben, erstellt der Agent den Ordner mit den erfassten Daten im Arbeitsverzeichnis der Komponente. Verwenden Sie denFolderPrefix
Parameter, um den Namen des Ordners für erfasste Daten anzugeben.Standard:
/work/aws.greengrass.SageMakerEdgeManager/capture/greengrass/v2
LocalDataRootPath
-
Diese Funktion ist in Version 1.2.0 und späteren Versionen der SageMaker Edge Manager-Komponente verfügbar.
(Optional) Der Pfad, in dem diese Komponente die folgenden Daten auf dem Kerngerät speichert:
-
Die lokale Datenbank für Laufzeitdaten, wenn Sie
DbEnable
auf einstellentrue
. -
SageMaker Neo-kompilierte Modelle, die diese Komponente automatisch herunterlädt, wenn Sie
DeploymentEnable
auftrue
einstellen.
Standard:
/work/aws.greengrass.SageMakerEdgeManager/greengrass/v2
-
DbEnable
-
(Optional) Sie können diese Komponente aktivieren, um Laufzeitdaten in einer lokalen Datenbank zu speichern, um die Daten für den Fall zu schützen, dass die Komponente ausfällt oder das Gerät ausfällt.
Diese Datenbank benötigt 5 MB Speicherplatz im Dateisystem des Kerngeräts.
Standard:
false
DeploymentEnable
-
Diese Funktion ist in Version 1.2.0 und späteren Versionen der SageMaker Edge Manager-Komponente verfügbar.
(Optional) Sie können diese Komponente aktivieren, um automatisch SageMaker NEO-kompilierte Modelle abzurufen, von denen Sie auf Amazon S3 hochladen. Nachdem Sie ein neues Modell auf Amazon S3 hochgeladen haben, verwenden Sie SageMaker Studio oder das, SageMaker API um das neue Modell auf diesem Kerngerät bereitzustellen. Wenn Sie diese Funktion aktivieren, können Sie neue Modelle auf Kerngeräten bereitstellen, ohne eine AWS IoT Greengrass Bereitstellung erstellen zu müssen.
Wichtig
Um diese Funktion verwenden zu können, müssen Sie
DbEnable
auftrue
einstellen. Diese Funktion verwendet die lokale Datenbank, um Modelle zu verfolgen, die sie aus der AWS Cloud abruft.Standard:
false
DeploymentPollInterval
-
Diese Funktion ist in Version 1.2.0 und späteren Versionen der SageMaker Edge Manager-Komponente verfügbar.
(Optional) Der Zeitraum (in Minuten), zwischen dem diese Komponente nach neuen Modellen zum Herunterladen sucht. Diese Option gilt, wenn Sie
DeploymentEnable
auf einstellentrue
.Standard:
1440
(1 Tag) DLRBackendOptions
-
Diese Funktion ist in Version 1.2.0 und späteren Versionen der SageMaker Edge Manager-Komponente verfügbar.
(Optional) Die DLR Runtime-Flags, die in der von dieser Komponente verwendeten DLR Laufzeit gesetzt werden sollen. Sie können das folgende Flag setzen:
-
TVM_TENSORRT_CACHE_DIR
— Aktiviert das Zwischenspeichern von TensorRT-Modellen. Geben Sie einen absoluten Pfad zu einem vorhandenen Ordner mit Lese-/Schreibberechtigungen an. -
TVM_TENSORRT_CACHE_DISK_SIZE_MB
— Weist die Obergrenze des TensorRT-Modell-Cache-Ordners zu. Wenn die Verzeichnisgröße diese Grenze überschreitet, werden die zwischengespeicherten Engines, die am wenigsten verwendet werden, gelöscht. Der Standardwert ist 512 MB.
Sie können diesen Parameter beispielsweise auf den folgenden Wert setzen, um das Zwischenspeichern von TensorRT-Modellen zu aktivieren und die Cachegröße auf 800 MB zu begrenzen.
TVM_TENSORRT_CACHE_DIR=/data/secured_folder/trt/cache; TVM_TENSORRT_CACHE_DISK_SIZE_MB=800
-
SagemakerEdgeLogVerbose
-
(Optional) Zeichenkettenwert, der angibt, ob die Debug-Protokollierung aktiviert werden soll. Unterstützte Werte sind
true
undfalse
.Standard:
false
UnixSocketName
-
(Optional) Der Speicherort des SageMaker Edge Manager-Socket-Dateideskriptors auf dem Kerngerät.
Standard:
/tmp/aws.greengrass.SageMakerEdgeManager.sock
Beispiel: Update zur Zusammenführung von Konfigurationen
Die folgende Beispielkonfiguration gibt an, dass das Kerngerät Teil der ist MyEdgeDeviceFleet
und dass der Agent Erfassungsdaten sowohl auf das Gerät als auch in einen S3-Bucket schreibt. Diese Konfiguration ermöglicht auch die Debug-Protokollierung.
{ "DeviceFleetName": "
MyEdgeDeviceFleet
", "BucketName": "amzn-s3-demo-bucket", "CaptureDataDestination": "Disk", "CaptureDataPeriodicUpload": "true", "SagemakerEdgeLogVerbose": "true" }
Lokale Protokolldatei
Diese Komponente verwendet die folgende Protokolldatei.
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
oder/greengrass/v2
C:\greengrass\v2
mit dem Pfad zum AWS IoT Greengrass Stammordner.
Änderungsprotokoll
In der folgenden Tabelle werden die Änderungen in den einzelnen Versionen der Komponente beschrieben.
Version |
Änderungen |
---|---|
1.3.6 |
Die Version wurde für die Version Greengrass Nucleus 2.12.5 aktualisiert. |
1.3.5 |
Die Version wurde für die Version 2.12.0 von Greengrass Nucleus aktualisiert. |
1.3.4 |
Die Version wurde für die Version 2.11.0 von Greengrass Nucleus aktualisiert. |
1.3.3 |
Die Version wurde für die Version 2.10.0 von Greengrass Nucleus aktualisiert. |
1.3.2 |
Die Version wurde für die Version 2.9.0 von Greengrass Nucleus aktualisiert. |
1.3.1 |
Die Version wurde für die Version 2.8.0 von Greengrass Nucleus aktualisiert. |
1.3.0 |
|
1.2.0 |
|
1.1.1 |
Die Version wurde für die Version 2.7.0 von Greengrass Nucleus aktualisiert. |
1.1.0 |
|
1.0.3 |
Die Version wurde für die Version 2.4.0 von Greengrass Nucleus aktualisiert. |
1.0.2 |
|
1.0.1 |
Die Version wurde für die Version 2.3.0 von Greengrass Nucleus aktualisiert. |
1.0.0 |
Erste Version |