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.
# Sammeln Sie AWS FleetWise IoT-Daten mit Kampagnen
**Wichtig**
Der Zugriff auf bestimmte AWS FleetWise IoT-Funktionen ist derzeit gesperrt. Weitere Informationen finden Sie unter [AWS Verfügbarkeit von Regionen und Funktionen im AWS Internet der Dinge FleetWise](fleetwise-regions.md).
Eine Kampagne ist eine Orchestrierung von Regeln für die Datenerfassung. Kampagnen geben der Edge Agent for AWS FleetWise IoT-Software Anweisungen zur Auswahl, Erfassung und Übertragung von Daten in die Cloud.
Sie erstellen Kampagnen in der Cloud. Nachdem Sie oder Ihr Team eine Kampagne genehmigt haben, FleetWise stellt AWS IoT die Kampagne als einsatzbereit fest und sie wird beim nächsten Fahrzeug-Check-in bereitgestellt. Sie können wählen, ob Sie eine Kampagne für ein Fahrzeug oder eine Fahrzeugflotte einsetzen möchten. Die Edge Agent-Software beginnt erst mit der Erfassung von Daten, wenn eine laufende Kampagne für das Fahrzeug bereitgestellt wird.
**Wichtig**
Kampagnen funktionieren erst, wenn Sie über Folgendes verfügen.
Die Edge Agent-Software wird in Ihrem Fahrzeug ausgeführt. Gehen Sie wie folgt vor, um weitere Informationen zur Entwicklung, Installation und Arbeit mit der Edge Agent-Software zu erhalten.
Öffnen Sie die [AWS FleetWise IoT-Konsole](https://console.aws.amazon.com/iotfleetwise).
Wählen Sie auf der Service-Startseite im FleetWise Abschnitt **Erste Schritte mit AWS IoT** die Option **Explore Edge Agent** aus.
Sie haben die Einrichtung AWS IoT Core für die Bereitstellung Ihres Fahrzeugs eingerichtet. Weitere Informationen finden Sie unter [Bereitstellung von AWS FleetWise IoT-Fahrzeugen](provision-vehicles.md).
**Anmerkung**
Sie können außerdem [Überwachen des letzten bekannten Zustands Ihrer Fahrzeuge](last-known-state.md) (nicht Flotten) nahezu in Echtzeit Statusvorlagen verwenden, mit denen Sie Telemetriedaten streamen können, entweder mit einer Aktualisierungsstrategie „bei Änderung“ oder „in regelmäßigen Abständen“. Diese Funktion bietet auch „On Demand“ -Funktionen, mit denen Sie zuvor bereitgestellte Vorlagen aktivieren oder deaktivieren oder den aktuellen Fahrzeugstatus einmalig anfordern können (Abrufen).
Der Zugriff auf den letzten bekannten Status ist derzeit gesperrt. Weitere Informationen finden Sie unter [AWS Verfügbarkeit von Regionen und Funktionen im AWS Internet der Dinge FleetWise](fleetwise-regions.md).
Jede Kampagne enthält die folgenden Informationen.
`signalCatalogArn`
Der Amazon-Ressourcenname (ARN) des Signalkatalogs, der mit der Kampagne verknüpft ist.
(Optional) `tags`
Tags sind Metadaten, die zur Verwaltung der Kampagne verwendet werden können. Sie können Ressourcen aus verschiedenen Services dasselbe Tag zuweisen, um anzugeben, dass die Ressourcen miteinander verbunden sind.
`TargetArn`
Der ARN eines Fahrzeugs oder einer Flotte, in der die Kampagne bereitgestellt wird.
`name`
Ein eindeutiger Name, anhand dessen die Kampagne identifiziert werden kann.
`collectionScheme`
Die Datenerfassungsschemata geben der Edge Agent-Software Anweisungen darüber, welche Daten gesammelt werden sollen oder wann sie gesammelt werden sollen. AWS IoT unterstützt FleetWise derzeit das zustandsbasierte Sammelschema und das zeitbasierte Sammelschema.
+ `conditionBasedCollectionScheme`— Das auf Bedingungen basierende Erfassungssystem verwendet einen logischen Ausdruck, um zu erkennen, welche Daten gesammelt werden sollen. Die Edge-Agent-Software erfasst Daten, wenn die Bedingung erfüllt ist.
+ `expression`— der logische Ausdruck, der verwendet wird, um zu erkennen, welche Daten gesammelt werden sollen. Wenn der `$variable.`myVehicle.InVehicleTemperature` > 50.0` Ausdruck beispielsweise angegeben ist, erfasst die Edge Agent-Software Temperaturwerte, die über 50,0 liegen. Anweisungen zum Schreiben von Ausdrücken finden Sie unter[Logische Ausdrücke für AWS FleetWise IoT-Kampagnen](logical-expression.md).
+ (Optional) `conditionLanguageVersion` — die Version der Sprache für bedingte Ausdrücke.
+ (Optional) `minimumTriggerIntervalMs` — die Mindestdauer zwischen zwei Datenerfassungsereignissen in Millisekunden. Wenn sich ein Signal häufig ändert, erfassen Sie Daten möglicherweise langsamer.
+ (Optional) `triggerMode` — kann einer der folgenden Werte sein:
+ `RISING_EDGE`— Die Edge Agent-Software erfasst Daten nur, wenn die Bedingung zum ersten Mal erfüllt ist. Beispiel, `$variable.`myVehicle.AirBagDeployed` == true`.
+ `ALWAYS`— Die Edge Agent-Software sammelt Daten, wenn die Bedingung erfüllt ist.
+ `timeBasedCollectionScheme`— Wenn Sie ein zeitbasiertes Erfassungsschema definieren, geben Sie einen Zeitraum in Millisekunden an. Die Edge-Agent-Software entscheidet dann unter Berücksichtigung des Zeitraums, wie oft Daten erfasst werden sollen. Wenn der Zeitraum beispielsweise 120.000 Millisekunden beträgt, erfasst die Edge Agent-Software alle zwei Minuten Daten.
+ `periodMs`— der Zeitraum (in Millisekunden), in dem entschieden wird, wie oft Daten gesammelt werden sollen.
(Optional) `compression`
Um drahtlose Bandbreite zu sparen und den Netzwerkverkehr zu reduzieren, können Sie [SNAPPY angeben, um Daten in Fahrzeugen](https://opensource.google/projects/snappy) zu komprimieren.
Standardmäßig (`OFF`) komprimiert die Edge Agent-Software keine Daten.
`dataDestinationConfigs`
Wählen Sie das einzige Ziel aus, an das die Kampagne Fahrzeugdaten übertragen soll. Sie können die Daten an ein [MQTT-Thema](https://docs.aws.amazon.com/iot/latest/developerguide/topics.html) senden oder sie in Amazon S3 oder Amazon Timestream speichern.
MQTT (Message Queuing Telemetry Transport) ist ein leichtes und weit verbreitetes Messaging-Protokoll. Sie können Daten zu einem MQTT-Thema veröffentlichen, um mithilfe von Regeln Ihre eigenen ereignisgesteuerten Architekturen aufzubauen. AWS IoT AWS IoT [Die Unterstützung für MQTT basiert auf der MQTT-Spezifikation [v3.1.1 und der MQTT-Spezifikation v5.0](http://docs.oasis-open.org/mqtt/mqtt/v3.1.1/os/mqtt-v3.1.1-os.html), mit einigen Unterschieden.](http://docs.oasis-open.org/mqtt/mqtt/v5.0/mqtt-v5.0.html) [Weitere Informationen finden Sie unter MQTT-Unterschiede.](https://docs.aws.amazon.com/iot/latest/developerguide/mqtt.html#mqtt-differences.html)
S3 kann ein kostengünstiger Datenspeichermechanismus sein, der dauerhafte Datenverwaltungsfunktionen und nachgelagerte Datendienste bietet. Sie können S3 für Daten zum Fahrverhalten oder zur Analyse langfristiger Wartungsarbeiten verwenden.
Timestream ist ein Mechanismus zur Datenpersistenz, mit dem Sie Trends und Muster nahezu in Echtzeit erkennen können. Sie können Timestream für Zeitreihendaten verwenden, z. B. um historische Trends bei der Fahrzeuggeschwindigkeit oder beim Bremsen zu analysieren.
Amazon Timestream ist in der Region Asien-Pazifik (Mumbai) nicht verfügbar.
(Optional) `dataExtraDimensions`
Sie können ein oder mehrere Attribute hinzufügen, um zusätzliche Informationen für ein Signal bereitzustellen.
(Optional) `dataPartitions`
Erstellen Sie eine Datenpartition, um Signaldaten vorübergehend auf einem Fahrzeug zu speichern. Sie konfigurieren, wann und wie die Daten an die Cloud weitergeleitet werden sollen.
+ Geben Sie an, wie AWS IoT die Daten in einem Fahrzeug oder einer Flotte FleetWise speichert, indem Sie die maximale Speichergröße, die Mindestlebensdauer und den Speicherort definieren.
+ Die Kampagne `spoolingMode` muss sein`TO_DISK`.
+ Das Hochladen von Konfigurationen umfasst die Definition der Version der Bedingungssprache und des logischen Ausdrucks.
(Optional) `description`
Fügen Sie eine Beschreibung hinzu, um den Zweck der Kampagne besser zu identifizieren.
(Optional) `diagnosticsMode`
Wenn der Diagnosemodus so konfiguriert ist`SEND_ACTIVE_DTCS`, sendet die Kampagne gespeicherte Standarddiagnose-Fehlercodes (DTCs), anhand derer festgestellt werden kann, was mit Ihrem Fahrzeug nicht stimmt. Beispielsweise bedeutet P0097, dass das Motorsteuergerät (ECM) festgestellt hat, dass der Eingang des Ansauglufttemperatursensors 2 (IAT2) unter dem normalen Sensorbereich liegt.
Standardmäßig (`OFF`) sendet die Edge Agent-Software keine Diagnosecodes.
(Optional) `expiryTime`
Definieren Sie das Ablaufdatum für Ihre Kampagne. Wenn die Kampagne abläuft, beendet die Edge Agent-Software die Erfassung von Daten, wie in dieser Kampagne angegeben. Wenn mehrere Kampagnen für das Fahrzeug bereitgestellt werden, verwendet die Edge Agent-Software andere Kampagnen, um Daten zu sammeln.
Standardwert: `253402243200` (31. Dezember 9999, 00:00:00 UTC)
(Optional) `postTriggerCollectionDuration`
Sie können eine Dauer für die Erfassung nach dem Auslösen definieren, sodass die Edge Agent-Software nach dem Aufrufen eines Schemas für einen bestimmten Zeitraum weiterhin Daten sammelt. Wenn beispielsweise ein zustandsbasiertes Erfassungsschema mit dem folgenden Ausdruck aufgerufen wird:`$variable.`myVehicle.Engine.RPM` > 7000.0`, erfasst die Edge Agent-Software weiterhin Werte für Umdrehungen pro Minute (U/min) für den Motor. Selbst wenn die Drehzahl nur einmal höher als 7000 ist, kann dies auf ein mechanisches Problem hinweisen. In diesem Fall möchten Sie möglicherweise, dass die Edge Agent-Software weiterhin Daten sammelt, um den Zustand zu überwachen.
Standardwert: `0`
(Optional) `priority`
Geben Sie eine Ganzzahl an, um die Prioritätsstufe der Kampagne anzugeben. Kampagnen mit einer kleineren Zahl haben eine höhere Priorität. Wenn Sie mehrere Kampagnen für ein Fahrzeug bereitstellen, werden die Kampagnen mit höherer Priorität zuerst initiiert.
Standardwert: `0`
(Optional) `signalsToCollect`
Eine Liste von Signalen, aus denen Daten gesammelt werden, wenn das Datenerfassungsschema aufgerufen wird.
+ `name`— der Name des Signals, aus dem Daten gesammelt werden, wenn das Datenerfassungsschema aufgerufen wird.
+ `dataPartitionId`— die ID der Datenpartition, die im Signal verwendet werden soll. Die ID muss mit einer der in IDs angegebenen übereinstimmen`dataPartitions`. Wenn Sie ein Signal als Bedingung in Ihre Datenpartition hochladen, müssen dieselben Signale darin enthalten sein`signalsToCollect`.
+ (Optional) `maxSampleCount` — Die maximale Anzahl von Datenproben, die die Edge Agent-Software sammelt und in die Cloud überträgt, wenn das Datenerfassungsschema aufgerufen wird.
+ (Optional) `minimumSamplingIntervalMs` — die Mindestdauer zwischen zwei Datenprobenerfassungsereignissen in Millisekunden. Wenn sich ein Signal häufig ändert, können Sie diesen Parameter verwenden, um Daten langsamer zu sammeln.
Gültiger Bereich: 0‐4294967295
(Optional) `spoolingMode`
Wenn dies konfiguriert `spoolingMode` ist`TO_DISK`, speichert die Edge Agent-Software vorübergehend Daten lokal, wenn ein Fahrzeug nicht mit der Cloud verbunden ist. Nachdem die Verbindung wiederhergestellt wurde, werden die lokal gespeicherten Daten automatisch in die Cloud übertragen.
Standardwert: `OFF`
(Optional) `startTime`
Eine genehmigte Kampagne wird zum Startzeitpunkt aktiviert.
Standardwert: `0`
Der Status einer Kampagne kann einer der folgenden Werte sein.
+ `CREATING`— AWS IoT FleetWise bearbeitet Ihre Anfrage zur Erstellung der Kampagne.
+ `WAITING_FOR_APPROVAL`— Nachdem eine Kampagne erstellt wurde, geht sie in den `WAITING_FOR_APPROVAL` Status über. Verwenden Sie den `UpdateCampaign` API-Vorgang, um die Kampagne zu genehmigen. Nachdem die Kampagne genehmigt wurde, stellt AWS IoT die Kampagne FleetWise automatisch für das Zielfahrzeug oder die Zielflotte bereit. Weitere Informationen finden Sie unter [Aktualisieren Sie eine AWS FleetWise IoT-Kampagne](update-campaign-cli.md).
+ `RUNNING `— Die Kampagne ist aktiv.
+ `SUSPENDED`— Die Kampagne ist ausgesetzt. Verwenden Sie den `UpdateCampaign` API-Vorgang, um die Kampagne fortzusetzen.
AWS IoT FleetWise bietet die folgenden API-Operationen, mit denen Sie Kampagnen erstellen und verwalten können.
+ [CreateCampaign](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_CreateCampaign.html)— Erstellt eine neue Kampagne.
+ [UpdateCampaign](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_UpdateCampaign.html)— Aktualisiert eine bestehende Kampagne. Nachdem eine Kampagne erstellt wurde, müssen Sie diese API-Operation verwenden, um die Kampagne zu genehmigen.
+ [DeleteCampaign](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_DeleteCampaign.html)— Löscht eine bestehende Kampagne.
+ [ListCampaigns](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_ListCampaigns.html)— Ruft eine paginierte Liste mit Zusammenfassungen für alle Kampagnen ab.
+ [GetCampaign](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_GetCampaign.html)— Ruft Informationen über eine Kampagne ab.
**Topics**
+ [Erstellen Sie eine AWS FleetWise IoT-Kampagne](create-campaign.md)
+ [Aktualisieren Sie eine AWS FleetWise IoT-Kampagne](update-campaign-cli.md)
+ [Eine AWS FleetWise IoT-Kampagne löschen](delete-campaign.md)
+ [Informationen zu AWS FleetWise IoT-Kampagnen abrufen](get-campaign-information-cli.md)
+ [Kampagnendaten speichern und weiterleiten](store-and-forward.md)
+ [Sammeln Sie diagnostische Fehlercode-Daten mithilfe von AWS IoT FleetWise](diagnostic-trouble-codes.md)
+ [Visualisieren Sie AWS FleetWise IoT-Fahrzeugdaten](process-visualize-data.md)
# Erstellen Sie eine AWS FleetWise IoT-Kampagne
**Wichtig**
Der Zugriff auf bestimmte AWS FleetWise IoT-Funktionen ist derzeit gesperrt. Weitere Informationen finden Sie unter [AWS Verfügbarkeit von Regionen und Funktionen im AWS Internet der Dinge FleetWise](fleetwise-regions.md).
Sie können die AWS FleetWise IoT-Konsole oder API verwenden, um Kampagnen zur Erfassung von Fahrzeugdaten zu erstellen.
**Wichtig**
Damit Ihre Kampagne funktioniert, müssen Sie über Folgendes verfügen:
Die Edge Agent-Software wird in Ihrem Fahrzeug ausgeführt. Gehen Sie wie folgt vor, um weitere Informationen zur Entwicklung, Installation und Arbeit mit der Edge Agent-Software zu erhalten:
Öffnen Sie die [AWS FleetWise IoT-Konsole](https://console.aws.amazon.com/iotfleetwise).
Wählen Sie auf der Service-Startseite im FleetWise Abschnitt **Erste Schritte mit AWS IoT** die Option **Explore Edge Agent** aus.
Sie haben die Einrichtung AWS IoT Core für die Bereitstellung Ihres Fahrzeugs eingerichtet. Weitere Informationen finden Sie unter [Bereitstellung von AWS FleetWise IoT-Fahrzeugen](provision-vehicles.md).
**Topics**
+ [Erstellen Sie eine Kampagne (Konsole)](#create-campaign-console)
+ [Erstelle eine Kampagne (AWS CLI)](#create-campaign-cli)
+ [Logische Ausdrücke für AWS FleetWise IoT-Kampagnen](logical-expression.md)
## Erstellen Sie eine Kampagne (Konsole)
Verwenden Sie die AWS FleetWise IoT-Konsole, um eine Kampagne zur Auswahl, Erfassung und Übertragung von Fahrzeugdaten in die Cloud zu erstellen.
**So erstellen Sie eine Kampagne**
1. Öffnen Sie die [AWS FleetWise IoT-Konsole](https://console.aws.amazon.com/iotfleetwise).
1. Wählen Sie im Navigationsbereich **Kampagnen** aus.
1. Wählen Sie auf der Seite **Kampagnen** die Option **Kampagne erstellen** aus, und führen Sie dann die Schritte in den folgenden Themen aus.
**Topics**
+ [Schritt 1: Kampagne konfigurieren](#configure-campaign-console)
+ [Schritt 2: Geben Sie die Speicher- und Upload-Bedingungen an](#specify-storage-upload-conditions)
+ [Schritt 3: Datenziel konfigurieren](#configure-data-collection-scheme-console)
+ [Schritt 4: Fahrzeuge hinzufügen](#add-attributes-console)
+ [Schritt 5: Überprüfen und Erstellen](#review-and-create-campaign-console)
+ [Schritt 6: Implementieren Sie eine Kampagne](#update-campaign-console)
**Wichtig**
Sie benötigen einen Signalkatalog und ein Fahrzeug, bevor Sie eine Kampagne erstellen können. Weitere Informationen erhalten Sie unter [AWS FleetWise IoT-Signalkataloge verwalten](signal-catalogs.md) und [AWS FleetWise IoT-Fahrzeuge verwalten](vehicles.md).
Nachdem eine Kampagne erstellt wurde, müssen Sie die Kampagne genehmigen. Weitere Informationen finden Sie unter [Aktualisieren Sie eine AWS FleetWise IoT-Kampagne](update-campaign-cli.md).
### Schritt 1: Kampagne konfigurieren
Gehen Sie **unter Allgemeine Informationen** wie folgt vor:
1. Geben Sie einen Namen für die Kampagne ein.
1. (Optional) Geben Sie eine Beschreibung ein.
Konfigurieren Sie das Datenerfassungsschema der Kampagne. Ein Datenerfassungsschema gibt der Edge Agent-Software Anweisungen darüber, welche Daten gesammelt werden sollen oder wann sie gesammelt werden sollen. In der AWS FleetWise IoT-Konsole können Sie ein Datenerfassungsschema auf folgende Weise konfigurieren:
+ Definieren Sie das Datenerfassungsschema manuell.
+ Laden Sie eine Datei hoch, um das Datenerfassungsschema automatisch zu definieren.
Wählen Sie **unter Konfigurationsoption** eine der folgenden Optionen aus:
+ Um den Typ des Datenerfassungsschemas manuell anzugeben und Optionen zur Anpassung des Schemas zu definieren, wählen Sie **Datenerfassungsschema definieren** aus.
#### Definieren Sie das Datenerfassungsschema manuell
Geben Sie manuell den Typ des Datenerfassungsschemas an und definieren Sie Optionen zur Anpassung des Schemas.
1. Wählen Sie im Abschnitt **Details zum Datenerfassungsschema** die Art des Datenerfassungsschemas aus, das für diese Kampagne verwendet werden soll. Wenn Sie anhand eines logischen Ausdrucks erkennen möchten, welche Fahrzeugdaten erfasst werden sollen, wählen Sie „**Zustandsbasiert**“. Wenn Sie anhand eines bestimmten Zeitraums entscheiden möchten, wie oft Fahrzeugdaten erfasst werden sollen, wählen Sie **Zeitbasiert**.
1. Definieren Sie die Dauer, für die die Kampagne Daten sammelt.
**Anmerkung**
Standardmäßig wird eine genehmigte Kampagne sofort aktiviert und hat keine festgelegte Endzeit. Um zusätzliche Gebühren zu vermeiden, müssen Sie einen Zeitraum angeben.
1. Wenn Sie ein auf Bedingungen basierendes Datenerfassungsschema angegeben haben, müssen Sie einen logischen Ausdruck definieren, um zu erkennen, welche Daten gesammelt werden sollen. AWS IoT FleetWise verwendet einen logischen Ausdruck, um zu erkennen, welche Daten für ein zustandsorientiertes Schema gesammelt werden müssen. Der Ausdruck muss den vollständig qualifizierten Namen eines Signals als Variable, einen Vergleichsoperator und einen Vergleichswert angeben.
Wenn Sie beispielsweise den `$variable.`myVehicle.InVehicleTemperature` > 50.0` Ausdruck angeben, FleetWise erfasst AWS IoT Temperaturwerte, die größer als 50,0 sind. Anweisungen zum Schreiben von Ausdrücken finden Sie unter[Logische Ausdrücke für AWS FleetWise IoT-Kampagnen](logical-expression.md).
Geben Sie den logischen Ausdruck ein, anhand dessen erkannt wird, welche Daten erfasst werden sollen.
1. (Optional) Geben Sie die Sprachversion des bedingten Ausdrucks an. Der Standardwert ist 1.
1. (Optional) Geben Sie das minimale Triggerintervall an. Dabei handelt es sich um die kleinste Zeitspanne zwischen zwei Datenerfassungsereignissen. Wenn sich ein Signal beispielsweise häufig ändert, möchten Sie möglicherweise Daten langsamer erfassen.
1. Geben Sie die Bedingung für den **Triggermodus** an, unter der die Edge Agent-Software Daten sammelt. Standardmäßig sammelt die Edge Agent for AWS FleetWise IoT-Software **immer** dann Daten, wenn die Bedingung erfüllt ist. Oder er kann nur Daten sammeln, wenn die Bedingung zum ersten Mal erfüllt ist (**beim ersten Trigger**).
1. Wenn Sie ein zeitbasiertes Datenerfassungsschema angegeben haben, müssen Sie einen **Zeitraum** in Millisekunden zwischen 10.000 und 60.000 Millisekunden angeben. Die Edge-Agent-Software entscheidet dann unter Berücksichtigung des Zeitraums, wie oft Daten erfasst werden sollen.
1. **(Optional) Bearbeiten Sie die erweiterten Schemaoptionen des Schemas.**
1. Um drahtlose Bandbreite zu sparen und den Netzwerkverkehr durch Komprimieren von Daten zu reduzieren, wählen Sie **Snappy**.
1. (Optional) Um zu definieren, wie lange (in Millisekunden) die Datenerfassung nach einem Datenerfassungsereignis fortgesetzt werden soll, können Sie die Dauer der Erfassung nach dem Trigger angeben**.**
1. **(Optional) Um die Prioritätsstufe der Kampagne anzugeben, geben Sie die Kampagnenpriorität an.** Kampagnen mit einer kleineren Prioritätsnummer werden zuerst bereitgestellt und haben dann eine höhere Priorität.
1. Die Edge Agent-Software kann Daten vorübergehend lokal speichern, wenn ein Fahrzeug nicht mit der Cloud verbunden ist. Nachdem die Verbindung wiederhergestellt wurde, werden die lokal gespeicherten Daten automatisch in die Cloud übertragen. Geben Sie an, ob der Edge-Agent **Daten während einer unterbrochenen Verbindung lokal speichern** soll.
1. (Optional) Um zusätzliche Informationen für ein Signal bereitzustellen, fügen Sie bis zu fünf Attribute als **Zusätzliche Datendimensionen** hinzu.
+ Um eine Datei zur Definition des Datenerfassungsschemas **hochzuladen, wählen Sie „.json-Datei von Ihrem lokalen Gerät** hochladen“. AWS IoT definiert FleetWise automatisch, welche Optionen Sie in der Datei definieren können. Sie können die ausgewählten Optionen überprüfen und aktualisieren.
#### Importieren Sie eine Datei, um das Datenerfassungsschema zu definieren
Laden Sie eine JSON-Datei mit Details zum Datenerfassungsschema hoch.
1. Um Informationen über das Datenerfassungsschema zu importieren, wählen Sie **Dateien auswählen**. Weitere Informationen zum erforderlichen Dateiformat finden Sie in der [CreateCampaign](https://docs.aws.amazon.com//iot-fleetwise/latest/APIReference/API_CreateCampaign.html#API_CreateCampaign)API-Dokumentation.
**Anmerkung**
AWS IoT unterstützt FleetWise derzeit die Dateiformaterweiterung „.json“.
1. AWS IoT definiert das Datenerfassungsschema FleetWise automatisch auf der Grundlage der Informationen in Ihrer Datei. Sehen Sie sich die Optionen an, die AWS IoT für Sie FleetWise ausgewählt hat. Sie können die Optionen bei Bedarf aktualisieren.
### Schritt 2: Geben Sie die Speicher- und Upload-Bedingungen an
Um auszuwählen, ob die Edge Agent-Software Daten vorübergehend lokal speichert, wenn ein Fahrzeug nicht mit der Cloud verbunden ist, geben Sie den Spooling-Modus an.
+ Wählen Sie im **Datenspooling-Modus** eine der folgenden Optionen:
+ **Nicht gespeichert** — Die Edge Agent-Software sammelt Daten, speichert sie aber nicht vorübergehend lokal, wenn ein Fahrzeug offline ist. Die Edge Agent-Software überträgt Daten in die Cloud, wenn das Fahrzeug wieder eine Verbindung herstellt.
+ Auf **Festplatte gespeichert** — Die Edge Agent-Software sammelt Daten und speichert sie vorübergehend lokal, wenn ein Fahrzeug offline ist. Die gesammelten Daten werden vorübergehend an einem Ort gespeichert, der im Abschnitt „Persistenz“ der Edge-Agent-Konfigurationsdatei definiert ist. Der Edge-Agent überträgt Daten in die Cloud, wenn das Fahrzeug wieder eine Verbindung herstellt.
+ **Mit Partitionen auf Festplatte gespeichert** — Das Fahrzeug speichert Daten immer vorübergehend auf dem Edge in der von Ihnen angegebenen Datenpartition. Sie können wählen, wann Sie Ihre gespeicherten Daten an die Cloud weiterleiten möchten.
1. (Optional) Geben Sie eine Partitions-ID ein, um einen bestimmten Datensatz zu kennzeichnen.
1. Geben Sie einen Ordnernamen als Speicherort für die Daten ein. Der absolute Pfad des Speicherorts lautet`{persistency_path} / {vehicle_name} / {campaign_name} / {storage_location}`.
1. Geben Sie die maximale Speichergröße der in der Partition gespeicherten Daten ein. Neuere Daten überschreiben ältere Daten, wenn die Partition die maximale Größe erreicht.
1. Geben Sie die Mindestdauer ein, für die Daten in dieser Partition auf der Festplatte gespeichert werden.
1. (Optional) Geben Sie die Upload-Bedingungen für die Partition ein.
#### Geben Sie Signale an
Sie können die Signale angeben, aus denen während der Kampagne Daten gesammelt werden sollen.
**Um die Signale zu spezifizieren, von denen Daten gesammelt werden sollen**
1. Wählen Sie den **Signalnamen** aus.
1. (Optional) Geben Sie für **Max. Stichprobenanzahl** die maximale Anzahl von Datenproben ein, die die Edge Agent-Software während der Kampagne sammelt und in die Cloud überträgt.
1. (Optional) Geben Sie für **Min. Stichprobenintervall** die Mindestdauer zwischen zwei Datenprobenerfassungsereignissen in Millisekunden ein. Wenn sich ein Signal häufig ändert, können Sie diesen Parameter verwenden, um Daten langsamer zu sammeln.
1. Um ein weiteres Signal hinzuzufügen, wählen **Sie Weitere Signale hinzufügen**. Sie können bis zu 999 Signale hinzufügen.
1. Wählen Sie **Weiter** aus.
### Schritt 3: Datenziel konfigurieren
**Anmerkung**
Wenn die Kampagne Datensignale des Bildverarbeitungssystems enthält, können Sie die Fahrzeugdaten nur in Amazon S3 speichern. Sie können es nicht in Timestream speichern oder an ein MQTT-Thema senden.
Die Daten des Bildverarbeitungssystems befinden sich in der Vorschauversion und können sich ändern.
Amazon Timestream ist in der Region Asien-Pazifik (Mumbai) nicht verfügbar.
Wählen Sie das Ziel aus, an das Sie die im Rahmen der Kampagne gesammelten Daten senden oder speichern möchten. Sie können Fahrzeugdaten an ein MQTT-Thema senden oder sie in Amazon S3 oder Amazon Timestream speichern.
Gehen Sie in **den Zieleinstellungen** wie folgt vor:
+ Wählen Sie Amazon S3, Amazon Timestream oder MQTT-Thema aus der Drop-down-Liste aus.
#### Amazon S3
**Wichtig**
Sie können Daten nur an S3 übertragen, wenn AWS IoT FleetWise über Schreibberechtigungen in den S3-Bucket verfügt. Weitere Informationen zur Zugriffsgewährung finden Sie unter [Zugriffskontrolle mit AWS IoT FleetWise](https://docs.aws.amazon.com/iot-fleetwise/latest/developerguide/controlling-access.html).
Um Fahrzeugdaten in einem S3-Bucket zu speichern, wählen Sie **Amazon S3**. S3 ist ein Objektspeicherdienst, der Daten als Objekte in Buckets speichert. Weitere Informationen finden Sie unter [Erstellen, Konfigurieren und Arbeiten mit Amazon S3 S3-Buckets](https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-buckets-s3.html) im *Amazon Simple Storage Service-Benutzerhandbuch*.
S3 optimiert die Kosten für die Datenspeicherung und bietet zusätzliche Mechanismen zur Nutzung von Fahrzeugdaten, z. B. Data Lakes, zentrale Datenspeicherung, Datenverarbeitungspipelines und Analysen. Sie können S3 verwenden, um Daten für die Stapelverarbeitung und Analyse zu speichern. Sie können beispielsweise Berichte über Ereignisse mit starker Bremsung für Ihr Modell für maschinelles Lernen (ML) erstellen. Eingehende Fahrzeugdaten werden vor der Auslieferung für 10 Minuten zwischengespeichert.
Gehen Sie in den **S3-Zieleinstellungen** wie folgt vor:
1. Wählen Sie für den **S3-Bucket** einen Bucket aus, der AWS IoT FleetWise über Berechtigungen für verfügt.
1. (Optional) Geben Sie ein benutzerdefiniertes Präfix ein, mit dem Sie die im S3-Bucket gespeicherten Daten organisieren können.
1. Wählen Sie das Ausgabeformat aus. Dabei handelt es sich um die Formatdateien, die wie im S3-Bucket gespeichert werden.
1. Wählen Sie aus, ob Sie die im S3-Bucket gespeicherten Daten als .gzip-Datei komprimieren möchten. Wir empfehlen die Komprimierung von Daten, da dadurch die Speicherkosten minimiert werden.
1. Die Optionen, die Sie in den **S3-Zieleinstellungen** auswählen, ändern den **Beispiel-S3-Objekt-URI**. Dies ist ein Beispiel dafür, wie Dateien in S3 gespeichert werden.
#### Amazon Timestream
**Wichtig**
Sie können Daten nur in eine Tabelle übertragen, wenn AWS IoT berechtigt FleetWise ist, Daten in Timestream zu schreiben. Weitere Informationen zur Zugriffsgewährung finden Sie unter [Zugriffskontrolle mit AWS IoT FleetWise](https://docs.aws.amazon.com/iot-fleetwise/latest/developerguide/controlling-access.html).
Amazon Timestream ist in der Region Asien-Pazifik (Mumbai) nicht verfügbar.
Um Fahrzeugdaten in einer Timestream-Tabelle zu speichern, wählen Sie **Amazon Timestream**. Sie können Timestream verwenden, um Fahrzeugdaten abzufragen, um Trends und Muster zu erkennen. Sie können Timestream beispielsweise verwenden, um einen Alarm für den Kraftstoffstand des Fahrzeugs zu erstellen. Eingehende Fahrzeugdaten werden nahezu in Echtzeit an Timestream übertragen. Weitere Informationen finden Sie unter [Was ist Amazon Timestream](https://docs.aws.amazon.com/timestream/latest/developerguide/what-is-timestream.html)? im *Amazon Timestream Developer Guide*.
Gehen Sie in den **Timestream-Tabelleneinstellungen** wie folgt vor:
1. Wählen Sie als **Timestream-Datenbankname** den Namen Ihrer Timestream-Datenbank aus der Dropdownliste aus.
1. Wählen Sie als **Timestream-Tabellenname** den Namen Ihrer Timestream-Tabelle aus der Drop-down-Liste aus.
Gehen Sie unter **Servicezugriff für Timestream** wie folgt vor:
+ Wählen Sie in der Dropdown-Liste eine IAM-Rolle aus.
#### MQTT-Thema
**Wichtig**
Sie können Daten nur an ein MQTT-Thema weiterleiten, wenn AWS IoT FleetWise über Berechtigungen für AWS IoT Themen verfügt. Weitere Informationen zur Zugriffsgewährung finden Sie unter [Zugriffskontrolle mit AWS IoT FleetWise](https://docs.aws.amazon.com/iot-fleetwise/latest/developerguide/controlling-access.html).
Um Fahrzeugdaten an ein MQTT-Thema zu senden, wählen Sie **MQTT-Thema**.
Fahrzeugdaten, die über MQTT-Messaging gesendet werden, werden nahezu in Echtzeit übermittelt und ermöglichen es Ihnen, Regeln zu verwenden, um Maßnahmen zu ergreifen oder Daten an andere Ziele weiterzuleiten. Weitere Informationen zur Verwendung von MQTT finden Sie unter [Gerätekommunikationsprotokolle](https://docs.aws.amazon.com/iot/latest/developerguide/protocols.html) und [Regeln für AWS IoT](https://docs.aws.amazon.com/iot/latest/developerguide/iot-rules.html) im *AWS IoT Core Entwicklerhandbuch*.
1. Geben Sie unter **MQTT-Thema** den Namen des **Themas** ein.
1. Wählen Sie unter dem **Thema Dienstzugriff für MQTT** aus, ob Sie AWS IoT **eine neue Servicerolle für Sie FleetWise erstellen und verwenden** lassen möchten. Wenn Sie **eine bestehende Servicerolle verwenden** möchten, wählen Sie die Rolle in der Dropdownliste unter Rolle **auswählen aus**.
+ Wählen Sie **Weiter** aus.
### Schritt 4: Fahrzeuge hinzufügen
Um auszuwählen, für welche Fahrzeuge deine Kampagne eingesetzt werden soll, wähle sie in der Fahrzeugliste aus. Filtern Sie Fahrzeuge, indem Sie nach den Attributen und ihren Werten suchen, die Sie bei der Erstellung der Fahrzeuge hinzugefügt haben, oder nach Fahrzeugnamen.
Gehen Sie **unter Fahrzeuge filtern** wie folgt vor:
1. Suchen Sie im Suchfeld das Attribut oder den Fahrzeugnamen und wählen Sie es aus der Liste aus.
**Anmerkung**
Jedes Attribut kann nur einmal verwendet werden.
1. Geben Sie den Wert des Attributs oder den Fahrzeugnamen ein, für das Sie die Kampagne bereitstellen möchten. Wenn der vollqualifizierte Name des Attributs beispielsweise lautet`fuelType`, geben Sie `gasoline` als Wert ein.
1. Um nach einem anderen Fahrzeugattribut zu suchen, wiederholen Sie die vorherigen Schritte. Sie können nach bis zu fünf Fahrzeugattributen und einer unbegrenzten Anzahl von Fahrzeugnamen suchen.
1. Fahrzeuge, die Ihrer Suche entsprechen, werden unter **Fahrzeugname** aufgeführt. Wählen Sie die Fahrzeuge aus, für die Sie die Kampagne einsetzen möchten.
**Anmerkung**
In den Suchergebnissen werden bis zu 100 Fahrzeuge angezeigt. **Wählen Sie Alle auswählen**, um alle Fahrzeuge zur Kampagne hinzuzufügen.
1. Wählen Sie **Weiter** aus.
### Schritt 5: Überprüfen und Erstellen
Überprüfen Sie die Konfigurationen für die Kampagne und wählen Sie dann **Kampagne erstellen** aus.
**Anmerkung**
Nachdem eine Kampagne erstellt wurde, müssen Sie oder Ihr Team die Kampagne für Fahrzeuge bereitstellen.
### Schritt 6: Implementieren Sie eine Kampagne
Nachdem Sie eine Kampagne erstellt haben, müssen Sie oder Ihr Team die Kampagne in Fahrzeugen einsetzen.
**Um eine Kampagne zu implementieren**
1. Wählen Sie auf der Seite mit der **Kampagnenübersicht** die Option **Bereitstellen** aus.
1. Überprüfe und bestätige, dass du mit der Bereitstellung beginnen und mit der Erfassung von Daten von Fahrzeugen beginnen möchtest, die mit der Kampagne verbunden sind.
1. Wählen Sie **Bereitstellen**.
Wenn Sie die Erfassung von Daten von Fahrzeugen, die mit der Kampagne verbunden sind, unterbrechen möchten, wählen Sie auf der Seite mit der **Kampagnenübersicht** die Option **Sperren** aus. Um die Erfassung von Daten von Fahrzeugen fortzusetzen, die mit der Kampagne verbunden sind, wähle **Fortfahren**.
## Erstelle eine Kampagne (AWS CLI)
Sie können den [CreateCampaign](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_CreateCampaign.html)API-Vorgang verwenden, um eine Kampagne zu erstellen. Das folgende Beispiel verwendet die AWS CLI.
Wenn Sie eine Kampagne erstellen, können von Fahrzeugen gesammelte Daten an ein MQTT-Thema gesendet oder entweder in Amazon S3 (S3) oder Amazon Timestream gespeichert werden. Wählen Sie Timestream für eine schnelle, skalierbare und serverlose Zeitreihendatenbank, z. B. zum Speichern von Daten, die nahezu in Echtzeit verarbeitet werden müssen. Wählen Sie S3 als Objektspeicher mit branchenführender Skalierbarkeit, Datenverfügbarkeit, Sicherheit und Leistung. Wählen Sie MQTT, um Daten nahezu in Echtzeit bereitzustellen und [Regeln zu verwenden AWS IoT, um](https://docs.aws.amazon.com/iot/latest/developerguide/iot-rules.html) von Ihnen definierte Aktionen auszuführen oder die Daten an andere Ziele weiterzuleiten.
**Wichtig**
Sie können Fahrzeugdaten nur an ein MQTT-Thema, Amazon S3 oder Amazon Timestream übertragen, wenn AWS IoT berechtigt FleetWise ist, MQTT-Nachrichten in Ihrem Namen zu senden oder Daten in S3 oder Timestream zu schreiben. Weitere Informationen zur Zugriffsgewährung finden Sie unter [Zugriffskontrolle mit AWS IoT FleetWise](https://docs.aws.amazon.com/iot-fleetwise/latest/developerguide/controlling-access.html).
Amazon Timestream ist in der Region Asien-Pazifik (Mumbai) nicht verfügbar.
### Kampagne erstellen
**Wichtig**
Sie benötigen einen Signalkatalog und ein Fahrzeug oder eine Flotte, bevor Sie eine Kampagne erstellen können. Weitere Informationen finden Sie unter [AWS FleetWise IoT-Signalkataloge verwalten](signal-catalogs.md), [AWS FleetWise IoT-Fahrzeuge verwalten](vehicles.md) und [Flotten im AWS IoT verwalten FleetWise](fleets.md).
Nachdem eine Kampagne erstellt wurde, müssen Sie den `UpdateCampaign` API-Vorgang verwenden, um die Kampagne zu genehmigen. Weitere Informationen finden Sie unter [Aktualisieren Sie eine AWS FleetWise IoT-Kampagne](update-campaign-cli.md).
Führen Sie den folgenden Befehl aus, um eine Kampagne zu erstellen.
*file-name*Ersetzen Sie ihn durch den Namen der JSON-Datei, die die Kampagnenkonfiguration enthält.
```
aws iotfleetwise create-campaign --cli-input-json file://file-name.json
```
#### Beispielkonfigurationsdatei für S3
+ Ersetze es *campaign-name* durch den Namen der Kampagne, die du gerade erstellst.
+ *signal-catalog-arn*Ersetzen Sie durch den Amazon-Ressourcennamen (ARN) des Signalkatalogs.
+ *target-arn*Ersetzen Sie es durch den ARN einer Flotte oder eines Fahrzeugs, das Sie erstellt haben.
+ *bucket-arn*Ersetzen Sie es durch den ARN des S3-Buckets.
```
{
"name": "campaign-name",
"targetArn": "target-arn",
"signalCatalogArn": "signal-catalog-arn",
"collectionScheme": {
"conditionBasedCollectionScheme": {
"conditionLanguageVersion": 1,
"expression": "$variable.`Vehicle.DemoBrakePedalPressure` > 7000",
"minimumTriggerIntervalMs": 1000,
"triggerMode": "ALWAYS"
}
},
"compression": "SNAPPY",
"diagnosticsMode": "OFF",
"postTriggerCollectionDuration": 1000,
"priority": 0,
"signalsToCollect": [
{
"maxSampleCount": 100,
"minimumSamplingIntervalMs": 0,
"name": "Vehicle.DemoEngineTorque"
},
{
"maxSampleCount": 100,
"minimumSamplingIntervalMs": 0,
"name": "Vehicle.DemoBrakePedalPressure"
}
],
"spoolingMode": "TO_DISK",
"dataDestinationConfigs": [
{
"s3Config": {
"bucketArn": "bucket-arn",
"dataFormat": "PARQUET",
"prefix": "campaign-name",
"storageCompressionFormat": "GZIP"
}
}
],
"dataPartitions": [
{ ... }
]
}
```
#### Beispielkonfigurationsdatei für Timestream
**Anmerkung**
Amazon Timestream ist in der Region Asien-Pazifik (Mumbai) nicht verfügbar.
+ *campaign-name*Ersetzen Sie es durch den Namen der Kampagne, die Sie erstellen.
+ Durch *signal-catalog-arn* den ARN des Signalkatalogs ersetzen.
+ *target-arn*Ersetzen Sie es durch den ARN einer Flotte oder eines Fahrzeugs, das Sie erstellt haben.
+ *role-arn*Ersetzen Sie es durch den ARN der Aufgabenausführungsrolle, die AWS FleetWise IoT-Berechtigungen zur Übermittlung von Daten an die Timestream-Tabelle erteilt.
+ *table-arn*Ersetzen Sie durch den ARN der Timestream-Tabelle.
```
{
"name": "campaign-name",
"targetArn": "target-arn",
"signalCatalogArn": "signal-catalog-arn",
"collectionScheme": {
"conditionBasedCollectionScheme": {
"conditionLanguageVersion": 1,
"expression": "$variable.`Vehicle.DemoBrakePedalPressure` > 7000",
"minimumTriggerIntervalMs": 1000,
"triggerMode": "ALWAYS"
}
},
"compression": "SNAPPY",
"diagnosticsMode": "OFF",
"postTriggerCollectionDuration": 1000,
"priority": 0,
"signalsToCollect": [
{
"maxSampleCount": 100,
"minimumSamplingIntervalMs": 0,
"name": "Vehicle.DemoEngineTorque"
},
{
"maxSampleCount": 100,
"minimumSamplingIntervalMs": 0,
"name": "Vehicle.DemoBrakePedalPressure"
}
],
"spoolingMode": "TO_DISK",
"dataDestinationConfigs": [
{
"timestreamConfig": {
"executionRoleArn": "role-arn",
"timestreamTableArn": "table-arn"
}
}
],
"dataPartitions": [
{ ... }
]
}
```
#### Beispielkonfigurationsdatei für ein MQTT-Thema
+ Ersetze es *campaign-name* durch den Namen der Kampagne, die du gerade erstellst.
+ *signal-catalog-arn*Ersetzen Sie durch den Amazon-Ressourcennamen (ARN) des Signalkatalogs.
+ *target-arn*Ersetzen Sie es durch den ARN einer Flotte oder eines Fahrzeugs, das Sie erstellt haben.
+ *topic-arn*Ersetzen Sie es durch den ARN des [MQTT-Themas](https://docs.aws.amazon.com/iot/latest/developerguide/topics.html), das Sie als Ziel für Nachrichten mit Fahrzeugdaten angegeben haben.
+ *role-arn*Ersetzen Sie es durch den ARN der Aufgabenausführungsrolle, die AWS FleetWise IoT-Berechtigungen zum Senden, Empfangen und Ausführen von Aktionen für Nachrichten für das von Ihnen angegebene MQTT-Thema erteilt.
```
{
"name": "campaign-name",
"targetArn": "target-arn",
"signalCatalogArn": "signal-catalog-arn",
"collectionScheme": {
"conditionBasedCollectionScheme": {
"conditionLanguageVersion": 1,
"expression": "$variable.`Vehicle.DemoBrakePedalPressure` > 7000",
"minimumTriggerIntervalMs": 1000,
"triggerMode": "ALWAYS"
}
},
"compression": "SNAPPY",
"diagnosticsMode": "OFF",
"postTriggerCollectionDuration": 1000,
"priority": 0,
"signalsToCollect": [
{
"maxSampleCount": 100,
"minimumSamplingIntervalMs": 0,
"name": "Vehicle.DemoEngineTorque"
},
{
"maxSampleCount": 100,
"minimumSamplingIntervalMs": 0,
"name": "Vehicle.DemoBrakePedalPressure"
}
],
"spoolingMode": "TO_DISK",
"dataDestinationConfigs": [
{
"mqttTopicConfig": {
"mqttTopicArn": "topic-arn",
"executionRoleArn": "role-arn"
}
}
]
}
```
Wenn Sie die [Verschlüsselung mit einem vom Kunden verwalteten AWS KMS Schlüssel aktiviert](key-management.md) haben, fügen Sie die folgende Richtlinienerklärung bei, damit Ihre Rolle den `CreateCampaign` API-Vorgang aufrufen kann.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"kms:GenerateDataKey*",
"kms:Decrypt"
],
"Resource": [
"arn:aws:kms:us-east-1:111122223333:key/KMS_KEY_ID"
]
}
]
}
```
------
# Logische Ausdrücke für AWS FleetWise IoT-Kampagnen
AWS IoT FleetWise verwendet einen logischen Ausdruck, um zu erkennen, welche Daten im Rahmen einer Kampagne gesammelt werden sollen. Weitere Informationen zu Ausdrücken finden Sie unter [Ausdrücke](https://docs.aws.amazon.com/iotevents/latest/developerguide/iotevents-expressions.html) im *AWS IoT Events Entwicklerhandbuch*.
Die Ausdrucksvariable sollte so konstruiert sein, dass sie den Regeln für den Typ der gesammelten Daten entspricht. Bei Telemetriesystemdaten sollte die Ausdrucksvariable der vollständig qualifizierte Name des Signals sein. Bei Bildverarbeitungssystemdaten kombiniert der Ausdruck den vollständig qualifizierten Namen des Signals mit dem Pfad, der vom Datentyp des Signals zu einer seiner Eigenschaften führt.
Wenn der Signalkatalog beispielsweise die folgenden Knoten enthält:
```
{
myVehicle.ADAS.Camera:
type: sensor
datatype: Vehicle.ADAS.CameraStruct
description: "A camera sensor"
myVehicle.ADAS.CameraStruct:
type: struct
description: "An obstacle detection camera output struct"
}
```
Wenn die Knoten der ROS 2-Definition folgen:
```
{
Vehicle.ADAS.CameraStruct.msg:
boolean obstaclesExists
uint8[] image
Obstacle[30] obstacles
}
{
Vehicle.ADAS.Obstacle.msg:
float32: probability
uint8 o_type
float32: distance
}
```
Im Folgenden sind alle möglichen Variablen für Ereignisausdrücke aufgeführt:
```
{
...
$variable.`myVehicle.ADAS.Camera.obstaclesExists`
$variable.`myVehicle.ADAS.Camera.Obstacle[0].probability`
$variable.`myVehicle.ADAS.Camera.Obstacle[1].probability`
...
$variable.`myVehicle.ADAS.Camera.Obstacle[29].probability`
$variable.`myVehicle.ADAS.Camera.Obstacle[0].o_type`
$variable.`myVehicle.ADAS.Camera.Obstacle[1].o_type`
...
$variable.`myVehicle.ADAS.Camera.Obstacle[29].o_type`
$variable.`myVehicle.ADAS.Camera.Obstacle[0].distance`
$variable.`myVehicle.ADAS.Camera.Obstacle[1].distance`
...
$variable.`myVehicle.ADAS.Camera.Obstacle[29].distance`
}
```
# Aktualisieren Sie eine AWS FleetWise IoT-Kampagne
Sie können den [UpdateCampaign](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_UpdateCampaign.html)API-Vorgang verwenden, um eine bestehende Kampagne zu aktualisieren. Der folgende Befehl verwendet AWS CLI.
+ Ersetze es *campaign-name* durch den Namen der Kampagne, die du aktualisierst.
+ Ersetzen Sie *action* durch einen der folgenden Werte:
+ `APPROVE`— Genehmigt die Kampagne, damit das AWS IoT der Dinge FleetWise in einem Fahrzeug oder einer Flotte eingesetzt werden kann.
+ `SUSPEND`— Setzt die Kampagne aus. Die Kampagne wird aus den Fahrzeugen gelöscht und alle Fahrzeuge der ausgesetzten Kampagne senden keine Daten mehr.
+ `RESUME`— Reaktiviert die `SUSPEND` Kampagne. Die Kampagne ist so eingestellt, dass sie beim nächsten Check-in auf alle Fahrzeuge übertragen wird und die Fahrzeuge wieder Daten senden.
+ `UPDATE`— Aktualisiert die Kampagne, indem Attribute definiert und mit der Kampagne verknüpft werden.
+ *description*Durch eine neue Beschreibung ersetzen.
Die Beschreibung kann bis zu 2.048 Zeichen enthalten.
+ *data-extra-dimensions*Ersetzen Sie sie durch bestimmte Fahrzeugattribute, um die während der Kampagne gesammelten Daten zu erweitern. Sie können der Kampagne beispielsweise Fahrzeugmarke und -modell hinzufügen, und AWS IoT verknüpft FleetWise die Daten mit diesen Attributen als Dimensionen in Amazon Timestream. Anschließend können Sie die Daten anhand von Fahrzeugmarke und -modell abfragen.
```
aws iotfleetwise update-campaign \
--name campaign-name \
--action action \
--description description \
--data-extra-dimensions data-extra-dimensions
```
Wenn Sie die [Verschlüsselung mit einem vom Kunden verwalteten AWS KMS Schlüssel aktiviert](key-management.md) haben, fügen Sie die folgende Richtlinienerklärung bei, damit Ihre Rolle den `UpdateCampaign` API-Vorgang aufrufen kann.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"kms:GenerateDataKey*",
"kms:Decrypt"
],
"Resource": [
"arn:aws:kms:us-east-1:111122223333:key/KMS_KEY_ID"
]
}
]
}
```
------
# Eine AWS FleetWise IoT-Kampagne löschen
Sie können die AWS FleetWise IoT-Konsole oder API verwenden, um Kampagnen zu löschen.
## Löschen Sie eine Kampagne (Konsole)
Verwenden Sie die AWS FleetWise IoT-Konsole, um eine Kampagne zu löschen.
**Um eine Kampagne zu löschen**
1. Öffnen Sie die [AWS FleetWise IoT-Konsole](https://console.aws.amazon.com/iotfleetwise).
1. Wählen Sie im Navigationsbereich **Kampagnen** aus.
1. Wählen Sie auf der Seite **Kampagnen** die Zielkampagne aus.
1. Wählen Sie **Löschen** aus.
1. Unter **Löschen**campaign-name**?** , geben Sie den Namen der Kampagne ein, die gelöscht werden soll, und wählen Sie dann **Bestätigen**.
## Löschen Sie eine Kampagne (AWS CLI)
Sie können den [DeleteCampaign](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_DeleteCampaign.html)API-Vorgang verwenden, um eine Kampagne zu löschen. Das folgende Beispiel verwendet AWS CLI.
Führen Sie den folgenden Befehl aus, um eine Kampagne zu löschen.
*campaign-name*Ersetzen Sie es durch den Namen des Fahrzeugs, das Sie löschen möchten.
```
aws iotfleetwise delete-campaign --name campaign-name
```
**Gelöschte Datenpartitionen können nicht wiederhergestellt werden**
Durch das Löschen einer Kampagne werden alle Daten von Geräten entfernt, und die Daten in einer Partition werden nicht in die Cloud hochgeladen.
## Bestätigen Sie das Löschen der Kampagne
Sie können den [ListCampaigns](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_ListCampaigns.html)API-Vorgang verwenden, um zu überprüfen, ob eine Kampagne gelöscht wurde. Das folgende Beispiel verwendet die AWS CLI.
Führen Sie den folgenden Befehl aus, um eine paginierte Liste mit Zusammenfassungen für alle Kampagnen abzurufen.
```
aws iotfleetwise list-campaigns
```
# Informationen zu AWS FleetWise IoT-Kampagnen abrufen
Sie können den [GetCampaign](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_GetCampaign.html)API-Vorgang verwenden, um Fahrzeuginformationen abzurufen. Das folgende Beispiel verwendet die AWS CLI.
Führen Sie den folgenden Befehl aus, um die Metadaten einer Kampagne abzurufen.
*campaign-name*Ersetzen Sie es durch den Namen der Kampagne, die Sie abrufen möchten.
```
aws iotfleetwise get-campaign --name campaign-name
```
**Anmerkung**
Diese Operation ist [letztlich konsistent](https://web.stanford.edu/class/cs345d-01/rl/eventually-consistent.pdf). Mit anderen Worten, Änderungen an der Kampagne werden möglicherweise nicht sofort übernommen.
Wenn Sie die [Verschlüsselung mit einem vom Kunden verwalteten AWS KMS Schlüssel aktiviert](key-management.md) haben, fügen Sie die folgende Richtlinienerklärung bei, damit Ihre Rolle den `GetCampaign` API-Vorgang aufrufen kann.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"kms:Decrypt"
],
"Resource": [
"arn:aws:kms:us-east-1:111122223333:key/KMS_KEY_ID"
]
}
]
}
```
------
# Kampagnendaten speichern und weiterleiten
**Wichtig**
Der Zugriff auf bestimmte AWS FleetWise IoT-Funktionen ist derzeit gesperrt. Weitere Informationen finden Sie unter [AWS Verfügbarkeit von Regionen und Funktionen im AWS Internet der Dinge FleetWise](fleetwise-regions.md).
Verwenden Sie Datenpartitionen innerhalb von Kampagnen, um Signaldaten für Fahrzeuge und Flotten vorübergehend auf dem Edge zu speichern. Durch die Konfiguration von Upload- und Speicheroptionen für Datenpartitionen können Sie Ihre idealen Bedingungen für die Datenweiterleitung an Ihre angegebenen Datenziele (z. B. einen Amazon S3 S3-Bucket) optimieren. Sie können die Datenpartition beispielsweise so konfigurieren, dass Daten auf einem Fahrzeug gespeichert werden, bis es eine Wi-Fi-Verbindung herstellt. Sobald das Fahrzeug eine Verbindung hergestellt hat, löst die Kampagne aus, dass die Daten in dieser bestimmten Partition an die Cloud gesendet werden. Alternativ können Sie Daten mithilfe von AWS IoT Jobs sammeln.
**Topics**
+ [Erstellen Sie Datenpartitionen](create-campaign-data-partitions.md)
+ [Laden Sie Kampagnendaten hoch](update-campaign-cli-data-partitions.md)
+ [Laden Sie Daten mithilfe von AWS IoT Jobs hoch](update-campaign-cli-data-partitions-jobs.md)
# Erstellen Sie Datenpartitionen
**Wichtig**
Der Zugriff auf bestimmte AWS FleetWise IoT-Funktionen ist derzeit gesperrt. Weitere Informationen finden Sie unter [AWS Verfügbarkeit von Regionen und Funktionen im AWS Internet der Dinge FleetWise](fleetwise-regions.md).
Eine Datenpartition in einer Kampagne speichert vorübergehend Signaldaten. Sie konfigurieren, wann und wie die Daten an die Cloud weitergeleitet werden sollen.
Bei einer Datenpartition wird zunächst ein bestimmter Datensatz anhand der `dataPartitionId` für eine Kampagne verwendet. Anschließend können Sie weitere Speicheroptionen für Partitionen definieren, z. B. die maximale Größe, die Mindestdauer für die Aktualisierung der Datenpartition (auf der Festplatte) und den Speicherort der Daten auf dem Edge. Sie können den Speicherort im Fahrzeug mithilfe von ermitteln`storageLocation`. Der Speicherort bestimmt den Ordnernamen für die Datenpartition unter dem Kampagnen-Speicherordner. Der Kampagnen-Speicherordner befindet sich in einem Ordner, der nach dem Fahrzeugnamen benannt ist, unter einem Persistenzpfad, der in der Edge-Konfigurationsdatei definiert ist. Dies ist der absolute Pfad des Speicherorts:. `{persistency_path} / {vehicle_name} / {campaign_name} / {storage_location}`
Der auf eingestellte Spooling-Modus `TO_DISK` gibt an, dass die partitionierten Daten auf einer Festplatte im Fahrzeug gespeichert werden sollen. Die Datenspeicherung für Datenpartitionen erfolgt auf FIFO-Basis (First In, First Out). Wenn Sie eine Kampagne löschen, löschen Sie auch die Daten in der zugehörigen Datenpartition. Wenn Sie keine Datenpartition für on/off Konnektivitätsanwendungsfälle angeben, speichert AWS IoT FleetWise dennoch Daten in einem Ringpuffer auf dem Fahrzeug, wenn keine Konnektivität besteht. Wenn die Konnektivität wieder hergestellt wird, FleetWise lädt AWS IoT die Daten in die Cloud hoch. Dieses Verhalten ist in der Edge Agent for AWS FleetWise IoT-Software konfigurierbar.
**Wichtig**
Wenn Ihre Datenpartition das festgelegte maximale Speicherlimit überschreitet, überschreiben neuere Daten ältere Daten, wenn die Partition die maximale Größe erreicht. Verlorene Daten auf dem Edge können nicht wiederhergestellt werden. Die Speichergröße wird durch Ihr Edge-Speicherlimit bestimmt.
Wenn Daten in die Cloud hochgeladen werden, können sie nach Ablauf der Mindestzeit entfernt werden. Stellen Sie die Mindestlebensdauer entsprechend ein, um ein unbeabsichtigtes Löschen zu vermeiden.
Die Upload-Optionen bestimmen die Variablenausdrücke und die Sprache der Bedingungen. Wenn Upload-Optionen angegeben sind, müssen Sie auch Speicheroptionen angeben. Sie können auch verlangen, dass Signale in Datenpartitionen in die Cloud hochgeladen werden. Weitere Informationen finden Sie unter [Laden Sie Kampagnendaten hoch](update-campaign-cli-data-partitions.md).
Nachdem die Bedingungen für die Datenpartition definiert wurden`signalsToCollect`, können Sie festlegen, welche Signale in der Datenpartition berücksichtigt werden sollen. Sie können entweder IDs Datenpartitionen angeben oder `dataPartitionId` auf `default` festlegen, dass eine etablierte Standarddatenpartition verwendet wird. Ein Signal ohne Angabe `dataPartitionId` wird der Standardeinstellung zugeordnet`dataPartition`.
**Um eine Datenpartition zu erstellen**
Erstellen Sie anhand des folgenden Beispiels eine Kampagne mit einer Speicherbedingung für Datenpartitionen. Diese Beispielkampagne ist so konfiguriert, dass Fahrzeugdaten in Amazon Timestream gespeichert werden.
1. *campaign-name*Ersetzen Sie es durch den Namen der Kampagne, die Sie erstellen.
1. (Optional) Geben Sie eine Beschreibung ein.
1. *role-arn*Ersetzen Sie es durch den Amazon-Ressourcennamen (ARN) der Aufgabenausführungsrolle, die AWS FleetWise IoT-Berechtigungen zur Übermittlung von Daten an die Timestream-Tabelle erteilt.
1. *table-arn*Ersetzen Sie durch den ARN der Timestream-Tabelle.
1. Durch *signal-catalog-arn* den ARN des Signalkatalogs ersetzen.
1. Ersetzen Sie *data-partition-id* sowohl die `dataPartitions` ID als auch die ID, der Sie zuordnen möchten`signalsToCollect`. Ersetzen Sie zunächst die ID der Datenpartition, die im Signal verwendet werden soll. Denn `signalsToCollect` die ID muss mit einer der unter IDs angegebenen übereinstimmen`dataPartitions`.
**Anmerkung**
Richten Sie eine Standarddatenpartition für eine Kampagne ein, indem Sie `default` sie als ID verwenden.
1. *target-arn*Ersetzen Sie es durch den ARN einer Flotte oder eines Fahrzeugs, das Sie erstellt haben.
```
{
"name": "campaign-name",
"description": "Measurement of SOC, SOH, thermal, and power optimization for Fleet 2704",
"targetArn": "target-arn",
"collectionScheme": {
"conditionBasedCollectionScheme": {
"conditionLanguageVersion": 1,
"expression": "$variable.`Vehicle.BMS` > 50",
"minimumTriggerIntervalMs": 1000,
"triggerMode": "ALWAYS"
}
},
"compression": "SNAPPY",
"dataDestinationConfigs": [{
"timestreamConfig": {
"executionRoleArn": "role-arn",
"timestreamTableArn": "table-arn"
}
}],
"dataPartitions": [{
"id": "data-partition-id",
"storageOptions": {
"maximumSize": {
"unit": "GB",
"value": 1024
},
"minimumTimeToLive": {
"unit": "WEEKS",
"value": 6
},
"storageLocation": "string"
},
"uploadOptions": {
"conditionLanguageVersion": 1,
"expression": "$variable.`Vehicle.BMS.PowerOptimization` > 90"
}
}],
"signalCatalogArn": "signal-catalog-arn",
"signalsToCollect": [{
"dataPartitionId": "data-partition-id",
"maxSampleCount": 50000,
"minimumSamplingIntervalMs": 100,
"name": "Below-90-percent"
}],
"spoolingMode": "TO_DISK",
"tags": [{
"Key": "BMS",
"Value": "Under-90"
}]
}
```
Nachdem alle angegebenen Bedingungen erfüllt sind, werden die partitionierten Daten an die Cloud weitergeleitet, sodass neue partitionierte Signale gesammelt und gespeichert werden können.
Als Nächstes rufen Sie die `UpdateCampaign` API auf, um sie in der Edge Agent for AWS FleetWise IoT-Software bereitzustellen. Weitere Informationen finden Sie unter [Laden Sie Kampagnendaten hoch](update-campaign-cli-data-partitions.md).
# Laden Sie Kampagnendaten hoch
**Wichtig**
Der Zugriff auf bestimmte AWS FleetWise IoT-Funktionen ist derzeit gesperrt. Weitere Informationen finden Sie unter [AWS Verfügbarkeit von Regionen und Funktionen im AWS Internet der Dinge FleetWise](fleetwise-regions.md).
Es gibt zwei Möglichkeiten, Kampagnendaten auf den Edge hochzuladen:
+ Kampagnen, die Ihre Upload-Bedingungen erfüllen, laden nach ihrer Genehmigung automatisch Daten in die Cloud hoch. Verwenden Sie den `updateCampaign` API-Vorgang, um eine Kampagne zu genehmigen.
+ Mithilfe von AWS IoT Jobs können Sie das Hochladen von Daten erzwingen, auch wenn bestimmte Bedingungen nicht erfüllt sind. Weitere Informationen finden Sie unter [Laden Sie Daten mithilfe von AWS IoT Jobs hoch](update-campaign-cli-data-partitions-jobs.md).
**Um Kampagnendaten mithilfe der `UpdateCampaign` API-Operation hochzuladen**
Nachdem Sie die Kampagne erstellt haben, wird der Kampagnenstatus so `WAITING_FOR_APPROVAL` lange angezeigt, bis Sie das `action` in ändern`APPROVED`.
+ Verwenden Sie das folgende Beispiel, um die Kampagne zu aktualisieren, `action` indem Sie den [UpdateCampaign](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_UpdateCampaign.html)API-Vorgang aufrufen.
```
{
"action": "APPROVED",
"dataExtraDimensions": [ "string" ],
"description": "string",
"name": "string"
}
```
# Laden Sie Daten mithilfe von AWS IoT Jobs hoch
**Wichtig**
Der Zugriff auf bestimmte AWS FleetWise IoT-Funktionen ist derzeit gesperrt. Weitere Informationen finden Sie unter [AWS Verfügbarkeit von Regionen und Funktionen im AWS Internet der Dinge FleetWise](fleetwise-regions.md).
Mit AWS IoT Jobs können Sie Kampagnen so konfigurieren, dass gespeicherte Fahrzeugdaten bei Bedarf in die Cloud hochgeladen werden.
**Um ein Jobdokument für Ihre Kampagne zu erstellen**
+ Verwenden Sie das folgende Beispiel, um ein Jobdokument für die Kampagne zu erstellen. Ein Auftragsdokument ist eine JSON-Datei, die Informationen über Fahrzeuge oder Flotten enthält, die für die Ausführung eines Auftrags erforderlich sind. Weitere Informationen zum Erstellen von Auftragsdokumenten finden Sie unter [Erstellen und Verwalten von Aufträgen mithilfe von AWS CLI im AWS IoT](https://docs.aws.amazon.com/iot/latest/developerguide/manage-job-cli.html) *Entwicklerhandbuch*.
Um anzufordern, dass nur ein Fahrzeug Daten hochlädt, legen Sie als Jobziel das Objekt AWS IoT fest, das dem Fahrzeug zugeordnet ist. Um zu verlangen, dass mehrere Fahrzeuge (in derselben Kampagne) Daten hochladen, erstellen Sie eine Dinggruppe mit allen Dingen, die den Fahrzeugen entsprechen, und legen Sie dann das Jobziel auf die Dinggruppe fest.
```
{
"version": "1.0",
"parameters": {
"campaignArn": ${aws:iot:parameter:campaignArn},
"endTime": ${aws:iot:parameter:endTime}
}
}
```
1. `CampaignArn`Ersetzen Sie es durch den Amazon-Ressourcennamen (ARN) einer Kampagne in derselben Region und demselben Konto. Der Kampagnen-ARN ist erforderlich.
1. (Optional) `endTime` Ersetzen Sie ihn durch den Zeitstempel der am Fahrzeug gesammelten Daten im UTC-Format ISO 8601 (ohne Millisekunden). Beispiel, `2024-03-05T23:00:00Z`. Der Zeitstempel ist exklusiv und bestimmt den letzten hochzuladenden Datenpunkt. Wenn Sie diesen Wert weglassen`endTime`, fährt die Edge Agent-Software mit dem Upload fort, bis alle gespeicherten Daten einer Kampagne hochgeladen sind. Nachdem alle Daten hochgeladen wurden, wird der [Status der Auftragsausführung](https://docs.aws.amazon.com/iot/latest/developerguide/iot-jobs-lifecycle.html#iot-job-execution-states) auf `SUCCEEDED` aktualisiert. Der [Status](https://docs.aws.amazon.com/iot/latest/developerguide/iot-jobs-lifecycle.html#iot-jobs-states) des Jobs wird auf aktualisiert`COMPLETED`.
**Um einen Job mit einer verwalteten Jobvorlage zu erstellen**
1. Wählen Sie **IoT-IO TFleet Wise- CollectCampaignData** aus der Liste der verwalteten Vorlagen aus. Weitere Informationen finden Sie im *AWS IoT Entwicklerhandbuch* unter [Erstellen eines Jobs aus AWS verwalteten Vorlagen](https://docs.aws.amazon.com/iot/latest/developerguide/job-template-manage-console-create.html).
1. Die verwaltete Vorlage hat die `endTime` Parameter `CampaignArn` und.
1. `CampaignArn`Ersetzen Sie es durch den Amazon-Ressourcennamen (ARN) einer Kampagne in derselben Region und demselben Konto. Der Kampagnen-ARN ist erforderlich.
1. (Optional) `endTime` Ersetzen Sie ihn durch den Zeitstempel der am Fahrzeug gesammelten Daten im UTC-Format ISO 8601 (ohne Millisekunden). Beispiel, `2024-03-05T23:00:00Z`. Der Zeitstempel ist exklusiv und bestimmt den letzten hochzuladenden Datenpunkt. Wenn Sie diesen Wert weglassen`endTime`, fährt die Edge Agent-Software mit dem Upload fort, bis alle gespeicherten Daten einer Kampagne hochgeladen sind. Nachdem alle Daten hochgeladen wurden, wird der [Status der Auftragsausführung](https://docs.aws.amazon.com/iot/latest/developerguide/iot-jobs-lifecycle.html#iot-job-execution-states) auf `SUCCEEDED` aktualisiert. Der [Status](https://docs.aws.amazon.com/iot/latest/developerguide/iot-jobs-lifecycle.html#iot-jobs-states) des Jobs wird auf aktualisiert`COMPLETED`.
Verwandte Themen zur Problembehandlung finden Sie unter[Probleme speichern und weiterleiten](troubleshooting-campaign.md).
Weitere Informationen zu AWS IoT [Jobs](https://docs.aws.amazon.com/iot/latest/developerguide/iot-jobs.html) finden Sie im *AWS IoT Developer Guide* unter Jobs.
# Sammeln Sie diagnostische Fehlercode-Daten mithilfe von AWS IoT FleetWise
**Wichtig**
Der Zugriff auf bestimmte AWS FleetWise IoT-Funktionen ist derzeit gesperrt. Weitere Informationen finden Sie unter [AWS Verfügbarkeit von Regionen und Funktionen im AWS Internet der Dinge FleetWise](fleetwise-regions.md).
Wenn ein Fahrzeug einen Fehler erkennt, generiert es einen Diagnose-Fehlercode (DTC) und zeichnet eine Momentaufnahme der betroffenen Sensoren oder Aktuatoren auf. DTCs hilft Ihnen, nahezu in Echtzeit über Fehler zu erfahren, zu verstehen, was sie verursacht, und Korrekturmaßnahmen zu ergreifen. AWS IoT FleetWise unterstützt die Erfassung von DTCs, einschließlich entsprechender DTC-Snapshots und erweiterter Daten, im Rahmen einer Datenerfassungskampagne. In diesem Thema werden die Konzepte, Workflows und Schlüsselwörter vorgestellt, die die DTC-Datenerfassung erleichtern, anhand von Beispielen veranschaulicht.
Im Folgenden werden die wichtigsten Konzepte für die Verwendung von DTC beschrieben.
**Benutzerdefiniert definierte Funktionen**
Eine benutzerdefinierte Funktion ist die Möglichkeit, Ihre eigenen, auf dem Edge Agent vordefinierten Funktionen aufzurufen und auszuführen, wodurch das [benutzerdefinierte Dekodierungskonzept](network-agnostic-data-collection.md) erweitert wird. Diese Funktionen werden in Abstimmung mit dem AWS IoT FleetWise Agent verwendet. Die Edge Agent for AWS FleetWise IoT-Software bietet integrierte Funktionen zur Berechnung von Signalstatistiken wie Minimal-, Maximal- und Durchschnittswerten. Eine benutzerdefinierte Funktion erweitert diese Funktion, indem sie es Ihnen ermöglicht, maßgeschneiderte Logik für bestimmte Anwendungsfälle zu erstellen. Für die Erfassung von DTC-Daten (Diagnostic Trouble Code) können Entwickler benutzerdefinierte Funktionen nutzen, um erweiterte Datenabrufmechanismen zu implementieren, z. B. das Abrufen von DTC-Codes, Schnappschüssen und erweiterten Daten direkt vom Edge des Fahrzeugs über Unified Diagnostic Services (UDS) oder alternative Diagnoseschnittstellen.
*Weitere Informationen finden Sie im [Leitfaden für benutzerdefinierte Funktionen](https://github.com/aws/aws-iot-fleetwise-edge/blob/main/docs/dev-guide/custom-function-dev-guide.md) und in der [Referenzimplementierung der DTC-Datenerfassung](https://github.com/aws/aws-iot-fleetwise-edge/blob/main/docs/dev-guide/edge-agent-uds-dtc-dev-guide.md#dtc_query-function-implementation) im Edge Agent Developer Guide.*
**Abrufen von Signalen**
Bei Datenerfassungskampagnen werden Signale in der Regel kontinuierlich von einem Gerät erfasst und in der Edge Agent-Software zwischengespeichert. Signale werden dann in regelmäßigen Abständen in zeitbasierten Kampagnen hochgeladen oder gespeichert oder bei zustandsabhängigen Kampagnen durch bestimmte Bedingungen ausgelöst. Aufgrund von Bedenken hinsichtlich einer Überlastung des Geräteverkehrs können DTC-Signale jedoch nicht von Geräten erfasst und kontinuierlich zwischengespeichert werden. Um diesem Problem zu begegnen, FleetWise bietet AWS IoT einen Signalabruf, der sicherstellt, dass das Zielsignal diskontinuierlich von einem Gerät abgerufen wird.
Das Abrufen von Signalen unterstützt sowohl periodische als auch zustandsabhängige Aktionen. Sie können die vom Abruf gesteuerte Methode, die Bedingungen und die genauen Aktionen mithilfe benutzerdefinierter Funktionen für jedes Signal definieren, das nicht kontinuierlich von einem Gerät erfasst werden soll. Bei Signalen, die vom Signalabrufmechanismus verwaltet werden, werden der Triggertyp und die Bedingungen für die lokale Speicherung oder den `CollectionScheme` Cloud-Upload weiterhin von beiden bestimmt `timeBasedCollectionScheme` und `conditionBasedCollectionScheme` unterstützt, was den regulären Signalen entspricht.
In den folgenden Themen erfahren Sie, wie Sie etwas erstellen und verwenden DTCs können.
**Topics**
+ [Schlüsselwörter für den diagnostischen Fehlercode](dtc-keywords.md)
+ [Erstellen Sie eine Kampagne zur Datenerfassung für diagnostische Fehlercodes](dtc-data-collection.md)
+ [Anwendungsfälle für diagnostische Fehlercodes](dtc-use-cases.md)
# Schlüsselwörter für den diagnostischen Fehlercode
**Wichtig**
Der Zugriff auf bestimmte AWS FleetWise IoT-Funktionen ist derzeit gesperrt. Weitere Informationen finden Sie unter [AWS Verfügbarkeit von Regionen und Funktionen im AWS Internet der Dinge FleetWise](fleetwise-regions.md).
**`signalsToFetch`Parameter für die Kampagnenerstellung**
Verwenden Sie die signalsToFetchSyntax, um zu konfigurieren, wie die Signalinformationen auf dem Edge abgerufen werden können. Das Abrufen von Standardsignalen wird durch Modellieren anhand von Regeln gesteuert, die explizit in einem Decoder-Manifest definiert sind, oder durch Edge First Modeling benutzerdefiniert. Mithilfe von Signalen zum Abrufen können Sie definieren, wann und wie Daten während Kampagnen abgerufen werden.
Abzurufende Signale ermöglichen die Erfassung von DTC-Informationen. Sie können beispielsweise ein Signal vom Typ Zeichenfolge mit dem Namen erstellen`DTC_Info`, das DTC-Informationen für jedes Motorsteuergerät (ECU) enthalten kann. Sie können auch nach einem bestimmten Steuergerät filtern.
+ `SignalFetchInformation`Struktur- und Parameterdefinitionen.
```
structure SignalFetchInformation {
@required
fullyQualifiedName: NodePath,
@required
signalFetchConfig: SignalFetchConfig,
// Conditional language version for this config
conditionLanguageVersion: languageVersion,
@required
actions: EventExpressionList,
}
```
+ `fullyQualifiedName`: der vollqualifizierte Name (FQDN) des Signals, für das Sie den benutzerdefinierten Abruf verwenden möchten.
+ `signalFetchConfig`: definiert Regeln, wie die oben definierten Signale abgerufen werden sollen. Es unterstützt zeit- und bedingungsbasiertes Abrufen.
+ `conditionLanguageVersion`: Die bedingte Sprachversion, die zum Analysieren des Ausdrucks in der Konfiguration verwendet wird.
+ `actions`: eine Liste aller Aktionsausdrücke, die auf dem Edge ausgewertet wurden. Der Edge erhält den Wert des definierten Signals.
**Wichtig**
Aktionen können nur verwenden`custom_function`.
## Schlüsselwörter für Kampagnenausdrücke
Der folgende Ausdruck verwendet den vollständig qualifizierten Namen eines Signals, der vom Fahrzeug unterstützt wird, und gibt „true“ zurück, wenn das Signal keine Daten in den Signalpuffern auf dem Edge enthält. Andernfalls wird False zurückgegeben.
```
isNull(signalFqdn:String): Boolean
```
**Example Nutzung**
```
isNull($variable.`Vehicle.ECU1.DTC_INFO`) == false
We want to make sure DTC_Info signal is being generated
on edge.
```
Dieser Ausdruck benötigt die folgende Eingabe:
**Funktionsname: Zeichenfolge**
Der Name der benutzerdefinierten Funktion, die vom Edge unterstützt wird
**Parameter: varargs *Expression***
Parameter für. `functionName` Dies kann eine beliebige Liste von Ausdrücken sein.
Parameter unterstützen Literaltypen: String, Int, Boolean oder Double.
```
custom_function(functionName:String, params: varargsExpression): Void
```
**Example Nutzung**
```
{
"fullyQualifiedName":"Vehicle.ECU1.DTC_INFO",
"signalFetchConfig":{
"timeBased":{
"executionFrequencyMs":2000
}
},
"actions":"custom_function(“DTC_QUERY”, -1, 2, -1)"
}
```
# Erstellen Sie eine Kampagne zur Datenerfassung für diagnostische Fehlercodes
**Wichtig**
Der Zugriff auf bestimmte AWS FleetWise IoT-Funktionen ist derzeit gesperrt. Weitere Informationen finden Sie unter [AWS Verfügbarkeit von Regionen und Funktionen im AWS Internet der Dinge FleetWise](fleetwise-regions.md).
In diesem Thema wird beschrieben, wie Sie eine Kampagne zur Datenerfassung für Diagnose-Fehlercodes (DTC) erstellen.
1. Definieren Sie ein benutzerdefiniertes Signal auf dem Edge. Sie müssen die Dekodierungsregeln für das DTC-Signal auf dem Edge als benutzerdefiniertes dekodiertes Signal definieren. Weitere Informationen finden Sie unter [Tutorial: Konfiguration der netzwerkunabhängigen Datenerfassung mithilfe einer benutzerdefinierten Dekodierungsschnittstelle](network-agnostic-data-collection.md).
1. Definieren Sie eine benutzerdefinierte Funktion auf dem Edge. Sie müssen eine benutzerdefinierte Funktion zum Sammeln von DTC-Signalen auf dem Edge zu einem kompilierten Zeitpunkt definieren.
Weitere Informationen finden Sie im [Leitfaden für benutzerdefinierte Funktionen](https://github.com/aws/aws-iot-fleetwise-edge/blob/main/docs/dev-guide/custom-function-dev-guide.md ) und in der [Referenzimplementierung der DTC-Datenerfassung](https://github.com/aws/aws-iot-fleetwise-edge/blob/main/docs/dev-guide/edge-agent-uds-dtc-dev-guide.md#dtc_query-function-implementation) im *Edge Agent Developer* Guide.
**Anmerkung**
Ein Beispiel für eine benutzerdefinierte Funktion ist `DTC_QUERY` im [Demoskript](https://github.com/aws/aws-iot-fleetwise-edge/blob/main/docs/dev-guide/edge-agent-uds-dtc-dev-guide.md) dargestellt.
1. Erstellen Sie einen Signalkatalog, der ein DTC-Signal als Zeichenfolgentyp modelliert.
```
[
{
"branch": {
"fullyQualifiedName": "Vehicle",
"description": "Vehicle"
}
},
{
"branch": {
"fullyQualifiedName": "Vehicle.ECU1",
"description": "Vehicle.ECU1"
}
},
{
"sensor": {
"fullyQualifiedName": "Vehicle.ECU1.DTC_INFO",
"description": "Vehicle.ECU1.DTC_INFO",
"dataType": "STRING"
}
}
]
```
1. Erstellen und aktivieren Sie ein Fahrzeugmodell mit dem hinzugefügten DTC-Signal.
1. Erstellen und aktivieren Sie ein Decoder-Manifest mit dem hinzugefügten DTC-Signal. Das DTC-Signal sollte ein `CUSTOM_DECODING_SIGNAL` Signaldecodertyp mit einem `CUSTOM_DECODING_INTERFACE` Netzwerkschnittstellentyp sein.
**Example Signaldecoder**
```
[
{
"fullyQualifiedName": "Vehicle.ECU1.DTC_INFO",
"interfaceId": "UDS_DTC",
"type": "CUSTOM_DECODING_SIGNAL",
"customDecodingSignal": {
"id": "Vehicle.ECU1.DTC_INFO"
}
}
]
```
**Example Netzwerkschnittstelle**
```
[
{
"interfaceId": "UDS_DTC",
"type": "CUSTOM_DECODING_INTERFACE",
"customDecodingInterface": {
"name": "NamedSignalInterface"
}
}
]
```
**Anmerkung**
CAN-Signale (Controller Area Network) unterstützen den String-Datentyp nicht.
1. Fahrzeuge bereitstellen und erstellen. Die Fahrzeuge müssen ein Fahrzeugmodell (Modellmanifest) und ein Decoder-Manifest verwenden, die in den vorherigen Schritten aktiviert wurden.
1. Erstellen und genehmigen Sie die Kampagne. Sie müssen eine Kampagne erstellen, indem Sie DTC-Signale (optional mit Telemetriesignalen) definieren und sie in Fahrzeugen einsetzen.
1. Greifen Sie auf die Daten im definierten Ziel zu. Zu den DTC-Daten gehören das`DTCCode`,`DTCSnapshot`, und `DTCExtendedDatastrings` als unformatierte Zeichenfolge in dem in der Kampagne definierten Datenziel.
# Anwendungsfälle für diagnostische Fehlercodes
**Wichtig**
Der Zugriff auf bestimmte AWS FleetWise IoT-Funktionen ist derzeit gesperrt. Weitere Informationen finden Sie unter [AWS Verfügbarkeit von Regionen und Funktionen im AWS Internet der Dinge FleetWise](fleetwise-regions.md).
In den folgenden Anwendungsfällen wird davon ausgegangen, dass die `DTC_QUERY` Funktion im [Demoskript](https://github.com/aws/aws-iot-fleetwise-edge/blob/main/docs/dev-guide/edge-agent-uds-dtc-dev-guide.md) definiert wurde.
## Periodischer Abruf
Ruft eine DTC-Sammlung in konfigurierten Intervallen ab.
Das folgende Beispiel zeigt eine Kampagne mit regelmäßigem Abrufen von Signalen `Vehicle.DTC_INFO` für alle DTCs mit einer Statusmaske für alle. ECUs Es gibt eine Bedingung für die Erfassung von Daten für`Vehicle.DTC_INFO`.
```
{
"compression": "SNAPPY",
"spoolingMode": "TO_DISK",
"signalsToFetch": [
{
"fullyQualifiedName": "Vehicle.ECU1.DTC_INFO",
"signalFetchConfig": {
"timeBased": {
// The FleetWise Edge Agent will query the UDS module for all DTCs every five seconds.
"executionFrequencyMs": 5000
}
},
"actions": [
// Every five seconds, this action is called and its output is stored in the
// signal history buffer of Vehicle.DTC_INFO
"custom_function(\"DTC_QUERY\", -1, 2, -1)"
]
}
],
"signalsToCollect": [
{
"name": "Vehicle.ECU1.DTC_INFO"
}
],
"collectionScheme": {
"conditionBasedCollectionScheme": {
"conditionLanguageVersion": 1,
// Whenever a new DTC is filled into the signal, the data is ingested.
"expression": "!isNull($variable.`Vehicle.ECU1.DTC_INFO`)",
"minimumTriggerIntervalMs": 1000,
// Make sure that data is ingested only when there are new DTCs.
"triggerMode": "RISING_EDGE"
}
},
"dataDestinationConfigs": [
{
"s3Config":
{
"bucketArn": "bucket-arn",
"dataFormat": "PARQUET",
"prefix": "campaign-name",
"storageCompressionFormat": "GZIP"
}
}
]
}
```
## Bedingungsgesteuerter Abruf
Ruft eine DTC-Sammlung ab, wenn eine Bedingung erfüllt ist. Wenn beispielsweise das CAN-Signal anliegt`Vehicle.Ignition == 1`, rufen Sie die DTC-Daten ab und laden Sie sie hoch.
In der folgenden Beispielkampagne wird ein bedingungsgesteuerter Signalabruf aktiviert, `Vehicle.ECU1.DTC_INFO` um zu überprüfen, ob der DTC (“ AAA123 „) mit RecordNumber 1 für ECU-1 aussteht. Bei dieser Kampagne werden Daten zeitbasiert erfasst und hochgeladen.
```
{
"compression": "SNAPPY",
"spoolingMode": "TO_DISK",
"signalsToFetch": [
{
"fullyQualifiedName": "Vehicle.ECU1.DTC_INFO",
"signalFetchConfig": {
"conditionBased": {
// The action will only run when the ignition is on.
"conditionExpression": "$variable.`Vehicle.Ignition` == 1",
"triggerMode": "ALWAYS"
}
},
// The UDS module is only requested for the specific ECU address and the specific DTC Number/Status.
"actions": ["custom_function(\"DTC_QUERY\", 1, 2, 8, \"0xAAA123\")"]
}
],
"signalsToCollect": [
{
"name": "Vehicle.ECU1.DTC_INFO"
},
{
"name": "Vehicle.Ignition"
}
],
"collectionScheme": {
"timeBasedCollectionScheme": {
"periodMs": 10000
}
},
"dataDestinationConfigs": [
{
"s3Config":
{
"bucketArn": "bucket-arn",
"dataFormat": "PARQUET",
"prefix": "campaign-name",
"storageCompressionFormat": "GZIP"
}
}
]
}
```
## Abruf auf Abruf
Ruft einen bestimmten DTC für eine Flotte ab.
Für einen On-Demand-Anwendungsfall können Sie dieselbe Kampagne verwenden, die im regelmäßigen Abruf definiert ist. Der On-Demand-Effekt wird erreicht, indem die Kampagne kurz nach der Bereitstellung der Kampagne über die AWS FleetWise IoT-Konsole oder durch Ausführen des folgenden CLI-Befehls unterbrochen wird.
+ Ersetzen Sie es *command-name* durch den Befehlsnamen.
```
aws iotfleetwise update-campaign \
--name campaign-name \
--action APPROVE
```
Unterbrechen Sie dann die Kampagne, nachdem die DTC-Daten eingetroffen sind.
```
aws iotfleetwise update-campaign \
--name campaign-name \
--action SUSPEND
```
Sie können die Kampagne erneut fortsetzen, um DTC-Daten abzurufen.
```
aws iotfleetwise update-campaign \
--name campaign-name \
--action RESUME
```
# Visualisieren Sie AWS FleetWise IoT-Fahrzeugdaten
**Wichtig**
Der Zugriff auf bestimmte AWS FleetWise IoT-Funktionen ist derzeit gesperrt. Weitere Informationen finden Sie unter [AWS Verfügbarkeit von Regionen und Funktionen im AWS Internet der Dinge FleetWise](fleetwise-regions.md).
Die Edge Agent for AWS FleetWise IoT-Software sendet ausgewählte Fahrzeugdaten an ein MQTT-Thema oder überträgt sie an Amazon Timestream oder Amazon Simple Storage Service (Amazon S3). Nachdem Ihre Daten am Datenziel angekommen sind, können Sie andere AWS Dienste verwenden, um sie zu verarbeiten, umzuleiten, zu visualisieren und zu teilen.
**Anmerkung**
Amazon Timestream ist in der Region Asien-Pazifik (Mumbai) nicht verfügbar.
## Verarbeitung von Fahrzeugdaten, die an ein MQTT-Thema gesendet wurden
Über MQTT-Messaging gesendete Fahrzeugdaten werden nahezu in Echtzeit übermittelt und ermöglichen es Ihnen, mithilfe von Regeln Maßnahmen zu ergreifen oder Daten an andere Ziele weiterzuleiten. Weitere Informationen zur Verwendung von MQTT finden Sie unter [Gerätekommunikationsprotokolle](https://docs.aws.amazon.com/iot/latest/developerguide/protocols.html) und [Regeln für AWS IoT](https://docs.aws.amazon.com/iot/latest/developerguide/iot-rules.html) im *AWS IoT Core Entwicklerhandbuch*.
Das Standardschema für Daten, die in einer MQTT-Nachricht gesendet werden, enthält die folgenden Felder.
| Feldname | Datentyp | Description |
| --- | --- | --- |
| `eventId` | varchar | Die ID des Datenerfassungsereignisses. |
| `vehicleName` | varchar | Die ID des Fahrzeugs, von dem die Daten gesammelt wurden. |
| `name` | varchar | Der Name der Kampagne, mit der die Edge Agent-Software Daten sammelt. |
| `time` | Zeitstempel | Der Zeitstempel des Datenpunkts. |
| `measure_name` | varchar | Der Name des Signals. |
| `measure_value::bigint` | bigint | Signalwerte vom Typ Integer. |
| `measure_value::double` | double | Signalwerte vom Typ Double. |
| `measure_value::boolean` | boolesch | Signalwerte des Typs Boolean. |
| `measure_value::varchar` | varchar | Signalwerte des Typs varchar. |
## Fahrzeugdaten in Timestream verarbeiten
Timestream ist eine vollständig verwaltete Zeitreihendatenbank, die Billionen von Zeitreihendatenpunkten pro Tag speichern und analysieren kann. Ihre Daten werden in einer vom Kunden verwalteten Timestream-Tabelle gespeichert. Sie können Timestream verwenden, um Fahrzeugdaten abzufragen, um Einblicke in Ihre Fahrzeuge zu gewinnen. Weitere Informationen finden Sie unter [Was ist Amazon Timestream](https://docs.aws.amazon.com/timestream/latest/developerguide/what-is-timestream.html)?
Das Standardschema für Daten, die an Timestream übertragen werden, enthält die folgenden Felder.
| Feldname | Datentyp | Description |
| --- | --- | --- |
| `eventId` | varchar | Die ID des Datenerfassungsereignisses. |
| `vehicleName` | varchar | Die ID des Fahrzeugs, von dem die Daten gesammelt wurden. |
| `name` | varchar | Der Name der Kampagne, mit der die Edge Agent-Software Daten sammelt. |
| `time` | Zeitstempel | Der Zeitstempel des Datenpunkts. |
| `measure_name` | varchar | Der Name des Signals. |
| `measure_value::bigint` | bigint | Signalwerte vom Typ Integer. |
| `measure_value::double` | double | Signalwerte vom Typ Double. |
| `measure_value::boolean` | boolesch | Signalwerte des Typs Boolean. |
| `measure_value::varchar` | varchar | Signalwerte des Typs varchar. |
## Visualisieren Sie die in Timestream gespeicherten Fahrzeugdaten
Nachdem Ihre Fahrzeugdaten an Timestream übertragen wurden, können Sie die folgenden AWS Dienste verwenden, um Ihre Daten zu visualisieren, zu überwachen, zu analysieren und zu teilen.
+ Visualisieren und überwachen Sie Daten in Dashboards mithilfe von [Grafana oder Amazon Managed](https://docs.aws.amazon.com/timestream/latest/developerguide/Grafana.html) Grafana. Sie können Daten aus mehreren AWS Quellen (wie Amazon CloudWatch und Timestream) und anderen Datenquellen mit einem einzigen Grafana-Dashboard visualisieren.
+ [Analysieren und visualisieren Sie Daten in Dashboards mithilfe von Quick.](https://docs.aws.amazon.com/timestream/latest/developerguide/Quicksight.html)
## Fahrzeugdaten in Amazon S3 verarbeiten
Amazon S3 ist ein Objektspeicherservice, der beliebige Datenmengen speichert und schützt. Sie können S3 für eine Vielzahl von Anwendungsfällen verwenden, z. B. für Datenseen, Sicherung und Wiederherstellung, Archivierung, Unternehmensanwendungen, AWS IoT Geräte und Big-Data-Analysen. Ihre Daten werden in S3 als Objekte in Buckets gespeichert. Weitere Informationen finden Sie unter [Was ist Amazon S3?](https://docs.aws.amazon.com/AmazonS3/latest/userguide/Welcome.html)
Das Standardschema von Daten, die an Amazon S3 übertragen werden, enthält die folgenden Felder.
| Feldname | Datentyp | Description |
| --- | --- | --- |
| `eventId` | varchar | Die ID des Datenerfassungsereignisses. |
| `vehicleName` | varchar | Die ID des Fahrzeugs, von dem die Daten gesammelt wurden. |
| `name` | varchar | Der Name der Kampagne, mit der die Edge Agent-Software Daten sammelt. |
| `time` | Zeitstempel | Der Zeitstempel des Datenpunkts. |
| `measure_name` | varchar | Der Name des Signals. |
| `measure_value_BIGINT` | bigint | Signalwerte vom Typ Integer. |
| `measure_value_DOUBLE` | double | Signalwerte vom Typ Double. |
| `measure_value_BOOLEAN` | boolesch | Signalwerte des Typs Boolean. |
| `measure_value_STRUCT` | struct | Signalwerte des Typs Struct. |
| `measure_value_VARCHAR` | varchar | Signalwerte des Typs varchar. |
## Amazon S3 S3-Objektformat
AWS IoT FleetWise überträgt Fahrzeugdaten an S3, wo sie als Objekt gespeichert werden. Sie können den Objekt-URI verwenden, der die Daten eindeutig identifiziert, um Daten aus der Kampagne zu finden. Das S3-Objekt-URI-Format hängt davon ab, ob es sich bei den gesammelten Daten um unstrukturierte oder verarbeitete Daten handelt.
### Unstrukturierte Daten
Unstrukturierte Daten werden in S3 auf nicht vordefinierte Weise gespeichert. Es kann in verschiedenen Formaten vorliegen, z. B. in Bildern oder Videos.
Fahrzeugnachrichten, die FleetWise mit Signaldaten aus Amazon Ion-Dateien an das AWS IoT übergeben werden, werden dekodiert und als Objekte an S3 übertragen. Die S3-Objekte repräsentieren jedes Signal und sind binär codiert.
Der S3-Objekt-URI für unstrukturierte Daten verwendet das folgende Format:
```
s3://bucket-name/prefix/unstructured-data/random-ID-yyyy-MM-dd-HH-mm-ss-SSS-vehicleName-signalName-fieldName
```
### Verarbeitete Daten
Verarbeitete Daten werden in S3 gespeichert und durchlaufen Verarbeitungsschritte, die Nachrichten validieren, anreichern und transformieren. Objektlisten und Geschwindigkeit sind Beispiele für verarbeitete Daten.
An S3 übertragene Daten werden als Objekte gespeichert, die Datensätze darstellen, die für einen Zeitraum von etwa 10 Minuten zwischengespeichert wurden. Standardmäßig FleetWise fügt AWS IoT dem Format ein UTC-Zeitpräfix hinzu, `year=YYYY/month=MM/date=DD/hour=HH` bevor Objekte in S3 geschrieben werden. Dieses Präfix erstellt eine logische Hierarchie im Bucket, in der jeder Schrägstrich (`/`) eine Ebene in der Hierarchie erzeugt. Die verarbeiteten Daten enthalten auch den S3-Objekt-URI für unstrukturierte Daten.
Der S3-Objekt-URI für verarbeitete Daten verwendet das folgende Format:
```
s3://bucket-name/prefix/processed-data/year=YYYY/month=MM/day=DD/hour=HH/part-0000-random-ID.gz.parquet
```
### Rohdaten
Rohdaten, auch Primärdaten genannt, sind Daten, die aus Amazon Ion-Dateien gesammelt wurden. Sie können Rohdaten verwenden, um Probleme zu beheben oder Fehler zu beheben.
Der S3-Objekt-URI für Rohdaten verwendet das folgende Format:
```
s3://bucket-name/prefix/raw-data/vehicle-name/eventID-timestamp.10n
```
## Analysieren Sie die in Amazon S3 gespeicherten Fahrzeugdaten
Nachdem Ihre Fahrzeugdaten an S3 übertragen wurden, können Sie die folgenden AWS Dienste verwenden, um Ihre Daten zu überwachen, zu analysieren und zu teilen.
Extrahieren und analysieren Sie Daten mit Amazon SageMaker AI für nachgelagerte Labeling- und Machine Learning-Workflows (ML).
Weitere Informationen finden Sie in den folgenden Themen im *Amazon SageMaker AI Developer Guide*:
+ [Daten verarbeiten](https://docs.aws.amazon.com/sagemaker/latest/dg/processing-job.html)
+ [Trainieren Sie Modelle für maschinelles Lernen](https://docs.aws.amazon.com/sagemaker/latest/dg/train-model.html)
+ [Bilder beschriften](https://docs.aws.amazon.com/sagemaker/latest/dg/sms-label-images.html)
Katalogisieren Sie Ihre Daten mithilfe AWS-Glue-Crawler und analysieren Sie sie in Amazon Athena. Standardmäßig verfügen in S3 geschriebene Objekte über Zeitpartitionen im Apache Hive-Stil mit Datenpfaden, die Schlüssel-Wert-Paare enthalten, die durch Gleichheitszeichen verbunden sind.
Weitere Informationen finden Sie in den folgenden Themen im *Amazon Athena Athena-Benutzerhandbuch*:
+ [Daten in Athena partitionieren](https://docs.aws.amazon.com/athena/latest/ug/partitions.html)
+ [Wird verwendet AWS Glue , um eine Verbindung zu Datenquellen in Amazon S3 herzustellen](https://docs.aws.amazon.com/athena/latest/ug/data-sources-glue.html)
+ [Bewährte Methoden bei der Verwendung von Athena mit AWS Glue](https://docs.aws.amazon.com/athena/latest/ug/glue-best-practices.html)
Visualisieren Sie Daten mit Quick, indem Sie entweder Ihre Athena-Tabelle oder Ihren S3-Bucket direkt lesen.
**Tipp**
Wenn Sie direkt aus S3 lesen, vergewissern Sie sich, dass Ihre Fahrzeugdaten im JSON-Format vorliegen, da Quick das Apache Parquet-Format nicht unterstützt.
Weitere Informationen finden Sie in den folgenden Themen in der *Amazon-Kurzanleitung*:
+ [Unterstützte Datenquellen](https://docs.aws.amazon.com/quicksight/latest/user/supported-data-sources.html)
+ [Eine Datenquelle erstellen](https://docs.aws.amazon.com/quicksight/latest/user/create-a-data-source.html)