Crea una campagna (console)Crea una campagna (AWS CLI)

AWS L'IoT non FleetWise è più aperto a nuovi clienti. FleetWise I clienti AWS IoT esistenti possono continuare a utilizzare il servizio. La Guidance for Connected Mobility on AWS fornisce indicazioni su come sviluppare e implementare servizi modulari per soluzioni di mobilità connessa che possono essere utilizzate per ottenere funzionalità equivalenti a quelle dell' 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 un AWS FleetWise Campagna IoT

Importante

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

Puoi utilizzare la FleetWise console o l'API AWS IoT per creare campagne per raccogliere dati sui veicoli.

Importante

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

Il software Edge Agent è in esecuzione nel tuo 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 Guida introduttiva all' AWS IoT, scegli Explore Edge Agent.
Hai impostato AWS IoT Core il provisioning del tuo veicolo. Per ulteriori informazioni, consulta Fornitura AWS FleetWise Veicoli IoT.

Argomenti

Crea una campagna (console)

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

Per creare una campagna

Apri la FleetWise console AWS IoT.
Nel riquadro di navigazione, scegli Campagne.
Nella pagina Campagne, scegli Crea campagna, quindi completa i passaggi nei seguenti argomenti.

Argomenti

Fase 1: Configurazione della campagna
Passaggio 2: Specifica le condizioni di archiviazione e caricamento
Fase 3: Configurare la destinazione dei dati
Fase 4: Aggiungere veicoli
Passaggio 5: revisione e creazione
Fase 6: Implementa una campagna

Importante

Devi disporre di un catalogo di segnali e di un veicolo prima di creare una campagna. Per ulteriori informazioni, consulta Gestisci i cataloghi di FleetWise segnali AWS IoT e Manage (Gestione) AWS Veicoli IoT FleetWise.
Dopo aver creato una campagna, devi approvarla. Per ulteriori informazioni, consulta Aggiornare un AWS FleetWise Campagna IoT.

Fase 1: Configurazione della campagna

In Informazioni generali, procedi come segue:

Inserisci un nome per la campagna.
(Opzionale) Immettere una descrizione.

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

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

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

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

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

Nella sezione Dettagli dello schema di raccolta dati, scegli il tipo di schema di raccolta dati che desideri utilizzare per questa campagna. Per utilizzare un'espressione logica per riconoscere i dati del veicolo da raccogliere, scegli Condition-based. Per utilizzare un periodo di tempo specifico per decidere con quale frequenza raccogliere i dati del veicolo, scegli Time-based.
Definisci il periodo di tempo in cui la campagna raccoglie i dati.

Nota
Per impostazione predefinita, una campagna approvata viene attivata immediatamente e non ha un'ora di fine prestabilita. Per evitare costi aggiuntivi, è necessario specificare un intervallo di tempo.
Se hai specificato uno schema di raccolta dati basato su condizioni, devi definire un'espressione logica per riconoscere quali dati 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, vedere. Espressioni logiche per AWS FleetWise Campagne IoT

Immettete l'espressione logica utilizzata per riconoscere i dati da raccogliere.
(Facoltativo) Specificate la versione linguistica dell'espressione condizionale. Il valore predefinito è 1.
(Facoltativo) Specifica l'intervallo minimo di attivazione, ovvero il periodo di tempo minimo tra due eventi di raccolta dati. Ad esempio, se un segnale cambia spesso, potresti voler raccogliere dati a una velocità inferiore.
Specifica la condizione della modalità Trigger affinché il software Edge Agent raccolga i dati. Per impostazione predefinita, il FleetWise software Edge Agent for AWS IoT raccoglie sempre i dati ogni volta che viene soddisfatta la condizione. Oppure, può raccogliere dati solo quando la condizione viene soddisfatta per la prima volta, al primo trigger.
Se hai specificato uno schema di raccolta dati basato sul tempo, devi 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 che frequenza raccogliere i dati.
(Facoltativo) Modifica le opzioni dello schema avanzato dello schema.
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 distribuite per prime e sono considerate con una priorità più alta.
4. Il software Edge Agent può archiviare temporaneamente i dati localmente quando un veicolo non è connesso al cloud. Una volta ristabilita la connessione, i dati archiviati localmente vengono trasferiti automaticamente nel cloud. Specifica se desideri che l'Edge Agent memorizzi i dati localmente durante una perdita della connessione.
5. (Facoltativo) Per fornire informazioni aggiuntive su un segnale, aggiungi fino a cinque attributi come dimensioni aggiuntive dei dati.

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

