Collectez et transférez des données grâce aux campagnes - AWS IoT FleetWise

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Collectez et transférez des données grâce aux campagnes

Une campagne est une orchestration de règles de collecte de données. Les campagnes fournissent au FleetWise logiciel Edge Agent for AWS IoT des instructions sur la manière de sélectionner, de collecter et de transférer des données vers le cloud.

Vous créez des campagnes dans le cloud. Une fois que vous ou votre équipe avez approuvé une campagne, AWS l'IoT la déploie FleetWise automatiquement sur les véhicules. Vous pouvez choisir de déployer une campagne sur un véhicule ou une flotte de véhicules. Le logiciel Edge Agent ne commence pas à collecter des données tant qu'une campagne en cours n'est pas déployée sur le véhicule.

Note

Les campagnes ne fonctionneront pas tant que vous n'aurez pas les éléments suivants.

  • Le logiciel Edge Agent est en cours d'exécution dans votre véhicule. Pour plus d'informations sur le développement, l'installation et l'utilisation du logiciel Edge Agent, procédez comme suit.

    1. Accédez à la FleetWiseconsole AWS IoT.

    2. Sur la page d'accueil du service, dans la FleetWise section Commencer avec AWS l'IoT, choisissez Explore Edge Agent.

  • Vous avez pris les dispositions nécessaires AWS IoT Core pour approvisionner votre véhicule. Pour en savoir plus, consultez Véhicules de ravitaillement.

Chaque campagne contient les informations suivantes.

signalCatalogArn

Le nom de ressource Amazon (ARN) du catalogue de signaux associé à la campagne.

(Facultatif) tags

Les tags sont des métadonnées qui peuvent être utilisées pour gérer la campagne. Vous pouvez attribuer le même tag à des ressources provenant de différents services pour indiquer que les ressources sont liées.

TargetArn

L'ARN d'un véhicule ou d'une flotte sur lequel la campagne est déployée.

name

Un nom unique qui permet d'identifier la campagne.

collectionScheme

Les schémas de collecte de données fournissent au logiciel Edge Agent des instructions sur les données à collecter ou à quel moment les collecter. AWS L'IoT prend FleetWise actuellement en charge le système de collecte basé sur les conditions et le système de collecte basé sur le temps.

conditionBasedCollectionScheme

Le schéma de collecte basé sur les conditions utilise une expression logique pour identifier les données à collecter. Le logiciel Edge Agent collecte des données lorsque la condition est remplie.

expression

L'expression logique utilisée pour identifier les données à collecter. Par exemple, si l'$variable.`myVehicle.InVehicleTemperature` > 50.0expression est spécifiée, le logiciel Edge Agent collecte des valeurs de température supérieures à 50,0. Pour obtenir des instructions sur la façon d'écrire des expressions, consultezExpressions logiques pour les campagnes.

(Facultatif) triggerMode peut être l'une des valeurs suivantes.

  • RISING_EDGE— Le logiciel Edge Agent collecte les données uniquement lorsque la condition est remplie pour la première fois. Par exemple, $variable.`myVehicle.AirBagDeployed` == true.

  • ALWAYS— Le logiciel Edge Agent collecte des données chaque fois que la condition est remplie.

(Facultatif) minimumTriggerIntervalMs

Durée minimale entre deux événements de collecte de données, en millisecondes. Si un signal change souvent, il est possible que vous collectiez des données à un rythme plus lent.

(Facultatif) conditionLanguageVersion

Version du langage d'expression conditionnelle.

timeBasedCollectionScheme

Lorsque vous définissez un schéma de collecte basé sur le temps, spécifiez une période en millisecondes. Le logiciel Edge Agent utilise cette période pour décider de la fréquence de collecte des données. Par exemple, si la période est de 120 000 millisecondes, le logiciel Edge Agent collecte les données toutes les deux minutes.

(Facultatif) compression

Pour économiser de la bande passante sans fil et réduire le trafic réseau, vous pouvez spécifier SNAPPY pour compresser les données dans les véhicules.

Par défaut (OFF), le logiciel Edge Agent ne compresse pas les données.

dataDestinationConfigs

Choisissez la destination où la campagne transférera les données du véhicule. Vous pouvez choisir de stocker les données dans Amazon S3 ou Amazon Timestream.

S3 est un mécanisme de stockage de données rentable qui offre des fonctionnalités de gestion des données durables et des services de données en aval. Vous pouvez utiliser S3 pour les données relatives aux comportements de conduite ou pour analyser la maintenance à long terme.

Timestream est un mécanisme de persistance des données qui peut vous aider à identifier les tendances et les modèles en temps quasi réel. Vous pouvez utiliser Timestream pour les données de séries chronologiques, par exemple pour analyser les tendances historiques en matière de vitesse ou de freinage du véhicule.

(Facultatif) dataExtraDimensions

