Crea una FleetWise campagna AWS IoT - AWS IoT FleetWise

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Crea una FleetWise campagna AWS IoT

Importante

L'accesso a determinate FleetWise funzionalità AWS IoT è attualmente limitato. Per ulteriori informazioni, consulta AWS Disponibilità di aree e funzionalità nell' AWS IoT FleetWise.

Puoi utilizzare la FleetWise console AWS IoT o API creare campagne per raccogliere i dati dei veicoli.

Importante

Affinché la tua campagna funzioni, devi disporre di quanto segue:

  • Il software Edge Agent è in esecuzione nel veicolo. Per ulteriori informazioni su come sviluppare, installare e utilizzare il software Edge Agent, procedi come segue:

    1. Apri la FleetWise console AWS IoT.

    2. Nella home page del servizio, nella FleetWise sezione Introduzione all' AWS IoT, scegli Explore Edge Agent.

  • Hai predisposto il AWS IoT Core rifornimento del tuo veicolo. Per ulteriori informazioni, consulta Fornitura di FleetWise veicoli AWS IoT.

Crea una campagna (console)

Usa la FleetWise console AWS IoT per creare una campagna per selezionare, raccogliere e trasferire i dati dei veicoli sul cloud.

Per creare una campagna
  1. Apri la FleetWise console AWS IoT.

  2. Nel riquadro di navigazione, scegli Campagne.

  3. Nella pagina Campagne, scegli Crea campagna, quindi completa i passaggi indicati nei seguenti argomenti.

Importante

Fase 1: Configurare la campagna

In Informazioni generali, procedi come segue:

  1. Inserisci un nome per la campagna.

  2. (Opzionale) Immettere una descrizione.

Configura lo schema di raccolta dati della campagna. Uno schema di raccolta dati fornisce al software Edge Agent istruzioni su quali dati raccogliere o quando raccoglierli. Nella FleetWise console AWS IoT, puoi configurare uno schema di raccolta dati nei seguenti modi:

  • Definire manualmente lo schema di raccolta dei dati.

  • Carica un file per definire automaticamente lo schema di raccolta dei dati.