Per importare informazioni sullo schema di raccolta dati, scegli Scegli i file. Per ulteriori informazioni sul formato di file richiesto, consulta la documentazione CreateCampaign API.

Nota
AWS IoT FleetWise attualmente supporta l'estensione del formato di file .json.
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: Specifica le condizioni di archiviazione e caricamento

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

In modalità spooling dei dati, 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.
- Archiviato 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 dalla sezione «persistenza» del file di configurazione di Edge Agent. L'Edge Agent trasferisce i dati sul cloud quando il veicolo si riconnette.
- Archiviato su disco con partizioni: il veicolo archivia sempre temporaneamente i dati sull'Edge nella partizione dati specificata. Puoi scegliere quando inoltrare i dati archiviati al cloud.
  1. (Facoltativo) Inserisci 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. Inserisci il periodo di tempo minimo per il quale i dati di questa partizione verranno conservati sul disco.
  5. (Facoltativo) Inserisci le condizioni di caricamento per la partizione.

Specifica i segnali

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

Per specificare i segnali da cui raccogliere i dati

Seleziona il nome del segnale.
(Facoltativo) Per Numero massimo di campioni, inserisci il numero massimo di campioni di dati che il software Edge Agent raccoglie e trasferisce nel cloud durante la campagna.
(Facoltativo) Per Intervallo di campionamento minimo, inserisci la durata minima tra due eventi di raccolta dei campioni di dati, in millisecondi. Se un segnale cambia spesso, è possibile utilizzare questo parametro per raccogliere dati a una velocità inferiore.
Per aggiungere un altro segnale, scegli Aggiungi altri segnali. Puoi aggiungere fino a 999 segnali.
Scegli Avanti.

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 Vision sono disponibili in 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 argomento MQTT o archiviarli in Amazon S3 o Amazon Timestream.

Nelle impostazioni di destinazione, procedi come segue:

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

Importante

Puoi trasferire dati a S3 solo se l' AWS IoT FleetWise dispone delle autorizzazioni per scrivere nel bucket S3. Per ulteriori informazioni sulla concessione dell'accesso, vedere Controllo dell'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 Amazon Simple Storage Service User Guide.

S3 ottimizza il costo dello storage 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. È possibile utilizzare S3 per archiviare i dati per l'elaborazione e l'analisi in batch. Ad esempio, puoi creare report sugli eventi frenanti per il tuo modello di machine learning (ML). I dati del veicolo in arrivo vengono memorizzati nel buffer per 10 minuti prima della consegna.

Nelle impostazioni di destinazione S3, procedi come segue:

Per il bucket S3, scegli un bucket con le autorizzazioni per. AWS IoT FleetWise
(Facoltativo) Inserisci un prefisso personalizzato da utilizzare per organizzare i dati archiviati nel bucket S3.
Scegli il formato di output, ovvero il formato dei file salvati nel bucket S3.
Scegli se vuoi comprimere i dati archiviati nel bucket S3 come file .gzip. Ti consigliamo di comprimere i dati perché riduce al minimo i costi di archiviazione.
Le opzioni selezionate nelle impostazioni di destinazione S3 modificano l'URI dell'oggetto S3 di esempio. Questo è un esempio di come vengono salvati i file in S3.

Importante

Puoi trasferire i dati su una tabella solo se AWS IoT FleetWise dispone delle autorizzazioni per scrivere dati in Timestream. Per ulteriori informazioni sulla concessione dell'accesso, consulta Controllare l'accesso con IoT. AWS 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 relativo al livello di carburante del veicolo. I dati del veicolo in entrata 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:

Per il nome del database Timestream, scegli il nome del tuo database Timestream dall'elenco a discesa.
Per il nome della tabella Timestream, scegli il nome della tua tabella Timestream dall'elenco a discesa.

