Buat kampanye AWS IoT FleetWise - AWS IoT FleetWise

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

Buat kampanye AWS IoT FleetWise

penting

Akses ke FleetWise fitur AWS IoT tertentu saat ini terjaga keamanannya. Untuk informasi selengkapnya, lihat AWS Ketersediaan wilayah dan fitur di AWS IoT FleetWise.

Anda dapat menggunakan FleetWise konsol AWS IoT atau membuat kampanye API untuk mengumpulkan data kendaraan.

penting

Agar kampanye Anda berfungsi, Anda harus memiliki yang berikut:

  • 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. Buka konsol AWS IoT 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 Penyediaan AWS kendaraan IoT FleetWise .

Buat kampanye (konsol)

Gunakan FleetWise konsol AWS IoT untuk membuat kampanye untuk memilih, mengumpulkan, dan mentransfer data kendaraan ke cloud.

Untuk membuat kampanye
  1. Buka konsol AWS IoT FleetWise .

  2. Pada panel navigasi, pilih Kampanye.

  3. Pada halaman Kampanye, pilih Buat kampanye, lalu selesaikan langkah-langkah dalam topik berikut.

penting

Langkah 1: Konfigurasikan kampanye

Secara umum informasi, lakukan hal berikut:

  1. Masukkan nama untuk kampanye.

  2. (Opsional) Masukkan deskripsi.

Konfigurasikan skema pengumpulan data kampanye. Skema pengumpulan data memberikan instruksi perangkat lunak Edge Agent tentang data apa yang harus dikumpulkan atau kapan harus mengumpulkannya. Di FleetWise konsol AWS IoT, Anda dapat mengonfigurasi skema pengumpulan data dengan cara berikut:

  • Tentukan skema pengumpulan data secara manual.

  • Unggah file untuk secara otomatis menentukan skema pengumpulan data.