Nell'opzione di configurazione, scegliete una delle seguenti opzioni:

  • Per specificare manualmente il tipo di schema di raccolta dati e definire le opzioni per personalizzare lo schema, scegliete Definisci schema di raccolta dati.

    Specificate manualmente il tipo di schema di raccolta dati e definite le opzioni per personalizzare lo schema.

    1. Nella sezione Dettagli dello schema di raccolta dati, scegli il tipo di schema di raccolta dati che desideri venga utilizzato da questa campagna. Per utilizzare un'espressione logica per riconoscere i dati del veicolo da raccogliere, scegli Basato sulle condizioni. Per utilizzare un periodo di tempo specifico per decidere con quale frequenza raccogliere i dati del veicolo, scegli Basato sul tempo.

    2. Definisci la durata della raccolta dei dati da parte della campagna.

      Nota

      Per impostazione predefinita, una campagna approvata viene attivata immediatamente e non ha un'ora di fine impostata. Per evitare costi aggiuntivi, devi specificare un intervallo di tempo.

    3. Se è stato specificato uno schema di raccolta dati basato sulle condizioni, è necessario definire un'espressione logica per riconoscere i dati da raccogliere. AWS L'IoT FleetWise utilizza un'espressione logica per riconoscere quali dati raccogliere per uno schema basato sulle condizioni. L'espressione deve specificare il nome completo di un segnale come variabile, operatore di confronto e valore di confronto.

      Ad esempio, se si specifica l'$variable.`myVehicle.InVehicleTemperature` > 50.0espressione, AWS IoT FleetWise raccoglie valori di temperatura superiori a 50,0. Per istruzioni su come scrivere espressioni, consulta. Espressioni logiche per FleetWise campagne AWS IoT

      Immettere l'espressione logica utilizzata per riconoscere i dati da raccogliere.

    4. (Facoltativo) Specificate la versione linguistica dell'espressione condizionale. Il valore predefinito è 1.

    5. (Facoltativo) Specificate l'intervallo minimo di attivazione, che è il periodo di tempo minimo tra due eventi di raccolta dati. Ad esempio, se un segnale cambia spesso, potresti voler raccogliere i dati a una velocità inferiore.

    6. Specificare la condizione della modalità Trigger per la raccolta dei dati da parte del software Edge Agent. Per impostazione predefinita, il FleetWise software Edge Agent for AWS IoT raccoglie sempre i dati ogni volta che viene soddisfatta la condizione. In alternativa, può raccogliere dati solo quando la condizione viene soddisfatta per la prima volta, al primo trigger.

    7. Se è stato specificato uno schema di raccolta dati basato sul tempo, è necessario specificare un periodo di tempo, in millisecondi, compreso tra 10.000 e 60.000 millisecondi. Il software Edge Agent utilizza il periodo di tempo per decidere con quale frequenza raccogliere i dati.

    8. (Facoltativo) Modificate le opzioni dello schema avanzato.

      1. Per risparmiare larghezza di banda wireless e ridurre il traffico di rete comprimendo i dati, scegli Snappy.

      2. (Facoltativo) Per definire per quanto tempo, in millisecondi, continuare a raccogliere dati dopo un evento di raccolta dati, puoi specificare la durata della raccolta Post Trigger.

      3. (Facoltativo) Per indicare il livello di priorità della campagna, specifica la priorità della campagna. Le campagne con un numero di priorità inferiore vengono implementate per prime e sono considerate con una priorità più elevata.

      4. Il software Edge Agent può archiviare temporaneamente i dati localmente quando un veicolo non è connesso al cloud. Dopo aver ristabilito la connessione, i dati archiviati localmente vengono trasferiti automaticamente nel cloud. Specificate se desiderate che Edge Agent memorizzi i dati localmente durante una connessione interrotta.

      5. (Facoltativo) Per fornire informazioni aggiuntive su un segnale, aggiungi fino a cinque attributi come dimensioni dati aggiuntive.

  • Per caricare un file per definire lo schema di raccolta dei dati, seleziona Carica un file.json dal tuo dispositivo locale. AWS L'IoT definisce FleetWise automaticamente le opzioni che è possibile definire nel file. È possibile rivedere e aggiornare le opzioni selezionate.

    Carica un file.json con dettagli sullo schema di raccolta dei dati.

    1. Per importare informazioni sullo schema di raccolta dati, scegli Scegli file. Per ulteriori informazioni sul formato di file richiesto, consulta la CreateCampaignAPIdocumentazione.

      Nota

      AWS FleetWise Attualmente IoT supporta l'estensione del formato di file.json.

    2. AWS L'IoT definisce FleetWise automaticamente lo schema di raccolta dei dati in base alle informazioni contenute nel file. Esamina le opzioni che l' AWS IoT ha FleetWise selezionato per te. Puoi aggiornare le opzioni, se necessario.

Passaggio 2: Specificare le condizioni di archiviazione e caricamento

Per scegliere se il software Edge Agent archivierà temporaneamente i dati localmente quando un veicolo non è connesso al cloud, specifica la modalità spooling.

  • In modalità Data spooling, scegli una delle seguenti opzioni:

    • Non archiviato: il software Edge Agent raccoglie ma non archivia temporaneamente i dati localmente quando un veicolo è offline. Il software Edge Agent trasferisce i dati sul cloud quando il veicolo si riconnette.

    • Archiviati su disco: il software Edge Agent raccoglie e archivia temporaneamente i dati localmente quando un veicolo è offline. I dati raccolti vengono temporaneamente archiviati in una posizione definita nella sezione «persistenza» del file di configurazione di Edge Agent. L'Edge Agent trasferisce i dati sul cloud quando il veicolo si riconnette.

    • Archiviati su disco con partizioni: il veicolo memorizza sempre temporaneamente i dati su Edge nella partizione dati specificata. Puoi scegliere quando inoltrare i dati memorizzati al cloud.

      1. (Facoltativo) Immettete un ID di partizione per designare un particolare set di dati.

      2. Immettete il nome di una cartella come posizione in cui verranno archiviati i dati. Il percorso assoluto della posizione di archiviazione è{persistency_path} / {vehicle_name} / {campaign_name} / {storage_location}.

      3. Immettere la dimensione massima di archiviazione dei dati memorizzati nella partizione. I dati più recenti sovrascrivono i dati più vecchi quando la partizione raggiunge la dimensione massima.

      4. Immettete la quantità minima di tempo in cui i dati di questa partizione verranno conservati sul disco.

      5. (Facoltativo) Inserite le condizioni di caricamento per la partizione.

