Mengumpulkan dan mentransfer data dengan kampanye - AWS IoT FleetWise

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Mengumpulkan dan mentransfer data dengan kampanye

Kampanye adalah orkestrasi aturan pengumpulan data. Kampanye memberikan instruksi FleetWise perangkat lunak Agen Edge untuk AWS IoT tentang cara memilih, mengumpulkan, dan mentransfer data ke cloud.

Anda membuat kampanye di cloud. Setelah Anda atau tim Anda menyetujui kampanye, AWS IoT FleetWise secara otomatis menyebarkannya ke kendaraan. Anda dapat memilih untuk menyebarkan kampanye ke kendaraan atau armada kendaraan. Perangkat lunak Edge Agent tidak mulai mengumpulkan data sampai kampanye yang sedang berjalan diterapkan ke kendaraan.

catatan

Kampanye tidak akan berfungsi sampai Anda memiliki yang berikut ini.

  • Perangkat lunak Edge Agent berjalan di kendaraan Anda. Untuk informasi lebih lanjut tentang cara mengembangkan, menginstal, dan bekerja dengan perangkat lunak Edge Agent, lakukan hal berikut.

    1. Arahkan ke konsol AWSIoT FleetWise.

    2. Di halaman beranda layanan, di FleetWise bagian Memulai dengan AWS IoT, pilih Explore Edge Agent.

  • Anda telah mengatur AWS IoT Core untuk menyediakan kendaraan Anda. Untuk informasi selengkapnya, lihat Kendaraan penyediaan.

Setiap kampanye berisi informasi berikut.

signalCatalogArn

Nama Sumber Daya Amazon (ARN) dari katalog sinyal yang terkait dengan kampanye.

(Opsional) tags

Tag adalah metadata yang dapat digunakan untuk mengelola kampanye. Anda dapat menetapkan tag yang sama ke sumber daya dari layanan yang berbeda untuk menunjukkan bahwa sumber daya terkait.

TargetArn

ARN kendaraan atau armada tempat kampanye dikerahkan.

name

Nama unik yang membantu mengidentifikasi kampanye.

collectionScheme

Skema pengumpulan data memberikan instruksi perangkat lunak Edge Agent tentang data apa yang harus dikumpulkan atau kapan harus mengumpulkannya. AWS IoT FleetWise saat ini mendukung skema pengumpulan berbasis kondisi dan skema pengumpulan berbasis waktu.

conditionBasedCollectionScheme

Skema pengumpulan berbasis kondisi menggunakan ekspresi logis untuk mengenali data apa yang akan dikumpulkan. Perangkat lunak Edge Agent mengumpulkan data ketika kondisi terpenuhi.

expression

Ekspresi logis digunakan untuk mengenali data apa yang akan dikumpulkan. Misalnya, jika $variable.`myVehicle.InVehicleTemperature` > 50.0 ekspresi ditentukan, perangkat lunak Edge Agent mengumpulkan nilai suhu yang lebih besar dari 50,0. Untuk petunjuk tentang cara menulis ekspresi, lihatEkspresi logis untuk kampanye.

(Opsional) triggerMode dapat menjadi salah satu dari nilai-nilai berikut.

  • RISING_EDGE— Perangkat lunak Edge Agent mengumpulkan data hanya ketika kondisi terpenuhi untuk pertama kalinya. Sebagai contoh, $variable.`myVehicle.AirBagDeployed` == true.

  • ALWAYS— Perangkat lunak Edge Agent mengumpulkan data setiap kali kondisi terpenuhi.

(Opsional) minimumTriggerIntervalMs

Durasi minimum waktu antara dua peristiwa pengumpulan data, dalam milidetik. Jika sinyal sering berubah, Anda mungkin mengumpulkan data pada tingkat yang lebih lambat.

(Opsional) conditionLanguageVersion

Versi bahasa ekspresi bersyarat.

timeBasedCollectionScheme

Saat Anda menentukan skema pengumpulan berbasis waktu, tentukan periode waktu dalam milidetik. Perangkat lunak Edge Agent menggunakan periode waktu untuk memutuskan seberapa sering mengumpulkan data. Misalnya, jika periode waktunya 120.000 milidetik, perangkat lunak Edge Agent mengumpulkan data setiap dua menit sekali.

(Opsional) compression

Untuk menghemat bandwidth nirkabel dan mengurangi lalu lintas jaringan, Anda dapat menentukan SNAPPY untuk mengompres data di kendaraan.

Secara default (OFF), perangkat lunak Edge Agent tidak memampatkan data.

dataDestinationConfigs

Pilih tujuan di mana kampanye akan mentransfer data kendaraan. Anda dapat memilih untuk menyimpan data di Amazon S3 atau Amazon Timestream.

S3 adalah mekanisme penyimpanan data hemat biaya yang menawarkan kemampuan manajemen data yang tahan lama dan layanan data hilir. Anda dapat menggunakan S3 untuk data yang terkait dengan perilaku mengemudi atau menganalisis pemeliharaan jangka panjang.

Timestream adalah mekanisme persistensi data yang dapat membantu Anda mengidentifikasi tren dan pola dalam waktu dekat. Anda dapat menggunakan Timestream untuk data deret waktu, seperti untuk menganalisis tren historis dalam kecepatan kendaraan atau pengereman.

(Opsional) dataExtraDimensions

