Créez une FleetWise campagne AWS IoT - 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.

Créez une FleetWise campagne AWS IoT

Important

L'accès à certaines FleetWise fonctionnalités de AWS l'IoT est actuellement restreint. Pour de plus amples informations, veuillez consulter AWS Disponibilité des régions et des fonctionnalités dans AWS l'IoT FleetWise.

Vous pouvez utiliser la FleetWise console AWS IoT ou créer des campagnes API pour collecter des données sur les véhicules.

Important

Pour que votre campagne fonctionne, vous devez disposer des é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. Ouvrez la FleetWise console 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 de plus amples informations, veuillez consulter Fournir AWS des FleetWise véhicules IoT.

Création d'une campagne (console)

Utilisez la FleetWise console AWS IoT pour créer une campagne visant à sélectionner, collecter et transférer les données des véhicules vers le cloud.

Création d'une campagne
  1. Ouvrez la FleetWise console AWS IoT.

  2. Dans le volet de navigation, choisissez Campaigns.

  3. Sur la page Campagnes, choisissez Créer une campagne, puis suivez les étapes décrites dans les rubriques suivantes.

Important

Étape 1 : Configuration de la campagne

Dans Informations générales, procédez comme suit :

  1. Entrez le nom de la campagne.

  2. (Facultatif) Entrez une description.

Configurez le schéma de collecte de données de la campagne. Un schéma de collecte de données fournit au logiciel Edge Agent des instructions sur les données à collecter ou à quel moment les collecter. Dans la FleetWise console AWS IoT, vous pouvez configurer un schéma de collecte de données de la manière suivante :

  • Définissez manuellement le schéma de collecte de données.

  • Téléchargez un fichier pour définir automatiquement le schéma de collecte de données.

Dans l'option Configuration, choisissez l'une des options suivantes :

  • Pour spécifier manuellement le type de schéma de collecte de données et définir les options permettant de personnaliser le schéma, choisissez Définir le schéma de collecte de données.

    Spécifiez manuellement le type de schéma de collecte de données et définissez les options pour personnaliser le schéma.

    1. Dans la section Détails du schéma de collecte de données, choisissez le type de schéma de collecte de données que vous souhaitez utiliser pour cette campagne. Pour utiliser une expression logique afin de reconnaître les données du véhicule à collecter, choisissez Condition-based. Pour utiliser une période spécifique afin de décider de la fréquence de collecte des données du véhicule, choisissez Basé sur le temps.

    2. Définissez la durée pendant laquelle la campagne collecte des données.

      Note

      Par défaut, une campagne approuvée est activée immédiatement et n'a pas d'heure de fin définie. Pour éviter des frais supplémentaires, vous devez spécifier une plage horaire.

    3. Si vous avez spécifié un schéma de collecte de données basé sur des conditions, vous devez définir une expression logique pour identifier les données à collecter. AWS L'IoT FleetWise utilise une expression logique pour identifier les données à collecter dans le cadre d'un schéma basé sur les conditions. L'expression doit spécifier le nom complet d'un signal en tant que variable, opérateur de comparaison et valeur de comparaison.

      Par exemple, si vous spécifiez l'$variable.`myVehicle.InVehicleTemperature` > 50.0expression, l' AWS IoT FleetWise 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 FleetWise campagnes AWS IoT.

      Entrez l'expression logique utilisée pour identifier les données à collecter.

    4. (Facultatif) Spécifiez la version linguistique de l'expression conditionnelle. La valeur par défaut est 1.

    5. (Facultatif) Spécifiez l'intervalle de déclenchement minimal, qui correspond à la durée minimale entre deux événements de collecte de données. Par exemple, si un signal change souvent, vous souhaiterez peut-être collecter des données à un rythme plus lent.

    6. Spécifiez la condition du mode déclencheur pour que le logiciel Edge Agent collecte des données. Par défaut, le FleetWise logiciel Edge Agent for AWS IoT collecte toujours des données chaque fois que la condition est remplie. Ou bien, il ne peut collecter des données que lorsque la condition est remplie pour la première fois, lors du premier déclencheur.

    7. Si vous avez spécifié un schéma de collecte de données basé sur le temps, vous devez spécifier une période, en millisecondes, comprise entre 10 000 et 60 000 millisecondes. Le logiciel Edge Agent utilise cette période pour décider de la fréquence de collecte des données.

    8. (Facultatif) Modifiez les options avancées du schéma.

      1. Pour économiser de la bande passante sans fil et réduire le trafic réseau en compressant les données, choisissez Snappy.

      2. (Facultatif) Pour définir la durée, en millisecondes, pendant laquelle vous pouvez continuer à collecter des données après un événement de collecte de données, vous pouvez spécifier la durée de collecte après le déclenchement.

      3. (Facultatif) Pour indiquer le niveau de priorité de la campagne, spécifiez la priorité de la campagne. Les campagnes dont le nombre de priorités est inférieur sont déployées en premier et sont considérées comme ayant une priorité plus élevée.

      4. Le logiciel Edge Agent peut stocker temporairement des 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. Spécifiez si vous souhaitez que l'agent Edge stocke les données localement en cas de perte de connexion.

      5. (Facultatif) Pour fournir des informations supplémentaires pour un signal, ajoutez jusqu'à cinq attributs en tant que dimensions de données supplémentaires.

  • Pour télécharger un fichier afin de définir le schéma de collecte de données, sélectionnez Télécharger un fichier .json depuis votre appareil local. AWS L'IoT définit FleetWise automatiquement les options que vous pouvez définir dans le fichier. Vous pouvez consulter et mettre à jour les options sélectionnées.

    Téléchargez un fichier .json contenant des informations détaillées sur le schéma de collecte de données.

    1. Pour importer des informations sur le schéma de collecte de données, choisissez Choisir des fichiers. Pour plus d'informations sur le format de fichier requis, consultez la CreateCampaignAPIdocumentation.

      Note

      AWS L'IoT prend FleetWise actuellement en charge l'extension de format de fichier .json.

    2. AWS L'IoT définit FleetWise automatiquement le schéma de collecte de données en fonction des informations contenues dans votre fichier. Passez en revue les options que AWS l'IoT a FleetWise sélectionnées pour vous. Vous pouvez mettre à jour les options, si nécessaire.