Specificare i segnali

Puoi specificare i segnali da cui raccogliere i dati durante la campagna.

Per specificare i segnali da cui raccogliere i dati
  1. Seleziona il nome del segnale.

  2. (Facoltativo) Per Numero massimo di campioni, inserisci il numero massimo di campioni di dati che il software Edge Agent raccoglie e trasferisce sul cloud durante la campagna.

  3. (Facoltativo) Per Intervallo di campionamento minimo, immettete la durata minima tra due eventi di raccolta dei campioni di dati, in millisecondi. Se un segnale cambia spesso, puoi utilizzare questo parametro per raccogliere dati a una velocità inferiore.

  4. Per aggiungere un altro segnale, scegli Aggiungi altri segnali. Puoi aggiungere fino a 999 segnali.

  5. Scegli Next (Successivo).

Fase 3: Configurare la destinazione dei dati

Nota

Se la campagna contiene segnali di dati del sistema di visione, puoi archiviare i dati del veicolo solo in Amazon S3. Non puoi archiviarli in Timestream o inviarli a un argomento. MQTT

I dati del sistema di visione sono in versione di anteprima e sono soggetti a modifiche.

Amazon Timestream non è disponibile nella regione Asia Pacifico (Mumbai).

Scegli la destinazione in cui desideri inviare o archiviare i dati raccolti dalla campagna. Puoi inviare i dati del veicolo a un MQTT argomento o archiviarli in Amazon S3 o Amazon Timestream.

Nelle impostazioni di destinazione, procedi come segue:

  • Scegli Amazon S3, Amazon Timestream MQTT o un argomento dall'elenco a discesa.

Importante

Puoi trasferire dati su S3 solo se AWS IoT FleetWise dispone delle autorizzazioni per scrivere nel bucket S3. Per ulteriori informazioni sulla concessione dell'accesso, consulta Controllare l'accesso con AWS IoT FleetWise.

Per archiviare i dati del veicolo in un bucket S3, scegli Amazon S3. S3 è un servizio di storage di oggetti che archivia i dati come oggetti all'interno di bucket. Per ulteriori informazioni, consulta Creazione, configurazione e utilizzo dei bucket Amazon S3 nella Guida per l'utente di Amazon Simple Storage Service.

S3 ottimizza il costo dell'archiviazione dei dati e fornisce meccanismi aggiuntivi per utilizzare i dati dei veicoli, come data lake, archiviazione centralizzata dei dati, pipeline di elaborazione dei dati e analisi. Puoi utilizzare S3 per archiviare i dati per l'elaborazione e l'analisi in batch. Ad esempio, puoi creare report di eventi di frenata brusca per il tuo modello di machine learning (ML). I dati del veicolo in entrata vengono memorizzati nel buffer per 10 minuti prima della consegna.

Nelle impostazioni di destinazione di S3, procedi come segue:

  1. Per il bucket S3, scegli un bucket con autorizzazioni per. AWS IoT FleetWise

  2. (Facoltativo) Inserisci un prefisso personalizzato che puoi utilizzare per organizzare i dati archiviati nel bucket S3.

  3. Scegli il formato di output, ovvero il formato dei file che vengono salvati come nel bucket S3.

  4. Scegli se vuoi comprimere i dati memorizzati nel bucket S3 come file.gzip. Consigliamo di comprimere i dati perché riduce al minimo i costi di archiviazione.

  5. Le opzioni selezionate nelle impostazioni di destinazione S3 modificano l'oggetto S3 di esempio. URI Questo è un esempio di come i file vengono salvati in S3.

Importante

