Raccogli e trasferisci dati con le campagne - 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à.

Raccogli e trasferisci dati con le campagne

Una campagna è un'orchestrazione delle regole di raccolta dei dati. Le campagne forniscono al FleetWise software Edge Agent for AWS IoT istruzioni su come selezionare, raccogliere e trasferire dati sul cloud.

Crei campagne nel cloud. Dopo che tu o il tuo team avete approvato una campagna, l'AWSIoT la distribuisce FleetWise automaticamente sui veicoli. Puoi scegliere di distribuire una campagna su un veicolo o su una flotta di veicoli. Il software Edge Agent non inizia a raccogliere dati finché non viene distribuita una campagna in corso sul veicolo.

Nota

Le campagne non funzioneranno finché non avrai 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. Passa alla FleetWiseconsole AWS IoT.

    2. Nella home page del servizio, nella FleetWise sezione Guida introduttiva all'AWSIoT, scegli Explore Edge Agent.

  • Hai predisposto il AWS IoT Core rifornimento del tuo veicolo. Per ulteriori informazioni, consulta Veicoli di approvvigionamento.

Ogni campagna contiene le seguenti informazioni.

signalCatalogArn

L'Amazon Resource Name (ARN) del catalogo dei segnali associato alla campagna.

(Facoltativo) tags

I tag sono metadati che possono essere utilizzati per gestire la campagna. Puoi assegnare lo stesso tag a risorse di servizi diversi per indicare che le risorse sono correlate.

TargetArn

L'ARN di un veicolo o di una flotta su cui viene implementata la campagna.

name

Un nome univoco che aiuta a identificare la campagna.

collectionScheme

Gli schemi di raccolta dei dati forniscono al software Edge Agent istruzioni su quali dati raccogliere o quando raccoglierli. AWS L'IoT FleetWise attualmente supporta lo schema di raccolta basato sulle condizioni e lo schema di raccolta basato sul tempo.

conditionBasedCollectionScheme

Lo schema di raccolta basato sulle condizioni utilizza un'espressione logica per riconoscere quali dati raccogliere. Il software Edge Agent raccoglie i dati quando viene soddisfatta la condizione.

expression

L'espressione logica utilizzata per riconoscere quali dati raccogliere. Ad esempio, se viene specificata l'$variable.`myVehicle.InVehicleTemperature` > 50.0espressione, il software Edge Agent raccoglie valori di temperatura superiori a 50,0. Per istruzioni su come scrivere espressioni, vedere. Espressioni logiche per le campagne

(Facoltativo) triggerMode può essere uno dei seguenti valori.

  • RISING_EDGE— Il software Edge Agent raccoglie i dati solo quando la condizione viene soddisfatta per la prima volta. Ad esempio, $variable.`myVehicle.AirBagDeployed` == true.

  • ALWAYS— Il software Edge Agent raccoglie dati ogni volta che viene soddisfatta la condizione.

(Facoltativo) minimumTriggerIntervalMs

La durata minima tra due eventi di raccolta dati, in millisecondi. Se un segnale cambia spesso, è possibile raccogliere dati a una velocità inferiore.

(Facoltativo) conditionLanguageVersion

La versione del linguaggio di espressione condizionale.

timeBasedCollectionScheme

Quando definisci uno schema di raccolta basato sul tempo, specifica un periodo di tempo in millisecondi. Il software Edge Agent utilizza il periodo di tempo per decidere con quale frequenza raccogliere i dati. Ad esempio, se il periodo di tempo è 120.000 millisecondi, il software Edge Agent raccoglie i dati una volta ogni due minuti.

(Facoltativo) compression

Per risparmiare larghezza di banda wireless e ridurre il traffico di rete, puoi specificare SNAPPY per comprimere i dati nei veicoli.

Per impostazione predefinita (OFF), il software Edge Agent non comprime i dati.

dataDestinationConfigs

Scegli la destinazione in cui la campagna trasferirà i dati del veicolo. Puoi scegliere di archiviare i dati in Amazon S3 o Amazon Timestream.

S3 è un meccanismo di archiviazione dei dati conveniente che offre funzionalità di gestione dei dati durevoli e servizi dati a valle. Puoi utilizzare S3 per i dati relativi ai comportamenti di guida o all'analisi della manutenzione a lungo termine.

Timestream è un meccanismo di persistenza dei dati che può aiutarti a identificare tendenze e modelli quasi in tempo reale. Puoi utilizzare Timestream per dati di serie temporali, ad esempio per analizzare le tendenze storiche della velocità o della frenata dei veicoli.