In Accesso al servizio per Timestream, procedi come segue:

Scegli un ruolo IAM dall'elenco a discesa.

Importante

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

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

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

Nell'argomento MQTT, inserisci il nome dell'argomento.
Nell'argomento Accesso al servizio per MQTT, scegli se consentire a AWS IoT FleetWise Create e utilizzare un nuovo ruolo di servizio per te. Se desideri utilizzare un ruolo di servizio esistente, seleziona il ruolo nell'elenco a discesa in Seleziona ruolo.

Scegli Avanti.

Fase 4: Aggiungere veicoli

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

In Filtra veicoli, procedi come segue:

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

Nota
Ogni attributo può essere utilizzato una sola volta.
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.
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.
I veicoli che corrispondono alla tua ricerca sono elencati in Nome veicolo. Scegli i veicoli su cui vuoi distribuire la campagna.

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

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.

Fase 6: Implementa una campagna

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

Per distribuire una campagna

Nella pagina di riepilogo della campagna, scegli Distribuisci.
Verifica e conferma di voler iniziare la distribuzione e iniziare a raccogliere dati dai veicoli collegati alla campagna.
Seleziona 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 dei dati dai veicoli collegati alla campagna, scegli Riprendi.

Crea una campagna (AWS CLI)

Puoi utilizzare l'operazione CreateCampaign API per creare una campagna. Gli esempi seguenti utilizzano AWS CLI.

Quando crei una campagna, i dati raccolti dai veicoli possono essere inviati a un argomento MQTT 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 per fornire dati quasi in tempo reale e per utilizzare le regole per eseguire azioni definite o AWS IoT indirizzare i dati verso altre destinazioni.

Importante

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

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

Crea una campagna

Importante

È necessario disporre di un catalogo di segnali e di un veicolo o di una flotta prima di creare una campagna. Per ulteriori informazioni, consultare Gestisci i cataloghi di FleetWise segnali AWS IoT, Manage (Gestione) AWS Veicoli IoT FleetWise e Gestisci le flotte in AWS IoT FleetWise.
Dopo aver creato una campagna, è necessario utilizzare l'operazione UpdateCampaign API per approvare la campagna. Per ulteriori informazioni, consulta Aggiornare un AWS FleetWise Campagna IoT

Per creare una campagna, esegui il comando seguente.

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

Sostituiscilo campaign-name con il nome della campagna che stai creando.
Sostituisci signal-catalog-arn con l'Amazon Resource Name (ARN) del catalogo dei segnali.
Sostituiscilo target-arn con l'ARN di una flotta o di un veicolo che hai creato.
Sostituiscilo bucket-arn con l'ARN del 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).

Sostituiscilo campaign-name con il nome della campagna che stai creando.
Sostituisci signal-catalog-arn con l'ARN del catalogo dei segnali.
Sostituiscilo target-arn con l'ARN di una flotta o di un veicolo che hai creato.
Sostituisci role-arn con l'ARN del ruolo di esecuzione delle attività che concede all' AWS IoT l' FleetWise autorizzazione a fornire dati alla tabella Timestream.
Sostituisci table-arn con l'ARN della tabella 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": [ 
      { ...  }
  ]
}

Sostituiscilo campaign-name con il nome della campagna che stai creando.
Sostituisci signal-catalog-arn con l'Amazon Resource Name (ARN) del catalogo dei segnali.
Sostituiscilo target-arn con l'ARN di una flotta o di un veicolo che hai creato.
Sostituisci topic-arn con l'ARN dell'argomento MQTT che hai specificato come destinazione per i messaggi contenenti i dati del veicolo.
Sostituisci role-arn con l'ARN del ruolo di esecuzione delle attività che concede a AWS IoT l' FleetWise autorizzazione a inviare, ricevere ed eseguire azioni sui messaggi relativi all'argomento MQTT 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 politica in modo che il tuo ruolo possa richiamare l'operazione API. CreateCampaign

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

Gestisci i dati con le campagne

Espressioni logiche per AWS FleetWise Campagne IoT