Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Integrasikan data ke SiteWise Edge menggunakan gateway V3 berkemampuan MQTT
Tutorial ini memandu Anda untuk mengintegrasikan perangkat dan sensor pihak ketiga yang menggunakan protokol pesan MQTT dengan gateway V3 berkemampuan AWS IoT SiteWise MQTT. Anda akan belajar cara mengatur gateway AWS IoT SiteWise tepi untuk mengumpulkan dan memantau data dari perangkat berkemampuan MQTT Anda. AWS IoT SiteWise memungkinkan Anda mengumpulkan, memproses, dan memantau data peralatan industri. Gunakan kemampuan SiteWise Edge untuk mengoptimalkan operasi IoT industri, dan mengubah data mentah menjadi wawasan yang dapat ditindaklanjuti.
Dalam tutorial ini, kami menggunakan data dari demonstrasi ladang angin untuk mengilustrasikan konsep-konsep kunci. Setelah Anda terbiasa dengan prosesnya, Anda dapat mengulangi tutorial dengan data Anda sendiri.
Setelah Anda menyelesaikan tutorial ini, Anda dapat melakukan hal-hal berikut:
+ Siapkan dan konfigurasikan gateway V3 berkemampuan MQTT untuk menerima data dari perangkat industri
+ Memproses dan memvalidasi pesan MQTT yang masuk dari peralatan Anda di tepi
+ Melihat data perangkat AWS IoT SiteWise menggunakan platform visualisasi pihak ketiga
+ Kirim data yang diproses dari gateway tepi Anda ke AWS Cloud untuk mengaktifkan penyimpanan terpusat dan analisis lebih lanjut
Selain itu, Anda dapat memanfaatkan kemampuan edge gateway Anda dengan menghubungkan ke AWS IoT layanan lain untuk melakukan tugas-tugas berikut:
+ Konfigurasikan AWS IoT aturan untuk merutekan data ke layanan seperti [Amazon S3](https://aws.amazon.com/s3/), [Amazon Timestream](https://aws.amazon.com/timestream/), dan. [AWS Lambda](https://aws.amazon.com/lambda/)
+ Gunakan [AWS IoT Device Defender](https://aws.amazon.com/iot-device-defender/)untuk mengelola dan memperbarui konfigurasi gateway Anda dari jarak jauh.
+ Menerapkan otentikasi dan otorisasi perangkat yang AWS IoT aman menggunakan fitur keamanan. Untuk informasi selengkapnya, lihat [Keamanan AWS IoT](https://docs.aws.amazon.com/iot/latest/developerguide/iot-security.html) di *Panduan Developer AWS IoT *.
+ Buat peringatan dan notifikasi otomatis berdasarkan data peralatan. Untuk informasi selengkapnya, lihat [Aturan untuk AWS IoT](https://docs.aws.amazon.com/iot/latest/developerguide/iot-rules.html) di *Panduan AWS IoT Pengembang*.
**catatan**
Tutorial ini merujuk pada layanan, alat, dan dokumentasi pihak ketiga. AWS bukan vendor atau pemasok untuk produk atau layanan pihak ketiga apa pun, dan tidak dapat menjamin keakuratan informasi dari penyedia eksternal. Mengevaluasi dan memvalidasi semua alat pihak ketiga sebelum penerapan.
**Topics**
+ [Prasyarat](#gateway-tutorial-prerequisites)
+ [Langkah 1: Buat AWS IoT kebijakan](#gateway-tutorial-create-iot-policy)
+ [Langkah 2: Buat dan konfigurasikan AWS IoT sesuatu](#gateway-tutorial-create-and-configure-aws-iot-thing)
+ [Langkah 3: Konfigurasikan gateway V3 yang SiteWise mendukung Edge MQTT Anda](#gateway-tutorial-configure-your-edge-gateway)
+ [Langkah 4: Instal perangkat lunak gateway SiteWise Edge](#install-gateway-software)
+ [Langkah 5: Konfigurasikan broker EMQX untuk terhubung ke aplikasi eksternal](#configure-emqx-broker-external-applications)
+ [Langkah 6: Publikasikan data dengan Mosquitto](#add-mqtt-data-source)
+ [Langkah 7: Tentukan tujuan](#specify-destinations)
+ [Langkah 8: Tentukan filter jalur](#specify-path-filters)
+ [Langkah 9: Konfigurasikan sumber daya AWS IoT Anda](#configure-iot-resources)
+ [Langkah 10: Visualisasikan data Anda](#visualize-your-data)
+ [Langkah 11: Bersihkan sumber daya setelah tutorial](#tutorial-clean-up-resources)
+ [Sumber daya tambahan](#additional-resources)
## Prasyarat
Untuk menyelesaikan tutorial ini, Anda memerlukan hal berikut:
+ Sebuah Akun AWS. Jika Anda tidak memilikinya, lihat [Siapkan AWS akun](getting-started.md#set-up-aws-account).
+ Pengguna AWS Identity and Access Management (IAM) dengan izin administrator. Untuk informasi selengkapnya, lihat [Identitas dan manajemen akses untuk AWS IoT SiteWise](security-iam.md).
+ Versi terbaru Python diinstal pada perangkat Anda.
**penting**
Tutorial ini membutuhkan penggunaan sumber daya yang dibuat dalam tutorial [data Ingest](ingest-data-from-iot-things.md). Anda harus menyelesaikannya sebelum melanjutkan dengan tutorial ini.
## Langkah 1: Buat AWS IoT kebijakan
Tutorial ini menggunakan AWS IoT kebijakan yang Anda buat dalam tutorial [data Ingest](ingest-data-from-iot-things.md). Kebijakan ini menetapkan aturan keamanan untuk perangkat Anda dan membuat representasi digital dari perangkat dan sensor eksternal Anda AWS IoT. Kebijakan ini memungkinkan perangkat pihak ketiga Anda untuk mengirim data AWS IoT Core menggunakan MQTT (Message Queuing Telemetry Transport). Untuk informasi selengkapnya tentang pesan MQTT, lihat [Apa](https://aws.amazon.com/what-is/mqtt/) itu MQTT? .
------
#### [ Console ]
Memastikan penyelesaian suatu AWS IoT kebijakan. Untuk petunjuk rinci, lihat [Langkah 1](ingest-data-from-iot-things.md#ingestion-tutorial-create-iot-policy) dalam tutorial [data Ingest](ingest-data-from-iot-things.md).
**Untuk memverifikasi bahwa Anda memiliki AWS IoT kebijakan aktif**
1. Navigasikan ke [konsol AWS IoT](https://console.aws.amazon.com/iot/) tersebut.
1. Di panel navigasi kiri, pilih **Sekuritas**, lalu **Kebijakan**.
1. Pilih kebijakan yang Anda buat. Misalnya, **SiteWiseTutorialDevicePolicy**.
1. Konfirmasikan bahwa status kebijakan terdaftar sebagai Aktif.
------
#### [ AWS CLI ]
Memastikan penyelesaian suatu AWS IoT kebijakan. Untuk instruksi rinci, lihat [Langkah 1](ingest-data-from-iot-things.md#ingestion-tutorial-create-iot-policy) dalam tutorial [data Ingest](ingest-data-from-iot-things.md).
Gunakan perintah AWS CLI [get-policy](https://docs.aws.amazon.com/cli/latest/reference/iot/get-policy.html) berikut di Command *Reference* untuk memverifikasi bahwa Anda memiliki kebijakan aktif AWS IoT :AWS CLI
```
aws iot get-policy --policy-name "SiteWiseTutorialDevicePolicy"
```
------
Kebijakan ini memungkinkan AWS IoT perangkat Anda membuat koneksi dan berkomunikasi dengan bayangan perangkat menggunakan pesan MQTT. Untuk berinteraksi dengan bayangan perangkat, AWS IoT barang-barang Anda mempublikasikan dan menerima pesan MQTT tentang topik yang dimulai. `$aws/things/{{thing-name}}/shadow/` Kebijakan ini menggabungkan variabel kebijakan sesuatu yang dikenal sebagai`${iot:Connection.Thing.ThingName}`. Variabel ini menggantikan nama benda yang terhubung di setiap topik. `iot:Connect`Pernyataan tersebut menetapkan batasan di mana perangkat dapat membuat koneksi, memastikan bahwa variabel kebijakan hal hanya dapat menggantikan nama yang dimulai dengan`SiteWiseTutorialDevice`.
Untuk informasi selengkapnya, lihat [Variabel kebijakan Thing](https://docs.aws.amazon.com/iot/latest/developerguide/iot-policy-variables.html) di *Panduan AWS IoT Pengembang*.
**catatan**
Kebijakan ini berlaku untuk hal-hal yang namanya dimulai`SiteWiseTutorialDevice`. Untuk menggunakan nama yang berbeda untuk barang-barang Anda, Anda harus memperbarui kebijakan yang sesuai.
## Langkah 2: Buat dan konfigurasikan AWS IoT sesuatu
Pada langkah ini, daftarkan perangkat edge Anda sebagai AWS IoT sesuatu dan buat sertifikat dan kunci barang Anda yang diperlukan untuk komunikasi yang aman dengan AWS IoT SiteWise Edge. Proses ini menetapkan dasar bagi perangkat Anda untuk mengirim data pihak ketiga melalui gateway V3 berkemampuan MQTT Anda.
------
#### [ Console ]
Pastikan penyelesaian langkah-langkah pembuatan dan konfigurasi untuk suatu AWS IoT hal. Untuk petunjuk rinci, lihat [Langkah 2](ingest-data-from-iot-things.md#rule-tutorial-create-iot-thing) dalam tutorial [data Ingest](ingest-data-from-iot-things.md).
**Untuk memverifikasi Anda memiliki AWS IoT hal yang aktif**
1. Navigasikan ke [konsol AWS IoT](https://console.aws.amazon.com/iot/) tersebut.
1. Di panel navigasi kiri, pilih **Semua perangkat**, lalu **Things**.
1. Pilih hal yang Anda buat. Misalnya, **SiteWiseTutorialDevice1**.
1. Di bawah **Sertifikat**, konfirmasikan bahwa status terdaftar sebagai aktif.
------
#### [ AWS CLI ]
Pastikan penyelesaian langkah-langkah pembuatan dan konfigurasi untuk suatu AWS IoT hal. Untuk petunjuk rinci, lihat [Langkah 2](ingest-data-from-iot-things.md#rule-tutorial-create-iot-thing) dalam tutorial [data Ingest](ingest-data-from-iot-things.md).
Gunakan AWS CLI perintah berikut untuk memverifikasi bahwa Anda memiliki AWS IoT kebijakan aktif:
```
aws iot describe-thing --thing-name "SiteWiseTutorialDevice1"
```
------
Setelah menyelesaikan langkah-langkah ini, Anda dapat menghubungkan perangkat Anda dengan aman ke AWS IoT SiteWise Edge. Anda membuat direktori lokal untuk menyimpan sertifikat dan kunci yang Anda buat untuk otentikasi MQTT. Perangkat Anda terdaftar sebagai AWS IoT sesuatu di [AWS IoT konsol](https://console.aws.amazon.com/iot/), dan perangkat Anda siap untuk mengintegrasikan data dengan SiteWise Edge. Anda dapat menghubungkan peralatan industri atau perangkat lain ke AWS IoT platform dan mulai menelan data ke SiteWise Edge.
## Langkah 3: Konfigurasikan gateway V3 yang SiteWise mendukung Edge MQTT Anda
Pada langkah ini, buat gateway V3 berkemampuan AWS IoT SiteWise Edge MQTT Anda dan konfigurasikan untuk menerima data dari broker EMQX. Gateway bertindak sebagai jembatan antara perangkat Anda dan AWS IoT. Ini memungkinkan Anda untuk memproses data secara lokal di tepi sebelum mengirimnya ke file. AWS Cloud Konfigurasi ini mengurangi bandwidth dan mengurangi penundaan pemrosesan cloud.
------
#### [ Console ]
**Untuk membuat gateway AWS IoT SiteWise V3 berkemampuan MQTT**
1. Masuk ke [Konsol Manajemen AWS](https://console.aws.amazon.com/)dan buka [AWS IoT SiteWise konsol](https://console.aws.amazon.com/iotsitewise/).
1. **Di panel navigasi kiri, pilih **Edge gateway, lalu pilih Buat gateway**.**
1. Di bawah **Target Deployment**, pilih Gateway yang **di-host sendiri**.
1. *Di bawah opsi gateway yang dihosting sendiri, pilih gateway V3 yang **diaktifkan MQTT - direkomendasikan**.*
1. Di bawah **konfigurasi Gateway**:
1. Di **nama Gateway**, masukkan nama untuk gateway Anda. Misalnya, **SiteWise Tutorial Device Gateway**.
1. Di OS **perangkat Greengrass, pilih opsi yang sesuai untuk perangkat** Anda.
1. Di bawah **Konfigurasi lanjutan**:
1. Pilih **Pengaturan default**.
1. Masukkan nama untuk perangkat inti Greengrass atau gunakan nama yang dihasilkan oleh. AWS IoT SiteWise
1. Pilih **Buat gateway**.
1. Dalam dialog konfirmasi, pilih **Hasilkan dan unduh** untuk menghasilkan penginstal untuk gateway SiteWise Edge Anda. Untuk informasi selengkapnya, lihat [Membuat gateway SiteWise Edge yang dihosting sendiri](create-gateway-ggv2.md#configure-gateway-console).
**Awas**
Simpan file penginstal di lokasi yang aman. File ini tidak dapat dibuat ulang, dan diperlukan untuk menyelesaikan pengaturan gateway di langkah selanjutnya.
------
#### [ AWS CLI ]
Gunakan AWS CLI untuk membuat gateway yang dihosting sendiri. Anda perlu memberikan nama untuk gateway, menentukan platform dan versi gateway. Untuk informasi selengkapnya, lihat [CreateGateway](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreateGateway.html) di dalam *Referensi API AWS IoT SiteWise *.
Untuk menggunakan contoh ini, ganti placeholder input pengguna dengan informasi Anda sendiri.
```
aws iotsitewise create-gateway \
--gateway-name SiteWise Tutorial Device Gateway \
--gateway-platform greengrassV2={coreDeviceThingName={{your-core-device-thing-name}}, coreDeviceOperatingSystem={{LINUX_AMD64}}} \
--gateway-version {{3}} \
[--cli-input-json {{your-configuration}}]
```
+ `gateway-name`— Nama unik untuk gateway, misalnya,`SiteWise Tutorial Device Gateway`.
+ `gateway-platform`— Masuk`greengrassV2`. Untuk informasi selengkapnya, lihat [CreateGateway](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreateGateway.html) di dalam *Referensi API AWS IoT SiteWise *.
+ `coreDeviceThingName`— Nama AWS IoT benda untuk perangkat AWS IoT Greengrass V2 inti Anda. Misalnya, `SiteWiseTutorialDevice1`.
+ `coreDeviceOperatingSystem`— Sistem operasi perangkat inti di AWS IoT Greengrass V2. Menentukan sistem operasi diperlukan untuk gateway-versi 3. Pilihannya meliputi:`LINUX_AARCH64`,`LINUX_AMD64`, dan`WINDOWS_AMD64`.
+ `gateway-version`— Versi gateway.
+ Gunakan `3` untuk versi gateway untuk membuat gateway V3 berkemampuan MQTT.
+ `cli-input-json`- File JSON yang berisi parameter permintaan.
Gunakan AWS CLI perintah berikut untuk memverifikasi bahwa gateway Anda berhasil dibuat:
```
aws iotsitewise describe-gateway --gateway-id {{your-gateway-id}}
```
------
## Langkah 4: Instal perangkat lunak gateway SiteWise Edge
Untuk menginstal perangkat lunak gateway, gunakan paket installer yang Anda unduh pada langkah sebelumnya. Proses instalasi mengkonfigurasi komponen yang diperlukan, memulai layanan inti Greengrass, dan mendaftarkan perangkat Anda. AWS IoT Greengrass Setelah instalasi selesai, verifikasi bahwa gateway Anda muncul di [AWS IoT SiteWise konsol](https://console.aws.amazon.com/iotsitewise/) di bawah **gateway Edge** dan bahwa layanan Greengrass berjalan dengan benar di perangkat Anda.
Untuk petunjuk mendetail, lihat [Instal perangkat lunak gateway AWS IoT SiteWise Edge di perangkat lokal Anda](install-gateway-software-on-local-device.md).
## Langkah 5: Konfigurasikan broker EMQX untuk terhubung ke aplikasi eksternal
**catatan**
Anda harus telah menerapkan gateway V3 yang mendukung SiteWise Edge MQTT sebelum melanjutkan. Gateway menyediakan infrastruktur dan pengaturan keamanan yang diperlukan untuk mengonfigurasi broker EMQX. Konfigurasi broker akan gagal tanpa penerapan gateway aktif.
Konfigurasikan broker EMQX untuk memungkinkan komunikasi yang aman antara perangkat IoT Anda dan aplikasi eksternal. Broker EMQX berfungsi sebagai pusat pesan pusat yang merutekan data antara perangkat IoT, gateway, dan aplikasi Anda. Broker EMQX memastikan pengiriman pesan yang andal di gateway Anda dan aplikasi yang terhubung di tepi. Untuk informasi selengkapnya, lihat [Hubungkan aplikasi eksternal ke broker EMQX](connect-external-applications-emqx.md).
**Untuk mengkonfigurasi broker EMQX**
1. Siapkan broker EMQX. Untuk petunjuk konfigurasi terperinci, ikuti Langkah 1-14 di [Perbarui konfigurasi penerapan EMQX](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/configure-emqx-broker.html#update-emqx-broker-authentication) untuk otentikasi.
1. Siapkan topik MQTT untuk pemantauan ladang angin. Untuk informasi lebih lanjut tentang persyaratan MQTT, lihat. [Persyaratan topik MQTT](connect-broker-payload-format.md#connect-broker-mqtt-requirements)
1. Penggunaan CPU: `SiteWiseTutorialDevice/cpu`
1. Penggunaan memori: `SiteWiseTutorialDevice/memory`
1. Stempel waktu: `SiteWiseTutorialDevice/timestamp`
1. Tinjau konfigurasi Anda dan selesaikan penerapan.
1. Pilih **Konfirmasi** untuk menyimpan pengaturan Anda.
1. Pilih **Berikutnya** sampai Anda mencapai langkah **Review**.
1. Di halaman **Tinjau**, pilih **Deploy**.
1. Tunggu hingga penerapan berhasil diselesaikan sebelum melanjutkan.
1. Siapkan pesan menggunakan format payload untuk dikirim ke broker EMQX. Untuk informasi selengkapnya tentang penataan payload, lihat [Memperbarui konfigurasi penerapan EMQX untuk](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/configure-emqx-broker.html#update-emqx-broker-authentication) autentikasi.
1. Menerapkan langkah-langkah keamanan berikut:
1. Gunakan enkripsi Transport Layer Security (TLS) (port 8833) untuk melindungi data dalam perjalanan. Untuk informasi selengkapnya, lihat [Konfigurasikan TLS untuk koneksi aman ke broker EMQX di Edge AWS IoT SiteWise](connect-app-to-broker.md#configure-tls-emqx-broker).
1. Siapkan otentikasi nama pengguna dan kata sandi untuk memverifikasi identitas perangkat. Tindakan keamanan ini membantu melindungi data Anda, dan memastikan hanya perangkat resmi yang dapat terhubung ke sistem Anda. Untuk informasi selengkapnya, lihat [Aktifkan otentikasi nama pengguna dan kata sandi](configure-emqx-broker.md#emqx-broker-username-password-auth).
EMQX memungkinkan Anda membuat aturan otorisasi berdasarkan pengidentifikasi seperti nama pengguna, alamat IP, atau ID klien. Ini berguna untuk mengontrol akses ke data Anda. Untuk informasi selengkapnya, lihat [Siapkan aturan otorisasi untuk AWS IoT SiteWise Edge di EMQX](authorization-rules-emqx-broker.md).
Setelah penerapan berhasil, broker EMQX Anda dikonfigurasi dan siap untuk terhubung dengan aman dengan aplikasi eksternal.
**catatan**
Format payload harus mengikuti struktur tertentu agar AWS IoT SiteWise Edge dapat memproses dan menyerap data Anda dengan benar. Untuk informasi lebih lanjut tentang struktur yang diperlukan, lihat[Struktur muatan JSON](connect-broker-payload-format.md#connect-broker-json-payload).
**Contoh: Tambahkan CPU, memori, dan stempel waktu muatan JSON**
**CPU JSON muatan**
```
{
"propertyAlias": "SiteWiseTutorialDevice/cpu",
"propertyValues": [
{
"quality": "GOOD",
"timestamp": {
"offsetInNanos": 0,
"timeInSeconds": 1753206441
},
"value": {
"integerValue": 45.2
}
}
]
}
```
**Memori muatan JSON**
```
{
"propertyAlias": "SiteWiseTutorialDevice/memory",
"propertyValues": [
{
"quality": "GOOD",
"timestamp": {
"offsetInNanos": 0,
"timeInSeconds": 1753206441
},
"value": {
"integerValue": 67.8
}
}
]
}
```
**Timestamp JSON payload**
```
{
"propertyAlias": "SiteWiseTutorialDevice/timestamp",
"propertyValues": [
{
"quality": "GOOD",
"timestamp": {
"offsetInNanos": 0,
"timeInSeconds": 1753206441
},
"value": {
"integerValue": 23.5
}
}
]
}
```
**catatan**
Setiap payload JSON harus dipublikasikan secara terpisah sebagai pesan individual. Jangan menggabungkan beberapa nilai properti menjadi satu pesan. Kirim setiap muatan CPU, memori, dan stempel waktu sebagai publikasi MQTT tersendiri.
Payload mendefinisikan struktur JSON yang diperlukan yang harus digunakan perangkat IoT Anda untuk mengirim data perangkat melalui broker EMQX ke Edge. SiteWise Format ini memastikan bahwa AWS IoT SiteWise dapat mengidentifikasi perangkat Anda dan memproses pembacaan sensor. Setelah Anda menerapkan konfigurasi dan struktur muatan ini, sistem pemantauan ladang angin Anda siap mengumpulkan dan memproses data.
## Langkah 6: Publikasikan data dengan Mosquitto
Setelah membuat gateway V3 berkemampuan MQTT, konfigurasikan Eclipse Mosquitto untuk mengirim data pengujian ke Edge. SiteWise Mosquitto adalah broker pesan MQTT open-source yang menggunakan protokol MQTT untuk pesan ringan antar perangkat. Klien Mosquitto memungkinkan Anda mempublikasikan pesan ke topik MQTT, mensimulasikan data dari sensor ladang angin. Menggunakan Mosquitto, simulasikan data perangkat tanpa memerlukan layanan pihak ketiga atau peralatan tambahan. Untuk informasi lebih lanjut, lihat [dokumentasi](https://mosquitto.org) di situs resmi Eclipse Mosquitto. Dalam tutorial ini, data lokal dari tutorial [data Ingest dan data](ingest-data-from-iot-things.md) fiktif digunakan untuk tujuan demonstrasi.
**Gunakan klien Mosquitto CLI untuk menguji broker Edge EMQX SiteWise **
1. Instal Mosquitto di perangkat lokal Anda. Untuk petunjuk terperinci, lihat [Unduh Mosquitto](https://mosquitto.org/download/) di situs web resmi Eclipse Mosquitto.
1. Untuk informasi selengkapnya tentang menghubungkan aplikasi eksternal untuk mentransfer data industri, lihat[Hubungkan aplikasi eksternal ke broker EMQX](connect-external-applications-emqx.md).
**penting**
Pastikan bahwa pengaturan koneksi MQTT yang Anda konfigurasikan di sini cocok dengan pengaturan yang digunakan dalam perintah Mosquitto publish. Host harus berupa alamat IP atau nama host gateway SiteWise Edge Anda. Port biasanya 1883 (atau 8883 jika menggunakan SSL/TLS).
Gunakan Mosquitto untuk mempublikasikan data uji. Buka baris perintah dan jalankan perintah berikut:
**Contoh: properti CPU**
```
mosquitto_pub -h localhost -p 1883 -t "SiteWiseTutorialDevice/cpu" -m '{
"propertyAlias": "SiteWiseTutorialDevice/cpu",
"propertyValues": [
{
"quality": "GOOD",
"timestamp": {
"timeInSeconds": 1753206441,
"offsetInNanos": 0
},
"value": {
"integerValue": 45.2
}
}
]
}'
```
**Contoh: Properti memori**
```
mosquitto_pub -h localhost -p 1883 -t "SiteWiseTutorialDevice/memory" -m '{
"propertyAlias": "SiteWiseTutorialDevice/memory",
"propertyValues": [
{
"quality": "GOOD",
"timestamp": {
"timeInSeconds": 1753206441,
"offsetInNanos": 0
},
"value": {
"integerValue": 72.1
}
}
]
}'
```
**Contoh: Properti stempel waktu**
```
mosquitto_pub -h localhost -p 1883 -t "SiteWiseTutorialDevice/timestamp" -m '{
"propertyAlias": "SiteWiseTutorialDevice/timestamp",
"propertyValues": [
{
"quality": "GOOD",
"timestamp": {
"timeInSeconds": 1753206441,
"offsetInNanos": 0
},
"value": {
"integerValue": 1683000000
}
}
]
}'
```
**catatan**
Penggunaan `localhost` sebagai alamat broker EMQX hanya untuk tujuan demonstrasi. Di lingkungan produksi atau saat menghubungkan dari perangkat eksternal, Anda harus menggunakan alamat broker EMQX yang sesuai untuk konfigurasi penerapan spesifik Anda. Untuk petunjuk koneksi terperinci, lihat[Hubungkan aplikasi ke broker EMQX di Edge AWS IoT SiteWise](connect-app-to-broker.md).
## Langkah 7: Tentukan tujuan
Pada langkah ini, tentukan tujuan untuk menentukan ke mana mengarahkan data sumber Anda. Gunakan AWS IoT SiteWise dengan buffering Amazon S3 sebagai tujuan Anda. Opsi ini menyediakan cara yang dapat diskalakan untuk menyimpan dan memproses data IoT Anda.
------
#### [ Console ]
**Untuk menambahkan tujuan**
1. Arahkan ke [AWS IoT SiteWise konsol](https://console.aws.amazon.com/iotsitewise/) dan pilih **gateway Edge**.
1. Di bawah **SiteWise Tutorial Device Gateway**, pilih **Tambahkan tujuan**.
1. Di bawah **Detail tujuan**, pilih **AWS IoT SiteWise buffer menggunakan Amazon** S3. Untuk mempelajari lebih lanjut tentang jenis tujuan, lihat [tujuan AWS IoT SiteWise gateway](gw-destinations.md#source-destination).
1. Di bawah **Nama tujuan**, masukkan nama untuk tujuan Anda, misalnya,`SiteWise Tutorial S3 Destination`.
1. Di bawah **pengaturan unggah S3**, masukkan lokasi bucket S3 Anda. Misalnya, `s3://sitewise-tutorial-mqtt-data-[your-account-id]`. Untuk mempelajari lebih lanjut tentang Amazon S3, lihat [Membuat, mengonfigurasi, dan bekerja dengan bucket Amazon S3 di](https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-buckets-s3.html) Panduan Pengguna Layanan Penyimpanan Sederhana *Amazon*.
1. Di bawah **Frekuensi unggah data**, masukkan nilai antara 1 menit dan 30 hari. Misalnya, `1 minute`.
1. Di bawah **Pengaturan penyimpanan data**:
1. Hapus pilihan **Salin data ke penyimpanan**. Meskipun pengaturan ini direkomendasikan untuk lingkungan produksi, Anda tidak membutuhkannya untuk tutorial ini. Ketika Anda membatalkan pilihan ini, opsi **Hapus data dari S3** secara otomatis tidak dipilih.
1. Pilih **Tambahkan tujuan**.
**catatan**
Tutorial ini menggunakan interval 1 menit untuk pengujian. Setelah Anda menyelesaikan tutorial, Anda dapat menyesuaikan interval ini agar sesuai dengan kebutuhan produksi Anda atau menghapusnya untuk menghindari biaya tambahan.
------
#### [ AWS CLI ]
**Contoh: Buat AWS IoT SiteWise tujuan baru yang di-buffer menggunakan Amazon S3**
Gunakan [update-gateway-capability-configuration](https://docs.aws.amazon.com/cli/latest/reference/iotsitewise/update-gateway-capability-configuration.html)di *AWS CLI Command Reference* untuk mengkonfigurasi penerbit. Atur parameter `capabilityNamespace` ke `iotsitewise:publisher:3`.
```
{
"sources": [
{
"type": "MQTT"
}
],
"destinations": [
{
"type": "SITEWISE_BUFFERED",
"name": "your-s3-destination-name",
"config": {
"targetBucketArn": "arn:aws:s3:::amzn-s3-demo-bucket/Optional/SomeFolder",
"publishPolicy": {
"publishFrequency": "1m",
"localSizeLimitGB": 10
},
"siteWiseImportPolicy": {
"enableSiteWiseStorageImport": true,
"enableDeleteAfterImport": true,
"bulkImportJobRoleArn": "arn:aws:iam::123456789012:role/your-role-name"
}
},
"filters": [
{
"type": "PATH",
"config": {
"paths": [
"#"
]
}
}
]
}
]
}
```
Untuk informasi lebih lanjut tentang tujuan, lihat[Tambahkan tujuan AWS IoT SiteWise buffer menggunakan Amazon S3](destinations-buffered.md).
------
## Langkah 8: Tentukan filter jalur
Pada langkah ini, konfigurasikan filter jalur untuk menentukan topik MQTT mana yang akan dipantau untuk data perangkat ladang angin Anda.
Filter jalur mengikuti spesifikasi wildcard topik MQTT, yang mendukung dua karakter khusus:
+ `+`— Simbol ini mewakili wildcard satu tingkat, yang cocok dengan string apa pun pada satu tingkat.
+ `#`— Simbol ini mewakili wildcard multi-level, yang cocok dengan sejumlah level dalam hierarki topik.
**catatan**
Untuk informasi selengkapnya tentang filter jalur lain, lihat[Karakter khusus dalam nama filter jalur](gw-destinations.md#path-filters-special-characters).
------
#### [ Console ]
**Untuk mengonfigurasi filter jalur Anda**
Di bawah **filter Path**:
1. Arahkan ke [AWS IoT SiteWise konsol](https://console.aws.amazon.com/iotsitewise/) dan pilih **gateway Edge**.
1. Di bawah **SiteWise Tutorial Device Gateway**, pilih **Tambahkan tujuan**.
1. Pilih **Tambahkan filter jalur** untuk memasukkan filter jalur berikut secara manual:
+ `SiteWiseTutorialDevice/#`
+ `windfarm/+/turbine/+/performance/#`
+ `cpu/+/idle-time`
+ `cpu/+/interruption-count/+`
+ `+/memory/consumption`
+ `timestamp/+/measurement`
+ `device/+/status/+`
+ `system/+/performance-log`
1. Pilih **Tambahkan tujuan**.
Untuk informasi selengkapnya tentang praktik terbaik untuk filter jalur, lihat[Praktik terbaik untuk filter jalur](gw-destinations.md#create-effective-path-filters).
------
#### [ AWS CLI ]
Gunakan AWS CLI perintah berikut untuk mengonfigurasi filter jalur Anda:
**Contoh 1: Data perangkat menggunakan wildcard**
```
{
"destinations": [
{
"name": "All Device Data Destination"
}
],
"filters": [
{
"type": "PATH",
"config": {
"paths": [
"SiteWiseTutorialDevice/#",
"windfarm/+/turbine/+/performance/#"
]
}
}
]
}
```
Konfigurasi filter jalur ini menggunakan wildcard multi-level (\#) untuk menangkap semua data dari SiteWiseTutorialDevice dan semua data kinerja dari turbin apa pun di ladang angin.
**Contoh 2: Kinerja CPU dan memori**
```
{
"destinations": [
{
"name": "Performance Metrics Destination"
}
],
"filters": [
{
"type": "PATH",
"config": {
"paths": [
"cpu/+/idle-time",
"+/memory/consumption",
"cpu/+/interruption-count/+"
]
}
}
]
}
```
Contoh ini menangkap berbagai metrik CPU (waktu idle dan jumlah interupsi) dan data konsumsi memori di seluruh perangkat.
**Contoh 3: Diagnostik perangkat**
```
{
"destinations": [
{
"name": "Device Diagnostics Destination"
}
],
"filters": [
{
"type": "PATH",
"config": {
"paths": [
"device/+/status/+",
"system/+/performance-log"
]
}
}
]
}
```
Konfigurasi ini menggunakan `+` wildcard untuk menangkap data diagnostik dari beberapa perangkat, khususnya log kinerja sistem dan pembaruan status perangkat.
Ketiga filter jalur ini cocok dengan topik MQTT yang Anda gunakan untuk mempublikasikan data pengujian dengan Mosquitto. Filter memastikan gateway SiteWise Edge Anda menangkap dan memproses pesan MQTT yang relevan. Untuk informasi selengkapnya tentang cara menambahkan filter jalur, lihat[Tambahkan filter jalur ke tujuan AWS IoT SiteWise Edge](destinations-add-path-filters.md).
------
## Langkah 9: Konfigurasikan sumber daya AWS IoT Anda
Pada langkah ini, buat model AWS IoT SiteWise aset dan aset yang diperlukan untuk mewakili perangkat pihak ketiga yang disimulasikan dan aktifkan konsumsi data melalui gateway edge Anda.
Sebelum memulai langkah ini, Anda harus menyelesaikan langkah 3 hingga 8 dalam tutorial [data Ingest](ingest-data-from-iot-things.md). Langkah-langkah ini menetapkan komponen dasar untuk mengintegrasikan data pihak ketiga Anda melalui gateway V3 berkemampuan MQTT. Anda juga menyiapkan aturan yang menentukan bagaimana data sensor Anda mengalir AWS IoT SiteWise, dan menjalankan skrip klien perangkat yang mensimulasikan data ladang angin industri.
**Untuk memvalidasi konfigurasi sumber daya AWS IoT Anda**
1. Gunakan AWS CLI perintah berikut untuk memverifikasi bahwa Anda membuat dan mengkonfigurasi dengan benar Model Perangkat SiteWise Tutorial dan Model Armada Perangkat SiteWise Tutorial Anda:
```
aws iotsitewise describe-asset-model --asset-model-id {{your-device-model-id}}
```
Gunakan AWS CLI perintah berikut untuk mengambil ID model aset Anda:
```
aws iotsitewise list-asset-models
```
1. Gunakan AWS CLI perintah berikut untuk memverifikasi bahwa Anda membuat dan mengonfigurasi aset SiteWise Tutorial Device 1 dan aset SiteWise Tutorial Device Fleet 1 Anda:
```
aws iotsitewise describe-asset --asset-id {{your-asset-id}}
```
Gunakan AWS CLI perintah berikut untuk mengambil ID aset Anda:
```
aws iotsitewise list-assets
```
## Langkah 10: Visualisasikan data Anda
Siapkan Grafana versi open-source untuk memvisualisasikan data perangkat ladang angin Anda. Grafana adalah platform visualisasi yang menampilkan data operasional real-time Anda. Dasbor ini membantu Anda melacak efisiensi operasional dan mengidentifikasi kebutuhan pemeliharaan di seluruh infrastruktur Anda. Untuk informasi selengkapnya tentang integrasi, lihat[Integrasikan AWS IoT SiteWise dengan Grafana](grafana-integration.md).
**Untuk mengatur Grafana**
1. Untuk petunjuk mengunduh dan menginstal Grafana versi terbaru, lihat Menginstal Grafana di situs web resmi [Grafana](https://grafana.com/docs/grafana/latest/setup-grafana/installation/#install-grafana).
1. Untuk petunjuk konfigurasi terperinci khusus untuk sistem operasi Anda, lihat [Mengonfigurasi Grafana](https://grafana.com/docs/grafana/latest/setup-grafana/configure-grafana/#configure-grafana) di situs web resmi Grafana.
1. Konfigurasikan sumber AWS IoT SiteWise data. Ini memungkinkan Anda untuk mengatur AWS IoT SiteWise plugin di server Grafana Anda. Untuk petunjuk mendetail tentang cara menggunakan plugin, lihat [Connect to an AWS IoT SiteWise data source](https://docs.aws.amazon.com/grafana/latest/userguide/using-iotsitewise-in-AMG.html) in the *Amazon Managed Grafana User* Guide.
**penting**
Pastikan Anda memiliki Grafana versi terbaru untuk kompatibilitas dengan sumber AWS IoT SiteWise data.
Setelah menyelesaikan langkah-langkah ini, Anda dapat membangun dan menyesuaikan dasbor Grafana untuk menampilkan metrik operasional ladang angin Anda. Ini memungkinkan Anda untuk melacak dan menganalisis kinerja ladang angin Anda di tepi secara real time.
**catatan**
Meskipun tutorial ini menggunakan Grafana versi open-source AWS , juga menawarkan Grafana Terkelola Amazon untuk lingkungan produksi. Grafana yang Dikelola Amazon adalah layanan yang dikelola sepenuhnya yang menghilangkan kebutuhan untuk mengatur, mengonfigurasi, dan memelihara server Grafana Anda sendiri.
Pertimbangkan untuk memutakhirkan ke Grafana Terkelola Amazon saat Anda siap untuk menskalakan solusi Anda. Untuk petunjuk terperinci tentang cara menghubungkan SiteWise data Anda ke Grafana, lihat tutorial [Visualisasi dan bagikan data di Grafana](visualize-with-grafana.md).
Anda telah menyelesaikan tutorialnya. Dalam prosedur ini, Anda mengonfigurasi AWS IoT SiteWise Edge untuk mengintegrasikan data perangkat pihak ketiga menggunakan gateway V3 berkemampuan MQTT. Pengaturan ini memungkinkan Anda mengumpulkan, memproses, dan memvisualisasikan data peralatan industri di edge, mengurangi latensi dan biaya operasional. Dengan menggunakan demo ladang angin, Anda mengumpulkan dan memproses metrik operasional seperti CPU dan data penggunaan memori melalui gateway V3 yang mendukung MQTT.
Untuk menyempurnakan solusi IoT Anda, pertimbangkan untuk menjelajahi fitur-fitur canggih seperti deteksi anomali dengan memanfaatkan[Deteksi anomali dengan Lookout for Equipment](anomaly-detection.md), atau mengintegrasikan dengan layanan lain AWS seperti Amazon [Quick di Panduan Pengguna Cepat](https://docs.aws.amazon.com/quicksight/latest/user/welcome.html) *Amazon* untuk analitik lanjutan.
## Langkah 11: Bersihkan sumber daya setelah tutorial
Setelah Anda menyelesaikan tutorial ini tentang mengintegrasikan data ke AWS IoT SiteWise Edge, bersihkan sumber daya Anda untuk menghindari biaya tambahan.
**Untuk menghapus aset hierarkis di AWS IoT SiteWise**
1. Navigasikan ke [konsol AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/) tersebut.
1. Di panel navigasi kiri, pilih **Aset**.
1. Saat Anda menghapus aset AWS IoT SiteWise, Anda harus terlebih dahulu memisahkannya.
Selesaikan langkah-langkah berikut untuk memisahkan aset perangkat Anda dari aset armada perangkat Anda:
1. Pilih aset armada perangkat Anda (**SiteWise Tutorial Device Fleet 1**).
1. Pilih **Edit**.
1. Di bawah **Aset yang terkait dengan aset ini**, pilih **Putuskan hubungan** untuk setiap aset perangkat yang terkait dengan aset armada perangkat ini.
1. Pilih **Simpan**.
**catatan**
Aset perangkat tidak lagi diatur sebagai hierarki sekarang.
1. Pilih aset perangkat Anda (**SiteWise Tutorial Device1**).
1. Pilih **Hapus**.
1. Dalam dialog konfirmasi, masukkan**Delete**, lalu pilih **Hapus**.
1. Ulangi langkah 4 hingga 6 untuk setiap aset perangkat dan aset armada perangkat (**SiteWise Tutorial Device Fleet 1**).
**Untuk menghapus model aset hierarkis di AWS IoT SiteWise**
1. Navigasikan ke [konsol AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/) tersebut.
1. Hapus aset armada perangkat dan perangkat Anda.
1. Di panel navigasi kiri, pilih **Model**.
1. Pilih model aset armada perangkat Anda (**SiteWise Tutorial Device Fleet Model**). Anda tidak dapat menghapus model jika Anda memiliki aset yang dibuat dari model tersebut.
Saat menghapus model aset hierarkis, mulailah dengan menghapus model aset induk terlebih dahulu.
1. Pilih **Hapus**.
1. Dalam dialog konfirmasi, masukkan**Delete**, lalu pilih **Hapus**.
1. Ulangi langkah 4 hingga 6 untuk model aset perangkat Anda (**SiteWise Tutorial Device Model**).
**Untuk menonaktifkan atau menghapus aturan di AWS IoT Core**
1. Navigasikan ke [konsol AWS IoT](https://console.aws.amazon.com/iot/) tersebut.
1. **Di panel navigasi kiri, pilih **Perutean pesan**, lalu pilih Aturan.**
1. Pilih aturan Anda dan pilih **Hapus**.
1. Dalam dialog konfirmasi, masukkan nama aturan lalu pilih **Hapus**.
**Untuk menghapus bucket Amazon S3**
1. Arahkan ke [konsol Amazon S3](https://console.aws.amazon.com/s3/).
1. Di panel navigasi kiri, pilih **Bucket tujuan umum**.
1. Dalam daftar bucket, pilih tombol opsi di sebelah bucket yang Anda buat, lalu pilih **Kosong** di bagian atas halaman.
1. **Dalam dialog konfirmasi, konfirmasikan penghapusan, lalu pilih Kosong.**
1. Setelah bucket kosong, pilih **Delete** untuk menghapus bucket.
1. Dalam dialog konfirmasi, masukkan nama bucket Anda untuk mengonfirmasi penghapusan.
1. Pilih **Hapus bucket**.
**Untuk menghapus gateway SiteWise Edge**
1. Navigasikan ke [konsol AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/) tersebut.
1. Di panel navigasi kiri, pilih **gateway Edge**.
1. Di bawah Gateways, pilih gateway yang Anda buat untuk tutorial ini. Misalnya, `SiteWise Tutorial Device Gateway`.
1. Pilih **Hapus**.
1. Untuk mengonfirmasi bahwa Anda ingin menghapus gateway, **Delete** ketik dialog konfirmasi, lalu pilih **Hapus** di jendela yang muncul.
**Untuk menghapus IoT Anda**
1. Navigasikan ke [konsol AWS IoT](https://console.aws.amazon.com/iot/) tersebut.
1. Di panel navigasi kiri, pilih **Kelola**, lalu pilih **Things**.
1. Pilih IoT yang Anda buat untuk tutorial ini. Misalnya, `SiteWiseTutorialDevice1`.
1. Pilih **Hapus**.
1. Dalam dialog konfirmasi, masukkan nama benda itu, lalu pilih **Hapus**.
**Untuk mencopot pemasangan Core AWS IoT Greengrass **
Copot pemasangan perangkat lunak AWS IoT Greengrass Core dari perangkat lokal Anda. Untuk petunjuk terperinci, lihat [Menghapus instalasi perangkat lunak AWS IoT Greengrass Inti](https://docs.aws.amazon.com/greengrass/v2/developerguide/uninstall-greengrass-core-v2.html) di *Panduan AWS IoT Greengrass Pengembang, Versi 2*.
**penting**
Menghapus instalan Greengrass menghapus semua konfigurasi dan data lokal. Pastikan Anda telah mencadangkan informasi penting apa pun sebelum melanjutkan.
**(Opsional) Untuk menghapus sumber daya pihak ketiga**
Setelah menyelesaikan tutorial ini, pertimbangkan untuk mematikan sumber daya eksternal yang Anda buat. Ini membantu mencegah timbulnya biaya dari penyedia pihak ketiga.
## Sumber daya tambahan
Lihat sumber daya berikut untuk informasi lebih lanjut:
+ [Berinteraksi dengan AWS layanan lain](interact-with-other-services.md)
+ [Gunakan AWS IoT SiteWise gateway Edge](gateways.md)
+ [Memecahkan masalah gateway Edge SiteWise](troubleshooting-gateway.md)
+ [Praktik terbaik keamanan untuk AWS IoT SiteWise](security-best-practices.md)
+ [AWS Harga IoT](https://aws.amazon.com/iot-sitewise/pricing/)
+ [Menelan data ke AWS IoT SiteWise](industrial-data-ingestion.md)
+ [Gunakan tag di AWS IoT SiteWise](tag-basics.md)