Sammeln und übertragen Sie Daten mit Kampagnen - AWS IoT FleetWise

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 und übertragen Sie Daten mit Kampagnen

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, stellt AWS IoT sie FleetWise automatisch in Fahrzeugen bereit. 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.

Anmerkung

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.

    1. Navigieren Sie zur AWS FleetWiseIoT-Konsole.

    2. 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 Fahrzeuge bereitstellen.

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 Diensten dasselbe Tag zuweisen, um anzuzeigen, dass die Ressourcen miteinander verknüpft sind.

TargetArn

Der ARN eines Fahrzeugs oder einer Flotte, in der die Kampagne bereitgestellt wird.

name

Ein eindeutiger Name, anhand dessen die Kampagne leichter 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 zustandsabhängige Erfassungsschema verwendet einen logischen Ausdruck, um zu erkennen, welche Daten gesammelt werden sollen. Die Edge Agent-Software sammelt Daten, wenn die Bedingung erfüllt ist.

expression

Der logische Ausdruck, mit dem erkannt wird, 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 unterLogische Ausdrücke für Kampagnen.

(Optional) triggerMode kann einer der folgenden Werte sein.

  • RISING_EDGE— Die Edge Agent-Software sammelt Daten nur, wenn die Bedingung zum ersten Mal erfüllt ist. Zum Beispiel $variable.`myVehicle.AirBagDeployed` == true.

  • ALWAYS— Die Edge Agent-Software sammelt Daten, wenn die Bedingung erfüllt ist.

(Optional) minimumTriggerIntervalMs

Die Mindestdauer zwischen zwei Datenerfassungsereignissen in Millisekunden. Wenn sich ein Signal häufig ändert, erfassen Sie Daten möglicherweise langsamer.

(Optional) conditionLanguageVersion

Die Version der Sprache für bedingte Ausdrücke.

timeBasedCollectionScheme

Wenn Sie ein zeitbasiertes Erfassungsschema definieren, geben Sie einen Zeitraum in Millisekunden an. Die Edge Agent-Software entscheidet anhand 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.

(Optional) compression

Um drahtlose Bandbreite zu sparen und den Netzwerkverkehr zu reduzieren, können Sie SNAPPY angeben, um Daten in Fahrzeugen zu komprimieren.

Standardmäßig (OFF) komprimiert die Edge Agent-Software keine Daten.

dataDestinationConfigs

Wählen Sie das Ziel aus, an das die Kampagne Fahrzeugdaten übertragen soll. Sie können wählen, ob Sie Daten in Amazon S3 oder Amazon Timestream speichern möchten.

S3 ist ein kostengünstiger Datenspeichermechanismus, 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.

(Optional) dataExtraDimensions

Sie können ein oder mehrere Attribute hinzufügen, um zusätzliche Informationen für ein Signal bereitzustellen.

(Optional) description

Sie können eine Beschreibung hinzufügen, um den Zweck der Kampagne besser zu identifizieren.

(Optional) diagnosticsMode

Wenn der Diagnosemodus so konfiguriert istSEND_ACTIVE_DTCS, sendet die Kampagne gespeicherte Standarddiagnosefehlercodes (DTCs), anhand derer Sie feststellen können, 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

Sie können das Ablaufdatum für Ihre Kampagne definieren. 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

Sie können eine Ganzzahl angeben, um die Prioritätsstufe der Kampagne anzugeben. Kampagnen mit einer kleineren Anzahl 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.

Wichtig

In diesem Feld müssen die Signale angegeben werden, die im Ausdruck für das bedingungsbasierte Erfassungsschema verwendet werden.

name

Der Name des Signals, aus dem Daten gesammelt werden, wenn das Datenerfassungsschema aufgerufen wird.

(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 istTO_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 Kampagne (AWS CLI).

  • RUNNING — Die Kampagne ist aktiv.

  • SUSPENDED— Die Kampagne ist ausgesetzt. Verwenden Sie den UpdateCampaign API-Vorgang, um die Kampagne fortzusetzen.

AWSIoT FleetWise bietet die folgenden API-Operationen, mit denen Sie Kampagnen erstellen und verwalten können.

  • CreateCampaign— Erstellt eine neue Kampagne.

  • UpdateCampaign— Aktualisiert eine bestehende Kampagne. Nachdem eine Kampagne erstellt wurde, müssen Sie diese API-Operation verwenden, um die Kampagne zu genehmigen.

  • DeleteCampaign— Löscht eine bestehende Kampagne.

  • ListCampaigns— Ruft eine paginierte Liste mit Zusammenfassungen für alle Kampagnen ab.

  • GetCampaign— Ruft Informationen über eine Kampagne ab.

Tutorials