Di opsi Konfigurasi, pilih salah satu dari berikut ini:

  • Untuk menentukan jenis skema pengumpulan data secara manual dan menentukan opsi untuk menyesuaikan skema, pilih Tentukan skema pengumpulan data.

    Tentukan jenis skema pengumpulan data secara manual dan tentukan opsi untuk menyesuaikan skema.

    1. Di bagian Rincian skema pengumpulan data, pilih jenis skema pengumpulan data yang ingin digunakan kampanye ini. Untuk menggunakan ekspresi logis untuk mengenali data kendaraan apa yang akan dikumpulkan, pilih Berbasis kondisi. Untuk menggunakan periode waktu tertentu untuk memutuskan seberapa sering mengumpulkan data kendaraan, pilih Berbasis waktu.

    2. Tentukan durasi waktu kampanye mengumpulkan data.

      catatan

      Secara default, kampanye yang disetujui segera diaktifkan dan tidak memiliki waktu akhir yang ditetapkan. Untuk menghindari biaya tambahan, Anda harus menentukan rentang waktu.

    3. Jika Anda menentukan skema pengumpulan data berbasis kondisi, Anda harus menentukan ekspresi logis untuk mengenali data apa yang akan dikumpulkan. AWS IoT FleetWise menggunakan ekspresi logis untuk mengenali data apa yang akan dikumpulkan untuk skema berbasis kondisi. Ekspresi harus menentukan nama sinyal yang sepenuhnya memenuhi syarat sebagai variabel, operator perbandingan, dan nilai perbandingan.

      Misalnya, jika Anda menentukan $variable.`myVehicle.InVehicleTemperature` > 50.0 ekspresi, AWS IoT FleetWise mengumpulkan nilai suhu yang lebih besar dari 50,0. Untuk petunjuk tentang cara menulis ekspresi, lihatEkspresi logis untuk AWS kampanye IoT FleetWise.

      Masukkan ekspresi logis yang digunakan untuk mengenali data apa yang akan dikumpulkan.

    4. (Opsional) Tentukan versi bahasa dari ekspresi bersyarat. Nilai default adalah 1.

    5. (Opsional) Tentukan interval pemicu minimum, yang merupakan durasi waktu terkecil antara dua peristiwa pengumpulan data. Misalnya, jika sinyal sering berubah, Anda mungkin ingin mengumpulkan data dengan kecepatan yang lebih lambat.

    6. Tentukan kondisi mode Pemicu untuk perangkat lunak Edge Agent untuk mengumpulkan data. Secara default, Edge Agent untuk FleetWise perangkat lunak AWS IoT Selalu mengumpulkan data setiap kali kondisi terpenuhi. Atau, dapat mengumpulkan data hanya ketika kondisi terpenuhi untuk pertama kalinya, Pada pemicu pertama.

    7. Jika Anda menentukan skema pengumpulan data berbasis waktu, Anda harus menentukan Periode waktu, dalam milidetik, dari 10.000 - 60.000 milidetik. Perangkat lunak Edge Agent menggunakan periode waktu untuk memutuskan seberapa sering mengumpulkan data.

    8. (Opsional) Edit opsi skema lanjutan skema.

      1. Untuk menghemat bandwidth nirkabel dan mengurangi lalu lintas jaringan dengan mengompresi data, pilih Snappy.

      2. (Opsional) Untuk menentukan berapa lama, dalam milidetik, untuk melanjutkan pengumpulan data setelah peristiwa pengumpulan data, Anda dapat menentukan durasi pengumpulan pemicu Post.

      3. (Opsional) Untuk menunjukkan tingkat prioritas kampanye, tentukan Prioritas kampanye. Kampanye dengan jumlah prioritas yang lebih kecil diterapkan terlebih dahulu dan dianggap memiliki prioritas yang lebih tinggi.

      4. Perangkat lunak Edge Agent dapat menyimpan data sementara secara lokal ketika kendaraan tidak terhubung ke cloud. Setelah koneksi dibangun kembali, data yang disimpan secara lokal ditransfer secara otomatis ke cloud. Tentukan apakah Anda ingin Agen Edge Menyimpan data secara lokal selama koneksi terputus.

      5. (Opsional) Untuk memberikan informasi tambahan untuk sinyal, tambahkan hingga lima atribut sebagai dimensi data tambahan.

  • Untuk mengunggah file untuk menentukan skema pengumpulan data, pilih Unggah file.json dari perangkat lokal Anda. AWS IoT FleetWise secara otomatis menentukan opsi mana yang dapat Anda tentukan dalam file. Anda dapat meninjau dan memperbarui opsi yang dipilih.

    Unggah file.json dengan detail tentang skema pengumpulan data.

    1. Untuk mengimpor informasi tentang skema pengumpulan data, pilih Pilih file. Untuk informasi selengkapnya tentang format file yang diperlukan, lihat CreateCampaignAPIdokumentasi.

      catatan

      AWS IoT FleetWise saat ini mendukung ekstensi format file.json.

    2. AWS IoT FleetWise secara otomatis mendefinisikan skema pengumpulan data berdasarkan informasi dalam file Anda. Tinjau opsi yang AWS IoT FleetWise pilih untuk Anda. Anda dapat memperbarui opsi, jika diperlukan.

Langkah 2: Tentukan kondisi penyimpanan dan unggah

Untuk memilih apakah perangkat lunak Edge Agent akan menyimpan data sementara secara lokal saat kendaraan tidak terhubung ke cloud, tentukan mode spooling.

  • Dalam mode spooling Data, pilih salah satu dari berikut ini:

    • Tidak disimpan — Perangkat lunak Edge Agent mengumpulkan tetapi tidak menyimpan data sementara secara lokal saat kendaraan sedang offline. Perangkat lunak Edge Agent mentransfer data ke cloud saat kendaraan terhubung kembali.

    • Disimpan ke disk — Perangkat lunak Edge Agent mengumpulkan dan menyimpan sementara data secara lokal saat kendaraan sedang offline. Data yang dikumpulkan disimpan sementara di lokasi yang ditentukan oleh bagian “persistensi” file konfigurasi Agen Edge. Agen Edge mentransfer data ke cloud saat kendaraan terhubung kembali.

    • Disimpan ke disk dengan partisi - Kendaraan selalu menyimpan sementara data di Edge di partisi data yang Anda tentukan. Anda dapat memilih kapan Anda ingin meneruskan data yang disimpan ke cloud.

      1. (Opsional) Masukkan ID partisi untuk menunjuk kumpulan data tertentu.

      2. Masukkan nama folder sebagai lokasi di mana data akan disimpan. Jalur absolut dari lokasi penyimpanan adalah{persistency_path} / {vehicle_name} / {campaign_name} / {storage_location}.

      3. Masukkan ukuran penyimpanan maksimum dari data yang disimpan di partisi. Data yang lebih baru menimpa data yang lebih lama ketika partisi mencapai ukuran maksimum.

      4. Masukkan jumlah minimum waktu data dalam partisi ini akan disimpan di disk.

      5. (Opsional) Masukkan kondisi unggahan untuk partisi.