Puoi trasferire dati su una tabella solo se l' AWS IoT FleetWise dispone delle autorizzazioni per scrivere dati in Timestream. Per ulteriori informazioni sulla concessione dell'accesso, consulta Controllare l'accesso con AWS IoT FleetWise.

Amazon Timestream non è disponibile nella regione Asia Pacifico (Mumbai).

Per archiviare i dati del veicolo in una tabella Timestream, scegli Amazon Timestream. Puoi utilizzare Timestream per interrogare i dati dei veicoli in modo da identificare tendenze e modelli. Ad esempio, puoi utilizzare Timestream per creare un allarme per il livello di carburante del veicolo. I dati del veicolo in arrivo vengono trasferiti su Timestream quasi in tempo reale. Per ulteriori informazioni, consulta Cos'è Amazon Timestream? nella Amazon Timestream Developer Guide.

Nelle impostazioni della tabella Timestream, procedi come segue:

  1. Per il nome del database Timestream, scegli il nome del tuo database Timestream dall'elenco a discesa.

  2. Per il nome della tabella Timestream, scegli il nome della tabella Timestream dall'elenco a discesa.

In Accesso al servizio per Timestream, procedi come segue:

  • Scegli un IAM ruolo dall'elenco a discesa.

Importante

Puoi indirizzare i dati a un MQTT argomento solo se l' AWS IoT FleetWise dispone delle autorizzazioni per AWS IoT gli argomenti. Per ulteriori informazioni sulla concessione dell'accesso, consulta Controllare l'accesso con AWS IoT FleetWise.

Per inviare i dati del veicolo a un MQTT argomento, scegli MQTTargomento.

I dati sui veicoli inviati tramite MQTT messaggistica vengono forniti quasi in tempo reale e consentono di utilizzare le regole per agire o indirizzare i dati verso altre destinazioni. Per ulteriori informazioni sull'utilizzoMQTT, consulta Protocolli e regole di comunicazione dei dispositivi AWS IoT nella Guida per gli AWS IoT Core sviluppatori.

  1. In MQTTArgomento, inserisci il nome dell'argomento.

  2. In Accesso ai servizi per MQTT argomento, scegli se consentire a AWS IoT di FleetWise creare e utilizzare un nuovo ruolo di servizio per te. Se desideri utilizzare un ruolo di servizio esistente, seleziona il ruolo nell'elenco a discesa sotto Seleziona ruolo.

  • Scegli Next (Successivo).

Fase 4: Aggiungere veicoli

Per scegliere su quali veicoli distribuire la tua campagna, selezionali nell'elenco dei veicoli. Filtra i veicoli cercando gli attributi e i relativi valori aggiunti durante la creazione dei veicoli o in base al nome del veicolo.

In Filtra veicoli, procedi come segue:

  1. Nella casella di ricerca, trova l'attributo o il nome del veicolo e selezionalo dall'elenco.

    Nota

    Ogni attributo può essere utilizzato una sola volta.

  2. Inserisci il valore dell'attributo o il nome del veicolo su cui desideri distribuire la campagna. Ad esempio, se il nome completo dell'attributo èfuelType, inseriscilo gasoline come valore.

  3. Per cercare un altro attributo del veicolo, ripeti i passaggi precedenti. Puoi cercare fino a cinque attributi del veicolo e un numero illimitato di nomi di veicoli.

  4. I veicoli che corrispondono alla tua ricerca sono elencati sotto Nome veicolo. Scegli i veicoli su cui vuoi che venga lanciata la campagna.

    Nota

    Nei risultati di ricerca vengono visualizzati fino a 100 veicoli. Scegli Seleziona tutto per aggiungere tutti i veicoli alla campagna.

  5. Scegli Next (Successivo).

Passaggio 5: revisione e creazione

Verifica le configurazioni per la campagna, quindi scegli Crea campagna.

Nota

Dopo aver creato una campagna, tu o il tuo team dovete distribuirla sui veicoli.

Passaggio 6: Distribuisci una campagna

Dopo aver creato una campagna, tu o il tuo team dovete distribuirla sui veicoli.