Étape 2 : Spécifier les conditions de stockage et de téléchargement

Pour choisir si le logiciel Edge Agent stockera temporairement les données localement lorsqu'un véhicule n'est pas connecté au cloud, spécifiez le mode de spoulage.

  • En mode Data spooling, choisissez l'une des options suivantes :

    • Non stocké — Le logiciel Edge Agent collecte mais ne stocke pas temporairement les données localement lorsqu'un véhicule est hors ligne. Le logiciel Edge Agent transfère les données vers le cloud lorsque le véhicule se reconnecte.

    • Stocké sur disque — Le logiciel Edge Agent collecte et stocke temporairement les données localement lorsqu'un véhicule est hors ligne. Les données collectées sont temporairement stockées à un emplacement défini dans la section « persistance » du fichier de configuration de l'agent Edge. L'agent Edge transfère les données vers le cloud lorsque le véhicule se reconnecte.

    • Stocké sur disque avec des partitions — Le véhicule stocke toujours temporairement les données sur l'Edge dans la partition de données que vous avez spécifiée. Vous pouvez choisir à quel moment vous souhaitez transférer vos données stockées vers le cloud.

      1. (Facultatif) Entrez un ID de partition pour désigner un ensemble de données particulier.

      2. Entrez un nom de dossier comme emplacement où les données seront stockées. Le chemin absolu de l'emplacement de stockage est{persistency_path} / {vehicle_name} / {campaign_name} / {storage_location}.

      3. Entrez la taille de stockage maximale des données stockées dans la partition. Les données les plus récentes remplacent les anciennes lorsque la partition atteint la taille maximale.

      4. Entrez la durée minimale pendant laquelle les données de cette partition seront conservées sur le disque.

      5. (Facultatif) Entrez les conditions de téléchargement pour la partition.