Tentukan sinyal

Anda dapat menentukan sinyal untuk mengumpulkan data selama kampanye.

Untuk menentukan sinyal untuk mengumpulkan data dari
  1. Pilih nama Sinyal.

  2. (Opsional) Untuk jumlah sampel Maks, masukkan jumlah maksimum sampel data yang dikumpulkan dan ditransfer oleh perangkat lunak Agen Edge ke cloud selama kampanye.

  3. (Opsional) Untuk interval pengambilan sampel Min, masukkan durasi waktu minimum 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.

  4. Untuk menambahkan sinyal lain, pilih Tambahkan lebih banyak sinyal. Anda dapat menambahkan hingga 999 sinyal.

  5. Pilih Berikutnya.

Langkah 3: Konfigurasikan tujuan data

catatan

Jika kampanye berisi sinyal data sistem visi, Anda hanya dapat menyimpan data kendaraan di Amazon S3. Anda tidak dapat menyimpannya di Timestream atau mengirimkannya ke MQTT topik.

Data sistem visi dalam rilis pratinjau dan dapat berubah sewaktu-waktu.

Amazon Timestream tidak tersedia di Wilayah Asia Pasifik (Mumbai).

Pilih tujuan tempat Anda ingin mengirim atau menyimpan data yang dikumpulkan oleh kampanye. Anda dapat mengirim data kendaraan ke suatu MQTT topik, atau menyimpannya di Amazon S3 atau Amazon Timestream.

Di Pengaturan tujuan, lakukan hal berikut:

  • Pilih Amazon S3, Amazon Timestream, MQTT atau topik dari daftar dropdown.

penting

Anda hanya dapat mentransfer data ke S3 jika AWS FleetWise IoT memiliki izin untuk menulis ke dalam bucket S3. Untuk informasi selengkapnya tentang pemberian akses, lihat Mengontrol akses dengan AWS IoT FleetWise.

Untuk menyimpan data kendaraan dalam bucket S3, pilih Amazon S3. S3 adalah layanan penyimpanan objek yang menyimpan data sebagai objek di dalam ember. Untuk informasi selengkapnya, lihat Membuat, mengonfigurasi, dan bekerja dengan bucket Amazon S3 di Panduan Pengguna Layanan Penyimpanan Sederhana Amazon.

S3 mengoptimalkan biaya penyimpanan data dan menyediakan mekanisme tambahan untuk menggunakan data kendaraan, seperti data lake, penyimpanan data terpusat, pipa pemrosesan data, dan analitik. Anda dapat menggunakan S3 untuk menyimpan data untuk pemrosesan dan analisis batch. Misalnya, Anda dapat membuat laporan peristiwa pengereman keras untuk model machine learning (ML) Anda. Data kendaraan yang masuk disangga selama 10 menit sebelum pengiriman.

Di pengaturan tujuan S3, lakukan hal berikut:

  1. Untuk bucket S3, pilih bucket yang AWS IoT FleetWise memiliki izin.

  2. (Opsional) Masukkan awalan khusus yang dapat Anda gunakan untuk mengatur data yang disimpan di bucket S3.

  3. Pilih format output, yang merupakan file format yang disimpan seperti pada bucket S3.

  4. Pilih apakah Anda ingin mengompres data yang disimpan di bucket S3 sebagai file.gzip. Kami merekomendasikan mengompresi data karena meminimalkan biaya penyimpanan.

  5. Opsi yang Anda pilih di pengaturan tujuan S3 mengubah objek Contoh S3. URI Ini adalah contoh file apa yang disimpan seperti di S3.