Per distribuire una campagna
  1. Nella pagina di riepilogo della campagna, scegli Distribuisci.

  2. Verifica e conferma che desideri avviare l'implementazione e iniziare a raccogliere dati dai veicoli collegati alla campagna.

  3. Seleziona Deploy (Implementa).

Se desideri sospendere la raccolta dei dati dai veicoli collegati alla campagna, nella pagina di riepilogo della campagna scegli Sospendi. Per riprendere la raccolta di dati dai veicoli collegati alla campagna, scegli Riprendi.

Crea una campagna ()AWS CLI

È possibile utilizzare l'CreateCampaignAPIoperazione per creare una campagna. Gli esempi seguenti utilizzano AWS CLI.

Quando crei una campagna, i dati raccolti dai veicoli possono essere inviati a un MQTT argomento o archiviati in Amazon S3 (S3) o Amazon Timestream. Scegli Timestream per un database di serie temporali veloce, scalabile e senza server, ad esempio per archiviare dati che richiedono un'elaborazione quasi in tempo reale. Scegli S3 per lo storage di oggetti con scalabilità, disponibilità dei dati, sicurezza e prestazioni leader del settore. Scegli MQTT di fornire i dati quasi in tempo reale e di utilizzare le regole per eseguire azioni da te definite o AWS IoT instradare i dati verso altre destinazioni.

Importante

Puoi trasferire i dati del veicolo su un MQTT argomento, Amazon S3 o Amazon Timestream solo se l' AWS FleetWise IoT dispone delle autorizzazioni per MQTT inviare messaggi per tuo conto o per scrivere dati in S3 o Timestream. Per ulteriori informazioni sulla concessione dell'accesso, consulta Controllare l'accesso con AWS IoT FleetWise.

Amazon Timestream non è disponibile nella regione Asia Pacifico (Mumbai).

Crea campagna

Importante

Per creare una campagna, esegui il comando seguente.

Replace (Sostituisci) file-name con il nome del file.json che contiene la configurazione della campagna.

aws iotfleetwise create-campaign --cli-input-json file://file-name.json
  • Replace (Sostituisci) campaign-name con il nome della campagna che stai creando.

  • Replace (Sostituisci) signal-catalog-arn con l'Amazon Resource Name (ARN) del catalogo dei segnali.

  • Replace (Sostituisci) target-arn con il nome ARN di una flotta o di un veicolo che hai creato.

  • Replace (Sostituisci) bucket-arn con il ARN bucket 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": [ { ... } ] }
Nota

Amazon Timestream non è disponibile nella regione Asia Pacifico (Mumbai).

  • Replace (Sostituisci) campaign-name con il nome della campagna che stai creando.

  • Replace (Sostituisci) signal-catalog-arn con il catalogo ARN dei segnali.

  • Replace (Sostituisci) target-arn con il nome ARN di una flotta o di un veicolo che hai creato.

  • Replace (Sostituisci) role-arn con il ruolo ARN di esecuzione delle attività che concede l' FleetWise autorizzazione AWS IoT a fornire dati alla tabella Timestream.

  • Replace (Sostituisci) table-arn con la tabella ARN 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": [ { ... } ] }
  • Replace (Sostituisci) campaign-name con il nome della campagna che stai creando.

  • Replace (Sostituisci) signal-catalog-arn con l'Amazon Resource Name (ARN) del catalogo dei segnali.

  • Replace (Sostituisci) target-arn con il nome ARN di una flotta o di un veicolo che hai creato.

  • Replace (Sostituisci) topic-arn con ARN l'MQTTargomento che hai specificato come destinazione per i messaggi contenenti i dati del veicolo.

  • Replace (Sostituisci) role-arn con il ruolo ARN di esecuzione dell'attività che concede l' FleetWise autorizzazione AWS IoT a inviare, ricevere e agire sui messaggi relativi all'MQTTargomento specificato.

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

Se hai abilitato la crittografia utilizzando una AWS KMS chiave gestita dal cliente, includi la seguente dichiarazione sulla politica in modo che il tuo ruolo possa richiamare l'CreateCampaignAPIoperazione.

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