Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris. # Menambahkan tujuan real-time AWS IoT SiteWise Edge Jenis tujuan real-time memungkinkan Anda untuk mengalirkan data IoT langsung dari perangkat dan gateway Anda ke AWS IoT SiteWise penyimpanan secara real-time. Opsi ini sangat ideal untuk kasus penggunaan yang memerlukan konsumsi dan pemrosesan data segera saat dihasilkan, tanpa perlu batching atau buffering. Anda hanya dapat memiliki satu tujuan real-time yang dikonfigurasi di setiap gateway, karena itu mengalirkan data secara terus AWS IoT SiteWise menerus. **catatan** Duplikat TQVs dapat mengakibatkan pengisian ganda. **Untuk menambahkan tujuan waktu nyata** Gunakan AWS IoT SiteWise konsol atau AWS CLI untuk menambahkan tujuan waktu nyata ke gateway berkemampuan SiteWise Edge MQTT Anda. ------ #### [ Console ] 1. Buka [konsol AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/). 1. Di panel navigasi, pilih **gateway Edge**. 1. Pilih gateway yang ingin Anda tambahkan tujuan. 1. Di bagian **Tujuan**, pilih **Tambah tujuan**. 1. Pada halaman **Tambah tujuan**, masukkan **Detail tujuan**: 1. Nama untuk tujuan Anda di bidang **Nama tujuan**. 1. Pilih **AWS IoT SiteWise waktu nyata** untuk **tipe Tujuan**. 1. Konfigurasikan urutan penerbitan gateway dengan menyetel **urutan Penerbitan** ke **Publikasikan data lama terlebih dahulu** atau **Publikasikan data terbaru terlebih dahulu**. Secara default, gateway menerbitkan data tertua terlebih dahulu. 1. Gunakan **waktu tunggu batch maksimum** untuk menetapkan waktu maksimum bagi penayang untuk menunggu sebelum mengirim sekumpulan data ke AWS IoT SiteWise. Pengaturan ini berlaku untuk setiap alias. Data disimpan secara lokal hingga: + Waktu yang ditentukan telah berlalu, atau + 10 time-quality-value (TQV) entri diterima untuk alias Kondisi mana pun yang terpenuhi terlebih dahulu memicu batch untuk dikirim ke cloud. 1. Untuk mengompres data yang diunggah, pilih kotak centang **Aktifkan kompresi saat mengunggah data**. Membiarkan gateway mengompres data Anda sebelum mengunggahnya ke cloud mengurangi penggunaan bandwidth. 1. Untuk memfilter data penayang yang kedaluwarsa, pilih kotak centang **Kecualikan data kedaluwarsa**. Pilihan ini hanya mengirimkan data aktif dan saat ini ke AWS IoT SiteWise. 1. Di bidang **Cutoff period**, masukkan frekuensi di mana data harus dianggap kedaluwarsa dalam kumpulan data Anda. Anda dapat menentukan apakah data dihitung dalam hitungan menit atau hari. Periode batas minimum adalah lima menit. Periode batas maksimum adalah tujuh hari. 1. Konfigurasikan **pengaturan penyimpanan lokal** secara opsional: 1. Mengatur frekuensi **periode Retensi** — Jumlah waktu gateway secara lokal menyimpan data yang lebih tua dari periode cutoff. Periode retensi minimum adalah satu menit. Periode retensi maksimum adalah 30 hari dan lebih besar dari atau sama dengan periode rotasi. 1. Atur **periode Rotasi** — Interval waktu untuk menentukan saat menyimpan data yang lebih lama dari periode cutoff untuk satu file. Gateway mentransfer satu batch data ke direktori lokal berikut pada akhir setiap periode rotasi: `/greengrass/v2/work/aws.iot.SiteWiseEdgePublisher/exports` Retensi harus lebih besar dari satu menit dan sama dengan periode retensi. 1. Berikan nilai **kapasitas Penyimpanan (GB)** untuk mengatur ukuran maksimum data yang disimpan secara lokal dalam GB. Jika data melebihi ukuran penyimpanan lokal maksimum yang ditentukan, gateway mulai menghapus data tertua terlebih dahulu. Gateway terus menghapus hingga ukuran data yang disimpan secara lokal sama dengan atau kurang dari kuota. Kapasitas penyimpanan harus lebih besar dari atau sama dengan satu GB. 1. Tambahkan filter jalur ke tujuan Anda. Untuk informasi selengkapnya, lihat [Tambahkan filter jalur ke tujuan AWS IoT SiteWise Edge](destinations-add-path-filters.md). Untuk informasi selengkapnya, lihat [Jenis tujuan](gw-destinations.md#destination-types). ------ #### [ AWS CLI ] **Example : Buat tujuan AWS IoT SiteWise real-time baru** Gunakan [UpdateGatewayCapabilityConfiguration](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_UpdateGatewayCapabilityConfiguration.html)API untuk mengonfigurasi penerbit. Atur parameter `capabilityNamespace` ke `iotsitewise:publisher:3`. ``` { "sources": [ { "type": "MQTT" } ], "destinations": [ { "type": "SITEWISE_REALTIME", "name": "{{your-destination-name}}", "config": { "publishingOrder": "TIME_ORDER", "enableCompression": true, "maxBatchWaitTime": "10s" }, "filters": [ { "type": "PATH", "config": { "paths": [ "{{#}}" ] } } ] } ] } ``` Untuk memperbarui tujuan AWS IoT SiteWise real-time yang ada, pertama-tama gunakan `DescribeGatewayCapabilityConfiguration` API untuk menemukan`destinationId`. **Example : Perbarui tujuan AWS IoT SiteWise waktu nyata** Gunakan [UpdateGatewayCapabilityConfiguration](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_UpdateGatewayCapabilityConfiguration.html)API untuk mengonfigurasi penerbit. Atur parameter `capabilityNamespace` ke `iotsitewise:publisher:3`. ``` { "sources": [ { "type": "MQTT" } ], "destinations": [ { "id": "{{your-existing-destination-id}}", "type": "SITEWISE_REALTIME", "name": "{{your-destination-name}}", "config": { "publishingOrder": "TIME_ORDER", "enableCompression": true, "dropPolicy": { "cutoffAge": "7d", "exportPolicy": { "retentionPeriod": "7d", "rotationPeriod": "6h", "exportSizeLimitGB": 10 } }, "maxBatchWaitTime": "10s" }, "filters": [ { "type": "PATH", "config": { "paths": [ "{{#}}" ] } } ] } ] } ``` Opsi konfigurasi berikut khusus untuk gateway menggunakan namespace. `iotsitewise:publisher:3` `sources` Mendefinisikan sumber data untuk mentransfer data dari peralatan industri Anda ke AWS IoT SiteWise. Untuk gateway berkemampuan MQTT, gunakan. `MQTT` Tipe: Array objek Wajib: Ya `destinations` Mendefinisikan ke mana harus mengirim data. Tujuan dapat real-time atau buffer menggunakan Amazon S3. Setidaknya satu objek tujuan diperlukan, tetapi Anda dapat menambahkan array kosong. Anda dapat memiliki satu tujuan real-time untuk setiap gateway. Untuk informasi selengkapnya, lihat [Memahami tujuan AWS IoT SiteWise Edge](gw-destinations.md#source-destination). Tipe: Array objek Wajib: Ya `id` Pengenal unik untuk tujuan. Anda dapat memberikan ID tujuan yang ada atau membiarkannya kosong. Jika Anda tidak menentukan ID maka UUID dihasilkan secara default. Tipe: String Wajib: Tidak `type` Jenis tujuan. Pilihan meliputi: `SITEWISE_REALTIME` dan`SITEWISE_BUFFERED`. + `SITEWISE_REALTIME`— Kirim data langsung ke AWS IoT SiteWise penyimpanan secara real-time. + `SITEWISE_BUFFERED`— Kirim data ke Amazon S3 dalam batch dalam format Parket, lalu impor ke penyimpanan. AWS IoT SiteWise Tipe: String Diperlukan: Ya `name` Nama unik untuk tujuan. Tipe: String Diperlukan: Ya `config` Konfigurasi khusus untuk jenis tujuan dalam format JSON. Konfigurasi bervariasi antara tujuan real-time dan buffer. Tipe: Objek Wajib: Ya PublishingOrder Menentukan urutan di mana data dipublikasikan. Data diterbitkan berdasarkan stempel waktunya. Pilihan termasuk `TIME_ORDER` dan`RECENT_DATA`. + `TIME_ORDER`(default) - Menerbitkan data lama terlebih dahulu. + `RECENT_DATA`— Menerbitkan data terbaru terlebih dahulu. Tipe: String Wajib: Tidak Aktifkan Kompresi Saat diatur ke`true`, aktifkan kompresi data sebelum dikirim ke AWS IoT SiteWise. Membiarkan gateway mengompres data Anda sebelum mengunggahnya ke cloud mengurangi penggunaan bandwidth. Nilai default-nya adalah `true`. Tipe: Boolean Wajib: Tidak DropPolicy Mendefinisikan cara menangani data yang lebih lama. Tipe: Objek Wajib: Tidak + `cutoffAge` Usia maksimum data yang akan dipublikasikan ditentukan dalam hari, jam, dan menit. Misalnya, `7d` atau `1d7h16m`. Data yang lebih tua dari yang Anda tentukan tidak dikirim ke AWS IoT SiteWise. Data yang lebih awal dari periode cutoff tidak dipublikasikan ke cloud. Usia batas harus antara lima menit dan tujuh hari. Anda dapat menggunakan`m`,`h`, dan `d` ketika Anda menentukan batas usia. Catatan yang `m` mewakili menit, `h` mewakili jam, dan `d` mewakili hari. Tipe: String Diperlukan: Ya + `exportPolicy` Mendefinisikan cara menangani data yang melebihi batas usia. Tipe: Objek Wajib: Tidak + `retentionPeriod` Gateway SiteWise Edge Anda menghapus data apa pun di tepi yang lebih awal dari periode cutoff dari penyimpanan lokal setelah disimpan untuk periode retensi yang ditentukan. Periode retensi harus antara satu menit dan 30 hari, dan lebih besar dari atau sama dengan periode rotasi. Anda dapat menggunakan`m`,`h`, dan `d` ketika Anda menentukan periode retensi. Catatan yang `m` mewakili menit, `h` mewakili jam, dan `d` mewakili hari. Tipe: String Wajib: Tidak + `rotationPeriod` Interval waktu untuk mengumpulkan dan menyimpan data yang lebih awal dari periode cutoff ke satu file. Gateway SiteWise Edge mentransfer satu batch data ke direktori lokal berikut pada akhir setiap periode rotasi:`/greengrass/v2/work/aws.iot.SiteWiseEdgePublisher/exports`. Periode rotasi harus lebih besar dari satu menit, dan sama dengan atau kurang dari periode retensi. Anda dapat menggunakan`m`,`h`, dan `d` ketika Anda menentukan periode rotasi. Catatan yang `m` mewakili menit, `h` mewakili jam, dan `d` mewakili hari. Tipe: String Wajib: Tidak + `exportSizeLimitGB` Ukuran maksimum yang diizinkan dari data yang disimpan secara lokal, dalam GB. Jika kuota ini dilanggar, gateway SiteWise Edge mulai menghapus data paling awal hingga ukuran data yang disimpan secara lokal sama dengan atau kurang dari kuota. Nilai parameter ini harus lebih besar dari atau sama dengan 1. Tipe: Integer Wajib: Tidak `maxBatchWaitTime` Menetapkan waktu maksimum bagi penayang untuk menunggu sebelum mengirim sekumpulan data ke AWS IoT SiteWise. Pengaturan ini berlaku untuk setiap alias. Data disimpan secara lokal hingga: + Waktu yang ditentukan telah berlalu, atau + 10 time-quality-value (TQV) entri diterima untuk alias Gunakan`m`,`h`, dan `d` untuk menentukan batas waktu. Catatan yang `m` mewakili menit, `h` mewakili jam, dan `d` mewakili hari. Tipe: String Wajib: Tidak `filters` Filter untuk diterapkan ke data. Setidaknya diperlukan satu filter. Tipe: String Diperlukan: Ya `type` Jenis filter. Gunakan `PATH`. Tipe: String Diperlukan: Ya `config` Konfigurasi khusus untuk jenis filter dalam format JSON. Setidaknya satu objek diperlukan, tetapi array bisa kosong. Tipe: Objek Wajib: Ya + `paths` Array filter jalur. Untuk informasi selengkapnya, lihat [Memahami filter jalur untuk tujuan AWS IoT SiteWise EdgeMemahami filter jalur](gw-destinations.md#destinations-path-filters). Jalur defaultnya adalah`#`. Tipe: Array string Wajib: Ya ------