Spécifier les signaux

Vous pouvez définir les signaux à partir desquels collecter les données pendant la campagne.

Pour spécifier les signaux à partir desquels collecter des données
  1. Sélectionnez le nom du signal.

  2. (Facultatif) Pour Nombre maximum d'échantillons, entrez le nombre maximum d'échantillons de données que le logiciel Edge Agent collecte et transfère vers le cloud pendant la campagne.

  3. (Facultatif) Pour Intervalle d'échantillonnage minimal, entrez la 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.

  4. Pour ajouter un autre signal, choisissez Ajouter d'autres signaux. Vous pouvez ajouter jusqu'à 999 signaux.

  5. Choisissez Suivant.

Étape 3 : Configuration de la destination des données

Note

Si la campagne contient des signaux de données du système de vision, vous ne pouvez stocker les données du véhicule que dans Amazon S3. Vous ne pouvez pas le stocker dans Timestream ni l'envoyer à un MQTT sujet.

Les données du système de vision sont en version préliminaire et sont susceptibles d'être modifiées.

Amazon Timestream n'est pas disponible dans la région Asie-Pacifique (Mumbai).

Choisissez la destination vers laquelle vous souhaitez envoyer ou stocker les données collectées par la campagne. Vous pouvez envoyer les données du véhicule vers un MQTT sujet ou les stocker dans Amazon S3 ou Amazon Timestream.

Dans les paramètres de destination, procédez comme suit :

  • Choisissez Amazon S3, Amazon Timestream MQTT ou un sujet dans la liste déroulante.

Important

Vous ne pouvez transférer des données vers S3 que si AWS l'IoT FleetWise est autorisé à écrire dans le compartiment S3. Pour plus d'informations sur l'octroi d'accès, consultez la section Contrôle de l'accès avec AWS l'IoT FleetWise.

Pour stocker les données du véhicule dans un compartiment S3, choisissez Amazon S3. S3 est un service de stockage d'objets qui stocke les données sous forme d'objets dans des compartiments. Pour plus d'informations, consultez la section Création, configuration et utilisation des compartiments Amazon S3 dans le guide de l'utilisateur d'Amazon Simple Storage Service.

S3 optimise le coût du stockage des données et fournit des mécanismes supplémentaires pour utiliser les données des véhicules, tels que les lacs de données, le stockage centralisé des données, les pipelines de traitement des données et les analyses. Vous pouvez utiliser S3 pour stocker des données à des fins de traitement et d'analyse par lots. Par exemple, vous pouvez créer des rapports sur les événements de freinage brusque pour votre modèle d'apprentissage automatique (ML). Les données entrantes du véhicule sont mises en mémoire tampon pendant 10 minutes avant la livraison.

Dans les paramètres de destination S3, procédez comme suit :

  1. Pour le compartiment S3, choisissez un AWS IoT FleetWise compartiment autorisé à.

  2. (Facultatif) Entrez un préfixe personnalisé que vous pouvez utiliser pour organiser les données stockées dans le compartiment S3.

  3. Choisissez le format de sortie, c'est-à-dire le format des fichiers enregistrés dans le compartiment S3.

  4. Choisissez si vous souhaitez compresser les données stockées dans le compartiment S3 sous forme de fichier .gzip. Nous recommandons de compresser les données car cela permet de minimiser les coûts de stockage.

  5. Les options que vous sélectionnez dans les paramètres de destination S3 modifient l'objet Example S3 URI. Il s'agit d'un exemple de la forme sous laquelle les fichiers sont enregistrés dans S3.

Important

Vous ne pouvez transférer des données vers une table que si AWS l'IoT FleetWise est autorisé à écrire des données dans Timestream. Pour plus d'informations sur l'octroi d'accès, consultez la section Contrôle de l'accès avec AWS l'IoT FleetWise.

Amazon Timestream n'est pas disponible dans la région Asie-Pacifique (Mumbai).