Vous pouvez ajouter un ou plusieurs attributs afin de fournir des informations supplémentaires pour un signal.

(Facultatif) description

Vous pouvez ajouter une description pour aider à identifier l'objectif de la campagne.

(Facultatif) diagnosticsMode

Lorsque le mode diagnostic est configuré surSEND_ACTIVE_DTCS, la campagne envoie des codes de diagnostic standard (DTC) enregistrés qui aident à identifier le problème avec votre véhicule. Par exemple, P0097 indique que le module de commande du moteur (ECM) a déterminé que l'entrée du capteur de température de l'air d'admission 2 (IAT2) est inférieure à la plage normale du capteur.

Par défaut (OFF), le logiciel Edge Agent n'envoie pas de codes de diagnostic.

(Facultatif) expiryTime

Vous pouvez définir la date d'expiration de votre campagne. Lorsque la campagne expire, le logiciel Edge Agent arrête de collecter les données comme indiqué dans cette campagne. Si plusieurs campagnes sont déployées sur le véhicule, le logiciel Edge Agent utilise d'autres campagnes pour collecter des données.

Valeur par défaut : 253402243200 (31 décembre 1999, 00:00:00 UTC)

(Facultatif) postTriggerCollectionDuration

Vous pouvez définir une durée de collecte après le déclenchement, afin que le logiciel Edge Agent continue de collecter des données pendant une période spécifiée après l'appel d'un schéma. Par exemple, si un schéma de collecte basé sur des conditions avec l'expression suivante est invoqué :$variable.`myVehicle.Engine.RPM` > 7000.0, le logiciel Edge Agent continue de collecter les valeurs de tours par minute (RPM) pour le moteur. Même si le régime ne dépasse les 7000 qu'une seule fois, cela peut indiquer un problème mécanique. Dans ce cas, vous souhaiterez peut-être que le logiciel Edge Agent continue à collecter des données pour aider à surveiller la maladie.

Valeur par défaut : 0

(Facultatif) priority

Vous pouvez spécifier un entier pour indiquer le niveau de priorité de la campagne. Les campagnes dont le nombre est inférieur sont prioritaires. Si vous déployez plusieurs campagnes sur un véhicule, les campagnes les plus prioritaires sont lancées en premier.

Valeur par défaut : 0

(Facultatif) signalsToCollect

Liste des signaux à partir desquels les données sont collectées lorsque le schéma de collecte de données est invoqué.

Important

Les signaux utilisés dans l'expression du schéma de collecte basé sur les conditions doivent être spécifiés dans ce champ.

name

Nom du signal à partir duquel les données sont collectées lorsque le schéma de collecte de données est invoqué.

(Facultatif) maxSampleCount

Nombre maximal d'échantillons de données que le logiciel Edge Agent collecte et transfère vers le cloud lorsque le schéma de collecte de données est invoqué.

(Facultatif) minimumSamplingIntervalMs

Durée minimale entre deux événements de collecte d'échantillons de données, en millisecondes. Si un signal change souvent, vous pouvez utiliser ce paramètre pour collecter des données plus lentement.

Plage valide : 0‐4294967295

(Facultatif) spoolingMode

S'il spoolingMode est configuré pourTO_DISK, le logiciel Edge Agent stocke temporairement les données localement lorsqu'un véhicule n'est pas connecté au cloud. Une fois la connexion rétablie, les données stockées localement sont automatiquement transférées vers le cloud.

Valeur par défaut : OFF

(Facultatif) startTime

Une campagne approuvée est activée dès le début.

Valeur par défaut : 0

Le statut d'une campagne peut être l'une des valeurs suivantes.

  • CREATING— AWS FleetWise L'IoT traite votre demande de création de la campagne.

  • WAITING_FOR_APPROVAL— Une fois qu'une campagne est créée, elle entre dans l'WAITING_FOR_APPROVALétat. Pour approuver la campagne, utilisez l'opération UpdateCampaign API. Une fois la campagne approuvée, AWS l'IoT la déploie FleetWise automatiquement sur le véhicule ou le parc cible. Pour en savoir plus, consultez Mettre à jour une campagne (AWS CLI).

  • RUNNING — La campagne est active.

  • SUSPENDED— La campagne est suspendue. Pour reprendre la campagne, utilisez l'opération UpdateCampaign API.

AWSL'IoT FleetWise fournit les opérations d'API suivantes que vous pouvez utiliser pour créer et gérer des campagnes.

  • CreateCampaign— Crée une nouvelle campagne.

  • UpdateCampaign— Met à jour une campagne existante. Après la création d'une campagne, vous devez utiliser cette opération d'API pour l'approuver.

  • DeleteCampaign— Supprime une campagne existante.

  • ListCampaigns— Récupère une liste paginée de résumés pour toutes les campagnes.

  • GetCampaign— Récupère les informations relatives à une campagne.

Didacticiels