penting

Anda hanya dapat mentransfer data ke tabel jika AWS IoT FleetWise memiliki izin untuk menulis data ke Timestream. Untuk informasi selengkapnya tentang pemberian akses, lihat Mengontrol akses dengan AWS IoT FleetWise.

Amazon Timestream tidak tersedia di Wilayah Asia Pasifik (Mumbai).

Untuk menyimpan data kendaraan dalam tabel Timestream, pilih Amazon Timestream. Anda dapat menggunakan Timestream untuk menanyakan data kendaraan sehingga Anda dapat mengidentifikasi tren dan pola. Misalnya, Anda dapat menggunakan Timestream untuk membuat alarm untuk tingkat bahan bakar kendaraan. Data kendaraan yang masuk ditransfer ke Timestream dalam waktu dekat. Untuk informasi selengkapnya, lihat Apa itu Amazon Timestream? di Panduan Pengembang Amazon Timestream.

Dalam pengaturan tabel Timestream, lakukan hal berikut:

  1. Untuk nama database Timestream, pilih nama database Timestream Anda dari daftar dropdown.

  2. Untuk nama tabel Timestream, pilih nama tabel Timestream Anda dari daftar dropdown.

Dalam akses Layanan untuk Timestream, lakukan hal berikut:

  • Pilih IAM peran dari daftar dropdown.

penting

Anda hanya dapat merutekan data ke MQTT topik jika AWS IoT FleetWise memiliki izin untuk topik. AWS IoT Untuk informasi selengkapnya tentang pemberian akses, lihat Mengontrol akses dengan AWS IoT FleetWise.

Untuk mengirim data kendaraan ke suatu MQTT topik, pilih MQTTtopik.

Data kendaraan yang dikirim melalui MQTT pesan dikirimkan dalam waktu dekat dan memungkinkan Anda menggunakan aturan untuk mengambil tindakan, atau merutekan data ke tujuan lain. Untuk informasi selengkapnya tentang penggunaanMQTT, lihat Protokol komunikasi perangkat dan Aturan untuk AWS IoT dalam Panduan AWS IoT Core Pengembang.

  1. Di bawah MQTTtopik, masukkan nama Topik.

  2. Di bawah Akses layanan untuk MQTT topik, pilih apakah Anda ingin mengizinkan AWS IoT FleetWise Membuat dan menggunakan peran layanan baru untuk Anda. Jika Anda ingin Menggunakan peran layanan yang ada, pilih peran dalam daftar tarik-turun di bawah Pilih peran.

  • Pilih Berikutnya.

Langkah 4: Tambahkan kendaraan

Untuk memilih kendaraan mana yang akan digunakan kampanye Anda, pilih di daftar kendaraan. Filter kendaraan dengan mencari atribut dan nilainya yang Anda tambahkan saat membuat kendaraan, atau dengan nama kendaraan.

Di kendaraan Filter, lakukan hal berikut:

  1. Di kotak pencarian, temukan atribut atau nama kendaraan dan pilih dari daftar.

    catatan

    Setiap atribut hanya dapat digunakan sekali.

  2. Masukkan nilai atribut atau nama kendaraan yang ingin Anda gunakan untuk kampanye. Misalnya, jika nama atribut yang sepenuhnya memenuhi syarat adalahfuelType, masukkan gasoline sebagai nilainya.

  3. Untuk mencari atribut kendaraan lain, ulangi langkah sebelumnya. Anda dapat mencari hingga lima atribut kendaraan dan jumlah nama kendaraan yang tidak terbatas.

  4. Kendaraan yang cocok dengan pencarian Anda tercantum di bawah nama Kendaraan. Pilih kendaraan yang Anda inginkan untuk disebarkan oleh kampanye.

    catatan

    Hingga 100 kendaraan ditampilkan di hasil pencarian. Pilih Pilih semua untuk menambahkan semua kendaraan ke kampanye.

  5. Pilih Berikutnya.

Langkah 5: Tinjau dan buat

Verifikasi konfigurasi untuk kampanye, lalu pilih Buat kampanye.

catatan

Setelah kampanye dibuat, Anda atau tim Anda harus menyebarkan kampanye ke kendaraan.