Pour stocker les données du véhicule dans un tableau Timestream, choisissez Amazon Timestream. Vous pouvez utiliser Timestream pour interroger les données du véhicule afin d'identifier les tendances et les modèles. Par exemple, vous pouvez utiliser Timestream pour créer une alarme indiquant le niveau de carburant du véhicule. Les données entrantes du véhicule sont transférées vers Timestream quasiment en temps réel. Pour plus d'informations, consultez Qu'est-ce qu'Amazon Timestream ? dans le guide du développeur Amazon Timestream.

Dans les paramètres du tableau Timestream, procédez comme suit :

  1. Pour le nom de la base de données Timestream, choisissez le nom de votre base de données Timestream dans la liste déroulante.

  2. Pour le nom de la table Timestream, choisissez le nom de votre table Timestream dans la liste déroulante.

Dans Accès au service pour Timestream, procédez comme suit :

  • Choisissez un IAM rôle dans la liste déroulante.

Important

Vous ne pouvez acheminer des données vers un MQTT sujet que si AWS l'IoT FleetWise dispose d'autorisations AWS IoT sur les sujets. Pour plus d'informations sur l'octroi d'accès, consultez la section Contrôle de l'accès avec AWS l'IoT FleetWise.

Pour envoyer les données du véhicule à une MQTT rubrique, choisissez une MQTTrubrique.

Les données du véhicule envoyées par MQTT messagerie sont transmises en temps quasi réel et vous permettent d'utiliser des règles pour agir ou d'acheminer des données vers d'autres destinations. Pour plus d'informations sur l'utilisationMQTT, consultez la section Protocoles et règles de communication de l'appareil AWS IoT dans le guide du AWS IoT Core développeur.

  1. Dans le MQTTchamp Rubrique, entrez le nom de la rubrique.

  2. Sous Accès aux services pour le MQTT sujet, indiquez si vous souhaitez laisser AWS IoT FleetWise créer et utiliser un nouveau rôle de service pour vous. Si vous souhaitez utiliser un rôle de service existant, sélectionnez-le dans la liste déroulante sous Sélectionner un rôle.

  • Choisissez Suivant.

Étape 4 : Ajouter des véhicules

Pour choisir les véhicules sur lesquels déployer votre campagne, sélectionnez-les dans la liste des véhicules. Filtrez les véhicules en recherchant les attributs et leurs valeurs que vous avez ajoutés lors de la création des véhicules, ou par nom de véhicule.

Dans Filtrer les véhicules, procédez comme suit :

  1. Dans le champ de recherche, trouvez l'attribut ou le nom du véhicule et choisissez-le dans la liste.

    Note

    Chaque attribut ne peut être utilisé qu'une seule fois.

  2. Entrez la valeur de l'attribut ou le nom du véhicule sur lequel vous souhaitez déployer la campagne. Par exemple, si le nom complet de l'attribut estfuelType, entrez gasoline sa valeur.

  3. Pour rechercher un autre attribut de véhicule, répétez les étapes précédentes. Vous pouvez rechercher jusqu'à cinq attributs de véhicules et un nombre illimité de noms de véhicules.

  4. Les véhicules correspondant à votre recherche sont répertoriés sous Nom du véhicule. Choisissez les véhicules sur lesquels vous souhaitez déployer la campagne.

    Note

    Jusqu'à 100 véhicules sont affichés dans les résultats de recherche. Choisissez Tout sélectionner pour ajouter tous les véhicules à la campagne.

  5. Choisissez Suivant.

Étape 5 : Vérification et création

Vérifiez les configurations de la campagne, puis choisissez Créer une campagne.

Note

Après la création d'une campagne, vous ou votre équipe devez la déployer sur les véhicules.

Étape 6 : Déployer une campagne

Après avoir créé une campagne, vous ou votre équipe devez la déployer sur les véhicules.

Pour déployer une campagne
  1. Sur la page de résumé de la campagne, choisissez Déployer.

  2. Vérifiez et confirmez que vous souhaitez démarrer le déploiement et commencer à collecter les données des véhicules connectés à la campagne.

  3. Choisissez Deploy (Déployer).