Anda dapat menambahkan satu atau beberapa atribut untuk memberikan informasi tambahan untuk sinyal.

(Opsional) description

Anda dapat menambahkan deskripsi untuk membantu mengidentifikasi tujuan kampanye.

(Opsional) diagnosticsMode

Saat mode diagnostik dikonfigurasiSEND_ACTIVE_DTCS, kampanye mengirimkan kode masalah diagnostik standar (DTC) tersimpan yang membantu mengidentifikasi apa yang salah dengan kendaraan Anda. Misalnya, P0097 menunjukkan modul kontrol mesin (ECM) telah menentukan bahwa input intake air temperature sensor 2 (IAT2) lebih rendah dari kisaran sensor normal.

Secara default (OFF), perangkat lunak Edge Agent tidak mengirim kode diagnostik.

(Opsional) expiryTime

Anda dapat menentukan tanggal kedaluwarsa untuk kampanye Anda. Saat kampanye kedaluwarsa, perangkat lunak Agen Edge berhenti mengumpulkan data sebagaimana ditentukan dalam kampanye ini. Jika beberapa kampanye diterapkan ke kendaraan, perangkat lunak Edge Agent menggunakan kampanye lain untuk mengumpulkan data.

Nilai default: 253402243200 (31 Desember 9999, 00:00:00 UTC)

(Opsional) postTriggerCollectionDuration

Anda dapat menentukan durasi pengumpulan pasca-pemicu, sehingga perangkat lunak Edge Agent terus mengumpulkan data untuk periode tertentu setelah skema dipanggil. Misalnya, jika skema pengumpulan berbasis kondisi dengan ekspresi berikut dipanggil:$variable.`myVehicle.Engine.RPM` > 7000.0, perangkat lunak Edge Agent terus mengumpulkan nilai putaran per menit (RPM) untuk mesin. Bahkan jika RPM hanya lebih tinggi dari 7000 sekali, itu mungkin menunjukkan bahwa ada masalah mekanis. Dalam hal ini, Anda mungkin ingin perangkat lunak Edge Agent terus mengumpulkan data untuk membantu memantau kondisi.

Nilai default: 0

(Opsional) priority

Anda dapat menentukan bilangan bulat untuk menunjukkan tingkat prioritas kampanye. Kampanye dengan jumlah yang lebih kecil adalah prioritas yang lebih tinggi. Jika Anda menerapkan beberapa kampanye ke kendaraan, kampanye yang memiliki prioritas lebih tinggi akan dimulai terlebih dahulu.

Nilai default: 0

(Opsional) signalsToCollect

Daftar sinyal dari mana data dikumpulkan ketika skema pengumpulan data dipanggil.

penting

Sinyal yang digunakan dalam ekspresi untuk skema pengumpulan berbasis kondisi harus ditentukan dalam bidang ini.

name

Nama sinyal dari mana data dikumpulkan ketika skema pengumpulan data dipanggil.

(Opsional) maxSampleCount

Jumlah maksimum sampel data yang dikumpulkan dan ditransfer oleh perangkat lunak Edge Agent ke cloud saat skema pengumpulan data dipanggil.

(Opsional) minimumSamplingIntervalMs

Durasi minimum waktu antara dua peristiwa pengumpulan sampel data, dalam milidetik. Jika sinyal sering berubah, Anda dapat menggunakan parameter ini untuk mengumpulkan data pada tingkat yang lebih lambat.

Rentang yang valid: 0-4294967295

(Opsional) spoolingMode

Jika spoolingMode dikonfigurasiTO_DISK, perangkat lunak Edge Agent untuk sementara menyimpan data secara lokal saat kendaraan tidak terhubung ke cloud. Setelah koneksi dibangun kembali, data yang disimpan secara lokal ditransfer secara otomatis ke cloud.

Nilai default: OFF

(Opsional) startTime

Kampanye yang disetujui diaktifkan pada waktu mulai.

Nilai default: 0

Status kampanye dapat menjadi salah satu dari nilai berikut.

  • CREATING— AWS IoT FleetWise sedang memproses permintaan Anda untuk membuat kampanye.

  • WAITING_FOR_APPROVAL— Setelah kampanye dibuat, ia memasuki WAITING_FOR_APPROVAL negara bagian. Untuk menyetujui kampanye, gunakan operasi UpdateCampaign API. Setelah kampanye disetujui, AWS IoT FleetWise secara otomatis menyebarkan kampanye ke kendaraan atau armada target. Untuk informasi selengkapnya, lihat Memperbarui kampanye (AWS CLI).

  • RUNNING Kampanye ini aktif.

  • SUSPENDEDKampanye ditangguhkan. Untuk melanjutkan kampanye, gunakan operasi UpdateCampaign API.

AWSIoT FleetWise menyediakan operasi API berikut yang dapat Anda gunakan untuk membuat dan mengelola kampanye.

  • CreateCampaign— Membuat kampanye baru.

  • UpdateCampaign— Memperbarui kampanye yang ada. Setelah kampanye dibuat, Anda harus menggunakan operasi API ini untuk menyetujui kampanye.

  • DeleteCampaign— Menghapus kampanye yang ada.

  • ListCampaigns— Mengambil daftar ringkasan paginasi untuk semua kampanye.

  • GetCampaign— Mengambil informasi tentang kampanye.

Tutorial