(Facoltativo) dataExtraDimensions

È possibile aggiungere uno o più attributi per fornire informazioni aggiuntive per un segnale.

(Facoltativo) description

Puoi aggiungere una descrizione per aiutare a identificare lo scopo della campagna.

(Facoltativo) diagnosticsMode

Quando la modalità diagnostica è configurata suSEND_ACTIVE_DTCS, la campagna invia codici diagnostici di errore (DTC) standard memorizzati che aiutano a identificare i problemi del veicolo. Ad esempio, P0097 indica che il modulo di controllo del motore (ECM) ha stabilito che l'ingresso del sensore di temperatura dell'aria aspirata 2 (IAT2) è inferiore al normale intervallo di sensori.

Per impostazione predefinita (OFF), il software Edge Agent non invia codici diagnostici.

(Facoltativo) expiryTime

Puoi definire la data di scadenza della tua campagna. Quando la campagna scade, il software Edge Agent interrompe la raccolta dei dati come specificato in questa campagna. Se sul veicolo vengono distribuite più campagne, il software Edge Agent utilizza altre campagne per raccogliere dati.

Valore predefinito: 253402243200 (31 dicembre 9999, 00:00:00 UTC)

(Facoltativo) postTriggerCollectionDuration

È possibile definire una durata della raccolta post-attivazione, in modo che il software Edge Agent continui a raccogliere dati per un periodo specificato dopo la chiamata di uno schema. Ad esempio, se viene richiamato uno schema di raccolta basato sulle condizioni con la seguente espressione:$variable.`myVehicle.Engine.RPM` > 7000.0, il software Edge Agent continua a raccogliere i valori di giri al minuto (RPM) per il motore. Anche se l'RPM supera i 7000 solo una volta, potrebbe indicare che c'è un problema meccanico. In questo caso, potresti volere che il software Edge Agent continui a raccogliere dati per monitorare la condizione.

Valore predefinito: 0

(Facoltativo) priority

Puoi specificare un numero intero per indicare il livello di priorità della campagna. Le campagne con un numero inferiore hanno priorità più elevate. Se distribuisci più campagne su un veicolo, le campagne con priorità più elevate vengono avviate per prime.

Valore predefinito: 0

(Facoltativo) signalsToCollect

Un elenco di segnali da cui vengono raccolti i dati quando viene richiamato lo schema di raccolta dei dati.

Importante

I segnali utilizzati nell'espressione per lo schema di raccolta basato sulle condizioni devono essere specificati in questo campo.

name

Il nome del segnale da cui vengono raccolti i dati quando viene richiamato lo schema di raccolta dei dati.

(Facoltativo) maxSampleCount

Il numero massimo di campioni di dati che il software Edge Agent raccoglie e trasferisce nel cloud quando viene richiamato lo schema di raccolta dei dati.

(Facoltativo) minimumSamplingIntervalMs

La durata minima del tempo 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.

Intervallo valido: 0‐4294967295

(Facoltativo) spoolingMode

Se spoolingMode è configurato perTO_DISK, il software Edge Agent archivia 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.

Valore predefinito: OFF

(Facoltativo) startTime

Una campagna approvata viene attivata all'inizio.

Valore predefinito: 0

Lo stato di una campagna può corrispondere a uno dei seguenti valori.

  • CREATING— FleetWise L'AWSIoT sta elaborando la tua richiesta per creare la campagna.

  • WAITING_FOR_APPROVAL— Una volta creata, una campagna entra nello WAITING_FOR_APPROVAL stato. Per approvare la campagna, utilizza l'operazione UpdateCampaign API. Dopo l'approvazione della campagna, l'AWSIoT la distribuisce FleetWise automaticamente sul veicolo o sulla flotta bersaglio. Per ulteriori informazioni, consulta Aggiorna una campagna (AWS CLI).

  • RUNNING — La campagna è attiva.

  • SUSPENDED— La campagna è sospesa. Per riprendere la campagna, utilizza l'operazione UpdateCampaign API.

AWSL'IoT FleetWise fornisce le seguenti operazioni API che puoi utilizzare per creare e gestire campagne.

  • CreateCampaign— Crea una nuova campagna.

  • UpdateCampaign— Aggiorna una campagna esistente. Dopo aver creato una campagna, è necessario utilizzare questa operazione API per approvare la campagna.

  • DeleteCampaign— Elimina una campagna esistente.

  • ListCampaigns— Recupera un elenco impaginato di riepiloghi per tutte le campagne.

  • GetCampaign— Recupera informazioni su una campagna.

Tutorial