Si vous souhaitez suspendre la collecte de données auprès des véhicules connectés à la campagne, sur la page récapitulative de la campagne, choisissez Suspendre. Pour reprendre la collecte de données auprès des véhicules connectés à la campagne, sélectionnez Reprendre.

Création d'une campagne (AWS CLI)

Vous pouvez utiliser cette CreateCampaignAPIopération pour créer une campagne. L'exemple suivant repose sur AWS CLI.

Lorsque vous créez une campagne, les données collectées auprès des véhicules peuvent être envoyées à un MQTT sujet ou stockées dans Amazon S3 (S3) ou Amazon Timestream. Choisissez Timestream pour une base de données de séries chronologiques rapide, évolutive et sans serveur, par exemple pour stocker des données nécessitant un traitement en temps quasi réel. Choisissez S3 pour le stockage d'objets avec une évolutivité, une disponibilité des données, une sécurité et des performances de pointe. Choisissez MQTT de fournir des données en temps quasi réel et d'utiliser des règles pour AWS IoT effectuer les actions que vous définissez ou acheminez les données vers d'autres destinations.

Important

Vous ne pouvez transférer les données du véhicule vers un MQTT sujet, Amazon S3 ou Amazon Timestream que AWS si l' FleetWise IoT est autorisé MQTT à envoyer des messages en votre nom ou à écrire des données dans S3 ou Timestream. Pour plus d'informations sur l'octroi d'accès, consultez la section Contrôle de l'accès avec AWS l'IoT FleetWise.

Amazon Timestream n'est pas disponible dans la région Asie-Pacifique (Mumbai).

Création d'une campagne

Important

Pour créer une campagne, exécutez la commande suivante.

Remplacez file-name avec le nom du fichier .json qui contient la configuration de la campagne.

aws iotfleetwise create-campaign --cli-input-json file://file-name.json
  • Remplacez campaign-name avec le nom de la campagne que vous créez.

  • Remplacez signal-catalog-arn avec le Amazon Resource Name (ARN) du catalogue de signaux.

  • Remplacez target-arn avec celui ARN d'une flotte ou d'un véhicule que vous avez créé.

  • Remplacez bucket-arn avec ARN le compartiment S3.

{ "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": [ { ... } ] }
Note

Amazon Timestream n'est pas disponible dans la région Asie-Pacifique (Mumbai).

  • Remplacez campaign-name avec le nom de la campagne que vous créez.

  • Remplacez signal-catalog-arn avec le catalogue ARN de signaux.

  • Remplacez target-arn avec celui ARN d'une flotte ou d'un véhicule que vous avez créé.

  • Remplacez role-arn avec le rôle ARN d'exécution des tâches qui autorise l' AWS IoT FleetWise à fournir des données à la table Timestream.

  • Remplacez table-arn avec le ARN tableau Timestream.

{ "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": [ { ... } ] }
  • Remplacez campaign-name avec le nom de la campagne que vous créez.

  • Remplacez signal-catalog-arn avec le Amazon Resource Name (ARN) du catalogue de signaux.

  • Remplacez target-arn avec celui ARN d'une flotte ou d'un véhicule que vous avez créé.

  • Remplacez topic-arn avec le ARN MQTTsujet que vous avez spécifié comme destination pour les messages contenant des données du véhicule.

  • Remplacez role-arn avec le rôle ARN d'exécution des tâches qui accorde à l' AWS IoT FleetWise l'autorisation d'envoyer, de recevoir et d'agir sur des messages relatifs au MQTT sujet que vous avez spécifié.

{ "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" } } ] }

Si vous avez activé le chiffrement à l'aide d'une AWS KMS clé gérée par le client, incluez la déclaration de politique suivante afin que votre rôle puisse invoquer l'CreateCampaignAPIopération.

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "kms:GenerateDataKey*", "kms:Decrypt" ], "Resource": [ "arn:aws:kms:KMS_KEY_REGION:KMS_KEY_ACCOUNT_ID:key/KMS_KEY_ID" ] }, ] }