Langkah 6: Menyebarkan kampanye

Setelah Anda membuat kampanye, Anda atau tim Anda harus menyebarkan kampanye ke kendaraan.

Untuk menyebarkan kampanye
  1. Pada halaman Ringkasan kampanye, pilih Terapkan.

  2. Tinjau dan konfirmasikan bahwa Anda ingin memulai penyebaran dan mulai mengumpulkan data dari kendaraan yang terhubung ke kampanye.

  3. Pilih Deploy.

Jika Anda ingin menjeda pengumpulan data dari kendaraan yang terhubung ke kampanye, pada halaman Ringkasan kampanye, pilih Tangguhkan. Untuk melanjutkan pengumpulan data dari kendaraan yang terhubung ke kampanye, pilih Lanjutkan.

Buat kampanye (AWS CLI)

Anda dapat menggunakan CreateCampaignAPIoperasi untuk membuat kampanye. Contoh berikut menggunakan AWS CLI.

Saat Anda membuat kampanye, data yang dikumpulkan dari kendaraan dapat dikirim ke MQTT topik atau disimpan di Amazon S3 (S3) atau Amazon Timestream. Pilih Timestream untuk database deret waktu yang cepat, dapat diskalakan, dan tanpa server, seperti untuk menyimpan data yang memerlukan pemrosesan hampir waktu nyata. Pilih S3 untuk penyimpanan objek dengan skalabilitas, ketersediaan data, keamanan, dan kinerja terdepan di industri. Pilih MQTT untuk mengirimkan data dalam waktu dekat dan menggunakan Aturan AWS IoT untuk melakukan tindakan yang Anda tentukan atau rute data ke tujuan lain.

penting

Anda hanya dapat mentransfer data kendaraan ke MQTT topik, Amazon S3, atau Amazon Timestream AWS jika FleetWise IoT memiliki izin MQTT untuk mengirim pesan atas nama Anda, atau untuk menulis data ke S3 atau Timestream. Untuk informasi selengkapnya tentang pemberian akses, lihat Mengontrol akses dengan AWS IoT FleetWise.

Amazon Timestream tidak tersedia di Wilayah Asia Pasifik (Mumbai).

Buat kampanye

penting

Untuk membuat kampanye, jalankan perintah berikut.

Ganti file-name dengan nama file.json yang berisi konfigurasi kampanye.

aws iotfleetwise create-campaign --cli-input-json file://file-name.json
  • Ganti campaign-name dengan nama kampanye yang Anda buat.

  • Ganti signal-catalog-arn dengan Amazon Resource Name (ARN) dari katalog sinyal.

  • Ganti target-arn dengan armada atau kendaraan yang Anda buat. ARN

  • Ganti bucket-arn dengan ARN ember 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": [ { ... } ] }
catatan

Amazon Timestream tidak tersedia di Wilayah Asia Pasifik (Mumbai).

  • Ganti campaign-name dengan nama kampanye yang Anda buat.

  • Ganti signal-catalog-arn dengan ARN katalog sinyal.

  • Ganti target-arn dengan armada atau kendaraan yang Anda buat. ARN

  • Ganti role-arn dengan peran eksekusi tugas yang memberikan izin AWS FleetWise IoT untuk mengirimkan data ke tabel Timestream. ARN

  • Ganti table-arn dengan tabel 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": [ { ... } ] }
  • Ganti campaign-name dengan nama kampanye yang Anda buat.

  • Ganti signal-catalog-arn dengan Amazon Resource Name (ARN) dari katalog sinyal.

  • Ganti target-arn dengan armada atau kendaraan yang Anda buat. ARN

  • Ganti topic-arn dengan MQTTtopik ARN yang Anda tentukan sebagai tujuan pesan yang berisi data kendaraan.

  • Ganti role-arn dengan peran eksekusi tugas yang memberikan izin AWS FleetWise IoT untuk mengirim, menerima, dan mengambil tindakan pada pesan untuk topik yang Anda MQTT tentukan. ARN

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

Jika Anda mengaktifkan enkripsi menggunakan AWS KMS kunci terkelola pelanggan, sertakan pernyataan kebijakan berikut agar peran Anda dapat menjalankan CreateCampaign API operasi.

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