Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Gunakan AWS IoT SiteWise gateway Edge
AWS IoT SiteWise Edge memperluas kemampuan cloud ke lingkungan tepi industri, memungkinkan pemrosesan data lokal, analisis, dan pengambilan keputusan. SiteWise Edge terintegrasi dengan AWS IoT SiteWise dan AWS layanan lainnya untuk menyediakan solusi IoT industri yang komprehensif. Gateway berfungsi sebagai perantara antara peralatan industri Anda dan. AWS IoT SiteWise
SiteWise Edge gateway berjalan pada dua target penyebaran yang berbeda:
+ AWS IoT Greengrass V2
+ Siemens Industrial Edge
Anda dapat menggunakan gateway SiteWise Edge untuk mengumpulkan data di tepi dan mempublikasikannya ke cloud. Untuk gateway yang berjalan AWS IoT Greengrass, Anda juga dapat memproses data di edge menggunakan model aset dan aset.
Aplikasi AWS IoT SiteWise Edge Siemens Industrial Edge mendukung integrasi antara peralatan industri AWS IoT SiteWise sehingga Anda dapat mengumpulkan dan memproses data mesin mentah dan menjalankan analisis secara lokal sebelum mengirim data yang disempurnakan ke Cloud. AWS
## Konsep kunci gateway SiteWise Edge
SiteWise Edge memiliki beberapa fitur yang berguna untuk komputasi tepi di lingkungan industri.
**Pengumpulan dan pemrosesan data lokal**
Mendukung pengumpulan data dari aset industri menggunakan protokol seperti OPC-UA dan MQTT. Gateway berjalan di perangkat AWS IoT Greengrass Core atau. Siemens Industrial Edge
**Operasi offline**
Terus mengumpulkan dan memproses data selama pemadaman internet, menyinkronkan dengan cloud saat konektivitas dipulihkan.
**Komputasi tepi dengan AWS IoT Greengrass komponen**
Menggunakan SiteWise penerbit IoT untuk meneruskan data ke cloud dan AWS IoT SiteWise prosesor untuk transformasi dan perhitungan lokal. Baik penerbit dan prosesor adalah AWS IoT Greengrass V2 komponen. Untuk informasi selengkapnya tentang AWS IoT Greengrass komponen, lihat [komponen AWS yang disediakan](https://docs.aws.amazon.com/greengrass/v2/developerguide/public-components.html).
**Integrasi dengan AWS IoT SiteWise untuk memperluas fitur cloud**
Bekerja dengan fitur AWS IoT SiteWise cloud, memperluas model aset, analitik, dan dasbor ke tepi.
Untuk gateway dengan paket pemrosesan data yang diaktifkan, Anda dapat menggunakannya AWS OpsHub AWS IoT SiteWise untuk mengelola gateway Edge secara terpusat. SiteWise AWS OpsHub menyediakan kemampuan manajemen dan pemantauan jarak jauh. Untuk informasi selengkapnya, lihat [Kelola gateway SiteWise Edge menggunakan for AWS OpsHub AWS IoT SiteWise](manage-gateways-ggv2.md#opshub-app).
**Integrasi sumber data mitra**
Hubungkan sumber data mitra ke gateway Anda dan terima data dari mitra di gateway SiteWise Edge dan AWS cloud Anda. Untuk informasi selengkapnya, lihat [Sumber data mitra di gateway SiteWise Edge](partner-data-sources.md).
**Visualisasi lokal di tepi**
Menyediakan dasbor khusus untuk wawasan waktu nyata di tepi.
Pantau data secara lokal di fasilitas Anda menggunakan portal SiteWise Monitor di perangkat lokal Anda. Untuk informasi selengkapnya, lihat [Mengaktifkan AWS IoT SiteWise portal Anda di tepi](monitor-enable-edge.md).
## Manfaat mengimplementasikan SiteWise Edge
SiteWise Edge menawarkan banyak keuntungan yang secara signifikan dapat meningkatkan operasi industri dan proses pengambilan keputusan.
+ Wawasan operasional real-time tanpa penundaan pemrosesan cloud
+ Kontinuitas operasional di lingkungan yang terputus
+ Mengurangi biaya bandwidth dan penyimpanan melalui pra-pemrosesan tepi
+ Peningkatan keandalan dengan kemampuan untuk membuat keputusan lokal berdasarkan data
# Self-host gateway AWS IoT SiteWise Edge dengan AWS IoT Greengrass V2
Siapkan AWS IoT SiteWise Edge untuk mengumpulkan, memproses, dan memvisualisasikan data dari peralatan industri secara lokal sebelum mengirimkannya ke cloud. Self-host menggunakan AWS IoT Greengrass Version 2.
Gerbang AWS IoT SiteWise Edge bertindak sebagai perantara antara peralatan industri Anda dan AWS IoT SiteWise. Berjalan AWS IoT Greengrass Version 2, gateway SiteWise Edge mendukung pengumpulan dan pemrosesan data di tempat.
Ada dua jenis gateway yang dihosting sendiri:
Gateway V3 yang berkemampuan MQTT
Arsitektur gateway V3 berkemampuan MQTT menyediakan kemampuan penyerapan data yang ditingkatkan. Ini menggunakan protokol MQTT untuk komunikasi data yang efisien dan menawarkan tujuan data yang dapat dikonfigurasi. Ini termasuk opsi untuk konsumsi data buffer menggunakan Amazon S3, serta konsumsi data waktu nyata. Anda dapat menerapkan filter jalur untuk berlangganan topik MQTT tertentu, memungkinkan pengumpulan data yang ditargetkan. Perhatikan bahwa gateway V3 berkemampuan MQTT tidak mendukung fitur Paket Pemrosesan Data. Untuk informasi selengkapnya, lihat [Gateway V3 berkemampuan MQTT untuk Edge AWS IoT SiteWise](mqtt-enabled-v3-gateway.md).
Gateway V2 aliran Klasik
Aliran Klasik, gateway V2 mewakili arsitektur gateway AWS IoT SiteWise Edge tradisional. Ini sangat cocok untuk penerapan SiteWise Edge yang ada dan pengguna yang terbiasa dengan alur kerja yang ditetapkan. Sementara aliran Klasik, gateway V2 mendukung paket pemrosesan data, perhatikan bahwa data yang dihasilkan oleh paket pemrosesan data tidak dapat dicerna melalui Amazon S3. Gunakan aliran Klasik, gateway V2 jika Anda perlu mempertahankan kompatibilitas dengan penerapan yang ada atau jika Anda memerlukan fungsionalitas paket pemrosesan data. Untuk informasi selengkapnya, lihat [Aliran klasik, gateway V2 untuk Edge AWS IoT SiteWise](classic-streams-v2-gateway.md).
**Topics**
+ [AWS IoT SiteWise Persyaratan gateway yang dihosting sendiri di Edge](configure-gateway-ggv2.md)
+ [Buat gateway SiteWise Edge yang dihosting sendiri](create-gateway-ggv2.md)
+ [Instal perangkat lunak gateway AWS IoT SiteWise Edge di perangkat lokal Anda](install-gateway-software-on-local-device.md)
+ [Gateway V3 berkemampuan MQTT untuk Edge AWS IoT SiteWise](mqtt-enabled-v3-gateway.md)
+ [Aliran klasik, gateway V2 untuk Edge AWS IoT SiteWise](classic-streams-v2-gateway.md)
+ [Tambahkan sumber data ke gateway AWS IoT SiteWise Edge Anda](add-data-sources.md)
+ [AWS IoT Greengrass komponen untuk AWS IoT SiteWise Edge](sw-edge-components.md)
+ [Filter aset di gateway SiteWise Edge](filter-assets-ggv2.md)
+ [Konfigurasikan dukungan proxy dan kelola toko kepercayaan untuk AWS IoT SiteWise Edge](edge-apis-manage-trust-stores-proxy.md)
+ [Gunakan AWS IoT SiteWise APIs di tepi](edge-apis.md)
# AWS IoT SiteWise Persyaratan gateway yang dihosting sendiri di Edge
AWS IoT SiteWise Edge gateway berjalan AWS IoT Greengrass V2 sebagai satu set AWS IoT Greengrass komponen yang mendukung pengumpulan data, pemrosesan, dan penerbitan di tempat. Untuk mengonfigurasi gateway SiteWise Edge yang berjalan AWS IoT Greengrass V2, buat gateway di AWS Cloud dan jalankan perangkat lunak gateway SiteWise Edge untuk menyiapkan perangkat lokal Anda. Saat Anda menggunakan Konsol Manajemen AWS untuk membuat gateway SiteWise Edge, skrip instalasi disediakan. Jalankan skrip ini di perangkat gateway target Anda untuk menyiapkan perangkat lunak dan dependensi yang diperlukan.
## Persyaratan perangkat lokal
Perangkat lokal harus memenuhi persyaratan berikut untuk menginstal dan menjalankan perangkat lunak gateway SiteWise Edge.
+ Mendukung perangkat lunak AWS IoT Greengrass V2 Core versi [v2.3.0](https://docs.aws.amazon.com/greengrass/v2/developerguide/greengrass-release-2021-06-29.html) atau yang lebih baru. Untuk informasi selengkapnya, lihat [Persyaratan](https://docs.aws.amazon.com/greengrass/v2/developerguide/setting-up.html#greengrass-v2-requirements) dalam *Panduan AWS IoT Greengrass Version 2 Pengembang*.
+ Salah satu platform yang didukung berikut:
+ OS: Ubuntu 20.04 atau yang lebih baru
Arsitektur: x86\$164 (AMD64) atau ARMv8 (Aarch64)
+ OS: Perusahaan Red Hat Linux (RHEL) 8
Arsitektur: x86\$164 (AMD64) atau ARMv8 (Aarch64)
+ OS: Amazon Linux 2
Arsitektur: x86\$164 (AMD64) atau ARMv8 (Aarch64)
+ OS: Debian 11
Arsitektur: x86\$164 (AMD64) atau ARMv8 (Aarch64)
+ OS: Windows Server 2019 dan yang lebih baru
Arsitektur: x86\$164 () AMD64
**catatan**
Platform ARM mendukung gateway SiteWise Edge hanya dengan Paket Pengumpulan Data. Paket pemrosesan data tidak didukung.
+ Minimal 4 GB RAM.
+ Ruang disk minimal 10 GB tersedia untuk perangkat lunak gateway SiteWise Edge.
+ Konfigurasikan perangkat lokal Anda untuk memastikan bahwa port yang tepat dapat diakses. Untuk daftar lengkap titik akhir layanan keluar yang diperlukan, lihat Titik akhir layanan yang [diperlukan untuk AWS IoT SiteWise gateway Edge](https://docs.aws.amazon.com/prescriptive-guidance/latest/endpoints-for-iot-sitewise-edge-gateways/required-endpoints.html).
+ Java Runtime Environment (JRE) versi 11 atau lebih tinggi. Java harus tersedia pada variabel `PATH` lingkungan pada perangkat. Untuk menggunakan Java untuk mengembangkan komponen kustom, Anda harus menginstal Java Development Kit (JDK). [Kami menyarankan Anda menggunakan [Amazon Corretto](https://docs.aws.amazon.com/corretto/) atau OpenJDK.](https://openjdk.org/projects/jdk/)
### Bucket Amazon S3 untuk mengizinkan daftar perangkat lokal
Konfigurasikan perangkat lokal Anda untuk menyediakan akses firewall ke bucket Amazon S3 berikut. Konfigurasikan akses berdasarkan wilayah masing-masing untuk perangkat Anda.
| Region | Titik akhir |
| --- | --- |
| Asia Pasifik (Tokyo) | https://iot-sitewise-gateway-ap-northeast-1-785558802005.s3.ap-northeast-1.amazonaws.com |
| Asia Pacific (Seoul) | https://iot-sitewise-gateway-ap-northeast-2-310055672453.s3.ap-northeast-2.amazonaws.com |
| Asia Pacific (Mumbai) | https://iot-sitewise-gateway-ap-south-1-677656657204.s3.ap-south-1.amazonaws.com |
| Asia Pasifik (Singapura) | https://iot-sitewise-gateway-ap-southeast-1-475191558554.s3.ap-southeast-1.amazonaws.com |
| Asia Pacific (Sydney) | https://iot-sitewise-gateway-ap-southeast-2-396319432685.s3.ap-southeast-2.amazonaws.com |
| Kanada (Pusat) | https://iot-sitewise-gateway-ca-central-1-842060018567.s3.ca-central-1.amazonaws.com |
| Tiongkok (Beijing) | https://iot-sitewise-gateway-cn-north-1-237124890262---s3---cn-north-1.amazonaws.com.rproxy.govskope.ca.cn |
| Eropa (Frankfurt) | https://iot-sitewise-gateway-eu-central-1-748875242063.s3.eu-central-1.amazonaws.com |
| Eropa (Irlandia) | https://iot-sitewise-gateway-eu-west-1-383414315062.s3.eu-west-1.amazonaws.com |
| AS Timur (Virginia Utara) | https://iot-sitewise-gateway-us-east-1-223558168232---s3---us-east-1.amazonaws.com.rproxy.govskope.cadan https://iot-sitewise-gateway-us-east-1-223558168232.s3.amazonaws.com/ |
| AS Timur (Ohio) | https://iot-sitewise-gateway-us-east-2-005072661813.s3.us-east-2.amazonaws.com |
| AWS GovCloud (AS-Barat) | https://iot-sitewise-gateway-us-gov-west-1-599984565679.s3.us-gov-west-1.amazonaws.com/ |
| AS Barat (Oregon) | https://iot-sitewise-gateway-us-west-2-502577205460.s3.us-west-2.amazonaws.com |
## Persyaratan paket pemrosesan data
**catatan**
Fitur paket pemrosesan data (DPP) tidak lagi tersedia untuk pelanggan baru. Pelanggan yang sudah ada dapat terus menggunakan layanan ini seperti biasa. Untuk informasi selengkapnya, lihat [Perubahan ketersediaan paket pemrosesan data](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/iotsitewise-dpp-availability-change.html).
+ Jika Anda berencana untuk menggunakan paket pemrosesan data di tepi AWS IoT SiteWise, perangkat lokal Anda juga harus memenuhi persyaratan berikut:
+ Memiliki prosesor quad-core x86 64 bit.
+ Memiliki setidaknya 16 GB RAM.
+ Memiliki setidaknya 32 GB untuk RAM jika menggunakanMicrosoft Windows.
+ Memiliki setidaknya 256 GB ruang disk kosong.
+ Perangkat lokal harus mengizinkan lalu lintas masuk jaringan pada port 443.
+ Port berikut dicadangkan untuk digunakan oleh AWS IoT SiteWise: 80, 443, 3001, 4569, 4572, 8000, 8081, 8082, 8084, 8085, 8445, 8086, 9000, 9500, 11080, dan 50010. Menggunakan port cadangan untuk lalu lintas dapat mengakibatkan koneksi terputus.
**catatan**
Komponen AWS IoT Greengrass V2 Stream manager memiliki persyaratannya sendiri. Untuk informasi selengkapnya, lihat [Konfigurasi](https://docs.aws.amazon.com/greengrass/v2/developerguide/stream-manager-component.html#stream-manager-component-configuration) di *Panduan AWS IoT Greengrass Version 2 Pengembang*.
+ Ruang disk minimum dan persyaratan kapasitas komputasi bergantung pada berbagai faktor yang unik untuk implementasi dan kasus penggunaan Anda.
+ Ruang disk yang diperlukan untuk caching data untuk konektivitas internet intermiten tergantung pada faktor-faktor berikut:
+ Jumlah aliran data yang diunggah
+ Titik data per aliran data per detik
+ Ukuran setiap titik data
+ Kecepatan komunikasi
+ Waktu henti jaringan yang diharapkan
+ Kapasitas komputasi yang diperlukan untuk melakukan polling dan mengunggah data tergantung pada faktor-faktor berikut:
+ Jumlah aliran data yang diunggah
+ Titik data per aliran data per detik
## Konfigurasikan izin untuk menggunakan gateway SiteWise Edge
Anda harus memiliki izin berikut untuk menggunakan gateway SiteWise Edge:
**catatan**
Jika Anda menggunakan AWS IoT SiteWise konsol untuk membuat gateway SiteWise Edge Anda, izin ini ditambahkan untuk Anda.
+ Peran IAM untuk gateway SiteWise Edge Anda harus memungkinkan Anda menggunakan gateway SiteWise Edge pada AWS IoT Greengrass V2 perangkat untuk memproses data model aset dan data aset.
Peran tersebut memungkinkan layanan berikut untuk mengambil peran:`credentials.iot.amazonaws.com`.
**Detail izin**
Peran harus memiliki izin berikut:
+ `iotsitewise`— Memungkinkan prinsipal untuk mengambil data model aset dan data aset di tepi.
+ `iot`— Memungkinkan AWS IoT Greengrass V2 perangkat Anda untuk berinteraksi dengan AWS IoT.
+ `logs`— Memungkinkan AWS IoT Greengrass V2 perangkat Anda mengirim log ke Amazon CloudWatch Logs.
+ `s3`— Memungkinkan AWS IoT Greengrass V2 perangkat Anda mengunduh artefak komponen khusus dari Amazon S3.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"iotsitewise:BatchPutAssetPropertyValue",
"iotsitewise:List*",
"iotsitewise:Describe*",
"iotsitewise:Get*"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"iot:DescribeCertificate",
"logs:CreateLogGroup",
"logs:CreateLogStream",
"logs:PutLogEvents",
"logs:DescribeLogStreams",
"s3:GetBucketLocation",
"s3:GetObject",
"iot:Connect",
"iot:Publish",
"iot:Subscribe",
"iot:Receive",
"iot:DescribeEndpoint"
],
"Resource": "*"
}
]
}
```
------
# Buat gateway SiteWise Edge yang dihosting sendiri
Gunakan AWS IoT SiteWise konsol atau AWS CLI untuk membuat gateway SiteWise Edge yang dihosting sendiri. Prosedur ini merinci cara membuat gateway SiteWise Edge yang dihosting sendiri yang akan Anda instal di perangkat keras Anda sendiri. Untuk informasi tentang membuat gateway SiteWise Edge yang berjalan di Siemens Industrial Edge, lihat. [Host gateway SiteWise Edge di Siemens Industrial Edge](sitewise-edge-on-siemens.md)
## Buat gateway SiteWise Edge
------
#### [ Console ]
1. Navigasikan ke [konsol AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/) tersebut.
1. Di panel navigasi, pilih **gateway Edge**.
1. Pilih **Buat gateway**.
1. Untuk **Pilih target penerapan**, pilih gateway yang **dihosting sendiri**.
1. Pilih salah satu **berkemampuan MQTT, gateway V3 atau aliran **Klasik**, gateway** V2. Untuk informasi lebih lanjut tentang setiap opsi, lihat[Self-host gateway AWS IoT SiteWise Edge dengan AWS IoT Greengrass V2](gw-self-host-gg2.md). Gateway V3 berkemampuan MQTT direkomendasikan untuk fitur-fiturnya yang siap di masa depan.
1. Di bagian **konfigurasi Gateway**, masukkan nama untuk gateway SiteWise Edge Anda atau gunakan nama yang dihasilkan oleh AWS IoT SiteWise.
1. Di bawah **Greengrass device** OS, pilih sistem operasi perangkat tempat Anda akan menginstal gateway Edge ini. SiteWise
**catatan**
Paket pemrosesan data hanya tersedia di platform x86. Ini hanya tersedia di aliran Klasik, gateway V2
1. (Opsional) Untuk memproses dan mengatur data di tepi, di bawah **kemampuan Edge**, pilih **Paket Pemrosesan Data**.
**catatan**
Untuk memberikan akses kepada grup pengguna di direktori perusahaan Anda ke gateway SiteWise Edge ini, lihat [Siapkan kemampuan tepi di SiteWise Edge](edge-data-collection-and-processing.md#using-sitewise-edge)
1. (Opsional) Di bawah **konfigurasi lanjutan**, lakukan hal berikut:
1. Untuk perangkat **inti Greengrass**, pilih salah satu opsi berikut:
+ **Pengaturan default** - AWS secara otomatis menggunakan pengaturan default untuk membuat perangkat inti Greengrass di. AWS IoT Greengrass V2
1. Masukkan nama untuk perangkat inti Greengrass atau gunakan nama yang dihasilkan oleh. AWS IoT SiteWise
+ **Pengaturan lanjutan** - Pilih opsi ini jika Anda ingin menggunakan perangkat inti Greengrass yang ada atau membuatnya secara manual.
1. Pilih perangkat inti Greengrass atau pilih **Buat perangkat inti Greengrass** untuk membuatnya di konsol. AWS IoT Greengrass V2 Untuk informasi selengkapnya, lihat [Menyiapkan perangkat AWS IoT Greengrass V2 inti](https://docs.aws.amazon.com/greengrass/v2/developerguide/setting-up.html) di *Panduan AWS IoT Greengrass Version 2 Pengembang*.
1. Pilih **Buat gateway**.
1. Dalam kotak dialog **Generate SiteWise Edge gateway installer**, pilih **Hasilkan dan unduh**. AWS IoT SiteWise secara otomatis menghasilkan penginstal yang dapat Anda gunakan untuk mengonfigurasi perangkat lokal Anda.
**penting**
Anda tidak dapat membuat ulang file ini. Pastikan Anda menyimpan file installer di lokasi yang aman karena Anda akan menggunakan file tersebut nanti.
------
#### [ AWS CLI ]
Untuk membuat gateway yang dihosting sendiri dengan menggunakan AWS CLI, berikan nama untuk gateway, tentukan platform, dan versi gateway. Ada banyak opsi lain yang dapat Anda tentukan saat membuat gateway. *Untuk informasi selengkapnya, lihat [create-gateway](https://docs.aws.amazon.com/cli/latest/reference/iotsitewise/create-gateway.html) di Command Reference untuk AWS CLI * AWS IoT SiteWise
Untuk menggunakan contoh ini, ganti placeholder input pengguna dengan informasi Anda sendiri.
```
aws iotsitewise create-gateway \
--gateway-name your-gateway-name \
--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.
+ `gateway-platform`— Menentukan konfigurasi platform gateway. Untuk gateway yang dihosting sendiri, masukkan. `greengrassV2` Untuk informasi selengkapnya, lihat [Opsi](https://docs.aws.amazon.com/cli/latest/reference/iotsitewise/create-gateway.html#options) di bagian create-gateway dari Referensi *AWS CLI Perintah* untuk. AWS IoT SiteWise
+ `coreDeviceThingName`— Nama hal AWS IoT untuk perangkat AWS IoT Greengrass V2 inti Anda.
+ `coreDeviceOperatingSystem`— Sistem operasi perangkat inti di AWS IoT Greengrass V2. Menentukan sistem operasi diperlukan untuk `gateway-version 3` dan tidak berlaku untuk`gateway-version 2`. Pilihannya meliputi:`LINUX_AARCH64`,`LINUX_AMD64`, dan `WINDOWS_AMD64`
+ `gateway-version`— Versi gateway.
+ Untuk membuat gateway V3 berkemampuan MQTT, gunakan `3` untuk versi gateway.
+ Untuk membuat aliran Klasik, gateway V2, gunakan `2` untuk versi gateway.
+ `cli-input-json`- File JSON yang berisi parameter permintaan.
------
Sekarang Anda telah membuat gateway SiteWise Edge,[Instal perangkat lunak gateway AWS IoT SiteWise Edge di perangkat lokal Anda](install-gateway-software-on-local-device.md).
# Instal perangkat lunak gateway AWS IoT SiteWise Edge di perangkat lokal Anda
Setelah Anda membuat gateway AWS IoT SiteWise Edge, instal perangkat lunak gateway SiteWise Edge di perangkat lokal Anda. SiteWise Perangkat lunak gateway Edge dapat diinstal pada perangkat lokal yang memiliki sistem operasi Linux atau Microsoft Windows server yang diinstal.
**penting**
Pastikan perangkat lokal Anda terhubung ke internet.
------
#### [ Linux ]
Prosedur berikut menggunakan SSH untuk terhubung ke perangkat lokal Anda. Atau, Anda dapat menggunakan USB flash drive atau alat lain untuk mentransfer file installer ke perangkat lokal Anda. Jika Anda tidak ingin menggunakan SSH, lewati ke **Langkah 2: Instal perangkat lunak gateway SiteWise Edge** di bawah ini.
**Prasyarat SSH**
Sebelum Anda terhubung ke perangkat Anda menggunakan SSH, lengkapi prasyarat berikut.
+ Linux dan macOS - Unduh dan instal OpenSSH. Untuk informasi selengkapnya, lihat [https://www.openssh.com](https://www.openssh.com/).
**Langkah 1: Salin penginstal ke perangkat gateway SiteWise Edge Anda**
Petunjuk berikut menjelaskan cara menghubungkan ke perangkat lokal Anda menggunakan klien SSH.
1. Untuk terhubung ke perangkat Anda, jalankan perintah berikut di jendela terminal di komputer Anda, ganti *username* dan *IP* dengan nama pengguna yang memiliki hak istimewa dan alamat IP yang tinggi.
```
ssh username@IP
```
1. Untuk mentransfer file penginstal yang AWS IoT SiteWise dihasilkan ke perangkat gateway SiteWise Edge Anda, jalankan perintah berikut.
**catatan**
Ganti *path-to-saved-installer* dengan path di komputer Anda yang Anda gunakan untuk menyimpan file installer dan nama file installer.
Ganti *IP-address* dengan alamat IP perangkat lokal Anda.
Ganti *directory-to-receive-installer* dengan jalur di perangkat lokal yang Anda gunakan untuk menerima file penginstal.
```
scp path-to-saved-installer.sh user-name@IP-address:directory-to-receive-installer
```
**Langkah 2: Instal perangkat lunak gateway SiteWise Edge**
Dalam prosedur berikut, jalankan perintah di jendela terminal pada perangkat gateway SiteWise Edge Anda.
1. Berikan file penginstal izin eksekusi.
```
chmod +x path-to-installer.sh
```
1. Jalankan pemasang.
```
sudo ./path-to-installer.sh
```
------
#### [ Windows Server ]
**Prasyarat**
Anda harus memiliki prasyarat berikut untuk menginstal perangkat lunak gateway Edge: SiteWise
+ Microsoft WindowsServer 2019 atau yang lebih baru diinstal
+ Hak istimewa administrator
+ PowerShell versi 5.1 atau yang lebih baru diinstal
+ SiteWise Edge gateway installer diunduh ke Windows Server di mana ia akan disediakan
**Langkah 1: Jalankan PowerShell sebagai administrator**
1. Di server Windows tempat Anda ingin menginstal gateway SiteWise Edge, masuk sebagai administrator.
1. Masukkan **PowerShell**di bilah pencarian Windows.
1. Dalam hasil pencarian, buka menu konteks (klik kanan) pada PowerShell aplikasi Windows. Pilih **Jalankan sebagai Administrator**.
**Langkah 2: Instal perangkat lunak gateway SiteWise Edge**
Jalankan perintah berikut di jendela terminal pada perangkat SiteWise Edge Gateway Anda.
1. Buka blokir penginstal gateway SiteWise Edge.
```
unblock-file path-to-installer.ps1
```
1. Jalankan Installer.
```
./path-to-installer.ps1
```
**catatan**
Jika eksekusi skrip dinonaktifkan pada sistem, ubah kebijakan eksekusi skrip menjadi`RemoteSigned`.
```
Set-ExecutionPolicy RemoteSigned
```
------
Langkah selanjutnya tergantung pada *jenis* gateway yang dihosting sendiri yang Anda butuhkan. Lanjutkan ke [Gateway V3 berkemampuan MQTT untuk Edge AWS IoT SiteWise](mqtt-enabled-v3-gateway.md) atau[Aliran klasik, gateway V2 untuk Edge AWS IoT SiteWise](classic-streams-v2-gateway.md).
# Gateway V3 berkemampuan MQTT untuk Edge AWS IoT SiteWise
AWS IoT SiteWise dapat menggunakan gateway V3 berkemampuan MQTT, yang mewakili kemajuan signifikan dalam arsitektur gateway Edge. SiteWise Tipe gateway ini memanfaatkan protokol MQTT (Message Queuing Telemetry Transport) untuk komunikasi data, memberikan peningkatan fleksibilitas dan efisiensi dalam penerapan IoT industri.
Gateway V3 berkemampuan MQTT menggunakan MQTT untuk transfer data, memungkinkan protokol jaringan berlangganan publikasi yang ringan yang secara efisien mengangkut pesan antar perangkat dan cloud. Anda dapat mengatur berbagai tujuan data, termasuk konsumsi data real-time langsung ke dalam AWS IoT SiteWise dan penyerapan data buffer menggunakan Amazon S3. Untuk mengaktifkan pengumpulan data yang tepat, Anda dapat menerapkan filter jalur untuk berlangganan topik MQTT tertentu.
Gateway V3 berkemampuan MQTT dilengkapi dengan tujuan real-time yang telah dikonfigurasi sebelumnya dengan filter yang disetel ke “\$1” (semua topik), yang dapat Anda sesuaikan atau hapus sesuai kebutuhan. Untuk merampingkan manajemen data, hanya satu tujuan real-time yang dapat ada di setiap gateway.
Arsitektur berkemampuan MQTT berbeda secara signifikan dari aliran Klasik, gateway V2. Sementara V2 menggunakan pendekatan berbasis streaming, V3 menggunakan MQTT, menawarkan lebih banyak tujuan data yang dapat dikonfigurasi dan opsi pemfilteran. Namun, perhatikan bahwa V3 tidak mendukung paket pemrosesan data, yang tersedia di V2.
Gateway V3 berkemampuan MQTT menawarkan beberapa keuntungan:
+ Peningkatan skalabilitas, karena sifat ringan MQTT, memungkinkan penanganan yang lebih baik dari berbagai perangkat dan transmisi data frekuensi tinggi.
+ Kontrol data yang ditingkatkan melalui filter jalur, memungkinkan manajemen pengumpulan data secara terperinci dan mengurangi transfer dan pemrosesan data yang tidak perlu.
+ Penanganan data yang fleksibel, memungkinkan konfigurasi antara pemrosesan real-time dan penyimpanan buffer berdasarkan kebutuhan spesifik.
+ Keselarasan dengan standar komunikasi IoT modern, menetapkan panggung untuk peningkatan dan integrasi di masa depan.
Pertimbangkan untuk mengadopsi gateway V3 berkemampuan MQTT untuk penerapan baru, terutama ketika Anda memerlukan opsi penyerapan data yang fleksibel dan kontrol yang tepat atas pengumpulan data.
**catatan**
Untuk penerapan atau skenario yang ada yang memerlukan paket pemrosesan data, aliran Klasik, gateway V2 tetap menjadi opsi yang layak.
Dengan menawarkan kedua jenis gateway, AWS IoT SiteWise pastikan Anda dapat memilih solusi yang paling sesuai dengan kebutuhan IoT industri spesifik Anda, baik Anda memprioritaskan kemampuan MQTT tingkat lanjut atau kompatibilitas dengan sistem yang ada.
## Tujuan dan filter jalur
Lihat topik berikut untuk mempelajari lebih lanjut tentang tujuan dan filter jalur di gateway berkemampuan MQTT:
+ [Memahami tujuan AWS IoT SiteWise Edge](gw-destinations.md#source-destination)
+ [Menambahkan tujuan real-time AWS IoT SiteWise Edge](destinations-real-time.md)
+ [Tambahkan tujuan AWS IoT SiteWise buffer menggunakan Amazon S3](destinations-buffered.md)
+ [Memahami filter jalur untuk tujuan AWS IoT SiteWise EdgeMemahami filter jalur](gw-destinations.md#destinations-path-filters)
+ [Tambahkan filter jalur ke tujuan AWS IoT SiteWise Edge](destinations-add-path-filters.md)
+ [Kelola tujuan AWS IoT SiteWise Edge](destinations-manage.md)
# Hubungkan aplikasi eksternal ke broker EMQX
Panduan ini menjelaskan cara menghubungkan aplikasi eksternal ke gateway AWS IoT SiteWise Edge Anda melalui broker EMQX di gateway V3 berkemampuan MQTT yang Anda gunakan. Aplikasi eksternal mungkin termasuk alat pemantauan khusus, perangkat lunak visualisasi pihak ketiga, atau sistem lama yang perlu berinteraksi dengan data industri Anda di edge.
Kami akan membahas langkah-langkah konfigurasi untuk Linux dan Microsoft Windows lingkungan, termasuk konfigurasi penerapan EMQX, pengaturan TLS untuk koneksi aman, dan aturan otorisasi untuk mengontrol akses ke topik tertentu.
**catatan**
EMQX bukan vendor atau pemasok untuk AWS IoT SiteWise Edge.
**penting**
Untuk mengamankan koneksi ke gateway Anda, kami sangat menyarankan menggunakan otentikasi berbasis sertifikat melalui fitur otentikasi perangkat klien. AWS IoT Greengrass Metode ini memberikan keamanan yang kuat melalui otentikasi TLS (mTLS) timbal balik. Untuk informasi selengkapnya, lihat [Connect perangkat klien ke perangkat inti](https://docs.aws.amazon.com/greengrass/v2/developerguide/connect-client-devices.html) di *Panduan AWS IoT Greengrass Version 2 Pengembang*.
Jika Anda tidak dapat menggunakan otentikasi berbasis sertifikat, ikuti panduan ini untuk mengatur otentikasi menggunakan nama pengguna dan kata sandi.
## Prasyarat
+ Gateway V3 berkemampuan SiteWise Edge MQTT yang telah digunakan dan sedang online
+ Akses ke host gateway
+ Akses ke AWS IoT SiteWise dan AWS IoT Greengrass konsol
**Topics**
+ [Prasyarat](#emqx-broker-prerequisites)
+ [Format payload pesan untuk broker EMQX di Edge AWS IoT SiteWise](connect-broker-payload-format.md)
+ [Konfigurasikan broker EMQX](configure-emqx-broker.md)
+ [Hubungkan aplikasi ke broker EMQX di Edge AWS IoT SiteWise](connect-app-to-broker.md)
+ [Siapkan aturan otorisasi untuk AWS IoT SiteWise Edge di EMQX](authorization-rules-emqx-broker.md)
# Format payload pesan untuk broker EMQX di Edge AWS IoT SiteWise
Agar komponen SiteWise penerbit IoT mengkonsumsi data dari aplikasi eksternal Anda dan mempublikasikannya ke AWS IoT SiteWise cloud, muatan yang dikirim ke broker harus memenuhi persyaratan khusus.
Memahami format payload adalah kunci keberhasilan komunikasi MQTT dengan Edge. AWS IoT SiteWise Sementara proses pengaturan koneksi tercakup dalam bagian selanjutnya, kami menyajikan persyaratan payload terlebih dahulu untuk membantu Anda merencanakan implementasi Anda.
## Persyaratan topik MQTT
Tidak ada batasan pada struktur topik MQTT, termasuk jumlah level atau karakter yang digunakan. Namun, kami menyarankan agar topik tersebut cocok dengan `propertyAlias` bidang di payload.
**Example Contoh alias properti**
Jika topik MQTT adalah`site1/line1/compressor1/temperature`, pastikan kecocokannya. `propertyAlias`
```
{
"assetId": "compressor_asset_01",
"propertyAlias": "site1/line1/compressor1/temperature",
"propertyId": "temperature_sensor_01",
"propertyValues": [
{
"quality": "GOOD",
"timestamp": {
"offsetInNanos": 0,
"timeInSeconds": 1683000000
},
"value": {
"doubleValue": 23.5
}
}
]
}
```
## Struktur muatan JSON
[Payload pesan MQTT ditulis dalam JSON dan mengikuti format `PutAssetPropertyValueEntry` pesan yang ditentukan dalam Referensi API.AWS IoT SiteWise](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_PutAssetPropertyValueEntry.html)
```
{
"assetId": "string",
"propertyAlias": "string",
"propertyId": "string",
"propertyValues": [
{
"quality": "string",
"timestamp": {
"offsetInNanos": number,
"timeInSeconds": number
},
"value": {
"booleanValue": boolean,
"doubleValue": number,
"integerValue": number,
"stringValue": "string"
}
}
]
}
```
**catatan**
Agar pesan dianggap valid, hanya satu dari kondisi berikut yang bisa benar:
yang `propertyAlias` ditetapkan, atau
Keduanya `assetId` dan `propertyId` diatur
`PutAssetPropertyValueEntry`Memiliki `entryId` bidang yang tidak diperlukan dalam konteks ini.
# Konfigurasikan broker EMQX
Bagian ini mencakup cara menambahkan nama pengguna dan kata sandi. Ini juga mencakup cara membuat koneksi TLS dari sumber eksternal menggunakan nama pengguna dan kata sandi yang ditambahkan. Anda dapat mengkonfigurasi broker EMQX menggunakan Linux atau. Microsoft Windows
**catatan**
Untuk mengonfigurasi broker, Anda memerlukan perangkat inti yang diatur dengan konfigurasi EMQX default di gateway V3 berkemampuan MQTT Anda.
**penting**
Setelah menyelesaikan prosedur ini, kami sangat menyarankan untuk mengonfigurasi aturan otorisasi. Untuk informasi selengkapnya, lihat [Siapkan aturan otorisasi untuk AWS IoT SiteWise Edge di EMQX](authorization-rules-emqx-broker.md). Aturan otorisasi untuk pengguna tambahan meningkatkan keamanan.
## Perbarui konfigurasi penerapan EMQX untuk otentikasi
**Untuk memperbarui konfigurasi penerapan EMQX untuk otentikasi**
1. Navigasikan ke [konsol AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/) tersebut.
1. Di navigasi kiri, pilih **gateway Edge** di bagian **Edge**.
1. Pilih gateway untuk dikonfigurasi.
1. Di bagian **konfigurasi gateway Edge**, salin nilai perangkat inti **Greengrass** Anda. Simpan untuk digunakan nanti.
1. Buka [konsol AWS IoT](https://console.aws.amazon.com/iot/).
1. **Di navigasi kiri, di bawah bagian **Kelola**, pilih Perangkat **Greengrass**, lalu Deployment.**
1. Temukan nilai perangkat inti yang Anda simpan sebelumnya dan pilih tautan itu untuk membuka penerapan.
1. **Pilih tombol dropdown **Actions**, lalu Revise.**
1. Baca pesan yang muncul lalu pilih **Revise deployment**. Halaman **Tentukan target** muncul.
1. Pilih **Berikutnya** hingga Anda mencapai langkah **Konfigurasi komponen**.
1. Pilih tombol `aws.greengrass.clientdevices.mqtt.EMQX` radio.
1. Pilih tombol **Configure component**. Halaman konfigurasi muncul untuk komponen.
1. Di bawah **Pembaruan konfigurasi**, pilih **Atur ulang ke konfigurasi default untuk versi komponen: 2.\$1. **\$1.
1. Masukkan konfigurasi berikut di bagian **Configuration to merge** berdasarkan OS Anda.
------
#### [ Linux ]
```
{
"emqxConfig": {
"authorization": {
"no_match": "allow"
},
"listeners": {
"tcp": {
"default": {
"enabled": true,
"enable_authn": false
}
},
"ssl": {
"default": {
"enabled": true,
"enable_authn": true,
"ssl_options": {
"verify": "verify_none",
"fail_if_no_peer_cert": false
}
}
}
},
"authentication": {
"enable": true,
"backend": "built_in_database",
"mechanism": "password_based",
"password_hash_algorithm": {
"iterations": 210000,
"mac_fun": "sha512",
"name": "pbkdf2"
},
"user_id_type": "username"
},
"dashboard": {
"listeners": {
"http": {
"bind": 18083
}
}
}
},
"authMode": "bypass",
"dockerOptions": "-p 8883:8883 -p 127.0.0.1:1883:1883 -p 127.0.0.1:18083:18083 -v emqx-data:/opt/emqx/data -e EMQX_NODE__NAME=emqx@local",
"requiresPrivilege": "true"
}
```
------
#### [ Windows ]
```
{
"emqxConfig": {
"authorization": {
"no_match": "allow"
},
"listeners": {
"tcp": {
"default": {
"enabled": true,
"enable_authn": false
}
},
"ssl": {
"default": {
"enabled": true,
"enable_authn": true,
"ssl_options": {
"verify": "verify_none",
"fail_if_no_peer_cert": false
}
}
}
},
"authentication": {
"enable": true,
"backend": "built_in_database",
"mechanism": "password_based",
"password_hash_algorithm": {
"iterations": 210000,
"mac_fun": "sha512",
"name": "pbkdf2"
},
"user_id_type": "username"
},
"dashboard": {
"listeners": {
"http": {
"bind": 18083
}
}
}
},
"authMode": "bypass",
"requiresPrivilege": "true"
}
```
`dockerOptions`Bidang ini hanya untuk gateway Linux.
------
1. Pilih **Konfirmasi**.
1. Pilih **Berikutnya** sampai Anda mencapai langkah **Review**.
1. Pilih **Deploy**.
1. Setelah penerapan berhasil, lanjutkan ke langkah berikutnya.
## Aktifkan otentikasi nama pengguna dan kata sandi
Bagian ini menunjukkan cara menambahkan nama pengguna dan kata sandi melalui GUI dasbor EMQX.
**catatan**
Instruksi terkait EMQX yang disediakan hanya untuk referensi. Karena dokumentasi dan fitur EMQX dapat berubah seiring waktu, dan kami tidak memelihara dokumentasinya, kami sarankan untuk berkonsultasi dengan [dokumentasi resmi EMQX untuk informasi](https://docs.emqx.com/en/emqx/latest/) terbaru.
------
#### [ EMQX Dashboard ]
**Untuk mengaktifkan otentikasi nama pengguna dan kata sandi melalui dasbor EMQX**
1. Pastikan Anda berada di dalam host gateway.
1. Buka jendela browser dan kunjungi [http://localhost:18083/](http://localhost:18083/).
1. Masukkan nama pengguna default **admin** dan kata sandi default dari**public**. Untuk informasi selengkapnya, lihat [Dasbor EMQX di Dokumen](https://docs.emqx.com/en/emqx/latest/dashboard/introduction.html#first-login) *EMQX*.
1. Setelah login, Anda diminta untuk mengubah kata sandi Anda. Perbarui kata sandi Anda untuk melanjutkan ke Dasbor EMQX.
1. Di navigasi kiri, pilih ikon perisai, lalu **Otentikasi.**
1. Di baris **Built-in Database**, pilih tombol **Users**.
1. Pilih tombol ikon tanda tambah untuk menambahkan pengguna. Layar **Tambah** muncul.
1. Masukkan nama pengguna dan kata sandi untuk pengguna aplikasi eksternal.
1. Pilih **Simpan**. Nama pengguna yang Anda pilih muncul di tabel halaman **Otentikasi**.
**catatan**
Aturan otorisasi yang ada atau default berlaku untuk pengguna baru. Disarankan untuk meninjau dan menyesuaikannya dengan kebutuhan aplikasi eksternal Anda.
------
#### [ EMQX Management with Linux ]
Gunakan alat AWS IoT SiteWise EMQX CLI di. `/greengrass/v2/bin/swe-emqx-cli`
**Untuk mengaktifkan otentikasi nama pengguna dan kata sandi melalui Manajemen EMQX menggunakan Linux**
1. Ubah kata sandi admin dengan menjalankan perintah berikut:
```
/greengrass/v2/bin/swe-emqx-cli admin change-pwd
```
1. Saat diminta, lakukan hal berikut:
1. Masukkan pengguna administrator Anda saat ini (default adalah`admin`) dan kata sandi (default adalah`public`).
1. Masukkan dan konfirmasikan kata sandi baru Anda.
Jika berhasil, Anda melihat pesan berikut:
```
admin password changed successfully
```
1. Tambahkan pengguna untuk aplikasi eksternal dengan menjalankan perintah berikut:
```
/greengrass/v2/bin/swe-emqx-cli users add
```
1. Saat diminta, lakukan hal berikut:
1. Masukkan nama pengguna untuk pengguna baru.
1. Masukkan dan konfirmasikan kata sandi untuk pengguna baru.
Jika berhasil, Anda melihat pesan berikut:
```
User '[username]' created successfully
```
1. Verifikasi konfigurasi pengguna dengan menjalankan perintah berikut:
```
/greengrass/v2/bin/swe-emqx-cli users list
```
Output menunjukkan semua pengguna yang dikonfigurasi:
```
Users:
- [your-added-username]
Total users: 1
```
------
#### [ EMQX Management with Windows ]
Gunakan alat AWS IoT SiteWise EMQX CLI di salah satu lokasi berikut:
+ PowerShell: `C:\greengrass\v2\bin\swe-emqx-cli.ps1`
+ Prompt Perintah: `C:\greengrass\v2\bin\swe-emqx-cli.bat`
**Untuk mengaktifkan otentikasi nama pengguna dan kata sandi melalui Manajemen EMQX menggunakan Windows**
1. Ubah kata sandi admin dengan menjalankan perintah berikut:
```
C:\greengrass\v2\bin\swe-emqx-cli.ps1 admin change-pwd
```
1. Saat diminta, lakukan hal berikut:
1. Masukkan pengguna administrator Anda saat ini (default adalah`admin`) dan kata sandi (default adalah`public`).
1. Masukkan dan konfirmasikan kata sandi baru Anda.
Jika berhasil, Anda melihat pesan berikut:
```
admin password changed successfully
```
1. Tambahkan pengguna untuk aplikasi eksternal dengan menjalankan perintah berikut:
```
C:\greengrass\v2\bin\swe-emqx-cli.ps1 users add
```
1. Saat diminta, lakukan hal berikut:
1. Masukkan nama pengguna untuk pengguna baru.
1. Masukkan dan konfirmasikan kata sandi untuk pengguna baru.
Jika berhasil, Anda melihat pesan berikut:
```
User '[username]' created successfully
```
1. Verifikasi konfigurasi pengguna dengan menjalankan perintah berikut:
```
C:\greengrass\v2\bin\swe-emqx-cli.ps1 users list
```
Output menunjukkan semua pengguna yang dikonfigurasi:
```
Users:
- [your-added-username]
Total users: 1
```
------
# Hubungkan aplikasi ke broker EMQX di Edge AWS IoT SiteWise
Broker EMQX menggunakan Transport Layer Security (TLS) pada port 8883 untuk mengenkripsi semua komunikasi, memastikan data Anda tetap terlindungi selama transmisi. Bagian ini memandu Anda melalui langkah-langkah untuk membangun koneksi antara aplikasi Anda dan broker EMQX. Mengikuti langkah-langkah ini membantu menjaga integritas dan kerahasiaan data industri Anda. Proses koneksi melibatkan dua pendekatan utama: menggunakan penemuan IP otomatis melalui komponen, atau mengonfigurasi nama DNS dan alamat IP secara manual sebagai Nama Alternatif Subjek (SANs) dalam sertifikat TLS Anda. Setiap metode memiliki kelebihannya sendiri tergantung pada pengaturan jaringan dan persyaratan keamanan Anda. Dokumentasi ini akan memandu Anda melalui kedua opsi.
**Topics**
+ [Konfigurasikan TLS untuk koneksi aman ke broker EMQX di Edge AWS IoT SiteWise](#configure-tls-emqx-broker)
+ [Uji koneksi broker EMQX di Edge AWS IoT SiteWise](#test-emqx-connection)
+ [Gunakan CA Anda sendiri](#configure-tls-custom-ca)
+ [Buka port 8883 untuk koneksi firewall eksternal](#emqx-firewall)
## Konfigurasikan TLS untuk koneksi aman ke broker EMQX di Edge AWS IoT SiteWise
Secara default, AWS IoT Greengrass menghasilkan sertifikat server TLS untuk broker EMQX yang ditandatangani oleh otoritas sertifikat perangkat inti (CA). Untuk informasi selengkapnya, lihat [Menghubungkan perangkat klien ke perangkat AWS IoT Greengrass Core dengan broker MQTT](https://docs.aws.amazon.com/greengrass/v2/developerguide/connecting-to-mqtt.html).
### Ambil sertifikat TLS
Untuk mendapatkan sertifikat CA, jalankan perintah berikut pada host gateway:
------
#### [ Linux ]
Jalankan perintah berikut dalam sesi shell pada host gateway:
```
/greengrass/v2/bin/swe-emqx-cli cert
```
Perintah ini menampilkan lokasi sertifikat dan mencetak konten sertifikat.
Anda dapat menyimpan sertifikat ke file menggunakan perintah ini:
```
/greengrass/v2/bin/swe-emqx-cli cert --output /path/to/certificate.pem
```
------
#### [ Windows ]
Jalankan perintah berikut dalam PowerShell sesi di host gateway:
```
C:\greengrass\v2\bin\swe-emqx-cli.ps1 cert
```
Perintah ini menampilkan lokasi sertifikat dan mencetak konten sertifikat.
Anda dapat menyimpan sertifikat ke file menggunakan perintah ini:
```
C:\greengrass\v2\bin\swe-emqx-cli.ps1 cert --output C:\path\to\certificate.pem
```
CLI secara otomatis menempatkan sertifikat terlepas dari jalur yang tepat pada sistem Anda.
------
Salin isi file ca.pem ke aplikasi eksternal yang Anda sambungkan ke broker. Simpan sebagai `BrokerCoreDeviceCA.pem`.
### Tambahkan names/IP alamat DNS khusus ke sertifikat server TLS
Nama alternatif subjek (SAN) pada sertifikat yang dihasilkan oleh AWS IoT Greengrass adalah`localhost`. Saat membuat koneksi TLS dari luar host gateway, langkah verifikasi TLS gagal karena nama host broker tidak cocok dengan nama host `localhost` pada sertifikat server.
Untuk mengatasi masalah nama host yang tidak cocok, AWS IoT Greengrass sediakan dua cara untuk mengelola titik akhir perangkat inti. Bagian ini mencakup kedua opsi. Untuk informasi selengkapnya, lihat [Mengelola titik akhir perangkat inti](https://docs.aws.amazon.com/greengrass/v2/developerguide/manage-core-device-endpoints.html) di *Panduan AWS IoT Greengrass Version 2 Pengembang*.
+ Untuk terhubung ke broker EMQX menggunakan alamat IP perangkat inti, gunakan bagian Penemuan IP Otomatis.
+ Untuk terhubung ke broker EMQX menggunakan nama DNS alih-alih alamat IP, Anda menggunakan bagian Manajemen manual.
------
#### [ Automated IP discovery ]
Opsi ini memungkinkan perangkat inti Anda untuk secara otomatis menemukan alamat IP-nya dan menambahkannya sebagai Nama Alternatif Subjek (SAN) ke sertifikat broker.
1. Tambahkan `aws.greengrass.clientdevices.IPDetector` komponen ke penerapan perangkat inti Anda.
1. Menerapkan perubahan ke perangkat Anda
1. Tunggu hingga penerapan selesai.
Setelah penerapan selesai, Anda dapat membuat koneksi TLS yang aman menggunakan alamat IP broker.
Alamat IP secara otomatis ditambahkan sebagai SAN ke sertifikat broker.
------
#### [ Manual DNS and IP Configuration ]
Anda dapat menambahkan nama DNS dan alamat IP secara manual sebagai Nama Alternatif Subjek (SANs) ke sertifikat TLS Anda. Metode ini berguna ketika Anda telah mengonfigurasi nama DNS untuk host gateway Anda.
**penting**
Jika Anda menggunakan IPDetector komponen, hapus dari penerapan Anda sebelum melanjutkan. IPDetectorKomponen mengesampingkan konfigurasi titik akhir manual.
**Untuk mengonfigurasi titik akhir secara manual**
1. Navigasikan ke [konsol AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/) tersebut.
1. Di navigasi kiri, pilih **gateway Edge** di bagian **Edge**.
1. Pilih gateway untuk dikonfigurasi.
1. Di bagian **konfigurasi gateway Edge**, pilih url perangkat inti **Greengrass** Anda. Halaman perangkat inti muncul.
1. Pilih tab **Perangkat klien**.
1. Pilih **Kelola titik akhir**.
1. Di kotak dialog Kelola titik akhir, masukkan nama DNS dan alamat IP apa pun yang ingin Anda tambahkan sebagai. SANs Gunakan port 8883.
1. Pilih **Perbarui**.
Sertifikat server TLS broker diperbarui secara otomatis untuk menyertakan titik akhir baru Anda.
**Untuk memverifikasi pembaruan sertifikat server TLS menggunakan Linux**
1. Mulai sesi shell di host gateway Anda.
```
docker exec emqx openssl x509 -in ./data/cert.pem -text -noout | grep -A1 "Subject Alternative Name"
```
1. Perintah mengembalikan output yang mirip dengan berikut ini:
```
X509v3 Subject Alternative Name:
DNS:endpoint_you_added, DNS:localhost
```
1. Verifikasi bahwa titik akhir Anda muncul dalam daftar. SANs
**Untuk memverifikasi pembaruan sertifikat server TLS menggunakan Windows**
1. Mulai sesi shell di host gateway Anda.
```
(Get-PfxCertificate -FilePath "C:\greengrass\v2\work\aws.greengrass.clientdevices.mqtt.EMQX\v2\data\cert.pem").Extensions | Where-Object { $_.Oid.FriendlyName -eq "Subject Alternative Name" } | ForEach-Object { "Subject Alternative Name:", ($_.Format($true) -split "`n")[0..1] }
```
1. Perintah mengembalikan output yang mirip dengan berikut ini:
```
Subject Alternative Name:
DNS Name=your-endpoint
DNS Name=localhost
```
1. Verifikasi bahwa titik akhir yang Anda tambahkan ada dalam daftar. SANs
------
## Uji koneksi broker EMQX di Edge AWS IoT SiteWise
Setelah mengonfigurasi broker EMQX Anda dengan sertifikat TLS dan kredensyal otentikasi, penting untuk memverifikasi bahwa pengaturan Anda berfungsi dengan benar. Menguji koneksi membantu memastikan bahwa konfigurasi keamanan Anda diterapkan dengan benar dan klien dapat berhasil membuat koneksi terenkripsi ke broker. Bagian ini menunjukkan cara menguji koneksi broker Anda menggunakan klien antarmuka baris perintah Mosquitto (CLI), alat klien MQTT yang banyak digunakan yang mendukung enkripsi dan otentikasi TLS.
### Gunakan klien Mosquitto CLI untuk menguji koneksi broker EMQX
Pada langkah ini kita akan menggunakan klien CLI mosquitto untuk menguji pengaturan kita dan memastikan kita dapat terhubung dengan sukses ke broker menggunakan nama pengguna dan kata sandi yang kita buat sebelumnya. Untuk mendapatkan langkah-langkah `BrokerCoreDeviceCA.pem` berikut di bawah Langkah 3: Menyiapkan TLS.
```
mosquitto_sub -h hostname|ip address \
-p 8883 \
-t "#" \
-q 1 \
-u username -P password \
--cafile BrokerCoreDeviceCA.pem
```
**catatan**
Anda mungkin mendapatkan kesalahan SSL: Verify jika hostname/IP alamat yang Anda sambungkan tidak cocok dengan Nama Alternatif Subjek (SAN) yang ada di sertifikat CA yang Anda berikan ke klien. Lihat “Menambahkan names/IP alamat DNS khusus ke sertifikat server TLS” di bawah Langkah 3: Menyiapkan TLS untuk cara mendapatkan sertifikat dengan SAN yang benar.
Pada titik ini, semua pengguna memiliki akses untuk mempublikasikan dan berlangganan semua topik di broker. Lanjut ke [Siapkan aturan otorisasi untuk AWS IoT SiteWise Edge di EMQX](authorization-rules-emqx-broker.md).
## Gunakan CA Anda sendiri
AWS IoT Greengrass menguraikan cara mengonfigurasi komponen autentikasi perangkat klien Anda sendiri untuk menggunakan otoritas sertifikat (CA) Anda sendiri. Komponen auth perangkat klien (`aws.greengrass.clientdevices.Auth`) mengautentikasi perangkat klien dan mengotorisasi tindakan perangkat klien. Untuk informasi selengkapnya, lihat [Menggunakan otoritas sertifikat Anda sendiri](https://docs.aws.amazon.com/greengrass/v2/developerguide/connecting-to-mqtt.html#use-your-own-CA) di *Panduan AWS IoT Greengrass Version 2 Pengembang*.
Untuk menggunakan CA Anda sendiri, tambahkan `aws.greengrass.clientdevices.Auth` komponen ke penerapan Anda sehingga Anda dapat menentukan konfigurasi kustom.
## Buka port 8883 untuk koneksi firewall eksternal
------
#### [ Linux ]
Dalam aturan firewall host Linux Anda, tambahkan aturan masuk untuk port 8883 untuk memungkinkan koneksi masuk dari luar host gateway. Jika ada firewall di tempat, pastikan bahwa koneksi TLS masuk pada port 8883 diperbolehkan.
------
#### [ Windows ]
Dalam aturan firewall Microsoft Windows host Anda, tambahkan aturan masuk untuk port 8883 untuk mengizinkan koneksi masuk dari luar host gateway. Pastikan aturannya adalah aturan izinkan, dari jenis port, yang menentukan port 8883. Anda dapat mengonfigurasi ini sesuai dengan konfigurasi jaringan Anda untuk memungkinkan koneksi dari aplikasi eksternal Anda ke broker.
------
# Siapkan aturan otorisasi untuk AWS IoT SiteWise Edge di EMQX
EMQX mendukung penambahan aturan otorisasi berdasarkan pengidentifikasi seperti nama pengguna, alamat IP atau ID klien. Ini berguna jika Anda ingin membatasi jumlah aplikasi eksternal yang terhubung ke berbagai operasi atau topik.
**Topics**
+ [Konfigurasikan otorisasi menggunakan database bawaan dengan Linux](add-auth-rules-database-emqx-broker-linux.md)
+ [Konfigurasikan otorisasi menggunakan database bawaan dengan Windows](add-auth-rules-database-emqx-broker-windows.md)
+ [Perbarui konfigurasi penerapan EMQX untuk otorisasi](update-emqx-broker-authorization.md)
+ [Tambahkan aturan otorisasi melalui Dasbor EMQX untuk pengguna](add-rules-emqx-broker.md)
# Konfigurasikan otorisasi menggunakan database bawaan dengan Linux
Saat Anda mengonfigurasi aturan otorisasi, ada dua pilihan konfigurasi yang bergantung pada pengaturan penerapan Anda.
+ **Docker**— Jika Anda menjalankan Docker instalasi standar tanpaLitmus Edge, gunakan konfigurasi **gateway jembatan Docker**. Ini biasanya terjadi ketika Anda hanya menerapkan AWS IoT SiteWise komponen.
+ **Litmus Edge**— Jika Anda telah Litmus Edge menginstal pada gateway Anda, gunakan konfigurasi **subnet Litmus Edge jaringan**.
**catatan**
Jika Anda awalnya mengkonfigurasi gateway Docker jembatan dan kemudian menginstalLitmus Edge, konfigurasikan ulang aturan otorisasi menggunakan opsi subnet Litmus Edge jaringan untuk memastikan komunikasi yang tepat antara semua komponen.
**Untuk menambahkan aturan otorisasi dasar**
1. Verifikasi bahwa broker EMQX digunakan dan dijalankan.
1. Mulai sesi shell di host gateway Anda.
------
#### [ Docker without Tepi Lakmus ]
Untuk Docker instalasi standar tanpaLitmus Edge, jalankan:
```
/greengrass/v2/bin/swe-emqx-cli acl init
```
------
#### [ Litmus Edge network subnet ]
Jika Anda menggunakanLitmus Edge, tentukan IP subnet jaringan Litmus Edge:
```
docker network inspect LitmusNetwork | grep IPAM -A9
```
Perhatikan nilai Subnet dari output dan jalankan perintah berikut. Ganti `litmus_subnet_ip` dengan nilai Subnet dari langkah sebelumnya.
```
/greengrass/v2/bin/swe-emqx-cli acl init litmus_subnet_ip
```
------
Alat ini secara otomatis membuat dan menerapkan aturan otorisasi untuk memungkinkan koneksi dari alamat IP yang disediakan ke broker. Ini memungkinkan akses ke semua topik. Ini termasuk kolektor IoT SiteWise OPC UA dan penerbit IoT. SiteWise
1. Lanjut ke [Perbarui konfigurasi penerapan EMQX untuk otorisasi](update-emqx-broker-authorization.md).
# Konfigurasikan otorisasi menggunakan database bawaan dengan Windows
Bagian ini mencakup konfigurasi aturan otorisasi menggunakan database bawaan untuk penerapan Windows.
**Untuk menambahkan aturan otorisasi dasar**
1. Verifikasi bahwa broker EMQX digunakan dan dijalankan.
1. Jalankan alat AWS IoT SiteWise EMQX CLI:
```
C:\greengrass\v2\bin\swe-emqx-cli.ps1 acl init
```
Alat ini secara otomatis membuat dan menerapkan aturan ACL yang memungkinkan koneksi dari localhost (127.0.0.1) ke broker. Ini memungkinkan akses ke semua topik. Ini termasuk kolektor IoT SiteWise OPC UA dan penerbit IoT. SiteWise
1. Lanjut ke [Perbarui konfigurasi penerapan EMQX untuk otorisasi](update-emqx-broker-authorization.md).
# Perbarui konfigurasi penerapan EMQX untuk otorisasi
**Untuk memperbarui konfigurasi penerapan EMQX untuk otorisasi**
1. Navigasikan ke [konsol AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/) tersebut.
1. Di navigasi kiri, pilih **gateway Edge** di bagian **Edge**.
1. Pilih gateway untuk dikonfigurasi.
1. Di bagian **konfigurasi gateway Edge**, salin nilai perangkat inti **Greengrass** Anda. Simpan untuk digunakan nanti.
1. Buka [konsol AWS IoT](https://console.aws.amazon.com/iot/).
1. **Di navigasi kiri, di bawah bagian **Kelola**, pilih Perangkat **Greengrass**, lalu Deployment.**
1. Temukan nilai perangkat inti yang Anda simpan sebelumnya dan pilih tautan itu untuk membuka penerapan.
1. **Pilih tombol dropdown **Actions**, lalu Revise.**
1. Baca pesan yang muncul lalu pilih **Revise deployment**. Halaman **Tentukan target** muncul.
1. Pilih **Berikutnya** hingga Anda mencapai langkah **Konfigurasi komponen**.
1. Pilih tombol `aws.greengrass.clientdevices.mqtt.EMQX` radio.
1. Pilih tombol **Configure component**. Halaman konfigurasi muncul untuk komponen.
1. Di bawah **Pembaruan konfigurasi**, pilih **Atur ulang ke konfigurasi default untuk versi komponen: 2.\$1. **\$1.
1. Rekatkan konten berikut di bagian **Configuration to merge** berdasarkan OS Anda.
------
#### [ Linux ]
```
{
"emqxConfig": {
"authorization": {
"no_match": "deny",
"sources": [
{
"type": "built_in_database"
},
{
"type": "file",
"path": "data/authz/acl.conf"
}
]
},
"listeners": {
"tcp": {
"default": {
"enabled": true,
"enable_authn": false
}
},
"ssl": {
"default": {
"enabled": true,
"enable_authn": true,
"ssl_options": {
"verify": "verify_none",
"fail_if_no_peer_cert": false
}
}
}
},
"authentication": {
"enable": true,
"backend": "built_in_database",
"mechanism": "password_based",
"password_hash_algorithm": {
"iterations": 210000,
"mac_fun": "sha512",
"name": "pbkdf2"
},
"user_id_type": "username"
},
"dashboard": {
"listeners": {
"http": {
"bind": 18083
}
}
}
},
"authMode": "bypass",
"dockerOptions": "-p 8883:8883 -p 127.0.0.1:1883:1883 -p 127.0.0.1:18083:18083 -v emqx-data:/opt/emqx/data -e EMQX_NODE__NAME=emqx@local",
"requiresPrivilege": "true"
}
```
------
#### [ Windows ]
```
{
"emqxConfig": {
"authorization": {
"no_match": "deny",
"sources": [
{
"type": "built_in_database"
},
{
"type": "file",
"path": "C:\\greengrass\\v2\\work\\aws.greengrass.clientdevices.mqtt.EMQX\\v2\\data\\authz\\acl.conf"
}
]
},
"listeners": {
"tcp": {
"default": {
"enabled": true,
"enable_authn": false
}
},
"ssl": {
"default": {
"enabled": true,
"enable_authn": true,
"ssl_options": {
"verify": "verify_none",
"fail_if_no_peer_cert": false
}
}
}
},
"authentication": {
"enable": true,
"backend": "built_in_database",
"mechanism": "password_based",
"password_hash_algorithm": {
"iterations": 210000,
"mac_fun": "sha512",
"name": "pbkdf2"
},
"user_id_type": "username"
},
"dashboard": {
"listeners": {
"http": {
"bind": 18083
}
}
}
},
"authMode": "bypass",
"requiresPrivilege": "true"
}
```
------
1. Pilih **Konfirmasi**.
1. Pilih **Berikutnya** sampai Anda mencapai langkah **Review**.
1. Pilih **Deploy**.
**catatan**
Mulai saat ini dan seterusnya, Anda tidak dapat mengedit file ACL untuk memperbarui aturan otorisasi. Atau, Anda dapat melanjutkan ke [Tambahkan aturan otorisasi melalui Dasbor EMQX untuk pengguna](add-rules-emqx-broker.md) setelah penerapan berhasil.
# Tambahkan aturan otorisasi melalui Dasbor EMQX untuk pengguna
Anda dapat menambahkan atau memperbarui aturan otorisasi menggunakan Dasbor EMQX atau alat EMQX AWS IoT SiteWise CLI. Alat AWS IoT SiteWise CLI EMQX mengelola otorisasi menggunakan database bawaan EMQX.
**catatan**
Menambahkan aturan otorisasi adalah langkah konfigurasi lanjutan yang memerlukan pemahaman tentang pola topik MQTT dan kontrol akses. *Untuk informasi selengkapnya tentang membuat aturan otorisasi menggunakan database bawaan EMQX, lihat [Menggunakan Basis Data Bawaan](https://docs.emqx.com/en/emqx/latest/access-control/authz/mnesia.html) di Dokumen EMQX.*
**catatan**
Instruksi terkait EMQX yang disediakan hanya untuk referensi. Karena dokumentasi dan fitur EMQX dapat berubah seiring waktu, dan kami tidak memelihara dokumentasinya, kami sarankan untuk berkonsultasi dengan [dokumentasi resmi EMQX untuk informasi](https://docs.emqx.com/en/emqx/latest/) terbaru.
------
#### [ EMQX dashboard ]
Prosedur ini menunjukkan bagaimana Anda dapat menambahkan aturan otorisasi di dasbor EMQX.
Dasbor EMQX hanya dapat diakses dari dalam host gateway. Jika Anda mencoba terhubung dari luar host gateway, Anda tidak dapat mengakses dasbor.
**Untuk menambahkan aturan otorisasi menggunakan Dasbor EMQX**
1. Pastikan Anda berada di dalam host gateway.
1. Buka jendela browser dan kunjungi [http://localhost:18083/](http://localhost:18083/).
1. Masuk ke dasbor EMQX. Prosedur ini mengasumsikan bahwa Anda telah mengubah kredensi login default Anda menjadi sesuatu yang Anda pilih. Untuk informasi lebih lanjut tentang penyiapan awal, lihat[Aktifkan otentikasi nama pengguna dan kata sandi](configure-emqx-broker.md#emqx-broker-username-password-auth).
1. Pilih ikon perisai, lalu **Otorisasi** dari menu tarik-turun.
1. Pilih tombol **Permissions** pada baris **Built-in Database**.
1. Di bagian otorisasi Basis Data bawaan, tambahkan atau perbarui aturan otorisasi pengguna untuk kebutuhan bisnis Anda. Untuk panduan selengkapnya tentang membuat aturan, lihat bagian [Use Built-in Database](https://docs.emqx.com/en/emqx/latest/access-control/authz/mnesia.html) di Dokumen *EMQX*.
------
#### [ AWS IoT SiteWise CLI tool using Linux ]
**Untuk mengelola aturan otorisasi menggunakan alat AWS IoT SiteWise EMQX CLI di Linux:**
+ Tambahkan aturan otorisasi untuk pengguna menggunakan format berikut:
```
/greengrass/v2/bin/swe-emqx-cli auth add your-username your-action your-permission your-topic [your-action-permission-topic]
```
**Example Menambahkan aturan otorisasi untuk pengguna**
Contoh ini menunjukkan cara menambahkan aturan untuk pengguna bernama`system1`:
```
/greengrass/v2/bin/swe-emqx-cli auth add system1 \
publish allow "sensors/#" \
subscribe allow "control/#" \
all deny "#"
```
**Example : Lihat aturan otorisasi untuk pengguna**
Untuk melihat aturan otorisasi bagi `system1` pengguna, jalankan perintah berikut:
```
/greengrass/v2/bin/swe-emqx-cli auth list system1
```
**Example : Lihat semua aturan otorisasi yang ada**
Untuk melihat semua aturan otorisasi yang Anda miliki saat ini, jalankan perintah berikut:
```
/greengrass/v2/bin/swe-emqx-cli auth list
```
**Example : Hapus semua aturan otorisasi untuk pengguna**
Untuk menghapus semua aturan otorisasi yang diterapkan pada pengguna tertentu, jalankan perintah berikut:
```
/greengrass/v2/bin/swe-emqx-cli auth delete system1
```
Anda diminta untuk mengkonfirmasi penghapusan.
------
#### [ AWS IoT SiteWise CLI tool using Windows ]
**Untuk mengelola aturan otorisasi menggunakan alat AWS IoT SiteWise EMQX CLI di: Windows PowerShell**
+ Tambahkan aturan otorisasi untuk pengguna menggunakan format berikut:
```
C:\greengrass\v2\bin\swe-emqx-cli.ps1 auth add your-username your-action your-permission your-topic [your-action-permission-topic]
```
**Example : Tambahkan aturan otorisasi untuk pengguna**
Contoh ini menunjukkan cara menambahkan aturan untuk pengguna bernama`system1`:
```
C:\greengrass\v2\bin\swe-emqx-cli.ps1 auth add system1 `
publish allow "sensors/#" `
subscribe allow "control/#" `
all deny "#"
```
**Example : Lihat aturan otorisasi untuk pengguna**
Untuk melihat aturan otorisasi bagi `system1` pengguna, jalankan perintah berikut:
```
C:\greengrass\v2\bin\swe-emqx-cli.ps1 auth list system1
```
**Example : Lihat semua aturan otorisasi yang ada**
Untuk melihat semua aturan otorisasi yang Anda miliki saat ini, jalankan perintah berikut:
```
C:\greengrass\v2\bin\swe-emqx-cli.ps1 auth list
```
**Example : Hapus semua aturan otorisasi untuk pengguna**
Untuk menghapus semua aturan otorisasi yang diterapkan pada pengguna tertentu, jalankan perintah berikut:
```
C:\greengrass\v2\bin\swe-emqx-cli.ps1 auth delete system1
```
Anda diminta untuk mengkonfirmasi penghapusan.
------
# Memproses dan memvisualisasikan data dengan SiteWise Edge dan alat sumber terbuka
Konfigurasikan gateway berkemampuan AWS IoT SiteWise Edge MQTT dengan alat sumber terbuka untuk pemrosesan dan visualisasi lokal guna meningkatkan kemampuan manajemen data industri Anda.
Dengan SiteWise Edge, Anda dapat membuat pipeline pemrosesan data lokal menggunakan alat sumber terbuka eksternal. [Gunakan [Node-red®](https://nodered.org/) untuk menyimpan data deret waktu dengan [InfluxDB®, dan memantau operasi melalui dasbor Grafana®](https://www.influxdata.com/lp/influxdb-database/).](https://grafana.com/)
Node-red memproses dan mengubah aliran data Anda, sementara InfluxDB menyediakan penyimpanan data deret waktu. Grafana menampilkan data operasional real-time Anda. Gunakan alat ini dengan SiteWise Edge untuk menyinkronkan data antara lingkungan lokal Anda dan lingkungan AWS Cloud, memberi Anda wawasan lokal langsung dan kemampuan analitik berbasis cloud jangka panjang.
**catatan**
Node-red®, InfluxDB®, dan Grafana® bukan vendor atau pemasok untuk Edge. SiteWise
![\[Diagram yang menunjukkan beberapa sumber data dan simulator turbin yang terhubung ke Broker EMQX untuk dipublikasikan. Kemudian broker EMQX berlangganan AWS IoT SiteWise Gateway dan Node-red. Node-red dimasukkan ke InfluxDB, dan kemudian Influx DB ke Dasbor Grafana.\]](http://docs.aws.amazon.com/id_id/iot-sitewise/latest/userguide/images/gateway-open-source-overview.png)
**catatan**
Dalam panduan ini, kami menggunakan Grafana SiteWise for Edge versi open-source sebagai lawan dari layanan [Grafana](https://grafana.com/) yang [Dikelola Amazon](https://docs.aws.amazon.com/grafana/latest/userguide/what-is-Amazon-Managed-Service-Grafana.html).
## Opsi deployment
Anda dapat menerapkan solusi ini menggunakan salah satu dari dua pendekatan. Dengan pengaturan Microsoft Windows manual, Anda mengontrol konfigurasi komponen dan integrasi dengan infrastruktur Anda. DenganLinux, Anda dapat menggunakan Docker untuk menyebarkan komponen yang telah dikonfigurasi sebelumnya dalam wadah.
Pilih metode yang memenuhi persyaratan operasional Anda.
+ [Mengatur integrasi open source secara manual (Windows)](windows-manual-setup.md)— Untuk konfigurasi kustom atau infrastruktur yang ada
+ [Siapkan integrasi sumber terbuka dengan Docker (Linux)](linux-docker-setup.md)— Untuk penyebaran cepat dengan komponen yang telah dikonfigurasi sebelumnya
## Ikhtisar contoh peternakan angin
Panduan ini menggunakan contoh ladang angin untuk menunjukkan bagaimana Anda dapat memantau kecepatan angin untuk turbin di ladang angin. Skenario praktis ini menggambarkan kebutuhan pemantauan industri umum di mana visibilitas lokal dan berbasis cloud berharga untuk efisiensi operasional.
Dengan integrasi ini, Anda dapat:
+ Kumpulkan data dari peralatan industri menggunakan gateway AWS IoT SiteWise Edge
+ Memproses data secara lokal dengan Node-Red, InfluxDB, dan Grafana
+ Simpan data secara lokal menggunakan InfluxDB
+ Pantau data secara real time menggunakan dasbor Grafana
Sepanjang panduan ini, kami menggunakan contoh ladang angin. Kami menggunakan Node-red untuk mensimulasikan turbin yang menghasilkan data kecepatan angin. Node-red menerjemahkan payload data, menerbitkan data ke broker SiteWise Edge MQTT, berlangganan untuk menerima data dari broker, dan menyimpan data secara lokal di InfluxDB. Pendekatan ini memastikan bahwa semua data operasional tersedia baik secara lokal untuk akses langsung dan di cloud untuk analisis lebih lanjut. Dengan menerapkan pola ini, Anda mendapatkan ketahanan terhadap gangguan jaringan sambil mempertahankan kemampuan untuk melakukan analitik lanjutan di. AWS Cloud Grafana terhubung ke InfluxDB untuk pemantauan lokal, memberikan operator visibilitas real-time ke dalam metrik tanpa dependensi cloud. Gateway berkemampuan SiteWise Edge MQTT terhubung ke broker MQTT yang sama untuk mengirim data AWS IoT SiteWise, menciptakan jembatan antara operasi edge Anda dan layanan berbasis cloud.
Anda dapat menggunakan data dan konfigurasi Anda sendiri untuk membuat alur kerja serupa yang disesuaikan dengan kebutuhan industri spesifik Anda, baik Anda memantau peralatan manufaktur, infrastruktur utilitas, atau aset industri lainnya.
## Persyaratan untuk integrasi sumber terbuka
Sebelum menerapkan integrasi sumber terbuka dengan SiteWise Edge, pastikan lingkungan Anda memenuhi persyaratan yang diperlukan.
+ **Persyaratan perangkat keras** - Perangkat keras gateway Anda harus memenuhi persyaratan untuk gateway SiteWise Edge. Untuk informasi selengkapnya, lihat [AWS IoT SiteWise Persyaratan gateway yang dihosting sendiri di Edge](configure-gateway-ggv2.md) gateway V3 berkemampuan MQTT, dan. [Persyaratan untuk aplikasi AWS IoT SiteWise Edge](siemens-app-gateway-requirements.md)
**penting**
[Saat menerapkan komponen sumber terbuka tambahan, pastikan perangkat keras Anda memenuhi persyaratan untuk [InfluxDB](https://docs.influxdata.com/influxdb/v2/install/), [Node-Red](https://nodered.org/docs/getting-started/), dan Grafana.](https://grafana.com/docs/grafana/latest/setup-grafana/installation/)
+ Konfigurasi jaringan Anda harus mendukung komunikasi lokal antara komponen dan konektivitas cloud untuk SiteWise Edge.
+ Semua layanan harus berjalan pada host yang sama.
## Pertimbangan keamanan
Kami menyarankan Anda mengenkripsi semua komunikasi antar komponen, terutama saat mengakses antarmuka dari jaringan non-lokal. Terapkan kontrol akses yang tepat untuk setiap komponen dan ikuti praktik AWS terbaik untuk konfigurasi gateway AWS IoT SiteWise Edge dan keamanan AWS akun.
**Lingkungan pengembangan**
Panduan ini menunjukkan Node-Red, InfluxDB, dan Grafana berjalan dan diakses secara lokal di host gateway. Untuk penerapan produksi yang memerlukan akses eksternal, terapkan langkah-langkah keamanan termasuk enkripsi TLS, otentikasi, dan otorisasi. Ikuti praktik terbaik keamanan setiap aplikasi.
**Perangkat lunak pihak ketiga**
Solusi ini menggunakan perangkat lunak pihak ketiga yang tidak dikelola oleh AWS, termasuk InfluxDB, Node-red, Grafana, dan plugin. `node-red-contrib-influxdb` Sebelum penerapan, pastikan komponen ini mematuhi persyaratan keamanan, standar kepatuhan, dan kebijakan tata kelola organisasi Anda.
**penting**
Panduan ini merujuk dan menggunakan perangkat lunak pihak ketiga yang tidak dimiliki atau dikelola oleh AWS. Sebelum implementasi, pastikan bahwa semua komponen memenuhi persyaratan keamanan, kepatuhan, dan tata kelola Anda. Tetap perbarui semua perangkat lunak dengan tambalan keamanan terbaru dan ikuti praktik terbaik untuk mengamankan penerapan edge Anda.
InfluxDB, Node-red, Grafana bukan vendor atau pemasok untuk Edge. SiteWise
## Pertimbangan lainnya
Pertimbangkan faktor-faktor tambahan ini saat menerapkan integrasi sumber terbuka dengan SiteWise Edge.
+ Gunakan versi terbaru dari semua layanan, alat, dan komponen.
+ Filter dan agregat data secara lokal sebelum transmisi cloud untuk mengurangi biaya konsumsi AWS IoT SiteWise data. Konfigurasikan periode retensi data yang sesuai di InfluxDB dan ukur perangkat keras gateway Anda dengan benar. Untuk informasi selengkapnya, lihat [harga AWS IoT SiteWise](https://aws.amazon.com/iot-sitewise/pricing/).
+ Menerapkan prosedur pencadangan reguler untuk semua data.
+ Pantau penggunaan sumber daya di gateway Anda dan konfigurasikan batas sumber daya yang sesuai untuk setiap komponen. Menerapkan kebijakan retensi data di InfluxDB untuk mengelola penggunaan disk.
# Mengatur integrasi open source secara manual (Windows)
Gunakan panduan ini untuk membuat bucket deret waktu secara manual untuk data kecepatan angin yang terhubung dengan Grafana® dan Node-red®.
Instal dan konfigurasikan Node-Red, InfluxDB®, dan Grafana secara manual untuk mengontrol konfigurasi penerapan Anda. Microsoft Windows Anda dapat menyimpan dan mengelola data deret waktu dari perangkat Anda menggunakan InfluxDB.
## Prasyarat pengaturan manual
Sebelum Anda mulai, lengkapi persyaratan ini:
**catatan**
Jalankan semua layanan (SiteWise Edge, InfluxDB, Node-red, dan Grafana) pada host yang sama.
+ Instal gateway V3 berkemampuan MQTT. Untuk informasi selengkapnya, lihat [Gateway V3 berkemampuan MQTT untuk Edge AWS IoT SiteWise](mqtt-enabled-v3-gateway.md).
+ Instal dan jalankan layanan ini secara lokal:
+ InfluxDB OSS v2. Untuk langkah-langkah instalasi, lihat [Menginstal InfluxDB](https://docs.influxdata.com/influxdb/v2/install/).
+ Simpul-merah. Untuk langkah-langkah instalasi, lihat [Menginstal Node-merah secara lokal](https://nodered.org/docs/getting-started/local).
+ Grafana. Untuk langkah-langkah instalasi, lihat [Menginstal Grafana](https://grafana.com/docs/grafana/latest/setup-grafana/installation/).
# Siapkan penyimpanan lokal dengan InfluxDB
Dengan InfluxDB®, Anda dapat menyimpan data deret waktu dari perangkat Anda secara lokal. Tujuan dari kemampuan penyimpanan lokal adalah untuk menjaga visibilitas operasional selama gangguan jaringan dan mengurangi latensi untuk aplikasi yang kritis waktu. Anda dapat melakukan analisis dan visualisasi di tepi sambil tetap memiliki opsi untuk meneruskan data secara selektif ke cloud.
Di bagian ini, Anda membuat bucket deret waktu untuk data kecepatan angin turbin dan menghasilkan token API untuk konektivitas Grafana® dan Node-red®. Bucket InfluxDB berfungsi sebagai wadah penyimpanan khusus untuk data deret waktu Anda, mirip dengan database dalam sistem tradisional. Token API memungkinkan akses terprogram yang aman ke data Anda.
**Untuk mengatur InfluxDB**
1. [Setelah menyelesaikan langkah-langkah prasyarat dan memastikan semua alat berjalan pada host yang sama, buka browser web Anda dan buka http://127.0.0.1:8086.](http://127.0.0.1:8086)
1. (Opsional) Aktifkan enkripsi TLS untuk keamanan yang ditingkatkan. Untuk informasi selengkapnya, lihat [Mengaktifkan enkripsi TLS](https://docs.influxdata.com/influxdb/v2/admin/security/enable-tls/) di. *InfluxData Documentation*
1. Buat bucket InfluxDB time series untuk menyimpan data dari Node-Red. Bucket akan berfungsi sebagai wadah khusus untuk data ladang angin Anda, memungkinkan Anda mengatur dan mengelola kebijakan retensi khusus untuk kumpulan data ini. Untuk informasi selengkapnya, lihat [Mengelola bucket](https://docs.influxdata.com/influxdb/v2/admin/buckets/) di. *InfluxData Documentation*
1. (Opsional) Konfigurasikan periode retensi data untuk lokasi tepi Anda. Menyetel periode retensi yang sesuai membantu mengelola sumber daya penyimpanan secara efisien dengan secara otomatis menghapus data lama yang tidak lagi diperlukan untuk operasi lokal.
Untuk informasi tentang retensi data, lihat [Retensi data di InfluxDB](https://docs.influxdata.com/influxdb/v2/reference/internals/data-retention/) di. *InfluxData Documentation*
1. Hasilkan token API untuk bucket. Token ini akan memungkinkan komunikasi yang aman antara InfluxDB dan komponen lain seperti Node-Red dan Grafana. Dengan cara ini, hanya layanan resmi yang dapat membaca dari atau menulis ke penyimpanan data Anda. Untuk informasi selengkapnya, lihat [Membuat token](https://docs.influxdata.com/influxdb/cloud/admin/tokens/create-token/) di *InfluxData Documentation*.
Setelah Anda menyelesaikan langkah-langkah ini, Anda dapat menyimpan data deret waktu di instans InfluxDB Anda, memberikan dasar untuk persistensi dan analisis data lokal di lingkungan edge Anda.
# Konfigurasikan alur Node-merah untuk integrasi data AWS IoT SiteWise
Dengan Node-Red®, Anda dapat menerapkan dua aliran untuk mengelola data antara perangkat Anda dan. AWS IoT SiteWise Alur ini bekerja sama untuk menciptakan solusi manajemen data komprehensif yang membahas aliran data lokal dan cloud.
+ **Aliran publikasi data** — Menerbitkan ke cloud. Aliran publikasi data mengirimkan data ke AWS IoT SiteWise. Aliran ini mensimulasikan perangkat turbin dengan menghasilkan data sensor, menerjemahkannya ke AWS IoT SiteWise format, dan menerbitkan ke broker SiteWise Edge MQTT. Ini memungkinkan Anda memanfaatkan AWS IoT SiteWise kemampuan cloud untuk penyimpanan, analitik, dan integrasi dengan AWS layanan lain.
Untuk informasi selengkapnya, lihat [Konfigurasikan alur publikasi data](windows-nodered-data-publish-flow.md).
+ **Aliran retensi data** — Menyimpan data di tepi. Alur retensi data berlangganan broker SiteWise Edge MQTT untuk menerima data, menerjemahkannya ke dalam format InfluxDB®, dan menyimpannya secara lokal untuk pemantauan. Penyimpanan lokal ini menyediakan akses langsung ke data operasional, mengurangi latensi untuk aplikasi kritis waktu, dan memastikan kontinuitas selama gangguan jaringan.
Untuk informasi selengkapnya, lihat [Konfigurasikan aliran retensi data](windows-nodered-data-retention-flow.md).
Kedua aliran ini bekerja sama untuk memastikan data dikirim AWS IoT SiteWise dan disimpan secara lokal untuk akses langsung.
[Untuk mengakses konsol Node-red Anda, buka http://127.0.0.1:1880.](http://127.0.0.1:1880) Untuk informasi tentang mengaktifkan TLS, lihat [Mengaktifkan enkripsi TLS](https://docs.influxdata.com/influxdb/v2/admin/security/enable-tls/).
# Konfigurasikan alur publikasi data
Aliran publikasi data menggunakan tiga node untuk membuat pipeline yang mengirimkan data industri Anda ke cloud. Alur ini penting untuk memungkinkan analitik berbasis cloud, penyimpanan jangka panjang, dan integrasi dengan layanan lain. AWS Pertama, data perangkat simulasi dikirim ke broker SiteWise Edge MQTT. Gateway mengambil data dari broker yang memungkinkan transmisi ke AWS IoT SiteWise cloud, di mana Anda dapat memanfaatkan kemampuan analitik dan visualisasi yang kuat.
+ **Input data** - Menerima data perangkat dari peralatan industri atau simulator Anda
+ **Penerjemah data untuk AWS IoT SiteWise** - Menerjemahkan data ke AWS IoT SiteWise format untuk memastikan kompatibilitas dengan gateway SiteWise Edge
+ **Penerbit MQTT** - Menerbitkan data ke broker SiteWise Edge MQTT, membuatnya tersedia untuk konsumen lokal dan cloud
![\[Diagram yang menunjukkan aliran penerbitan data NODE-Red. Ini mengirimkan data perangkat simulasi ke broker SiteWise Edge MQTT untuk diambil oleh SiteWise Edge Gateway dan kemudian ke Cloud. AWS IoT SiteWise\]](http://docs.aws.amazon.com/id_id/iot-sitewise/latest/userguide/images/gateway-open-source-nodered-publish-flow.png)
## Konfigurasikan simpul input data
Dalam contoh ini, simpul input data menggunakan perangkat turbin angin simulasi yang menghasilkan data kecepatan angin. Node ini berfungsi sebagai titik masuk untuk data industri Anda, apakah itu berasal dari sumber simulasi (seperti dalam contoh kami) atau dari peralatan industri aktual di lingkungan produksi.
Kami menggunakan format JSON khusus untuk muatan data guna menyediakan struktur standar yang bekerja secara efisien dengan alat pemrosesan lokal dan layanan cloud. AWS IoT SiteWise Format ini mencakup metadata penting seperti stempel waktu dan indikator kualitas di samping nilai pengukuran aktual, memungkinkan manajemen data yang komprehensif dan pelacakan kualitas di seluruh pipeline Anda. Impor node injeksi untuk menerima data simulasi dalam format JSON standar ini dengan stempel waktu, indikator kualitas, dan nilai.
*Untuk informasi selengkapnya tentang node-Red inject node, lihat bagian [Inject di Dokumentasi](https://nodered.org/docs/user-guide/nodes#inject). Node-RED*
Simulator turbin menghasilkan data kecepatan angin setiap detik dalam format JSON standar ini:
**Example : Muatan data turbin**
```
{
name: string, // Property name/identifier
timestamp: number, // Epoch time in nanoseconds
quality: "GOOD" | "UNCERTAIN" | "BAD",
value: number | string | boolean
}
```
Format ini memberikan beberapa manfaat:
+ `name`Bidang mengidentifikasi properti atau pengukuran tertentu, memungkinkan Anda melacak beberapa titik data dari perangkat yang sama
+ `timestamp`Dalam nanodetik memastikan pelacakan waktu yang tepat untuk analisis historis yang akurat
+ `quality`Indikator membantu Anda memfilter dan mengelola data berdasarkan keandalannya
+ `value`Bidang fleksibel mendukung tipe data yang berbeda untuk mengakomodasi berbagai output sensor
**Example : Menyuntikkan simpul simulator turbin**
```
[
{
"id": "string",
"type": "inject",
"z": "string",
"name": "Turbine Simulator",
"props": [
{
"p": "payload.timestamp",
"v": "",
"vt": "date"
},
{
"p": "payload.quality",
"v": "GOOD",
"vt": "str"
},
{
"p": "payload.value",
"v": "$random()",
"vt": "jsonata"
},
{
"p": "payload.name",
"v": "/Renton/WindFarm/Turbine/WindSpeed",
"vt": "str"
}
],
"repeat": "1",
"crontab": "",
"once": false,
"onceDelay": "",
"topic": "",
"x": 270,
"y": 200,
"wires": [
[
"string"
]
]
}
]
```
## Konfigurasikan node untuk terjemahan data
Gateway SiteWise Edge membutuhkan data dalam format tertentu untuk memastikan kompatibilitas dengan AWS IoT SiteWise cloud. Node penerjemah adalah komponen penting yang mengubah data input Anda ke format AWS IoT SiteWise payload yang diperlukan. Langkah penerjemahan ini memastikan bahwa data industri Anda dapat diproses, disimpan, dan kemudian dianalisis dengan benar di lingkungan AWS IoT SiteWise cloud.
Dengan menstandarisasi format data pada tahap ini, Anda mengaktifkan integrasi antara perangkat edge dan layanan cloud tempat Anda dapat menggunakan pemodelan aset, analitik, dan kemampuan visualisasi. Gunakan struktur ini:
**Example : Struktur muatan untuk penguraian data SiteWise Edge**
```
{
"propertyAlias": "string",
"propertyValues": [
{
"value": {
"booleanValue": boolean,
"doubleValue": number,
"integerValue": number,
"stringValue": "string"
},
"timestamp": {
"timeInSeconds": number,
"offsetInNanos": number
},
"quality": "GOOD" | "UNCERTAIN" | "BAD",
}]
}
```
**catatan**
`propertyAlias`Cocokkan dengan hierarki topik MQTT Anda (misalnya,). `/Renton/WindFarm/Turbine/WindSpeed` Ini memastikan bahwa data Anda terkait dengan benar dengan properti aset yang benar di AWS IoT SiteWise. Untuk informasi selengkapnya, lihat konsep “Alias aliran data” di[AWS IoT SiteWise konsep](concept-overview.md).
1. Impor node fungsi contoh untuk terjemahan AWS IoT SiteWise payload. Fungsi ini menangani konversi dari format input standar Anda ke format AWS IoT SiteWise-kompatibel, memastikan pemformatan stempel waktu yang tepat, indikator kualitas, dan pengetikan nilai.
```
[
{
"id": "string",
"type": "function",
"z": "string",
"name": "Translate to SiteWise payload",
"func": "let input = msg.payload;\nlet output = {};\n\noutput[\"propertyAlias\"] = input.name;\n\nlet propertyVal = {}\n\nlet timeInSeconds = Math.floor(input.timestamp / 1000);\nlet offsetInNanos = (input.timestamp % 1000) * 1000000;\n\npropertyVal[\"timestamp\"] = {\n \"timeInSeconds\": timeInSeconds,\n \"offsetInNanos\": offsetInNanos,\n};\n\npropertyVal[\"quality\"] = input.quality\n\nlet typeNameConverter = {\n \"number\": (x) => Number.isInteger(x) ? \"integerValue\" : \"doubleValue\",\n \"boolean\": (x) => \"booleanValue\",\n \"string\": (x) => \"stringValue\", \n}\nlet typeName = typeNameConverter[typeof input.value](input.value)\npropertyVal[\"value\"] = {}\npropertyVal[\"value\"][typeName] = input.value;\n\noutput[\"propertyValues\"] = [propertyVal]\n\nreturn {\n payload: JSON.stringify(output)\n};",
"outputs": 1,
"timeout": "",
"noerr": 0,
"initialize": "",
"finalize": "",
"libs": [],
"x": 530,
"y": 200,
"wires": [
[
"string"
]
]
}
]
```
1. Verifikasi bahwa JavaScript kode menerjemahkan data kecepatan angin dengan benar. Fungsi ini melakukan beberapa tugas penting:
+ Mengekstrak nama properti dari input dan menetapkannya sebagai PropertyAlias
+ Mengonversi stempel waktu dari milidetik ke format detik dan nanodetik yang diperlukan
+ Mempertahankan indikator kualitas untuk pelacakan keandalan data
+ Secara otomatis mendeteksi jenis nilai dan memformatnya sesuai dengan persyaratan AWS IoT SiteWise
1. Hubungkan node ke alur Anda, hubungkan antara node input data dan penerbit MQTT.
Untuk panduan tentang menulis fungsi khusus untuk kebutuhan bisnis Anda, lihat [Fungsi Menulis](https://nodered.org/docs/user-guide/writing-functions) dalam *Node-REDDokumentasi*
## Konfigurasikan penerbit MQTT
Setelah terjemahan, data siap untuk dipublikasikan ke broker SiteWise Edge MQTT.
Konfigurasikan penerbit MQTT dengan pengaturan ini untuk mengirim data ke broker Edge MQTT: SiteWise
**Untuk mengimpor node keluar MQTT**
1. Impor node konfigurasi MQTT keluar menggunakan. `"type": "mqtt out"` Node keluar MQTT memungkinkan Anda berbagi konfigurasi broker.
1. Masukkan pasangan nilai kunci untuk informasi yang relevan dengan koneksi broker MQTT dan perutean pesan.
Impor `mqtt out` simpul contoh.
**Example**
```
[
{
"id": "string",
"type": "mqtt out",
"z": "string",
"name": "Publish to MQTT broker",
"topic": "/Renton/WindFarm/Turbine/WindSpeed",
"qos": "1",
"retain": "",
"respTopic": "",
"contentType": "",
"userProps": "",
"correl": "",
"expiry": "",
"broker": "string",
"x": 830,
"y": 200,
"wires": []
},
{
"id": "string",
"type": "mqtt-broker",
"name": "emqx",
"broker": "127.0.0.1",
"port": "1883",
"clientid": "",
"autoConnect": true,
"usetls": false,
"protocolVersion": "5",
"keepalive": 15,
"cleansession": true,
"autoUnsubscribe": true,
"birthTopic": "",
"birthQos": "0",
"birthPayload": "",
"birthMsg": {},
"closeTopic": "",
"closePayload": "",
"closeMsg": {},
"willTopic": "",
"willQos": "0",
"willPayload": "",
"willMsg": {},
"userProps": "",
"sessionExpiry": ""
}
]
```
Contoh MQTT out node menciptakan koneksi MQTT dengan informasi berikut:
+ Server: `127.0.0.1`
+ Pelabuhan: `1883`
+ Protokol: `MQTT V5`
Kemudian, node keluar MQTT mengonfigurasi perutean pesan dengan informasi berikut:
+ Topik: `/Renton/WindFarm/Turbine/WindSpeed`
+ QoS: `1`
## Menyebarkan dan memverifikasi node
Setelah mengonfigurasi tiga node aliran publikasi data, ikuti langkah-langkah ini untuk menyebarkan aliran dan memverifikasi bahwa data sedang dikirim dengan benar AWS IoT SiteWise
**Untuk menyebarkan dan memverifikasi koneksi**
1. Connect ketiga node seperti yang ditunjukkan dalam aliran data publish.
![\[Data publish flow diagram showing input from turbine simulator to AWS IoT SiteWise to MQTT broker.\]](http://docs.aws.amazon.com/id_id/iot-sitewise/latest/userguide/images/gateway-open-source-nodered-publish-flow.png)
1. Pilih **Deploy** untuk menerapkan semua perubahan koneksi node.
1. Arahkan ke [AWS IoT SiteWise konsol](https://console.aws.amazon.com/iotsitewise/) dan pilih **Aliran data**.
1. Pastikan **awalan Alias** dipilih di menu dropdown. Kemudian, cari `/Renton/WindFarm/Turbine/WindSpeed` alias.
Jika Anda melihat alias yang benar dalam pencarian Anda, Anda telah menerapkan aliran dan transmisi data yang diverifikasi.
# Konfigurasikan aliran retensi data
Aliran retensi data dapat digunakan untuk menjaga visibilitas operasional di tepi. Ini berguna selama gangguan jaringan atau ketika Anda membutuhkan akses langsung ke data Anda. Alur ini berlangganan broker MQTT untuk menerima data perangkat, mengubahnya menjadi format InfluxDB®, dan menyimpannya secara lokal. Dengan menerapkan alur ini, Anda membuat penyimpanan data lokal yang tangguh yang dapat diakses operator tanpa dependensi cloud, memungkinkan pemantauan waktu nyata dan pengambilan keputusan di tepi.
Alur terdiri dari tiga komponen utama yang bekerja sama untuk memastikan data Anda ditangkap dan disimpan dengan benar:
+ **Klien berlangganan MQTT** - Menerima data dari broker, memastikan Anda menangkap semua data industri yang relevan
+ **Penerjemah InfluxDB** - Mengonversi AWS IoT SiteWise payload ke format InfluxDB, menyiapkan data untuk penyimpanan deret waktu yang efisien
+ **Penulis InfluxDB** - Menangani penyimpanan lokal, memastikan persistensi data dan ketersediaan untuk aplikasi lokal
![\[Aliran retensi data node-merah\]](http://docs.aws.amazon.com/id_id/iot-sitewise/latest/userguide/images/gateway-open-source-nodered-data-retention.png)
## Siapkan klien berlangganan MQTT
+ Konfigurasikan klien berlangganan MQTT di Node-Red untuk menerima data dari broker MQTT EMQX dengan mengimpor contoh di bawah ini. AWS IoT SiteWise
**Example : MQTT di simpul**
```
[
{
"id": "string",
"type": "mqtt in",
"z": "string",
"name": "Subscribe to MQTT broker",
"topic": "/Renton/WindFarm/Turbine/WindSpeed",
"qos": "1",
"datatype": "auto-detect",
"broker": "string",
"nl": false,
"rap": true,
"rh": 0,
"inputs": 0,
"x": 290,
"y": 340,
"wires": [
[
"string"
]
]
},
{
"id": "string",
"type": "mqtt-broker",
"name": "emqx",
"broker": "127.0.0.1",
"port": "1883",
"clientid": "",
"autoConnect": true,
"usetls": false,
"protocolVersion": "5",
"keepalive": 15,
"cleansession": true,
"autoUnsubscribe": true,
"birthTopic": "",
"birthQos": "0",
"birthPayload": "",
"birthMsg": {},
"closeTopic": "",
"closePayload": "",
"closeMsg": {},
"willTopic": "",
"willQos": "0",
"willPayload": "",
"willMsg": {},
"userProps": "",
"sessionExpiry": ""
}
]
```
Langganan ini memastikan bahwa semua data relevan yang dipublikasikan ke broker ditangkap untuk penyimpanan lokal, memberikan catatan lengkap operasi industri Anda. Node menggunakan parameter koneksi MQTT yang sama dengan [Konfigurasikan penerbit MQTT](windows-nodered-data-publish-flow.md#windows-nodered-mqtt-publisher-config) bagian, dengan pengaturan langganan berikut:
+ Topik — `/Renton/WindFarm/Turbine/WindSpeed`
+ QoS — `1`
*Untuk informasi selengkapnya, lihat [Connect to an MQTT Broker](https://cookbook.nodered.org/mqtt/connect-to-broker) di Dokumentasi. Node-RED*
## Konfigurasikan penerjemah InfluxDB
[InfluxDB mengatur data menggunakan [tag](https://docs.influxdata.com/influxdb/v1/concepts/glossary/#tag) untuk pengindeksan dan bidang untuk nilai.](https://docs.influxdata.com/influxdb/v1/concepts/glossary/#field) Organisasi ini mengoptimalkan kinerja kueri dan efisiensi penyimpanan untuk data deret waktu. Impor node fungsi contoh yang berisi JavaScript kode untuk mengonversi AWS IoT SiteWise payload ke format InfluxDB. Penerjemah membagi properti menjadi dua kelompok:
+ Tag - Kualitas dan properti nama untuk pengindeksan yang efisien
+ Bidang - Timestamp (dalam milidetik sejak zaman) dan nilai
**Example : Fungsi simpul menerjemahkan ke muatan InfluxDB**
```
[
{
"id": "string",
"type": "function",
"z": "string",
"name": "Translate to InfluxDB payload",
"func": "let data = msg.payload;\n\nlet timeInSeconds = data.propertyValues[0].timestamp.timeInSeconds;\nlet offsetInNanos = data.propertyValues[0].timestamp.offsetInNanos;\nlet timestampInMilliseconds = (timeInSeconds * 1000) + (offsetInNanos / 1000000);\n\nmsg.payload = [\n {\n \"timestamp(milliseconds_since_epoch)\": timestampInMilliseconds,\n \"value\": data.propertyValues[0].value.doubleValue\n },\n {\n \"name\": data.propertyAlias,\n \"quality\": data.propertyValues[0].quality\n }\n]\n\nreturn msg",
"outputs": 1,
"timeout": "",
"noerr": 0,
"initialize": "",
"finalize": "",
"libs": [],
"x": 560,
"y": 340,
"wires": [
[
"string"
]
]
}
]
```
Untuk opsi konfigurasi tambahan, lihat [node-red-contrib-influxdb](https://github.com/mblackstock/node-red-contrib-influxdb)di repositori Node-Red GitHub .
## Siapkan penulis InfluxDB
Node penulis InfluxDB adalah komponen terakhir dalam aliran retensi data Anda, yang bertanggung jawab untuk menyimpan data industri Anda di database InfluxDB lokal. Penyimpanan lokal ini penting untuk menjaga visibilitas operasional selama gangguan jaringan dan menyediakan akses langsung ke data untuk aplikasi kritis waktu.
1. Instal node-red-contrib-influxdb paket melalui opsi Kelola palet. Paket ini menyediakan node yang diperlukan untuk menghubungkan Node-Red dengan InfluxDB.
1. Tambahkan node keluar InfluxDB ke alur Anda. Node ini akan menangani penulisan data aktual ke database InfluxDB Anda.
1. Konfigurasikan properti server untuk membuat koneksi aman ke instans InfluxDB Anda:
1. Set Version to 2.0 - Ini menentukan bahwa Anda terhubung ke InfluxDB v2.x, yang menggunakan API yang berbeda dari versi sebelumnya
1. Setel URL ke `http://127.0.0.1:8086` - Ini menunjuk ke instans InfluxDB lokal Anda
1. Masukkan token otentikasi InfluxDB Anda. Token aman ini mengotorisasi koneksi ke database Anda. Anda membuat token selama [Siapkan penyimpanan lokal dengan InfluxDB](windows-influxdb-setup.md) prosedur.
1. Tentukan parameter lokasi penyimpanan untuk menentukan di mana dan bagaimana data Anda akan disimpan:
1. Masukkan nama Organisasi InfluxDB Anda — Organisasi adalah ruang kerja untuk sekelompok pengguna, tempat bucket dan dasbor Anda berada. Untuk informasi selengkapnya, lihat [Mengelola organisasi](https://docs.influxdata.com/influxdb/v2/admin/organizations/) di *InfluxData Documentation*.
1. Tentukan Bucket InfluxDB (misalnya,`WindFarmData`) - Bucket setara dengan database dalam sistem tradisional, berfungsi sebagai wadah untuk data deret waktu Anda
1. Mengatur Pengukuran InfluxDB (misalnya,`TurbineData`) - Pengukurannya mirip dengan tabel dalam database relasional, mengatur titik data terkait
**catatan**
Temukan nama organisasi Anda di sidebar kiri instans InfluxDB. Konsep organisasi, bucket, dan pengukuran sangat penting untuk model organisasi data InfluxDB. Untuk informasi selengkapnya, lihat dokumentasi [InfluxDB](https://docs.influxdata.com/influxdb/v2/admin/organizations/).
## Menyebarkan dan memverifikasi aliran retensi
Setelah mengonfigurasi semua komponen aliran retensi data, Anda perlu menerapkan dan memverifikasi bahwa sistem berfungsi dengan benar. Verifikasi ini memastikan bahwa data industri Anda disimpan dengan benar secara lokal untuk akses dan analisis segera.
1. Hubungkan ketiga node seperti yang ditunjukkan pada diagram alir retensi data. Ini menciptakan pipeline lengkap dari langganan data ke penyimpanan lokal.
![\[Aliran retensi data node-merah\]](http://docs.aws.amazon.com/id_id/iot-sitewise/latest/userguide/images/gateway-open-source-nodered-data-retention.png)
1. Pilih **Deploy** untuk menerapkan perubahan Anda dan mengaktifkan alur. Ini memulai proses pengumpulan dan penyimpanan data.
1. Gunakan InfluxDB Data Explorer untuk menanyakan dan memvisualisasikan data Anda. Alat ini memungkinkan Anda untuk memverifikasi bahwa data disimpan dengan benar dan untuk membuat visualisasi awal data deret waktu Anda.
Di Data Explorer, Anda harus dapat melihat pengukuran kecepatan angin Anda direkam dari waktu ke waktu, mengonfirmasi bahwa seluruh pipa dari pembuatan data ke penyimpanan lokal berfungsi dengan benar.
Untuk informasi selengkapnya, lihat [Kueri di Penjelajah Data](https://docs.influxdata.com/influxdb/v2/query-data/execute-queries/data-explorer/) di *InfluxData Documentation*.
Dengan aliran publikasi data dan aliran retensi data yang diterapkan, Anda sekarang memiliki sistem lengkap yang mengirimkan data ke AWS IoT SiteWise cloud sambil mempertahankan salinan lokal untuk akses dan ketahanan langsung. Pendekatan jalur ganda ini memastikan bahwa Anda mendapatkan manfaat dari analitik dan penyimpanan berbasis cloud sambil mempertahankan visibilitas operasional di edge.
# Siapkan Grafana untuk Edge SiteWise
Grafana® memungkinkan Anda membuat dasbor pemantauan real-time lokal untuk data industri Anda. Dengan memvisualisasikan data yang disimpan di InfluxDB®, Anda dapat memberikan wawasan langsung kepada operator tentang kinerja peralatan, efisiensi proses, dan potensi masalah. Visibilitas di tepi ini penting untuk operasi yang sensitif terhadap waktu dan menjaga kontinuitas selama gangguan jaringan.
## Konfigurasikan sumber data
Menghubungkan Grafana ke database InfluxDB Anda menciptakan lapisan visualisasi yang kuat untuk data industri Anda. Koneksi ini memungkinkan dasbor pemantauan waktu nyata yang dapat digunakan operator untuk membuat keputusan berdasarkan informasi tanpa dependensi cloud.
1. [Akses instans Grafana Anda secara lokal dengan menavigasi ke http://127.0.0.1:3000 di browser Anda.](http://127.0.0.1:3000) *Jika mengaktifkan TLS diperlukan, Anda dapat merujuk ke [Mengatur Grafana HTTPS untuk lalu lintas web yang aman](https://grafana.com/docs/grafana/latest/setup-grafana/set-up-https/) di Dokumentasi. Grafana Labs*
1. Tambahkan sumber data InfluxDB yang menunjuk ke bucket seri waktu InfluxDB tempat Node-red menulis data. Misalnya, `WindFarmData`. Koneksi ini menetapkan tautan antara data yang Anda simpan dan platform visualisasi.
1. *Untuk petunjuk terperinci, lihat [Mengkonfigurasi sumber data InfluxDB di Dokumentasi](https://grafana.com/docs/grafana/latest/datasources/influxdb/configure-influxdb-data-source/). Grafana Labs*
### Buat dasbor Grafana untuk SiteWise data Edge
Membuat dasbor adalah langkah terakhir dalam membangun solusi pemantauan lokal Anda. Dasbor memberikan representasi visual dari data industri Anda, sehingga lebih mudah untuk mengidentifikasi tren, anomali, dan potensi masalah secara sekilas.
+ Ikuti panduan untuk membuat dasbor. Untuk informasi selengkapnya, lihat [Membangun dasbor pertama Anda](https://grafana.com/docs/grafana/latest/getting-started/build-first-dashboard/) di *Grafana LabsDokumentasi*. Template ini mengasumsikan bucket Anda diberi nama `WindFarmData` dan pengukurannya`TurbineData`.
Anda juga dapat menggunakan panduan mulai cepat dengan mengimpor contoh templat dasbor yang disediakan untuk membuat dasbor dengan cepat dengan plot deret waktu untuk data yang dihasilkan Node-red di bagian sebelumnya. Template ini menyediakan titik awal yang dapat Anda sesuaikan untuk memenuhi kebutuhan pemantauan spesifik Anda.
```
{
"__inputs": [
{
"name": "DS_WINDFARM-DEMO",
"label": "windfarm-demo",
"description": "",
"type": "datasource",
"pluginId": "influxdb",
"pluginName": "InfluxDB"
}
],
"__elements": {},
"__requires": [
{
"type": "grafana",
"id": "grafana",
"name": "Grafana",
"version": "11.6.0-pre"
},
{
"type": "datasource",
"id": "influxdb",
"name": "InfluxDB",
"version": "1.0.0"
},
{
"type": "panel",
"id": "timeseries",
"name": "Time series",
"version": ""
}
],
"annotations": {
"list": [
{
"builtIn": 1,
"datasource": {
"type": "grafana",
"uid": "-- Grafana --"
},
"enable": true,
"hide": true,
"iconColor": "rgba(0, 211, 255, 1)",
"name": "Annotations & Alerts",
"type": "dashboard"
}
]
},
"editable": true,
"fiscalYearStartMonth": 0,
"graphTooltip": 0,
"id": null,
"links": [],
"panels": [
{
"datasource": {
"type": "influxdb",
"uid": "${DS_WINDFARM-DEMO}"
},
"fieldConfig": {
"defaults": {
"color": {
"mode": "palette-classic"
},
"custom": {
"axisBorderShow": false,
"axisCenteredZero": false,
"axisColorMode": "text",
"axisLabel": "",
"axisPlacement": "auto",
"barAlignment": 0,
"barWidthFactor": 0.6,
"drawStyle": "line",
"fillOpacity": 0,
"gradientMode": "none",
"hideFrom": {
"legend": false,
"tooltip": false,
"viz": false
},
"insertNulls": false,
"lineInterpolation": "linear",
"lineWidth": 1,
"pointSize": 5,
"scaleDistribution": {
"type": "linear"
},
"showPoints": "auto",
"spanNulls": false,
"stacking": {
"group": "A",
"mode": "none"
},
"thresholdsStyle": {
"mode": "off"
}
},
"mappings": [],
"thresholds": {
"mode": "absolute",
"steps": [
{
"color": "green"
},
{
"color": "red",
"value": 80
}
]
}
},
"overrides": []
},
"gridPos": {
"h": 8,
"w": 12,
"x": 0,
"y": 0
},
"id": 1,
"options": {
"legend": {
"calcs": [],
"displayMode": "list",
"placement": "bottom",
"showLegend": true
},
"tooltip": {
"hideZeros": false,
"mode": "single",
"sort": "none"
}
},
"pluginVersion": "11.6.0-pre",
"targets": [
{
"datasource": {
"type": "influxdb",
"uid": "${DS_WINDFARM-DEMO}"
},
"query": "from(bucket: \"WindFarmData\")\n |> range(start: v.timeRangeStart, stop: v.timeRangeStop)\n |> filter(fn: (r) => r[\"_measurement\"] == \"TurbineData\")\n |> filter(fn: (r) => r[\"_field\"] == \"value\")\n |> filter(fn: (r) => r[\"name\"] == \"/Renton/WindFarm/Turbine/WindSpeed\")\n |> filter(fn: (r) => r[\"quality\"] == \"GOOD\")\n |> aggregateWindow(every: v.windowPeriod, fn: mean, createEmpty: false)\n |> yield(name: \"mean\")",
"refId": "A"
}
],
"title": "Panel Title",
"type": "timeseries"
}
],
"schemaVersion": 41,
"tags": [],
"templating": {
"list": []
},
"time": {
"from": "now-6h",
"to": "now"
},
"timepicker": {},
"timezone": "browser",
"title": "demo dashboard",
"uid": "fejc0t08o6d4wb",
"version": 1,
"weekStart": ""
}
```
# Siapkan integrasi sumber terbuka dengan Docker (Linux)
Untuk proses penyebaran yang efisien, Anda dapat menggunakan Docker untuk menyiapkan Node-Red®, InfluxDB®, dan Grafana® di lingkungan Linux. Metode ini menggunakan kontainer yang telah dikonfigurasi sebelumnya, memungkinkan penyebaran cepat dan pengelolaan komponen yang lebih mudah.
## Prasyarat pengaturan Docker
Sebelum Anda mulai, verifikasi yang memiliki yang berikut:
+ Gateway V3 berkemampuan MQTT. Untuk informasi selengkapnya, lihat [Gateway V3 berkemampuan MQTT untuk Edge AWS IoT SiteWise](mqtt-enabled-v3-gateway.md).
+ Plugin Docker Compose. Untuk langkah-langkah instalasi, lihat [Menginstal Docker Compose plugin di](https://docs.docker.com/compose/install/linux/) dokumentasi Manual *Docker*.
## Menyebarkan layanan
Penerapan ini menjalankan SiteWise Edge, InfluxDB, Node-red, dan Grafana pada host yang sama.
### Mengatur lingkungan
1. Dapatkan akses root:
```
sudo -i
```
1. Buat file.env atau ekspor variabel lingkungan ini:
```
export INFLUXDB_PASSWORD=your-secure-influxdb-password
export INFLUXDB_TOKEN=your-secure-influxdb-token
export GRAFANA_PASSWORD=your-secure-grafana-password
```
### Konfigurasikan jaringan Docker
+ Buat jaringan jembatan menggunakan nama`SiteWiseEdgeNodeRedDemoNetwork`.
```
docker network create --driver=bridge SiteWiseEdgeNodeRedDemoNetwork
```
### Siapkan Docker Compose file
Salin konten file YAMM berikut ke perangkat gateway SiteWise Edge Anda.
#### Perluas untuk melihat contoh file Docker Compose YAMM
```
services:
influxdb:
image: influxdb:latest
container_name: influxdb
ports:
- "127.0.0.1:8086:8086"
volumes:
- influxdb-storage:/.influxdbv2
environment:
- DOCKER_INFLUXDB_INIT_MODE=setup
- DOCKER_INFLUXDB_INIT_USERNAME=admin
- DOCKER_INFLUXDB_INIT_PASSWORD=${INFLUXDB_PASSWORD}
- DOCKER_INFLUXDB_INIT_ORG=iot-sitewise-edge
- DOCKER_INFLUXDB_INIT_BUCKET=WindFarmData
- DOCKER_INFLUXDB_INIT_RETENTION=0
- DOCKER_INFLUXDB_INIT_ADMIN_TOKEN=${INFLUXDB_TOKEN}
networks:
- SiteWiseEdgeNodeRedDemoNetwork
restart: unless-stopped
grafana:
image: grafana/grafana:latest
container_name: grafana
ports:
- "127.0.0.1:3000:3000"
volumes:
- grafana-storage:/var/lib/grafana
- ./grafana/provisioning:/etc/grafana/provisioning
environment:
- GF_SECURITY_ADMIN_USER=admin
- GF_SECURITY_ADMIN_PASSWORD=${GRAFANA_PASSWORD}
- GF_INSTALL_PLUGINS=grafana-clock-panel,grafana-simple-json-datasource
- GF_PATHS_PROVISIONING=/etc/grafana/provisioning
- GF_PATHS_CONFIG=/etc/grafana/grafana.ini
- GF_LOG_LEVEL=info
configs:
- source: grafana_datasource
target: /etc/grafana/provisioning/datasources/influxdb.yaml
- source: grafana_preload_dashboard_config
target: /etc/grafana/provisioning/dashboards/dashboard.yml
- source: grafana_preload_dashboard
target: /etc/grafana/provisioning/dashboards/demo_dashboard.json
depends_on:
- influxdb
networks:
- SiteWiseEdgeNodeRedDemoNetwork
restart: unless-stopped
nodered:
build:
context: .
dockerfile_inline: |
FROM nodered/node-red:latest
RUN npm install node-red-contrib-influxdb
container_name: nodered
ports:
- "127.0.0.1:1880:1880"
volumes:
- node_red_data:/data
environment:
- NODE_RED_ENABLE_SAFE_MODE=false
- NODE_RED_ENABLE_PALETTE_EDIT=true
- NODE_RED_AUTO_INSTALL_MODULES=true
configs:
- source: nodered_flows
target: /data/flows.json
- source: nodered_settings
target: /data/settings.js
- source: nodered_flows_cred
target: /data/flows_cred.json
depends_on:
- influxdb
networks:
- SiteWiseEdgeNodeRedDemoNetwork
restart: unless-stopped
volumes:
influxdb-storage:
grafana-storage:
node_red_data:
networks:
SiteWiseEdgeNodeRedDemoNetwork:
external: true
configs:
grafana_datasource:
content: |
apiVersion: 1
datasources:
- name: windfarm-demo
type: influxdb
access: proxy
url: http://influxdb:8086
jsonData:
version: Flux
organization: iot-sitewise-edge
defaultBucket: WindFarmData
tlsSkipVerify: true
secureJsonData:
token: ${INFLUXDB_TOKEN}
editable: false
grafana_preload_dashboard_config:
content: |
apiVersion: 1
providers:
- name: "Dashboard provider"
orgId: 1
type: file
options:
path: /etc/grafana/provisioning/dashboards
grafana_preload_dashboard:
content: |
{
"annotations": {
"list": [
{
"builtIn": 1,
"datasource": {
"type": "grafana",
"uid": "-- Grafana --"
},
"enable": true,
"hide": true,
"iconColor": "rgba(0, 211, 255, 1)",
"name": "Annotations & Alerts",
"type": "dashboard"
}
]
},
"editable": true,
"fiscalYearStartMonth": 0,
"graphTooltip": 0,
"id": 1,
"links": [],
"panels": [
{
"datasource": {
"type": "influxdb",
"uid": "PEB0DCBF338B3CEB2"
},
"fieldConfig": {
"defaults": {
"color": {
"mode": "palette-classic"
},
"custom": {
"axisBorderShow": false,
"axisCenteredZero": false,
"axisColorMode": "text",
"axisLabel": "",
"axisPlacement": "auto",
"barAlignment": 0,
"barWidthFactor": 0.6,
"drawStyle": "line",
"fillOpacity": 0,
"gradientMode": "none",
"hideFrom": {
"legend": false,
"tooltip": false,
"viz": false
},
"insertNulls": false,
"lineInterpolation": "linear",
"lineWidth": 1,
"pointSize": 5,
"scaleDistribution": {
"type": "linear"
},
"showPoints": "auto",
"spanNulls": false,
"stacking": {
"group": "A",
"mode": "none"
},
"thresholdsStyle": {
"mode": "off"
}
},
"mappings": [],
"thresholds": {
"mode": "absolute",
"steps": [
{
"color": "green"
},
{
"color": "red",
"value": 80
}
]
}
},
"overrides": []
},
"gridPos": {
"h": 8,
"w": 12,
"x": 0,
"y": 0
},
"id": 1,
"options": {
"legend": {
"calcs": [],
"displayMode": "list",
"placement": "bottom",
"showLegend": true
},
"tooltip": {
"hideZeros": false,
"mode": "single",
"sort": "none"
}
},
"pluginVersion": "11.6.0",
"targets": [
{
"datasource": {
"type": "influxdb",
"uid": "PEB0DCBF338B3CEB2"
},
"query": "from(bucket: \"WindFarmData\")\n |> range(start: v.timeRangeStart, stop: v.timeRangeStop)\n |> filter(fn: (r) => r[\"_measurement\"] == \"TurbineData\")\n |> filter(fn: (r) => r[\"_field\"] == \"value\")\n |> filter(fn: (r) => r[\"name\"] == \"/Renton/WindFarm/Turbine/WindSpeed\")\n |> filter(fn: (r) => r[\"quality\"] == \"GOOD\")\n |> aggregateWindow(every: v.windowPeriod, fn: mean, createEmpty: false)\n |> yield(name: \"mean\")",
"refId": "A"
}
],
"title": "Wind Speed",
"type": "timeseries"
}
],
"preload": false,
"schemaVersion": 41,
"tags": [],
"templating": {
"list": []
},
"time": {
"from": "now-6h",
"to": "now"
},
"timepicker": {},
"timezone": "browser",
"title": "Demo Dashboard",
"uid": "eejtureqjo9a8c",
"version": 2
}
nodered_flows:
content: |
[
{
"id": "95fce448fdd43b47",
"type": "tab",
"label": "Demo Flow",
"disabled": false,
"info": ""
},
{
"id": "5f63740b66af3386",
"type": "mqtt out",
"z": "95fce448fdd43b47",
"name": "Publish to MQTT broker",
"topic": "/Renton/WindFarm/Turbine/WindSpeed",
"qos": "1",
"retain": "",
"respTopic": "",
"contentType": "",
"userProps": "",
"correl": "",
"expiry": "",
"broker": "5744207557fa19be",
"x": 830,
"y": 200,
"wires": []
},
{
"id": "8f2eb590d596679b",
"type": "function",
"z": "95fce448fdd43b47",
"name": "Translate to SiteWise payload",
"func": "let input = msg.payload;\nlet output = {};\n\noutput[\"propertyAlias\"] = input.name;\n\nlet propertyVal = {}\n\nlet timeInSeconds = Math.floor(input.timestamp / 1000);\nlet offsetInNanos = (input.timestamp % 1000) * 1000000;\n\npropertyVal[\"timestamp\"] = {\n \"timeInSeconds\": timeInSeconds,\n \"offsetInNanos\": offsetInNanos,\n};\n\npropertyVal[\"quality\"] = input.quality\n\nlet typeNameConverter = {\n \"number\": (x) => Number.isInteger(x) ? \"integerValue\" : \"doubleValue\",\n \"boolean\": (x) => \"booleanValue\",\n \"string\": (x) => \"stringValue\", \n}\nlet typeName = typeNameConverter[typeof input.value](input.value)\npropertyVal[\"value\"] = {}\npropertyVal[\"value\"][typeName] = input.value;\n\noutput[\"propertyValues\"] = [propertyVal]\n\nreturn {\n payload: JSON.stringify(output)\n};",
"outputs": 1,
"timeout": "",
"noerr": 0,
"initialize": "",
"finalize": "",
"libs": [],
"x": 530,
"y": 200,
"wires": [
[
"5f63740b66af3386"
]
]
},
{
"id": "4b78cbdea5e3258c",
"type": "inject",
"z": "95fce448fdd43b47",
"name": "Turbine Simulator",
"props": [
{
"p": "payload.timestamp",
"v": "",
"vt": "date"
},
{
"p": "payload.quality",
"v": "GOOD",
"vt": "str"
},
{
"p": "payload.value",
"v": "$$random()",
"vt": "jsonata"
},
{
"p": "payload.name",
"v": "/Renton/WindFarm/Turbine/WindSpeed",
"vt": "str"
}
],
"repeat": "1",
"crontab": "",
"once": false,
"onceDelay": "",
"topic": "",
"x": 270,
"y": 200,
"wires": [
[
"8f2eb590d596679b"
]
]
},
{
"id": "b658bf337ea2e316",
"type": "influxdb out",
"z": "95fce448fdd43b47",
"influxdb": "2f1c38495035d2e4",
"name": "Store data in InfluxDB",
"measurement": "TurbineData",
"precision": "",
"retentionPolicy": "",
"database": "",
"retentionPolicyV18Flux": "",
"org": "iot-sitewise-edge",
"bucket": "WindFarmData",
"x": 840,
"y": 340,
"wires": []
},
{
"id": "9432d39af35b202f",
"type": "function",
"z": "95fce448fdd43b47",
"name": "Translate to InfluxDB payload",
"func": "let data = msg.payload;\n\nlet timeInSeconds = data.propertyValues[0].timestamp.timeInSeconds;\nlet offsetInNanos = data.propertyValues[0].timestamp.offsetInNanos;\nlet timestampInMilliseconds = (timeInSeconds * 1000) + (offsetInNanos / 1000000);\n\nmsg.payload = [\n {\n \"timestamp(milliseconds_since_epoch)\": timestampInMilliseconds,\n \"value\": data.propertyValues[0].value.doubleValue\n },\n {\n \"name\": data.propertyAlias,\n \"quality\": data.propertyValues[0].quality\n }\n]\n\nreturn msg",
"outputs": 1,
"timeout": "",
"noerr": 0,
"initialize": "",
"finalize": "",
"libs": [],
"x": 560,
"y": 340,
"wires": [
[
"b658bf337ea2e316"
]
]
},
{
"id": "b689403d2c80816b",
"type": "mqtt in",
"z": "95fce448fdd43b47",
"name": "Subscribe to MQTT broker",
"topic": "/Renton/WindFarm/Turbine/WindSpeed",
"qos": "1",
"datatype": "auto-detect",
"broker": "5744207557fa19be",
"nl": false,
"rap": true,
"rh": 0,
"inputs": 0,
"x": 290,
"y": 340,
"wires": [
[
"9432d39af35b202f"
]
]
},
{
"id": "4f59bed8e829fc35",
"type": "comment",
"z": "95fce448fdd43b47",
"name": "Data Publish Flow",
"info": "dfgh",
"x": 270,
"y": 160,
"wires": []
},
{
"id": "b218c7fc58c8b6e7",
"type": "comment",
"z": "95fce448fdd43b47",
"name": "Data Retention flow",
"info": "",
"x": 270,
"y": 300,
"wires": []
},
{
"id": "5744207557fa19be",
"type": "mqtt-broker",
"name": "emqx",
"broker": "emqx",
"port": "1883",
"clientid": "",
"autoConnect": true,
"usetls": false,
"protocolVersion": "5",
"keepalive": 15,
"cleansession": true,
"autoUnsubscribe": true,
"birthTopic": "",
"birthQos": "0",
"birthPayload": "",
"birthMsg": {},
"closeTopic": "",
"closePayload": "",
"closeMsg": {},
"willTopic": "",
"willQos": "0",
"willPayload": "",
"willMsg": {},
"userProps": "",
"sessionExpiry": ""
},
{
"id": "2f1c38495035d2e4",
"type": "influxdb",
"hostname": "influxdb",
"port": 8086,
"protocol": "http",
"database": "",
"name": "InfluxDB",
"usetls": false,
"tls": "",
"influxdbVersion": "2.0",
"url": "http://influxdb:8086",
"timeout": "",
"rejectUnauthorized": false
}
]
nodered_flows_cred:
content: |
{
"2f1c38495035d2e4": {
"token": "${INFLUXDB_TOKEN}"
}
}
nodered_settings:
content: |
module.exports = {
flowFile: 'flows.json',
credentialSecret: false,
adminAuth: null,
editorTheme: {
projects: {
enabled: false
}
}
}
```
### Perbarui penerapan SiteWise Edge
1. Arahkan ke [AWS IoT konsol](https://console.aws.amazon.com/iot/)
1. **Pilih perangkat **Greengrass** di menu navigasi kiri di bawah bagian Kelola, lalu Perangkat **inti**.**
1. Pilih perangkat inti yang terhubung ke SiteWise Edge Gateway Anda.
1. Pilih tab **Deployment**, lalu pilih nilai ID **Deployment**.
1. Pilih **Tindakan**, lalu pilih **Revisi**.
1. Baca pesan pop up lalu pilih **Revise Deployment**.
1. Pada **Langkah 2 - Pilih komponen**, pilih komponen berikut dan kemudian pilih **Berikutnya**.
+ `aws.greengrass.clientdevices.mqtt.EMQX`
+ `aws.iot.SiteWiseEdgePublisher`
1. Pada **Langkah 3 - Konfigurasikan komponen**, pilih nilai `aws.greengrass.clientdevices.mqtt.EMQX` komponen dan tambahkan konfigurasi jaringan berikut:
```
{
"emqxConfig": {
"authorization": {
"no_match": "allow"
},
"listeners": {
"tcp": {
"default": {
"enabled": true,
"enable_authn": false
}
}
}
},
"authMode": "bypass",
"dockerOptions": "-p 127.0.0.1:1883:1883 --network=SiteWiseEdgeNodeRedDemoNetwork",
"requiresPrivilege": "true"
}
```
1. Pilih **Berikutnya**.
1. Di **Langkah 4 - Konfigurasikan pengaturan lanjutan**, pilih **Berikutnya**.
1. Pilih **Deploy**
### Luncurkan layanan
1. Mulai layanan menggunakan file Docker Compose. Jalankan perintah berikut di bawah direktori yang berisi `compose.yaml` file.
```
docker compose up -d
```
1. Buat terowongan SSH untuk mengakses layanan:
```
ssh -i path_to_your_ssh_key -L 1880:127.0.0.1:1880 -L 3000:127.0.0.1:3000 -L 8086:127.0.0.1:8086 username@gateway_ip_address
```
Penerapan ini membuat layanan berikut di`SiteWiseEdgeNodeRedDemoNetwork network`:
**InfluxDB v2 (port 8086)**
Termasuk organisasi (iot-sitewise-edge), bucket WindFarmData InfluxDB, dan kredenal admin yang telah dikonfigurasi sebelumnya
**Node-merah (port 1880)**
Termasuk node InfluxDB dan alur pra-konfigurasi untuk integrasi AWS IoT SiteWise
**Grafana (port 3000)**
Termasuk pengguna admin, sumber data InfluxDB, dan dasbor pemantauan
### Akses layanan
Setelah penerapan, akses layanan menggunakan yang berikut URLs dan kredensyal:
**catatan**
Anda dapat mengakses setiap layanan dari host Anda atau mesin gateway.
**Detail akses layanan**
| Layanan | URL | Kredensial |
| --- | --- | --- |
| Simpul-merah | [http://127.0.0.1:1880](http://127.0.0.1:1880) | Tidak ada kredensi yang diperlukan |
| InfluxDB | [http://127.0.0.1:8086](http://127.0.0.1:8086) | Nama Pengguna: admin Kata sandi: \$1 INFLUXDB\$1PASSWORD |
| Grafana | [http://127.0.0.1:3000](http://127.0.0.1:3000) | Nama Pengguna: admin Kata sandi: \$1GRAFANA\$1PASSWORD |
## Verifikasi penyebaran
Untuk memastikan penerapan Anda berhasil, lakukan pemeriksaan berikut:
1. Untuk Node-Red, verifikasi keberadaan dua aliran yang dimuat sebelumnya:
+ Aliran publikasi data
+ Aliran retensi data
1. Untuk AWS IoT SiteWise, di AWS IoT SiteWise konsol, konfirmasikan keberadaan aliran data dengan alias`/Renton/WindFarm/Turbine/WindSpeed`.
1. Untuk InfluxDB, gunakan Data Explorer untuk memverifikasi penyimpanan data dalam `TurbineData` pengukuran di dalam bucket. `WindFarmData`
1. Untuk Grafana, lihat dasbor untuk mengonfirmasi tampilan data deret waktu yang dihasilkan dari Node-merah.
# Memproses data untuk integrasi sumber terbuka
Data dapat diproses (seperti transformasi atau agregasi), pada tahap yang berbeda menggunakan berbagai alat, masing-masing melayani persyaratan pemantauan yang berbeda.
## Memproses data dengan node Node-red
Ubah data Anda secara real time menggunakan node pemrosesan bawaan Node-Red®. Konfigurasikan node ini melalui konsol Node-Red untuk membuat pipeline data Anda.
### Node transformasi data
Ubah titik data individual, mirip dengan Transforms in AWS IoT SiteWise, menggunakan node ini:
+ **change node** - Melakukan modifikasi nilai sederhana pada data Anda.
+ **fungsi node** - Mengaktifkan JavaScript transformasi kustom untuk pemrosesan data yang kompleks.
### Node perhitungan metrik
Gabungkan beberapa titik data menjadi satu output, mirip dengan Metrik di AWS IoT SiteWise, menggunakan node ini:
+ **batch node** - Kelompokkan beberapa pesan untuk pemrosesan batch.
+ **join node** - Menggabungkan beberapa aliran data menjadi satu output.
+ **aggregator node** - Menghitung metrik agregat dari beberapa titik data.
Untuk opsi node tambahan, lihat Pustaka [Node-merah](https://flows.nodered.org/).
## Buat tugas InfluxDB
Sementara Node-Red unggul dalam pemrosesan data dasar dengan pengaturan cepat, perhitungan metrik yang kompleks dapat menjadi tantangan dalam pemrograman berbasis aliran. InfluxDB® Tasks memberikan alternatif melalui skrip Flux terjadwal untuk kebutuhan pemrosesan lanjutan.
Gunakan Tugas InfluxDB untuk:
+ Agregasi statistik di seluruh kumpulan data besar
+ Operasi matematika pada beberapa properti
+ Pengukuran turunan dari berbagai sumber
### Fitur tugas
+ **Eksekusi Terjadwal** - Jalankan tugas berdasarkan ekspresi cron
+ **Pemrosesan Batch** - Optimalkan operasi untuk data deret waktu
+ **Pemulihan Kesalahan** - Coba ulang operasi yang gagal secara otomatis
+ **Monitoring** - Melacak eksekusi melalui log rinci
Kelola tugas melalui UI InfluxDB, API, atau CLI. Untuk informasi selengkapnya, lihat [Memproses data dengan tugas InfluxDB](https://docs.influxdata.com/influxdb/cloud/process-data/).
## Gunakan transformasi Grafana
Ubah visualisasi data di Grafana® tanpa memodifikasi data sumber di InfluxDB. Transformasi Grafana hanya berlaku untuk lapisan visualisasi.
+ **Visual Builder** - Buat transformasi tanpa menulis kode
+ **Live Preview** - Lihat hasil transformasi secara real time
+ **Multi-Sumber** - Memproses data dari berbagai sumber database
+ **Penyimpanan Efisien** - Mengubah data pada waktu visualisasi tanpa menyimpan hasil perantara
Untuk informasi selengkapnya, lihat [Mengubah data](https://grafana.com/docs/grafana/latest/panels/transform-data/).
## Memecahkan masalah integrasi sumber terbuka
Untuk informasi selengkapnya tentang topik pemecahan masalah yang terkait dengan integrasi sumber terbuka untuk gateway SiteWise Edge, lihat. [Memecahkan masalah integrasi sumber terbuka di Edge](troubleshooting-gateway.md#open-source-troubleshooting)
# Aliran klasik, gateway V2 untuk Edge AWS IoT SiteWise
Pahami fitur dan batasan aliran Klasik, gateway V2 untuk Edge. AWS IoT SiteWise
Aliran Klasik, gateway V2 mempertahankan fungsionalitas tradisional yang akrab dari AWS IoT SiteWise penerapan sebelumnya sebelum pengenalan gateway V3 berkemampuan MQTT. Gerbang SiteWise Edge ini dianggap sebagai aliran Klasik, gateway V2. Mereka mempertahankan kompatibilitas mundur dan berfungsi dengan paket pemrosesan data. Sementara aliran Klasik, gateway V2 menawarkan kinerja yang andal untuk pengaturan yang ada, ia memiliki keterbatasan dibandingkan dengan opsi gateway yang lebih baru. Secara khusus, jenis gateway ini tidak sepenuhnya kompatibel dengan fitur-fitur canggih yang tersedia di tujuan gateway V3 berkemampuan MQTT. Untuk menggunakan protokol pesan MQTT, Anda dapat membuat gateway V3 berkemampuan MQTT baru. Untuk informasi selengkapnya, lihat [Gateway V3 berkemampuan MQTT untuk Edge AWS IoT SiteWise](mqtt-enabled-v3-gateway.md).
**Topics**
+ [Gunakan paket untuk mengumpulkan dan memproses data di SiteWise Edge](data-packs.md)
+ [Konfigurasikan AWS IoT SiteWise komponen penerbit](configure-publisher-component.md)
+ [Tujuan dan pengelola AWS IoT Greengrass aliran](destinations-gg-stream-manager.md)
+ [Konfigurasikan kemampuan tepi di AWS IoT SiteWise Edge](edge-data-collection-and-processing.md)
+ [Konfigurasikan pemrosesan data tepi untuk AWS IoT SiteWise model dan aset](edge-processing.md)
# Gunakan paket untuk mengumpulkan dan memproses data di SiteWise Edge
**catatan**
Fitur paket pemrosesan data (DPP) tidak lagi tersedia untuk pelanggan baru. Pelanggan yang sudah ada dapat terus menggunakan layanan ini seperti biasa. Untuk informasi selengkapnya, lihat [Perubahan ketersediaan paket pemrosesan data](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/iotsitewise-dpp-availability-change.html).
AWS IoT SiteWise Edge gateway menggunakan paket yang berbeda untuk menentukan cara mengumpulkan dan memproses data Anda.
Saat ini, paket berikut tersedia:
+ **Paket pengumpulan data** — Gunakan paket ini untuk mengumpulkan data industri Anda dan mengarahkannya ke tujuan AWS Cloud. Secara default, paket ini diaktifkan secara otomatis untuk gateway SiteWise Edge Anda.
+ **Paket pemrosesan data** — Gunakan paket ini untuk mengaktifkan komunikasi gateway SiteWise Edge dengan model dan aset aset yang dikonfigurasi tepi. Anda dapat menggunakan konfigurasi edge untuk mengontrol data aset apa yang akan dikomputasi dan diproses di tempat. Anda kemudian dapat mengirim data Anda ke AWS IoT SiteWise atau AWS layanan lain. Untuk informasi selengkapnya tentang paket pemrosesan data, lihat[Konfigurasikan pemrosesan data tepi untuk AWS IoT SiteWise model dan aset](edge-processing.md).
## Meningkatkan paket
**penting**
Memutakhirkan versi paket pemrosesan data dari sebelumnya (dan termasuk) 2.0.x ke versi 2.1.x akan mengakibatkan hilangnya data pengukuran yang disimpan secara lokal.
SiteWise Edge gateway menggunakan paket yang berbeda untuk menentukan cara mengumpulkan dan memproses data Anda. Anda dapat menggunakan AWS IoT SiteWise konsol untuk meningkatkan paket.
**Untuk meningkatkan paket (konsol)**
1. Navigasikan ke [konsol AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/) tersebut.
1. Di navigasi kiri, pilih **gateway Edge** di bagian **Edge**.
1. Dalam daftar **Gateways**, pilih gateway SiteWise Edge dengan paket yang ingin Anda tingkatkan.
1. Di bagian **konfigurasi Gateway**, pilih **Pembaruan perangkat lunak tersedia**.
1. Pada halaman Edit versi perangkat lunak, pilih **Pembaruan**.
**catatan**
Anda hanya dapat memutakhirkan paket yang diaktifkan. Untuk menemukan daftar paket yang diaktifkan untuk gateway SiteWise Edge ini, pilih **Ikhtisar**, lalu lihat bagian **Kemampuan tepi**.
1. Pada halaman edit versi perangkat lunak, di bagian **pembaruan komponen Gateway**, lakukan hal berikut:
+ Untuk memperbarui **kolektor OPC UA**, pilih versi, lalu pilih **Deploy**.
+ Untuk memperbarui **Publisher**, pilih versi, lalu pilih **Deploy**.
+ Untuk memperbarui **paket pemrosesan data**, pilih versi, lalu pilih **Deploy**.
1. Setelah selesai menerapkan versi baru, pilih **Selesai**.
Jika Anda mengalami masalah dalam meningkatkan paket, lihat[Tidak dapat menerapkan paket ke gateway SiteWise Edge](troubleshooting-gateway.md#gateway-issue-ggv2-packs).
# Perubahan ketersediaan paket pemrosesan data
**catatan**
Fitur paket pemrosesan data (DPP) tidak lagi tersedia untuk pelanggan baru. Pelanggan yang sudah ada dapat terus menggunakan layanan ini seperti biasa. Untuk informasi selengkapnya, lihat [Perubahan ketersediaan paket pemrosesan data](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/iotsitewise-dpp-availability-change.html).
[Untuk kemampuan yang mirip dengan fitur paket pemrosesan data AWS IoT, jelajahi [alternatif sumber terbuka atau integrasi mitra](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/open-source-edge-integrations.html) kami.](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/cpa-add-source.html) Paket Pemrosesan AWS IoT SiteWise Data adalah fitur AWS IoT SiteWise yang menyediakan transformasi data, metrik, penyaringan, penyimpanan lokal, dan visualisasi di tepi.
**catatan**
AWS IoT SiteWise dan fitur paket pengumpulan data AWS IoT SiteWise Edge terus tersedia, tetapi fitur paket pemrosesan data memasuki mode pemeliharaan.
## Opsi migrasi
Jelajahi opsi migrasi ini untuk mengganti fungsionalitas paket pemrosesan data.
**Alternatif sumber terbuka**
Buat pipeline pemrosesan data lokal menggunakan Node-RED untuk transformasi data, InfluxDB untuk penyimpanan deret waktu, dan Grafana untuk visualisasi. Alat ini bekerja dengan gateway V3 berkemampuan MQTT melalui MQTT untuk memberikan pemrosesan tepi dan wawasan lokal sambil menyinkronkan data dengan Cloud. AWS
Untuk informasi selengkapnya, lihat [Memproses dan memvisualisasikan data dengan SiteWise Edge dan alat sumber terbuka](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/open-source-edge-integrations.html).
**Integrasi mitra**
Hubungkan peralatan dan sensor industri melalui sumber data mitra pihak ketiga seperti CloudRail, EasyEdge, dan Litmus Edge. Komponen Greengrass ini dikembangkan dalam kemitraan AWS dengan dan mendukung lebih dari 200 protokol industri untuk pengumpulan dan pemrosesan data yang komprehensif.
Untuk informasi selengkapnya, lihat [Menambahkan sumber data](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/cpa-add-source.html).
**Gateway V3 berkemampuan MQTT**
Gateway V3 berkemampuan MQTT menggunakan protokol MQTT ringan untuk komunikasi data yang efisien dan menawarkan tujuan data yang fleksibel termasuk konsumsi waktu nyata dan penyerapan Amazon S3 yang disangga. Anda dapat menerapkan filter jalur untuk pengumpulan data yang tepat dan mendapatkan manfaat dari peningkatan skalabilitas dan penyelarasan standar IoT. Gateway V3 berkemampuan MQTT menyediakan pemrosesan data berbasis cloud melalui layanan AWS IoT SiteWise inti termasuk model aset, properti terkomputasi, alarm, dan kueri data historis.
Untuk informasi selengkapnya, lihat [Gateway V3 berkemampuan MQTT untuk Edge AWS IoT SiteWise](mqtt-enabled-v3-gateway.md).
## Pertanyaan umum
### Bisakah saya bermigrasi secara bertahap?
Ya, Anda dapat bermigrasi secara bertahap menggunakan kombinasi opsi migrasi apa pun. Anda dapat menerapkan gateway V3 berkemampuan MQTT, alternatif sumber terbuka, atau integrasi mitra bersama aliran Klasik yang ada, gateway V2 dengan paket pemrosesan data. Semua opsi dapat mengirim data ke AWS IoT SiteWise lingkungan yang sama.
### Berapa lama saya bisa terus menggunakan paket pemrosesan data?
Paket pemrosesan data tetap tersedia untuk pelanggan yang sudah ada dalam mode pemeliharaan. Anda akan menerima pemberitahuan terlebih dahulu jika ada perubahan ketersediaan yang direncanakan. Pantau pengumuman AWS layanan dan pemberitahuan akun Anda untuk pembaruan.
# Konfigurasikan AWS IoT SiteWise komponen penerbit
Setelah Anda membuat gateway AWS IoT SiteWise Edge dan menginstal perangkat lunak, Anda dapat mengatur komponen penerbit sehingga gateway SiteWise Edge Anda dapat mengekspor data ke AWS Cloud. Gunakan komponen penerbit untuk mengaktifkan fitur tambahan atau mengkonfigurasi pengaturan default. Untuk informasi selengkapnya, lihat [AWS IoT SiteWise penerbit](https://docs.aws.amazon.com/greengrass/v2/developerguide/iotsitewise-publisher-component.html) di *Panduan AWS IoT Greengrass Version 2 Pengembang*.
**catatan**
Konfigurasi penerbit berbeda berdasarkan jenis gateway yang Anda gunakan. Untuk aliran Klasik, gateway V2, gunakan namespace. `iotsitewise:publisher:2` Untuk gateway V3 berkemampuan MQTT, gunakan namespace. `iotsitewise:publisher:3`
------
#### [ Console ]
1. Navigasikan ke [konsol AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/) tersebut.
1. Di panel navigasi, pilih **gateway Edge**.
1. Pilih gateway SiteWise Edge yang ingin Anda konfigurasikan penerbit.
1. **Di bagian **konfigurasi Publisher**, pilih Edit**
1. Untuk **pesanan Penerbitan**, pilih salah satu dari berikut ini:
+ **Publikasikan data tertua terlebih dahulu** — Gateway SiteWise Edge menerbitkan data tertua ke cloud terlebih dahulu secara default.
+ **Publikasikan data terbaru terlebih dahulu** — Gateway SiteWise Edge menerbitkan data terbaru ke cloud terlebih dahulu.
1. (Opsional) Jika Anda tidak ingin gateway SiteWise Edge mengompres data Anda, batalkan pilihan **Aktifkan kompresi saat mengunggah** data.
1. (Opsional) Jika Anda tidak ingin mempublikasikan data lama, pilih **Kecualikan data kedaluwarsa** dan lakukan hal berikut:
1. Untuk **periode Cutoff**, masukkan nilai dan pilih unit. Periode batas harus antara lima menit dan tujuh hari. Misalnya, jika batas waktu adalah tiga hari, data yang lebih tua dari tiga hari tidak dipublikasikan ke cloud.
1. (Opsional) Untuk mengatur pengaturan kustom tentang bagaimana data ditangani pada perangkat lokal Anda, pilih **Pengaturan penyimpanan lokal** dan lakukan hal berikut:
1. Untuk **periode Retensi**, masukkan nomor dan pilih unit. Periode retensi harus antara satu menit dan 30 hari, dan lebih besar dari atau sama dengan periode rotasi. Misalnya, jika periode retensi adalah 14 hari, gateway SiteWise Edge menghapus data apa pun di tepi yang lebih lama dari periode batas yang ditentukan setelah disimpan selama 14 hari.
1. Untuk **periode Rotasi**, masukkan nomor dan pilih unit. Periode rotasi harus lebih besar dari satu menit, dan sama dengan, atau kurang dari, periode retensi. Misalnya, katakanlah periode rotasi adalah dua hari, gateway SiteWise Edge mengumpulkan dan menyimpan data yang lebih lama dari periode cutoff ke satu file. Untuk gateway yang dihosting sendiri AWS IoT Greengrass V2, gateway SiteWise Edge mentransfer sekumpulan data ke direktori lokal berikut setiap dua hari sekali:. `/greengrass/v2/work/aws.iot.SiteWiseEdgePublisher/exports`
1. Untuk **kapasitas Penyimpanan**, masukkan nilai yang lebih besar dari atau sama dengan 1. Jika kapasitas penyimpanan 2 GB, gateway SiteWise Edge mulai menghapus data ketika lebih dari 2 GB data disimpan secara lokal.
1. Pilih **Simpan**.
------
#### [ AWS CLI ]
Gunakan [UpdateGatewayCapabilityConfiguration](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_UpdateGatewayCapabilityConfiguration.html)API untuk mengonfigurasi penerbit.
Atur parameter `capabilityNamespace` ke `iotsitewise:publisher:2`.
**Example : Konfigurasi penerbit untuk Classic Stream, gateway V2**
Namespace penerbit: `iotsitewise:publisher:2`
```
{
"SiteWisePublisherConfiguration": {
"publishingOrder": "TIME_ORDER",
"enableCompression": true,
"dropPolicy": {
"cutoffAge": "7d",
"exportPolicy": {
"retentionPeriod": "7d",
"rotationPeriod": "6h",
"exportSizeLimitGB": 10
}
}
},
"SiteWiseS3PublisherConfiguration": {
"accessRoleArn": "arn:aws:iam:123456789012:role/roleName",
"streamToS3ConfigMapping": [
{
"streamName": "S3_OPC-UA_Data_Collector",
"targetBucketArn": "arn:aws:s3:::amzn-s3-demo-bucket/dataCollector",
"publishPolicy": {
"publishFrequency": "10m",
"localSizeLimitGB": 10
},
"siteWiseImportPolicy": {
"enableSiteWiseStorageImport": true,
"enableDeleteAfterImport": true
}
}
]
}
}
```
Publisher menyediakan parameter konfigurasi berikut yang dapat Anda sesuaikan:
`SiteWisePublisherConfiguration`
`publishingOrder`
Urutan di mana data dipublikasikan ke cloud. Nilai parameter ini dapat berupa salah satu dari yang berikut:
+ `TIME_ORDER`(**Publikasikan data tertua terlebih dahulu**) — Data paling awal dipublikasikan ke cloud terlebih dahulu, secara default.
+ `RECENT_DATA`(**Publikasikan data terbaru terlebih dahulu**) — Data terbaru dipublikasikan ke cloud terlebih dahulu.
`enableCompression`
Setel ini untuk `true` mengompres data sebelum dipublikasikan. Kompresi data dapat mengurangi penggunaan bandwidth.
`dropPolicy`
(Opsional) Kebijakan yang mengontrol data apa yang dipublikasikan ke cloud.
`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.
`exportPolicy`
(Opsional) Kebijakan yang mengelola penyimpanan data di tepi. Kebijakan ini berlaku untuk data yang lebih awal dari batas usia.
`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.
`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.
`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.
`SiteWiseS3PublisherConfiguration`
`accessRoleArn`
Peran akses yang memberikan AWS IoT SiteWise izin untuk mengelola bucket Amazon S3 yang Anda terbitkan.
`streamToS3ConfigMapping`
Array konfigurasi yang memetakan aliran ke konfigurasi Amazon S3.
`streamName`
Aliran untuk membaca dan mempublikasikan ke konfigurasi Amazon S3.
`targetBucketArn`
Ember ARN untuk dipublikasikan ke.
`publishPolicy`
`publishFrequency`
Frekuensi penerbitan gateway SiteWise Edge ke bucket Amazon S3.
`localSizeLimitGB`
Ukuran maksimum file yang ditulis ke disk lokal. Jika ambang batas ini dilanggar, penerbit menerbitkan semua data buffer ke tujuannya.
`siteWiseImportPolicy`
`enableSiteWiseStorageImport`
Setel ini `true` untuk mengimpor data dari bucket Amazon S3 ke AWS IoT SiteWise penyimpanan.
`enableDeleteAfterImport`
Setel ini `true` untuk menghapus file di bucket Amazon S3 setelah tertelan ke dalam penyimpanan. AWS IoT SiteWise
------
# Tujuan dan pengelola AWS IoT Greengrass aliran
AWS IoT Greengrass stream manager memungkinkan Anda mengirim data ke AWS Cloud tujuan berikut: saluran masuk AWS IoT Analytics, streaming di Amazon Kinesis Data Streams, properti aset di, atau objek AWS IoT SiteWise di Amazon Simple Storage Service (Amazon S3). Untuk informasi selengkapnya, lihat [Mengelola aliran data di *Panduan AWS IoT Greengrass Version 2 Pengembang AWS IoT Greengrass * Inti](https://docs.aws.amazon.com/greengrass/v2/developerguide/manage-data-streams.html).
**Example : Struktur pesan aliran data**
Contoh berikut menunjukkan struktur pesan aliran data yang diperlukan dikirimkan oleh manajer AWS IoT Greengrass aliran.
```
{
"assetId": "string",
"propertyAlias": "string",
"propertyId": "string",
"propertyValues": [
{
"quality": "string",
"timestamp": {
"offsetInNanos": number,
"timeInSeconds": number
},
"value": {
"booleanValue": boolean,
"doubleValue": number,
"integerValue": number,
"stringValue": "string"
}
}
]
}
```
**catatan**
Pesan aliran data harus menyertakan (`assetId`dan`propertyId`) atau `propertyAlias` dalam strukturnya.
`assetId`
(Opsional) ID aset yang akan diperbarui.
`propertyAlias`
(Opsional) Alias yang mengidentifikasi properti, seperti jalur aliran data server OPC UA. Contoh:
```
/company/windfarm/3/turbine/7/temperature
```
Untuk informasi selengkapnya, lihat [Mengelola aliran data](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/manage-data-streams.html) di *Panduan AWS IoT SiteWise Pengguna*.
`propertyId`
(Opsional) ID properti aset untuk entri ini.
`propertyValues`
(Wajib) Daftar nilai properti yang akan diunggah. Anda dapat menentukan hingga 10 elemen `propertyValues` array.
`quality`
(Opsional) Kualitas nilai properti aset.
`timestamp`
(Wajib) Stempel waktu dari nilai properti aset.
`offsetInNanos`
(Opsional) Offset nanodetik dari. `timeInSeconds`
`timeInSeconds`
(Wajib) Tanggal stempel waktu, dalam hitungan detik, dalam format epoch Unix. Data nanodetik pecahan disediakan oleh. `offsetInNanos`
`value`
(Wajib) Nilai properti aset.
Hanya satu dari nilai berikut yang dapat ada di `value` lapangan.
`booleanValue`
(Opsional) Data properti aset tipe Boolean (`true`atau`false`).
`doubleValue`
(Opsional) Data properti aset tipe ganda (nomor floating point).
`integerValue`
(Opsional) Data properti aset tipe integer (bilangan bulat).
`stringValue`
(Opsional) Data properti aset tipe string (urutan karakter).
# Konfigurasikan kemampuan tepi di AWS IoT SiteWise Edge
**catatan**
Fitur paket pemrosesan data (DPP) tidak lagi tersedia untuk pelanggan baru. Pelanggan yang sudah ada dapat terus menggunakan layanan ini seperti biasa. Untuk informasi selengkapnya, lihat [Perubahan ketersediaan paket pemrosesan data](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/iotsitewise-dpp-availability-change.html).
Anda dapat menggunakan AWS IoT SiteWise Edge untuk mengumpulkan dan menyimpan sementara data sehingga Anda dapat mengatur dan memproses data perangkat secara lokal. Dengan mengaktifkan pemrosesan tepi, Anda dapat memilih untuk mengirim hanya data agregat ke AWS Cloud untuk mengoptimalkan penggunaan bandwidth dan biaya penyimpanan cloud Anda. Menggunakan AWS IoT SiteWise komponen dengan AWS IoT Greengrass, Anda dapat mengumpulkan dan memproses data di tepi sebelum mengirimnya ke AWS Cloud, atau mengelolanya di tempat menggunakan SiteWise Edge APIs.
Pengumpulan data terjadi melalui paket data dan AWS IoT SiteWise komponen yang berjalan AWS IoT Greengrass.
**catatan**
AWS IoT SiteWise mempertahankan data tepi Anda di gateway SiteWise Edge Anda hingga 30 hari. Periode penyimpanan data Anda tergantung pada ruang disk yang tersedia di perangkat Anda.
Jika gateway SiteWise Edge Anda telah terputus AWS Cloud selama 30 hari, [Paket Pemrosesan Data](configure-opcua-source.md) secara otomatis dinonaktifkan.
**Topics**
+ [Siapkan kemampuan tepi di SiteWise Edge](#using-sitewise-edge)
## Siapkan kemampuan tepi di SiteWise Edge
AWS IoT SiteWise menyediakan paket berikut yang dapat digunakan gateway SiteWise Edge Anda untuk menentukan cara mengumpulkan dan memproses data Anda. Pilih paket untuk mengaktifkan kemampuan tepi untuk gateway SiteWise Edge Anda.
+ **Paket pengumpulan data** memungkinkan gateway SiteWise Edge Anda mengumpulkan data dari beberapa server OPC UA, lalu mengekspor data dari edge ke AWS Cloud. Ini menjadi aktif setelah Anda menambahkan sumber data ke gateway SiteWise Edge Anda.
+ **Paket pemrosesan data** memungkinkan gateway SiteWise Edge Anda untuk memproses data peralatan Anda di tepi. Misalnya, Anda dapat menggunakan model aset untuk menghitung metrik dan transformasi. Untuk informasi selengkapnya tentang model aset dan aset, lihat[Model aset industri](industrial-asset-models.md).
**catatan**
Paket pemrosesan data hanya tersedia di platform x86.
**Untuk mengkonfigurasi kemampuan tepi**
1. Navigasikan ke [konsol AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/) tersebut.
1. Di panel navigasi, pilih **gateway Edge**.
1. Pilih gateway SiteWise Edge yang ingin Anda aktifkan kemampuan tepi.
1. Di bagian **kemampuan Edge**, pilih **Edit**
1. Di bagian **kemampuan Edge**, pilih **Aktifkan paket pemrosesan data (dikenakan biaya tambahan**).
1. (Opsional) Di bagian **koneksi Edge LDAP**, Anda dapat memberikan grup pengguna di direktori perusahaan Anda akses ke gateway SiteWise Edge ini. Grup pengguna dapat menggunakan kredensyal Lightweight Directory Access Protocol (LDAP) untuk mengakses gateway Edge. SiteWise Kemudian mereka dapat menggunakan AWS IoT SiteWise aplikasi AWS OpsHub for, operasi AWS IoT SiteWise API, atau alat lain untuk mengelola gateway SiteWise Edge. Untuk informasi selengkapnya, lihat [Kelola SiteWise gateway Edge](manage-gateways-ggv2.md).
**catatan**
Anda juga dapat menggunakan Linux atau Microsoft Windows kredensyal untuk mengakses gateway SiteWise Edge. Untuk informasi selengkapnya, lihat [Akses gateway SiteWise Edge Anda menggunakan kredensyal sistem operasi Linux](manage-gateways-ggv2.md#linux-user-pool).
1. Pilih **Diaktifkan**.
1. Untuk **nama Penyedia**, masukkan nama untuk penyedia LDAP Anda.
1. Untuk **nama host atau alamat IP**, masukkan nama host atau alamat IP server LDAP Anda.
1. Untuk **Port**, masukkan nomor port.
1. Untuk **Base Distinguished Name (DN)**, masukkan Distinguished Name (DN) untuk basis.
Jenis atribut berikut didukung: commonName (CN), localityName (L), Name (ST), OrganizationName (O), stateOrProvince (OU), countryName (C), streetAddress organizationalUnitName (STREET), domainComponent (DC), dan userid (UID).
1. Untuk **grup Admin DN**, masukkan DN.
1. Untuk **grup Pengguna DN**, masukkan DN.
1. Pilih **Simpan**.
Sekarang setelah Anda mengaktifkan kemampuan edge di gateway SiteWise Edge Anda, Anda perlu mengonfigurasi model aset Anda untuk edge. Konfigurasi tepi model aset Anda menentukan tempat properti aset Anda dihitung. Anda dapat menghitung semua properti di edge, atau Anda dapat mengonfigurasi properti model aset Anda secara terpisah. [Properti model aset meliputi [metrik](concept-overview.md#concept-metric), [transformasi](concept-overview.md#concept-transform), dan pengukuran.](concept-overview.md#concept-measurement)
Untuk informasi selengkapnya tentang properti aset, lihat[Tentukan properti data](asset-properties.md).
Setelah Anda membuat model aset Anda, Anda kemudian dapat mengonfigurasinya untuk edge. Untuk informasi selengkapnya tentang mengonfigurasi model aset Anda untuk edge, lihat[Buat model aset (konsol)](create-asset-models.md#create-asset-model-console).
**catatan**
Model aset dan dasbor secara otomatis disinkronkan antara AWS Cloud dan gateway SiteWise Edge Anda setiap 10 menit. Anda juga dapat menyinkronkan secara manual dari aplikasi gateway SiteWise Edge lokal.
# Konfigurasikan pemrosesan data tepi untuk AWS IoT SiteWise model dan aset
**catatan**
Fitur paket pemrosesan data (DPP) tidak lagi tersedia untuk pelanggan baru. Pelanggan yang sudah ada dapat terus menggunakan layanan ini seperti biasa. Untuk informasi selengkapnya, lihat [Perubahan ketersediaan paket pemrosesan data](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/iotsitewise-dpp-availability-change.html).
Anda dapat menggunakan AWS IoT SiteWise Edge untuk mengumpulkan, menyimpan, mengatur, dan memantau data peralatan secara lokal. Anda dapat menggunakan SiteWise Edge sehingga Anda dapat memodelkan data industri Anda dan memvisualisasikannya secara lokal. Anda dapat memproses data secara lokal dan mengirimkannya ke AWS Cloud, atau memprosesnya secara lokal menggunakan API. AWS IoT SiteWise
Dengan AWS IoT SiteWise Edge, Anda dapat memproses data mentah secara lokal dan memilih untuk mengirim hanya data gabungan ke AWS Cloud untuk mengoptimalkan penggunaan bandwidth dan biaya penyimpanan cloud Anda.
**catatan**
AWS IoT SiteWise mempertahankan data tepi Anda di gateway SiteWise Edge Anda hingga 30 hari. Periode penyimpanan data Anda tergantung pada ruang disk yang tersedia di perangkat Anda.
Jika gateway SiteWise Edge Anda telah terputus dari AWS Cloud selama 30 hari, gateway Edge akan dinonaktifkan [Siapkan sumber OPC UA di SiteWise Edge](configure-opcua-source.md) secara otomatis.
## Konfigurasikan model aset untuk pemrosesan data di SiteWise Edge
Anda harus mengonfigurasi model aset Anda untuk edge sebelum Anda dapat memproses data gateway SiteWise Edge Anda di tepi. Konfigurasi tepi model aset Anda menentukan tempat properti aset Anda dihitung. Anda dapat memilih untuk menghitung semua properti di edge dan mengirim hasilnya ke AWS Cloud, atau menyesuaikan tempat menghitung setiap properti aset secara terpisah. Untuk informasi selengkapnya, lihat [Konfigurasikan pemrosesan data tepi untuk AWS IoT SiteWise model dan aset](#edge-processing).
Properti aset meliputi metrik, transformasi, dan pengukuran:
+ Metrik adalah data agregat aset selama periode waktu tertentu. Anda dapat menghitung metrik baru dengan menggunakan data metrik yang ada. AWS IoT SiteWise selalu mengirimkan metrik Anda ke AWS Cloud untuk penyimpanan jangka panjang. AWS IoT SiteWise menghitung metrik di AWS Cloud secara default. Anda dapat mengonfigurasi model aset Anda untuk menghitung metrik Anda di tepi. AWS IoT SiteWise mengirimkan hasil yang diproses ke AWS Cloud.
+ Transformasi adalah ekspresi matematika yang memetakan titik data properti aset dari satu bentuk ke bentuk lainnya. Transformasi dapat menggunakan metrik sebagai data input dan harus dihitung dan disimpan di lokasi yang sama dengan inputnya. Jika Anda mengonfigurasi input metrik untuk menghitung di tepi, hitung AWS IoT SiteWise juga transformasi terkaitnya di tepi.
+ Pengukuran diformat sebagai data mentah yang dikumpulkan dan dikirim perangkat Anda ke AWS Cloud secara default. Anda dapat mengonfigurasi model aset untuk menyimpan data ini di perangkat lokal Anda.
Untuk informasi selengkapnya tentang properti aset, lihat[Tentukan properti data](asset-properties.md).
Setelah Anda membuat model aset Anda, Anda kemudian dapat mengonfigurasinya untuk edge. Untuk informasi selengkapnya tentang mengonfigurasi model aset Anda untuk edge, lihat[Buat model aset (konsol)](create-asset-models.md#create-asset-model-console).
**catatan**
Model aset dan dasbor secara otomatis disinkronkan antara AWS Cloud dan gateway SiteWise Edge Anda setiap 10 menit. Anda juga dapat menyinkronkan secara manual dari file[Kelola SiteWise gateway Edge](manage-gateways-ggv2.md).
Anda dapat menggunakan AWS IoT SiteWise REST APIs dan AWS Command Line Interface (AWS CLI) untuk menanyakan gateway SiteWise Edge Anda untuk data di tepi. Sebelum Anda menanyakan gateway SiteWise Edge Anda untuk data di tepi, Anda harus memenuhi prasyarat berikut:
+ Kredensyal Anda harus ditetapkan untuk REST. APIs Untuk informasi selengkapnya tentang menyetel kredensyal, lihat. [Kelola SiteWise gateway Edge](manage-gateways-ggv2.md)
+ Titik akhir SDK harus mengarah ke alamat IP gateway SiteWise Edge Anda. Anda dapat menemukan informasi selengkapnya di dokumentasi SDK Anda. Misalnya, lihat [Menentukan Titik Akhir Kustom di Panduan AWS SDK for Java 2.x](https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/specifying-endpoints.html) *Pengembang*.
+ Sertifikat gateway SiteWise Edge Anda harus terdaftar. Anda dapat menemukan informasi selengkapnya tentang mendaftarkan sertifikat gateway SiteWise Edge Anda di dokumentasi untuk SDK Anda. Misalnya, lihat [Mendaftarkan Bundel Sertifikat di Node.js](https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/node-registering-certs.html) di *Panduan AWS SDK for Java 2.x Pengembang*.
Untuk informasi selengkapnya tentang kueri data dengan AWS IoT SiteWise, lihat[Data kueri dari AWS IoT SiteWise](query-industrial-data.md).
# Tambahkan sumber data ke gateway AWS IoT SiteWise Edge Anda
Setelah menyiapkan gateway AWS IoT SiteWise Edge, Anda dapat menambahkan dan mengonfigurasi sumber data untuk menyerap data dari peralatan industri lokal. AWS IoT SiteWise SiteWise Edge mendukung berbagai protokol, termasuk OPC UA, dan banyak protokol lain yang tersedia melalui sumber data mitra. Sumber-sumber ini memungkinkan gateway Anda untuk terhubung dengan server lokal dan mengambil data industri Anda. Dengan mengonfigurasi sumber data, Anda dapat mengambil data dari berbagai sumber data, dan kemudian mengaitkan aliran data dengan properti aset, memungkinkan pemodelan aset industri yang komprehensif dan pemetaan data. AWS IoT SiteWise
**Topics**
+ [Sumber data OPC UA untuk gateway AWS IoT SiteWise Edge](configure-sources-opcua.md)
+ [Sumber data mitra di gateway SiteWise Edge](partner-data-sources.md)
# Sumber data OPC UA untuk gateway AWS IoT SiteWise Edge
Setelah menyiapkan gateway AWS IoT SiteWise Edge, Anda dapat mengonfigurasi sumber data sehingga gateway SiteWise Edge Anda dapat menyerap data dari peralatan industri lokal ke AWS IoT SiteWise. Setiap sumber mewakili server lokal, seperti server OPC UA, yang menghubungkan gateway SiteWise Edge Anda dan mengambil aliran data industri. Untuk informasi selengkapnya tentang menyiapkan gateway SiteWise Edge, lihat[Buat gateway SiteWise Edge yang dihosting sendiri](create-gateway-ggv2.md).
Jenis gateway, berkemampuan MQTT, gateway V3 versus aliran Klasik, gateway V2, memengaruhi cara data OPC UA ditangani. Dalam aliran Klasik, gateway V2, sumber data OPC UA ditambahkan langsung ke konfigurasi penerbit IoT gateway. SiteWise Setiap sumber data digabungkan dengan gateway, dan perutean data dikonfigurasi secara individual untuk setiap sumber. Sebaliknya, menggunakan gateway V3 berkemampuan MQTT, sumber data OPC UA dikonversi ke topik MQTT dan dikelola melalui tujuan terpusat. Untuk informasi lebih lanjut tentang setiap jenis, lihat [Gateway V3 berkemampuan MQTT untuk Edge AWS IoT SiteWise](mqtt-enabled-v3-gateway.md) dan[Aliran klasik, gateway V2 untuk Edge AWS IoT SiteWise](classic-streams-v2-gateway.md).
**catatan**
AWS IoT SiteWise restart gateway SiteWise Edge Anda setiap kali Anda menambahkan atau mengedit sumber. Gateway SiteWise Edge Anda tidak akan menelan data saat memperbarui konfigurasi sumber. Waktu untuk memulai ulang gateway SiteWise Edge Anda tergantung pada jumlah tag pada sumber gateway SiteWise Edge Anda. Waktu restart dapat berkisar dari beberapa detik (untuk gateway SiteWise Edge dengan beberapa tag) hingga beberapa menit (untuk gateway SiteWise Edge dengan banyak tag).
Setelah membuat sumber, Anda dapat mengaitkan aliran data Anda dengan properti aset. Untuk informasi selengkapnya tentang cara membuat dan menggunakan aset, lihat[Model aset industri](industrial-asset-models.md).
Anda dapat melihat CloudWatch metrik untuk memverifikasi bahwa sumber data terhubung AWS IoT SiteWise. Untuk informasi selengkapnya, lihat [AWS IoT Greengrass Version 2 metrik gateway](monitor-cloudwatch-metrics.md#gateway-metrics-ggv2).
Saat ini, AWS IoT SiteWise mendukung protokol sumber data berikut:
+ [OPC UA](https://en.wikipedia.org/wiki/OPC_Unified_Architecture) — Protokol komunikasi machine-to-machine (M2M) untuk otomasi industri.
## Support untuk protokol industri tambahan
SiteWise Edge mendukung berbagai protokol industri melalui integrasi dengan mitra sumber data. Kemitraan ini memungkinkan konektivitas dengan lebih dari 200 protokol yang berbeda, mengakomodasi berbagai sistem dan perangkat industri.
Untuk daftar mitra sumber data yang tersedia, lihat[SiteWise Opsi sumber data mitra gateway tepi](connect-partner-data-source.md).
# Siapkan sumber OPC UA di SiteWise Edge
Anda dapat menggunakan AWS IoT SiteWise konsol atau kemampuan gateway SiteWise Edge untuk menentukan dan menambahkan sumber OPC UA ke gateway SiteWise Edge Anda untuk mewakili server OPC UA lokal.
**Topics**
+ [Konfigurasikan sumber OPC UA (konsol)](#config-opcua-source-console)
+ [Konfigurasikan sumber OPC UA ()AWS CLI](#configure-opc-ua-source-cli)
## Konfigurasikan sumber OPC UA (konsol)
Anda dapat menggunakan konsol untuk mengonfigurasi sumber OPC UA dengan prosedur berikut.
**catatan**
Peringatan: Duplikat TQVs dapat mengakibatkan pengisian ganda.
**Untuk mengonfigurasi sumber OPC UA menggunakan konsol AWS IoT SiteWise**
1. Navigasikan ke [konsol AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/) tersebut.
1. Di navigasi kiri, pilih **gateway Edge** di bagian **Edge**.
1. Pilih gateway SiteWise Edge untuk menambahkan sumber OPC UA.
1. Pilih **Tambahkan sumber data**.
1. Masukkan nama untuk sumbernya.
1. Masukkan **titik akhir lokal** dari server sumber data. Titik akhir dapat berupa alamat IP atau nama host. Anda juga dapat menambahkan nomor port ke titik akhir lokal. Misalnya, titik akhir lokal Anda mungkin terlihat seperti ini: **opc.tcp://203.0.113.0:49320**
1. (Opsional) Untuk **ID Node untuk pemilihan**, tambahkan filter node untuk membatasi aliran data mana yang tertelan ke Cloud. AWS Secara default, gateway SiteWise Edge menggunakan simpul akar server untuk menyerap semua aliran data. Anda dapat menggunakan filter node untuk mengurangi waktu startup dan penggunaan CPU gateway SiteWise Edge dengan hanya menyertakan jalur ke data yang Anda modelkan AWS IoT SiteWise. Secara default, gateway SiteWise Edge mengunggah semua jalur OPC UA kecuali yang dimulai dengan. `/Server/` Untuk menentukan filter node OPC UA, Anda dapat menggunakan jalur simpul dan `**` karakter wildcard `*` dan. Untuk informasi selengkapnya, lihat [Gunakan filter node OPC UA di SiteWise Edge](opc-ua-node-filters.md).
1. **Tujuan** bervariasi antara gateway V3 berkemampuan MQTT, dan aliran Klasik, gateway V2.
+ **Steam klasik, tujuan gateway V2** memiliki hubungan 1:1 dengan sumbernya. Setiap sumber mengirimkan data ke tujuan tertentu.
+ **Tujuan gateway V3 berkemampuan MQTT** disiapkan secara terpisah karena model hub dan spoke memungkinkan Anda memusatkan konfigurasi dan pengelolaan beberapa sumber data di seluruh gateway yang berbeda. Untuk mengatur tujuan di gateway V3, lihat[Memahami tujuan AWS IoT SiteWise Edge](gw-destinations.md#source-destination).
------
#### [ Classic steams, V2 gateway destinations ]
+ **AWS IoT SiteWise real-time** — Pilih ini untuk mengirim data langsung ke AWS IoT SiteWise penyimpanan. Menelan dan memantau data secara real-time di tepi.
+ **AWS IoT SiteWise Buffer menggunakan Amazon** S3 - Kirim data dalam format Parket ke Amazon S3 dan kemudian impor ke penyimpanan. AWS IoT SiteWise Pilih opsi ini untuk menelan data dalam batch, dan menyimpan data historis dengan cara yang hemat biaya. Anda dapat mengonfigurasi lokasi bucket Amazon S3 pilihan Anda, dan frekuensi di mana Anda ingin data diunggah ke Amazon S3. Anda juga dapat memilih apa yang harus dilakukan dengan data setelah tertelan. AWS IoT SiteWise Anda dapat memilih untuk memiliki data yang tersedia di keduanya AWS IoT SiteWise dan Amazon S3 atau Anda dapat memilih untuk menghapusnya secara otomatis dari Amazon S3 setelah diimpor ke. AWS IoT SiteWise
+ Bucket Amazon S3 adalah mekanisme pementasan dan buffering dan mendukung file dalam format Parket.
+ Jika Anda memilih kotak centang **Impor data ke AWS IoT SiteWise penyimpanan**, data diunggah ke Amazon S3 terlebih dahulu, lalu AWS IoT SiteWise ke penyimpanan.
+ Jika Anda memilih kotak centang **Hapus data dari Amazon S3**, data dihapus dari Amazon S3, setelah diimpor ke penyimpanan. SiteWise
+ Jika Anda menghapus kotak centang **Hapus data dari Amazon S3**, data disimpan baik di Amazon S3, dan di penyimpanan. SiteWise
+ Jika Anda menghapus kotak centang **Impor data ke AWS IoT SiteWise penyimpanan**, data hanya disimpan di Amazon S3. Itu tidak diimpor ke SiteWise penyimpanan.
Kunjungi [Mengelola penyimpanan data](manage-data-storage.md) untuk detail tentang berbagai opsi penyimpanan yang AWS IoT SiteWise disediakan. Untuk mempelajari lebih lanjut tentang opsi harga, lihat [AWS IoT SiteWise harga](https://aws.amazon.com/iot-sitewise/pricing/).
+ **AWS IoT Greengrass pengelola aliran** — Gunakan pengelola AWS IoT Greengrass aliran untuk mengirim data ke tujuan AWS Cloud berikut: saluran di AWS IoT Analytics, streaming di Amazon Kinesis Data Streams, properti aset di, atau objek AWS IoT SiteWise di Amazon Simple Storage Service (Amazon S3). Untuk informasi selengkapnya, lihat [Mengelola aliran data di *Panduan AWS IoT Greengrass Version 2 Pengembang AWS IoT Greengrass * Inti](https://docs.aws.amazon.com/greengrass/v2/developerguide/manage-data-streams.html).
Masukkan nama untuk AWS IoT Greengrass streaming.
------
#### [ MQTT-enabled, V3 gateway destinations ]
1. Lihat [Gateway V3 berkemampuan MQTT untuk Edge AWS IoT SiteWise](mqtt-enabled-v3-gateway.md) untuk informasi tentang menambahkan tujuan Anda yang relevan.
1. Kembali ke prosedur ini setelah menambahkan tujuan sumber Anda.
------
1. Di panel **konfigurasi lanjutan**, Anda dapat melakukan hal berikut:
1. Pilih **mode keamanan Pesan** untuk koneksi dan data dalam perjalanan antara server sumber dan gateway SiteWise Edge Anda. Bidang ini adalah kombinasi dari kebijakan keamanan OPC UA dan mode keamanan pesan. Pilih kebijakan keamanan dan mode keamanan pesan yang sama yang Anda tentukan untuk server OPC UA Anda.
1. Jika sumber Anda memerlukan otentikasi, pilih AWS Secrets Manager rahasia dari daftar **konfigurasi Otentikasi**. Gateway SiteWise Edge menggunakan kredensyal otentikasi dalam rahasia ini ketika terhubung ke sumber data ini. Anda harus melampirkan rahasia ke AWS IoT Greengrass komponen gateway SiteWise Edge Anda untuk menggunakannya untuk otentikasi sumber data. Untuk informasi selengkapnya, lihat [Konfigurasikan otentikasi sumber data untuk Edge SiteWise](configure-source-authentication-ggv2.md).
**Tip**
Server data Anda mungkin memiliki opsi bernama **Izinkan login anonim**. Jika opsi ini adalah **Ya**, maka sumber Anda tidak memerlukan otentikasi.
1. *(Opsional) Anda dapat mengaktifkan awalan aliran data dengan memilih **Aktifkan awalan aliran data -** opsional.*
1. Masukkan **awalan aliran Data**. Gateway SiteWise Edge menambahkan awalan ini ke semua aliran data dari sumber ini. Gunakan awalan aliran data untuk membedakan antara aliran data yang memiliki nama yang sama dari sumber yang berbeda. Setiap aliran data harus memiliki nama unik dalam akun Anda.
1. (Opsional) Pilih opsi **konversi tipe data** untuk mengonversi tipe data OPC UA yang tidak didukung menjadi string sebelum memasukkannya ke dalam. AWS IoT SiteWise Konversi nilai array dengan tipe data sederhana ke string JSON dan tipe DateTime data ke string ISO 8601. Untuk informasi selengkapnya, lihat [Mengonversi tipe data yang tidak didukung](string-conversion.md).
1. Pilih **pemicu perubahan data default** untuk node yang tidak terkandung dalam grup properti yang ditentukan pengguna. Pemicu perubahan data default menentukan kapan server OPC UA mengirimkan nilai yang diperbarui ke gateway. Anda dapat memilih salah satu opsi berikut:
+ **Status** — untuk menerima data hanya ketika status berubah.
+ **StatusValue**— untuk menerima data ketika status atau nilai berubah.
+ **StatusValueTimestamp**— untuk menerima data ketika status, nilai, atau stempel waktu berubah.
1. (Opsional) Pada gateway V3 berkemampuan MQTT, Anda dapat menggunakan konfigurasi Discovery untuk **mengonfigurasi proses penemuan simpul** OPC UA. Konfigurasi Discovery menggantikan sistem file penggantian konfigurasi sebelumnya untuk opsi ini dengan pengaturan berbasis konsol yang diperbarui secara dinamis tanpa perlu memulai ulang gateway.
**catatan**
**Pemicu perubahan data default** memerlukan versi 3.1.0 atau yang lebih baru dari komponen kolektor SiteWise IoT OPC UA. Untuk informasi selengkapnya, lihat [Perbarui versi AWS IoT SiteWise komponen](manage-gateways-ggv2.md#update-component-version).
1. Untuk **Jumlah permintaan penelusuran bersamaan maksimum**, masukkan jumlah maksimum permintaan penelusuran yang dapat ditangani oleh server OPC UA Anda secara bersamaan. Anda dapat mengonfigurasi hingga 500 permintaan penelusuran bersamaan per sumber data.
1. Untuk **jumlah node maksimum per permintaan penelusuran**, masukkan jumlah node maksimum untuk mengirim setiap permintaan penelusuran ke server OPC UA. Anda dapat mengirim hingga 1.000 node per permintaan penelusuran.
1. Pilih **Hindari loop pohon simpul** untuk mencegah gateway terjebak dalam referensi melingkar saat menjelajahi struktur server OPC UA. Saat dipilih, gateway melacak lokasi yang dikunjungi untuk menghindari loop tak terbatas yang dapat terjadi ketika node server saling mereferensikan dalam pola melingkar.
1. Pilih **Aktifkan traversal node** untuk memungkinkan gateway menjelajahi struktur lengkap server OPC UA Anda untuk menemukan semua titik data yang tersedia dari peralatan dan perangkat Anda. Saat dipilih, gateway menavigasi organisasi data peralatan Anda di luar level root untuk menemukan semua sensor, kontrol, dan titik pengukuran secara otomatis.
1. Pilih **Aktifkan penemuan berkala** untuk menjalankan operasi penemuan secara otomatis secara berkala untuk mendeteksi perubahan dalam struktur server OPC UA. Saat dipilih, gateway terus memantau peralatan atau titik data yang baru ditambahkan, memastikan mereka terdeteksi secara otomatis dan tersedia untuk pengumpulan data.
1. Untuk **interval penemuan periodik**, atur interval waktu antara operasi penemuan otomatis saat penemuan periodik berjalan. Interval penemuan periodik minimum adalah 30 detik dan maksimum adalah 30 hari.
1. Untuk **node Maksimum yang ditemukan per interval**, atur jumlah maksimum node yang harus ditemukan per interval penemuan. Ini membantu mengontrol beban pada gateway dan server OPC UA selama operasi penemuan.
1. (Opsional) Untuk **grup Properti**, pilih **Tambahkan grup baru**.
1. Masukkan **Nama** untuk grup properti.
1. Untuk **Properti**:
1. Untuk **jalur Node**, tambahkan filter node OPC UA untuk membatasi jalur OPC UA mana yang diunggah. AWS IoT SiteWise Formatnya mirip dengan **Node ID untuk seleksi**.
1. Untuk **pengaturan Grup**, lakukan hal berikut:
1. Untuk **pengaturan kualitas Data**, pilih jenis kualitas data yang ingin Anda konsumsi oleh AWS IoT SiteWise Kolektor.
1. Untuk **pengaturan mode Pindai**, konfigurasikan properti langganan standar menggunakan **mode Pindai**. Anda dapat memilih **Subscribe** atau **Poll**. Untuk informasi selengkapnya tentang mode pemindaian, lihat[Filter rentang konsumsi data dengan OPC UA](opcua-data-acquisition.md).
------
#### [ Subscribe ]
**Untuk mengirim setiap titik data**
1. Pilih **Berlangganan** dan atur yang berikut ini:
1. **[Pemicu perubahan data](https://reference.opcfoundation.org/v104/Core/docs/Part4/7.17.2/)** — Kondisi yang memulai peringatan perubahan data.
1. **[Ukuran antrian langganan](https://reference.opcfoundation.org/v104/Core/docs/Part4/7.16/)** — Kedalaman antrian pada server OPC UA untuk metrik tertentu di mana pemberitahuan untuk item yang dipantau diantrian.
1. **[Interval penerbitan langganan](https://reference.opcfoundation.org/v104/Core/docs/Part4/5.13.2/)** — Interval (dalam milidetik) siklus penerbitan yang ditentukan saat langganan dibuat.
1. **Interval snapshot - *Opsional*** - Pengaturan batas waktu frekuensi snapshot untuk memastikan bahwa AWS IoT SiteWise Edge menyerap aliran data yang stabil.
1. **Tingkat pemindaian** — Tingkat yang Anda inginkan gateway SiteWise Edge untuk membaca register Anda. AWS IoT SiteWise secara otomatis menghitung tingkat pemindaian minimum yang diijinkan untuk gateway SiteWise Edge Anda.
1. **Timestamp — Stempel** waktu untuk disertakan dengan titik data OPC UA Anda. Anda dapat menggunakan stempel waktu server atau stempel waktu perangkat Anda.
**catatan**
Gunakan versi 2.5.0 atau yang lebih baru dari komponen kolektor SiteWise IoT OPC UA. Jika Anda menggunakan fitur stempel waktu dengan versi sebelumnya, pembaruan konfigurasi gagal. Untuk informasi selengkapnya, lihat [Perbarui versi AWS IoT SiteWise komponen](manage-gateways-ggv2.md#update-component-version).
1. Dalam **pengaturan Deadband**, konfigurasikan tipe **Deadband**. Jenis deadband mengontrol data apa yang dikirim sumber Anda ke Anda AWS IoT SiteWise, dan data apa yang dibuang. Untuk informasi lebih lanjut tentang pengaturan deadband, lihat[Filter rentang konsumsi data dengan OPC UA](opcua-data-acquisition.md).
+ **Tidak ada** — Server terkait mengirimkan semua titik data untuk grup properti ini.
+ **Persentase** — Server terkait hanya mengirimkan data yang berada di luar persentase tertentu dari rentang data. Rentang ini dihitung oleh server berdasarkan unit teknik minimum dan maksimum yang ditentukan untuk setiap node. Jika server tidak mendukung persentase deadband atau tidak memiliki unit teknik yang ditentukan, gateway menghitung rentang menggunakan nilai minimum dan maksimum yang disediakan di bawah ini.
+ **Absolute** — Server terkait hanya mengirimkan data yang berada di luar rentang tertentu.
1. Tetapkan **nilai Deadband** sebagai persentase rentang data ke deadband.
1. (Opsional) Tentukan minimum dan maksimum untuk rentang deadband menggunakan **Rentang minimum - *opsional*** dan **Rentang maksimum - *opsional***.
------
#### [ Poll ]
**Untuk mengirim titik data pada interval tertentu**
+ Pilih **Poll** dan atur yang berikut:
1. **Tingkat pemindaian** — Tingkat yang Anda inginkan gateway SiteWise Edge untuk membaca register Anda. AWS IoT SiteWise secara otomatis menghitung tingkat pemindaian minimum yang diijinkan untuk gateway SiteWise Edge Anda.
1. **Timestamp — Stempel** waktu untuk disertakan dengan titik data OPC UA Anda. Anda dapat menggunakan stempel waktu server atau stempel waktu perangkat Anda.
**catatan**
Gunakan versi 3.1.0 atau yang lebih baru dari komponen kolektor SiteWise IoT OPC UA. Jika Anda menggunakan fitur stempel waktu dengan versi sebelumnya, pembaruan konfigurasi gagal. Untuk informasi selengkapnya, lihat [Perbarui versi AWS IoT SiteWise komponen](manage-gateways-ggv2.md#update-component-version).
**catatan**
**Pengaturan deadband** berlaku ketika Anda telah memilih **Berlangganan** dalam **pengaturan mode Pindai**.
------
1. Pilih **Simpan**.
## Konfigurasikan sumber OPC UA ()AWS CLI
Anda dapat menentukan sumber data OPC UA untuk gateway SiteWise Edge menggunakan file. AWS CLI Untuk melakukan ini, buat file JSON konfigurasi kemampuan OPC UA dan gunakan [ update-gateway-capability-configuration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsitewise/update-gateway-capability-configuration.html#)perintah untuk memperbarui konfigurasi gateway SiteWise Edge. Anda harus menentukan semua sumber OPC UA Anda dalam satu konfigurasi kemampuan.
------
#### [ MQTT-enabled, V3 gateway ]
Kemampuan ini memiliki namespace berikut.
+ `iotsitewise:opcuacollector:3`
```
{
"sources": [
{
"name": "string",
"endpoint": {
"certificateTrust": {
"type": "TrustAny" | "X509",
"certificateBody": "string",
"certificateChain": "string",
},
"endpointUri": "string",
"securityPolicy": "NONE" | "BASIC128_RSA15" | "BASIC256" | "BASIC256_SHA256" | "AES128_SHA256_RSAOAEP" | "AES256_SHA256_RSAPSS",
"messageSecurityMode": "NONE" | "SIGN" | "SIGN_AND_ENCRYPT",
"identityProvider": {
"type": "Anonymous" | "Username",
"usernameSecretArn": "string"
},
"nodeFilterRules": [
{
"action": "INCLUDE",
"definition": {
"type": "OpcUaRootPath",
"rootPath": "string"
}
}
]
},
"measurementDataStreamPrefix": "string",
"typeConversions": {
"array": "JsonArray",
"datetime": "ISO8601String"
},
"destination": {
{
"type":"MQTT"
}
},
"defaultPropertyGroupConfig": {
"dataChangeTrigger": "STATUS" | "STATUS_VALUE" | "STATUS_VALUE_TIMESTAMP"
},
"discoveryConfig": {
"enableNodeTraversal": true | false,
"avoidNodeTreeLoops": true | false,
"maxConcurrentBrowseRequests": integer,
"maxNodesPerBrowseRequest": integer,
"periodicDiscovery": {
"interval": "string",
"maxNodesDiscoveredPerInterval": integer
}
},
"propertyGroups": [
{
"name": "string",
"nodeFilterRuleDefinitions": [
{
"type": "OpcUaRootPath",
"rootPath": "string"
}
],
"deadband": {
"type": "PERCENT" | "ABSOLUTE",
"value": double,
"eguMin": double,
"eguMax": double,
"timeoutMilliseconds": integer
},
"scanMode": {
"type": "EXCEPTION" | "POLL",
"rate": integer,
"timestampToReturn": "SOURCE_TIME" | "SERVER_TIME"
},
"dataQuality": {
"allowGoodQuality": true | false,
"allowBadQuality": true | false,
"allowUncertainQuality": true | false
},
"subscription": {
"dataChangeTrigger": "STATUS" | "STATUS_VALUE" | "STATUS_VALUE_TIMESTAMP",
"queueSize": integer,
"publishingIntervalMilliseconds": integer,
"snapshotFrequencyMilliseconds": integer
}
}
]
}
]
}
```
------
#### [ Classic streams, V2 gateway ]
Kemampuan ini memiliki namespace berikut.
+ `iotsitewise:opcuacollector:2`
Sintaksis Permintaan
```
{
"sources": [
{
"name": "string",
"endpoint": {
"certificateTrust": {
"type": "TrustAny" | "X509",
"certificateBody": "string",
"certificateChain": "string",
},
"endpointUri": "string",
"securityPolicy": "NONE" | "BASIC128_RSA15" | "BASIC256" | "BASIC256_SHA256" | "AES128_SHA256_RSAOAEP" | "AES256_SHA256_RSAPSS",
"messageSecurityMode": "NONE" | "SIGN" | "SIGN_AND_ENCRYPT",
"identityProvider": {
"type": "Anonymous" | "Username",
"usernameSecretArn": "string"
},
"nodeFilterRules": [
{
"action": "INCLUDE",
"definition": {
"type": "OpcUaRootPath",
"rootPath": "string"
}
}
]
},
"measurementDataStreamPrefix": "string",
"typeConversions": {
"array": "JsonArray",
"datetime": "ISO8601String"
},
"destination": {
"type": "StreamManager",
"streamName": "string",
"streamBufferSize": integer,
},
"propertyGroups": [
{
"name": "string",
"nodeFilterRuleDefinitions": [
{
"type": "OpcUaRootPath",
"rootPath": "string"
}
],
"deadband": {
"type": "PERCENT" | "ABSOLUTE",
"value": double,
"eguMin": double,
"eguMax": double,
"timeoutMilliseconds": integer
},
"scanMode": {
"type": "EXCEPTION" | "POLL",
"rate": integer,
"timestampToReturn": "SOURCE_TIME" | "SERVER_TIME"
},
"dataQuality": {
"allowGoodQuality": true | false,
"allowBadQuality": true | false,
"allowUncertainQuality": true | false
},
"subscription": {
"dataChangeTrigger": "STATUS" | "STATUS_VALUE" | "STATUS_VALUE_TIMESTAMP",
"queueSize": integer,
"publishingIntervalMilliseconds": integer,
"snapshotFrequencyMilliseconds": integer
}
}
]
}
]
}
```
------
### Isi permintaan
`sources`
Daftar struktur definisi sumber OPC UA yang masing-masing berisi informasi berikut:
`name`
Nama yang unik dan ramah untuk sumbernya.
`endpoint`
Struktur endpoint yang berisi informasi berikut:
`certificateTrust`
Struktur kebijakan kepercayaan sertifikat yang berisi informasi berikut:
`type`
Mode kepercayaan sertifikat untuk sumbernya. Pilih salah satu cara berikut:
+ `TrustAny`— Gateway SiteWise Edge mempercayai sertifikat apa pun saat terhubung ke sumber OPC UA.
+ `X509`— Gateway SiteWise Edge mempercayai sertifikat X.509 saat terhubung ke sumber OPC UA. Jika Anda memilih opsi ini, Anda harus menentukan `certificateBody``certificateTrust`. Anda juga dapat menentukan `certificateChain` dalam`certificateTrust`.
`certificateBody`
(Opsional) Badan sertifikat X.509.
Bidang ini diperlukan jika Anda memilih `X509` untuk `type` masuk`certificateTrust`.
`certificateChain`
(Opsional) Rantai kepercayaan untuk sertifikat X.509.
Bidang ini hanya digunakan jika Anda memilih `X509` untuk `type` masuk`certificateTrust`.
`endpointUri`
Titik akhir lokal dari sumber OPC UA. Misalnya, titik akhir lokal Anda mungkin terlihat seperti`opc.tcp://203.0.113.0:49320`.
`securityPolicy`
Kebijakan keamanan yang digunakan sehingga Anda dapat mengamankan pesan yang dibaca dari sumber OPC UA. Pilih salah satu cara berikut:
+ `NONE`— Gateway SiteWise Edge tidak mengamankan pesan dari sumber OPC UA. Kami menyarankan Anda memilih kebijakan keamanan yang berbeda. Jika Anda memilih opsi ini, Anda juga harus memilih `NONE` untuk`messageSecurityMode`.
+ `BASIC256_SHA256`- Kebijakan `Basic256Sha256` keamanan.
+ `AES128_SHA256_RSAOAEP`- Kebijakan `Aes128_Sha256_RsaOaep` keamanan.
+ `AES256_SHA256_RSAPSS`- Kebijakan `Aes256_Sha256_RsaPss` keamanan.
+ `BASIC128_RSA15`— (Usang) Kebijakan `Basic128Rsa15` keamanan tidak digunakan lagi dalam spesifikasi OPC UA karena tidak lagi dianggap aman. Kami menyarankan Anda memilih kebijakan keamanan yang berbeda. Untuk informasi lebih lanjut, lihat [Profil SecurityPolicy — Basic128Rsa15](https://profiles.opcfoundation.org/profile/1532).
+ `BASIC256`— (Usang) Kebijakan `Basic256` keamanan tidak digunakan lagi dalam spesifikasi OPC UA karena tidak lagi dianggap aman. Kami menyarankan Anda memilih kebijakan keamanan yang berbeda. Untuk informasi lebih lanjut, lihat [SecurityPolicy — Basic256](https://profiles.opcfoundation.org/profile/1536).
Jika Anda memilih kebijakan keamanan selain`NONE`, Anda harus memilih `SIGN` atau `SIGN_AND_ENCRYPT` untuk`messageSecurityMode`. Anda juga harus mengonfigurasi server sumber Anda untuk mempercayai gateway SiteWise Edge. Untuk informasi selengkapnya, lihat [Siapkan server OPC UA untuk mempercayai gateway AWS IoT SiteWise Edge](enable-source-trust.md).
`messageSecurityMode`
Mode keamanan pesan yang digunakan untuk mengamankan koneksi ke sumber OPC UA. Pilih salah satu cara berikut:
+ `NONE`— Gateway SiteWise Edge tidak mengamankan koneksi ke sumber OPC UA. Kami menyarankan Anda memilih mode keamanan pesan yang berbeda. Jika Anda memilih opsi ini, Anda juga harus memilih `NONE` untuk`securityPolicy`.
+ `SIGN`— Data dalam perjalanan antara gateway SiteWise Edge dan sumber OPC UA ditandatangani tetapi tidak dienkripsi.
+ `SIGN_AND_ENCRYPT`— Data dalam perjalanan antara gateway dan sumber OPC UA ditandatangani dan dienkripsi.
Jika Anda memilih mode keamanan pesan selain`NONE`, Anda harus memilih `securityPolicy` selain`NONE`. Anda juga harus mengonfigurasi server sumber Anda untuk mempercayai gateway SiteWise Edge. Untuk informasi selengkapnya, lihat [Siapkan server OPC UA untuk mempercayai gateway AWS IoT SiteWise Edge](enable-source-trust.md).
`identityProvider`
Struktur penyedia identitas yang berisi informasi berikut:
`type`
Jenis kredensyal otentikasi yang diperlukan oleh sumber. Pilih salah satu cara berikut:
+ `Anonymous`— Sumber tidak memerlukan otentikasi untuk terhubung.
+ `Username`— Sumber membutuhkan nama pengguna dan kata sandi untuk terhubung. Jika Anda memilih opsi ini, Anda harus menentukan `usernameSecretArn``identityProvider`.
`usernameSecretArn`
(Opsional) ARN rahasia. AWS Secrets Manager Gateway SiteWise Edge menggunakan kredensyal otentikasi dalam rahasia ini ketika terhubung ke sumber ini. Anda harus melampirkan rahasia ke SiteWise konektor IoT gateway SiteWise Edge Anda untuk menggunakannya untuk otentikasi sumber. Untuk informasi selengkapnya, lihat [Konfigurasikan otentikasi sumber data untuk Edge SiteWise](configure-source-authentication-ggv2.md).
Bidang ini diperlukan jika Anda memilih `Username` untuk `type` masuk`identityProvider`.
`nodeFilterRules`
Daftar struktur aturan filter node yang menentukan jalur aliran data OPC UA untuk dikirim ke AWS Cloud. Anda dapat menggunakan filter node untuk mengurangi waktu startup dan penggunaan CPU gateway SiteWise Edge dengan hanya menyertakan jalur ke data yang Anda modelkan AWS IoT SiteWise. Secara default, gateway SiteWise Edge mengunggah semua jalur OPC UA kecuali yang dimulai dengan. `/Server/` Untuk menentukan filter node OPC UA, Anda dapat menggunakan jalur simpul dan `**` karakter wildcard `*` dan. Untuk informasi selengkapnya, lihat [Gunakan filter node OPC UA di SiteWise Edge](opc-ua-node-filters.md).
Setiap struktur dalam daftar harus berisi informasi berikut:
`action`
Tindakan untuk aturan filter node ini. Anda dapat memilih opsi berikut:
+ `INCLUDE`— Gateway SiteWise Edge hanya mencakup aliran data yang cocok dengan aturan ini.
`definition`
Struktur aturan filter node yang berisi informasi berikut:
`type`
Jenis jalur filter node untuk aturan ini. Anda dapat memilih opsi berikut:
+ `OpcUaRootPath`— Gateway SiteWise Edge mengevaluasi jalur filter node ini terhadap root hierarki jalur OPC UA.
`rootPath`
Jalur filter node untuk mengevaluasi terhadap akar hierarki jalur OPC UA. Jalan ini harus dimulai dengan`/`.
`measurementDataStreamPrefix`
Sebuah string untuk ditambahkan ke semua aliran data dari sumber. Gateway SiteWise Edge menambahkan awalan ini ke semua aliran data dari sumber ini. Gunakan awalan aliran data untuk membedakan antara aliran data yang memiliki nama yang sama dari sumber yang berbeda. Setiap aliran data harus memiliki nama unik dalam akun Anda.
`typeConversions`
Jenis konversi yang tersedia untuk tipe data OPC UA yang tidak didukung. Setiap tipe data dikonversi menjadi string. Untuk informasi selengkapnya, lihat [Mengonversi tipe data yang tidak didukung](string-conversion.md).
`array`
Tipe data array sederhana yang dikonversi ke string. Anda dapat memilih opsi berikut:
+ `JsonArray`— Menunjukkan bahwa Anda memilih untuk mengonversi tipe data array sederhana Anda menjadi string.
`datetime`
Tipe DateTime data yang dikonversi ke string. Anda dapat memilih opsi berikut:
+ `ISO8601String`— Menunjukkan bahwa Anda memilih untuk mengonversi tipe data ISO 8601 menjadi string.
`destination`
Konfigurasi untuk tujuan tag OPC UA. Aliran klasik, v2 dan berkemampuan MQTT, gateway V3 memiliki konfigurasi yang berbeda untuk tujuan.
`type`
Jenis tujuan.
`streamName`— *hanya untuk aliran Klasik, gateway V2*
Nama sungai. Nama stream harus unik.
`streamBufferSize`— *hanya untuk aliran Klasik, gateway V2*
Ukuran buffer aliran. Ini penting untuk mengelola aliran data dari sumber OPC UA.
`defaultPropertyGroupConfig`- Hanya *gateway V3 yang diaktifkan MQTT*
(Opsional) Konfigurasi untuk grup properti default. Grup properti default berisi semua node yang tidak terkandung dalam grup properti yang ditentukan pengguna.
`dataChangeTrigger`
Pemicu perubahan data default untuk digunakan dalam grup properti default. Nilai yang valid adalah `STATUS_VALUE_TIMESTAMP`, `STATUS_VALUE`, atau `STATUS`.
`defaultPropertyGroupConfig`memerlukan versi 3.1.0 atau yang lebih baru dari komponen kolektor SiteWise IoT OPC UA. Untuk informasi selengkapnya, lihat [Perbarui versi AWS IoT SiteWise komponen](manage-gateways-ggv2.md#update-component-version).
`discoveryConfig`- Hanya *gateway V3 yang diaktifkan MQTT*
(Opsional) Konfigurasi untuk proses penemuan node OPC UA.
`enableNodeTraversal`
Menentukan apakah akan melanjutkan melintasi node anak dari simpul akar yang ditentukan oleh filter node sumber data ini. Saat diatur ke`false`, penemuan berhenti di simpul akar.
`avoidNodeTreeLoops`
Menentukan apakah untuk menghindari loop tak terbatas selama proses penjelajahan node OPC UA. Ketika diatur ke`true`, gateway melacak node yang dikunjungi untuk mencegah referensi melingkar.
`maxConcurrentBrowseRequests`
Jumlah maksimum permintaan penelusuran bersamaan yang dapat ditangani oleh server OPC UA Anda secara bersamaan. Rentang yang valid adalah 1 hingga 500.
`maxNodesPerBrowseRequest`
Jumlah maksimum node untuk mengirim setiap permintaan penelusuran ke server OPC UA. Rentang yang valid adalah 1 hingga 1.000.
`periodicDiscovery`
Konfigurasi untuk menjalankan penemuan secara berkala pada interval tetap. Penemuan berkala diaktifkan saat konfigurasi ini disediakan.
`interval`
Jumlah waktu antara operasi penemuan periodik. Anda dapat menggunakan `m` selama beberapa menit, `h` berjam-jam, dan `d` berhari-hari. Misalnya, `90m` atau `1h`. Interval minimum adalah 30 detik.
`maxNodesDiscoveredPerInterval`
Jumlah maksimum node yang harus ditemukan per interval penemuan. Ini membantu mengontrol beban pada gateway dan server OPC UA.
`periodicDiscovery`memerlukan versi 3.1.0 atau yang lebih baru dari komponen kolektor SiteWise IoT OPC UA. Untuk informasi selengkapnya, lihat [Perbarui versi AWS IoT SiteWise komponen](manage-gateways-ggv2.md#update-component-version).
Jika penemuan berputar tanpa batas, aktifkan`avoidNodeTreeLoops`. Pantau kemajuan penemuan dalam CloudWatch log di bawah `aws.iot.SiteWiseOpcUaCollector` komponen.
`propertyGroups`
(Opsional) Daftar grup properti yang menentukan `deadband` dan `scanMode` diminta oleh protokol.
`name`
Nama grup properti. Ini harus menjadi pengidentifikasi unik.
`deadband`
`deadband`Nilai mendefinisikan perubahan minimum dalam nilai titik data yang harus terjadi sebelum data dikirim ke cloud. Itu berisi informasi berikut:
`type`
Jenis deadband yang didukung. Anda dapat memilih dari opsi berikut:
+ `ABSOLUTE`— Nilai tetap yang menentukan perubahan absolut minimum yang diperlukan untuk mempertimbangkan titik data yang cukup signifikan untuk dikirim ke cloud.
+ `PERCENT`— Nilai dinamis yang menentukan perubahan minimum yang diperlukan sebagai persentase dari nilai titik data terakhir yang dikirim. Jenis deadband ini berguna ketika nilai data bervariasi secara signifikan dari waktu ke waktu.
`value`
Nilai deadband. `type`Kapan`ABSOLUTE`, nilai ini adalah ganda tanpa unit. `type`Kapan`PERCENT`, nilai ini adalah ganda antara `1` dan`100`.
`eguMin`
(Opsional) Unit teknik minimum saat menggunakan `PERCENT` deadband. Anda mengatur ini jika server OPC UA tidak memiliki unit teknik yang dikonfigurasi.
`eguMax`
(Opsional) Unit teknik maksimum saat menggunakan `PERCENT` deadband. Anda mengatur ini jika server OPC UA tidak memiliki unit teknik yang dikonfigurasi.
`timeoutMilliseconds`
Durasi dalam milidetik sebelum batas waktu. Minimal adalah`100`.
`scanMode`
`scanMode`Struktur yang berisi informasi berikut:
`type`
Jenis yang didukung dari`scanMode`. Nilai yang diterima adalah `POLL` dan`EXCEPTION`.
`rate`
Interval pengambilan sampel untuk mode pemindaian.
`timestampToReturn`
Sumber stempel waktu. Anda dapat memilih dari opsi berikut:
+ `SOURCE_TIME`— Menggunakan stempel waktu dari perangkat Anda.
+ `SERVER_TIME`— Menggunakan stempel waktu dari server Anda.
Gunakan `TimestampToReturn` dengan versi 2.5.0 atau yang lebih baru dari komponen kolektor SiteWise IoT OPC UA. Jika Anda menggunakan fitur ini dengan versi sebelumnya, pembaruan konfigurasi gagal. Untuk informasi selengkapnya, lihat [Perbarui versi AWS IoT SiteWise komponen](manage-gateways-ggv2.md#update-component-version).
`nodeFilterRuleDefinitions`
(Opsional) Daftar jalur simpul untuk disertakan dalam grup properti. Grup properti tidak dapat tumpang tindih. Jika Anda tidak menentukan nilai untuk bidang ini, grup berisi semua jalur di bawah root, dan Anda tidak dapat membuat grup properti tambahan. `nodeFilterRuleDefinitions`Struktur berisi informasi berikut:
`type`
`OpcUaRootPath`adalah satu-satunya tipe yang didukung. Ini menentukan bahwa nilai `rootPath` adalah jalur relatif terhadap akar ruang penjelajahan OPC UA.
`rootPath`
Daftar yang dibatasi koma yang menentukan jalur (relatif terhadap root) untuk disertakan dalam grup properti.
### Contoh konfigurasi kemampuan tambahan untuk aliran Klasik, gateway V2 ()AWS CLI
Contoh berikut mendefinisikan konfigurasi kemampuan gateway OPC UA SiteWise Edge dari payload yang disimpan dalam file JSON.
```
aws iotsitewise update-gateway-capability-configuration \
--capability-namespace "iotsitewise:opcuacollector:2" \
--capability-configuration file://opc-ua-configuration.json
```
**Example : Konfigurasi sumber OPC UA**
`opc-ua-configuration.json`File berikut mendefinisikan konfigurasi sumber OPC UA dasar dan tidak aman.
```
{
"sources": [
{
"name": "Wind Farm #1",
"endpoint": {
"certificateTrust": {
"type": "TrustAny"
},
"endpointUri": "opc.tcp://203.0.113.0:49320",
"securityPolicy": "NONE",
"messageSecurityMode": "NONE",
"identityProvider": {
"type": "Anonymous"
},
"nodeFilterRules": []
},
"measurementDataStreamPrefix": ""
}
]
}
```
**Example : Konfigurasi sumber OPC UA dengan grup properti yang ditentukan**
`opc-ua-configuration.json`File berikut mendefinisikan konfigurasi sumber OPC UA dasar dan tidak aman dengan grup properti yang ditentukan.
```
{
"sources": [
{
"name": "source1",
"endpoint": {
"certificateTrust": {
"type": "TrustAny"
},
"endpointUri": "opc.tcp://10.0.0.9:49320",
"securityPolicy": "NONE",
"messageSecurityMode": "NONE",
"identityProvider": {
"type": "Anonymous"
},
"nodeFilterRules": [
{
"action": "INCLUDE",
"definition": {
"type": "OpcUaRootPath",
"rootPath": "/Utilities/Tank"
}
}
]
},
"measurementDataStreamPrefix": "propertyGroups",
"propertyGroups": [
{
"name": "Deadband_Abs_5",
"nodeFilterRuleDefinitions": [
{
"type": "OpcUaRootPath",
"rootPath": "/Utilities/Tank/Temperature/TT-001"
},
{
"type": "OpcUaRootPath",
"rootPath": "/Utilities/Tank/Temperature/TT-002"
}
],
"deadband": {
"type":"ABSOLUTE",
"value": 5.0,
"timeoutMilliseconds": 120000
}
},
{
"name": "Polling_10s",
"nodeFilterRuleDefinitions": [
{
"type": "OpcUaRootPath",
"rootPath": "/Utilities/Tank/Pressure/PT-001"
}
],
"scanMode": {
"type": "POLL",
"rate": 10000
}
},
{
"name": "Percent_Deadband_Timeout_90s",
"nodeFilterRuleDefinitions": [
{
"type": "OpcUaRootPath",
"rootPath": "/Utilities/Tank/Flow/FT-*"
}
],
"deadband": {
"type":"PERCENT",
"value": 5.0,
"eguMin": -100,
"eguMax": 100,
"timeoutMilliseconds": 90000
}
}
]
}
]
}
```
**Example : Konfigurasi sumber OPC UA dengan properti**
Contoh JSON berikut untuk `opc-ua-configuration.json` mendefinisikan konfigurasi sumber OPC UA dengan properti berikut:
+ Mempercayai sertifikat apa pun.
+ Menggunakan kebijakan `BASIC256` keamanan untuk mengamankan pesan.
+ Menggunakan `SIGN_AND_ENCRYPT` mode untuk mengamankan koneksi.
+ Menggunakan kredensi otentikasi yang disimpan dalam rahasia Secrets Manager.
+ Memfilter aliran data kecuali yang jalurnya dimulai dengan`/WindFarm/2/WindTurbine/`.
+ Menambahkan `/Washington` ke awal setiap jalur aliran data untuk membedakan antara “Wind Farm \$12" dan “Wind Farm \$12" di area lain.
```
{
"sources": [
{
"name": "Wind Farm #2",
"endpoint": {
"certificateTrust": {
"type": "TrustAny"
},
"endpointUri": "opc.tcp://203.0.113.1:49320",
"securityPolicy": "BASIC256",
"messageSecurityMode": "SIGN_AND_ENCRYPT",
"identityProvider": {
"type": "Username",
"usernameSecretArn": "arn:aws:secretsmanager:region:123456789012:secret:greengrass-windfarm2-auth-1ABCDE"
},
"nodeFilterRules": [
{
"action": "INCLUDE",
"definition": {
"type": "OpcUaRootPath",
"rootPath": "/WindFarm/2/WindTurbine/"
}
}
]
},
"measurementDataStreamPrefix": "/Washington"
}
]
}
```
**Example : Konfigurasi sumber OPC UA dengan kepercayaan sertifikat**
Contoh JSON berikut untuk `opc-ua-configuration.json` mendefinisikan konfigurasi sumber OPC UA dengan properti berikut:
+ Mempercayai sertifikat X.509 yang diberikan.
+ Menggunakan kebijakan `BASIC256` keamanan untuk mengamankan pesan.
+ Menggunakan `SIGN_AND_ENCRYPT` mode untuk mengamankan koneksi.
```
{
"sources": [
{
"name": "Wind Farm #3",
"endpoint": {
"certificateTrust": {
"type": "X509",
"certificateBody": "-----BEGIN CERTIFICATE-----
MIICiTCCAfICCQD6m7oRw0uXOjANBgkqhkiG9w
0BAQUFADCBiDELMAkGA1UEBhMCVVMxCzAJBgNVBAgTAldBMRAwDgYDVQQHEwdTZ
WF0dGxlMQ8wDQYDVQQKEwZBbWF6b24xFDASBgNVBAsTC0lBTSBDb25zb2xlMRIw
EAYDVQQDEwlUZXN0Q2lsYWMxHzAdBgkqhkiG9w0BCQEWEG5vb25lQGFtYXpvbi5
jb20wHhcNMTEwNDI1MjA0NTIxWhcNMTIwNDI0MjA0NTIxWjCBiDELMAkGA1UEBh
MCVVMxCzAJBgNVBAgTAldBMRAwDgYDVQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBb
WF6b24xFDASBgNVBAsTC0lBTSBDb25zb2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMx
HzAdBgkqhkiG9w0BCQEWEG5vb25lQGFtYXpvbi5jb20wgZ8wDQYJKoZIhvcNAQE
BBQADgY0AMIGJAoGBAMaK0dn+a4GmWIWJ21uUSfwfEvySWtC2XADZ4nB+BLYgVI
k60CpiwsZ3G93vUEIO3IyNoH/f0wYK8m9TrDHudUZg3qX4waLG5M43q7Wgc/MbQ
ITxOUSQv7c7ugFFDzQGBzZswY6786m86gpEIbb3OhjZnzcvQAaRHhdlQWIMm2nr
AgMBAAEwDQYJKoZIhvcNAQEFBQADgYEAtCu4nUhVVxYUntneD9+h8Mg9q6q+auN
KyExzyLwaxlAoo7TJHidbtS4J5iNmZgXL0FkbFFBjvSfpJIlJ00zbhNYS5f6Guo
EDmFJl0ZxBHjJnyp378OD8uTs7fLvjx79LjSTbNYiytVbZPQUQ5Yaxu2jXnimvw
3rrszlaEXAMPLE=
-----END CERTIFICATE-----",
"certificateChain": "-----BEGIN CERTIFICATE-----
MIICiTCCAfICCQD6m7oRw0uXOjANBgkqhkiG9w
0BAQUFADCBiDELMAkGA1UEBhMCVVMxCzAJBgNVBAgTAldBMRAwDgYDVQQHEwdTZ
WF0dGxlMQ8wDQYDVQQKEwZBbWF6b24xFDASBgNVBAsTC0lBTSBDb25zb2xlMRIw
EAYDVQQDEwlUZXN0Q2lsYWMxHzAdBgkqhkiG9w0BCQEWEG5vb25lQGFtYXpvbi5
jb20wHhcNMTEwNDI1MjA0NTIxWhcNMTIwNDI0MjA0NTIxWjCBiDELMAkGA1UEBh
MCVVMxCzAJBgNVBAgTAldBMRAwDgYDVQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBb
WF6b24xFDASBgNVBAsTC0lBTSBDb25zb2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMx
HzAdBgkqhkiG9w0BCQEWEG5vb25lQGFtYXpvbi5jb20wgZ8wDQYJKoZIhvcNAQE
BBQADgY0AMIGJAoGBAMaK0dn+a4GmWIWJ21uUSfwfEvySWtC2XADZ4nB+BLYgVI
k60CpiwsZ3G93vUEIO3IyNoH/f0wYK8m9TrDHudUZg3qX4waLG5M43q7Wgc/MbQ
ITxOUSQv7c7ugFFDzQGBzZswY6786m86gpEIbb3OhjZnzcvQAaRHhdlQWIMm2nr
AgMBAAEwDQYJKoZIhvcNAQEFBQADgYEAtCu4nUhVVxYUntneD9+h8Mg9q6q+auN
KyExzyLwaxlAoo7TJHidbtS4J5iNmZgXL0FkbFFBjvSfpJIlJ00zbhNYS5f6Guo
EDmFJl0ZxBHjJnyp378OD8uTs7fLvjx79LjSTbNYiytVbZPQUQ5Yaxu2jXnimvw
3rrszlaEXAMPLE=
-----END CERTIFICATE-----"
},
"endpointUri": "opc.tcp://203.0.113.2:49320",
"securityPolicy": "BASIC256",
"messageSecurityMode": "SIGN_AND_ENCRYPT",
"identityProvider": {
"type": "Anonymous"
},
"nodeFilterRules": []
},
"measurementDataStreamPrefix": ""
}
]
}
```
# Siapkan server OPC UA untuk mempercayai gateway AWS IoT SiteWise Edge
Jika Anda memilih `messageSecurityMode` selain **None** saat mengonfigurasi sumber OPC UA Anda, Anda harus mengaktifkan server sumber Anda untuk mempercayai gateway AWS IoT SiteWise Edge. Gateway SiteWise Edge menghasilkan sertifikat yang mungkin diperlukan oleh server sumber Anda. Prosesnya bervariasi tergantung pada server sumber Anda. Untuk informasi selengkapnya, lihat dokumentasi untuk server Anda.
Prosedur berikut menguraikan langkah-langkah dasar.
**Untuk mengaktifkan server OPC UA untuk mempercayai gateway SiteWise Edge**
1. Buka antarmuka untuk mengonfigurasi server OPC UA Anda.
1. Masukkan nama pengguna dan kata sandi untuk administrator server OPC UA.
1. Temukan **Klien Tepercaya** di antarmuka, lalu pilih **AWS IoT SiteWise Gateway Client**.
1. Pilih **Kepercayaan**.
## Mengekspor sertifikat klien OPC UA
Beberapa server OPC UA memerlukan akses ke file sertifikat klien OPC UA untuk mempercayai gateway SiteWise Edge. Jika ini berlaku untuk server OPC UA Anda, Anda dapat menggunakan prosedur berikut untuk mengekspor sertifikat klien OPC UA dari gateway SiteWise Edge. Kemudian, Anda dapat mengimpor sertifikat di server OPC UA Anda.
**Untuk mengekspor file sertifikat klien OPC UA untuk sumber**
1. Jalankan perintah berikut untuk mengubah ke direktori yang berisi file sertifikat. Ganti *sitewise-work* dengan jalur penyimpanan lokal untuk folder *aws.iot.SiteWiseEdgeCollectorOpcua* kerja Greengrass dan *source-name* ganti dengan nama sumber data.
Secara default, folder */greengrass/v2/work/aws.iot.SiteWiseEdgeCollectorOpcua* kerja Greengrass ada di Linux dan seterusnya. *C:/greengrass/v2/work/aws.iot.SiteWiseEdgeCollectorOpcua* Microsoft Windows
```
cd /sitewise-work/source-name/opcua-certificate-store
```
1. Sertifikat klien OPC UA gateway SiteWise Edge untuk sumber ini ada di `aws-iot-opcua-client.pfx` file.
Jalankan perintah berikut untuk mengekspor sertifikat ke `.pem` file bernama`aws-iot-opcua-client-certificate.pem`.
```
keytool -exportcert -v -alias aws-iot-opcua-client -keystore aws-iot-opcua-client.pfx -storepass amazon -storetype PKCS12 -rfc > aws-iot-opcua-client-certificate.pem
```
1. Transfer file sertifikat,`aws-iot-opcua-client-certificate.pem`, dari gateway SiteWise Edge ke server OPC UA.
Untuk melakukannya, Anda dapat menggunakan perangkat lunak umum seperti `scp` program untuk mentransfer file menggunakan protokol SSH. Untuk informasi selengkapnya, lihat [Salinan aman](https://en.wikipedia.org/wiki/Secure_copy) di *Wikipedia*.
**catatan**
Jika gateway SiteWise Edge Anda berjalan di Amazon Elastic Compute Cloud (Amazon EC2) dan Anda menghubungkannya untuk pertama kalinya, Anda harus mengonfigurasi prasyarat untuk terhubung. Untuk informasi selengkapnya, lihat [Connect ke instans Linux menggunakan SSH](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/connect-to-linux-instance.html) di Panduan *Pengguna Amazon EC2*.
1. Impor file sertifikat,`aws-iot-opcua-client-certificate.pem`, di server OPC UA untuk mempercayai gateway SiteWise Edge. Langkah-langkah dapat bervariasi tergantung pada server sumber yang Anda gunakan. Konsultasikan dokumentasi untuk server.
# Filter rentang konsumsi data dengan OPC UA
Anda dapat mengontrol cara Anda menelan data dengan sumber OPC UA dengan menggunakan mode pemindaian dan rentang deadband. Fitur-fitur ini memungkinkan Anda mengontrol jenis data apa yang akan dikonsumsi, dan bagaimana serta kapan server dan gateway SiteWise Edge Anda bertukar informasi ini.
## Mengumpulkan atau menyaring data berdasarkan kualitas
Anda dapat mengonfigurasi pengaturan kualitas data Anda untuk mengontrol data apa yang dikumpulkan dari sumber OPC UA. Sumber data mencakup peringkat kualitas sebagai metadata saat mengirimkannya. Anda dapat memilih salah satu atau semua opsi berikut:
+ `Good`
+ `Bad`
+ `Uncertain`
### Menangani NaN atau nilai null
SiteWise Edge mendukung pengumpulan dan penanganan NaN dan nilai null.
+ *NaN (Bukan Angka): Merupakan hasil numerik* yang tidak terdefinisi atau tidak dapat direpresentasikan.
+ *Null:* Menunjukkan data yang hilang.
Kolektor IoT SiteWise OPC UA menangkap nilai NaN dan Null dengan kualitas BURUK atau TIDAK PASTI. Nilai-nilai khusus ini ditulis ke aliran lokal, memungkinkan pengumpulan data yang lebih komprehensif.
## Kontrol frekuensi pengumpulan data dengan mode Pindai
Anda dapat mengonfigurasi mode pemindaian OPC UA Anda untuk mengontrol cara Anda mengumpulkan data dari sumber OPC UA Anda. Anda dapat memilih mode berlangganan atau polling.
+ Mode berlangganan — Sumber OPC UA mengumpulkan data untuk dikirim ke gateway SiteWise Edge Anda pada frekuensi yang ditentukan oleh tingkat pemindaian Anda. Server hanya mengirim data ketika nilai telah berubah, jadi ini adalah frekuensi maksimum gateway SiteWise Edge Anda menerima data.
+ Mode polling - Gateway SiteWise Edge Anda menjajak pendapat sumber OPC UA pada frekuensi yang ditetapkan yang ditentukan oleh tingkat pemindaian Anda. Server mengirimkan data terlepas dari apakah nilainya telah berubah, sehingga gateway SiteWise Edge Anda selalu menerima data pada interval ini.
**catatan**
Opsi mode polling mengesampingkan pengaturan deadband Anda untuk sumber ini.
## Filter konsumsi data OPC UA dengan rentang deadband
Anda dapat menerapkan deadband ke grup properti sumber OPC UA Anda untuk memfilter dan membuang data tertentu alih-alih mengirimkannya ke Cloud. AWS Deadband menentukan jendela fluktuasi yang diharapkan dalam nilai data yang masuk dari sumber OPC UA Anda. Jika nilai termasuk dalam jendela ini, server OPC UA Anda tidak akan mengirimkannya ke AWS Cloud. Anda dapat menggunakan pemfilteran deadband untuk mengurangi jumlah data yang Anda proses dan kirim ke Cloud. AWS Untuk mempelajari cara menyiapkan sumber OPC UA untuk gateway SiteWise Edge Anda, lihat[Sumber data OPC UA untuk gateway AWS IoT SiteWise Edge](configure-sources-opcua.md).
**catatan**
Server Anda menghapus semua data yang ada di dalam jendela yang ditentukan oleh deadband Anda. Anda tidak dapat memulihkan data yang dibuang ini.
### Jenis deadband
Anda dapat menentukan dua jenis deadband untuk grup properti server OPC UA Anda. Ini memungkinkan Anda memilih berapa banyak data yang dikirim ke AWS Cloud, dan berapa banyak yang dibuang.
+ Persentase - Anda menentukan jendela menggunakan persentase fluktuasi yang diharapkan dalam nilai pengukuran. Server menghitung jendela yang tepat dari persentase ini, dan mengirimkan data ke AWS Cloud yang melebihi jatuh di luar jendela. Misalnya, menentukan nilai deadband 2% pada sensor dengan kisaran dari -100 derajat Fahrenheit hingga \$1100 derajat Fahrenheit memberi tahu server untuk mengirim data ke Cloud ketika nilainya berubah 4 derajat Fahrenheit atau lebih. AWS
**catatan**
Anda dapat secara opsional menentukan nilai deadband minimum dan maksimum untuk jendela ini jika server sumber Anda tidak menentukan unit teknik. Jika rentang unit teknik tidak disediakan, server OPC UA default ke rentang penuh tipe data pengukuran.
+ Absolute — Anda menentukan jendela menggunakan unit yang tepat. Misalnya, menentukan nilai deadband 2 pada sensor memberitahu server untuk mengirim data ke AWS Cloud ketika nilainya berubah setidaknya 2 unit. Anda dapat menggunakan deadbanding absolut untuk lingkungan dinamis di mana fluktuasi diharapkan secara teratur selama operasi normal.
### Batas waktu deadband
Anda dapat secara opsional mengonfigurasi pengaturan batas waktu deadband. Setelah batas waktu ini, server OPC UA mengirimkan nilai pengukuran saat ini meskipun berada dalam fluktuasi deadband yang diharapkan. Anda dapat menggunakan pengaturan batas waktu untuk memastikan bahwa AWS IoT SiteWise menelan aliran data yang stabil setiap saat, bahkan ketika nilai tidak melebihi jendela deadband yang ditentukan.
# Gunakan filter node OPC UA di SiteWise Edge
Saat Anda menentukan sumber data OPC UA untuk gateway SiteWise Edge, Anda dapat menentukan filter node. Filter node memungkinkan Anda membatasi jalur aliran data mana yang dikirim gateway SiteWise Edge ke cloud. Anda dapat menggunakan filter node untuk mengurangi waktu startup dan penggunaan CPU gateway SiteWise Edge dengan hanya menyertakan jalur ke data yang Anda modelkan AWS IoT SiteWise. Secara default, gateway SiteWise Edge mengunggah semua jalur OPC UA kecuali yang dimulai dengan. `/Server/` Anda dapat menggunakan karakter `*` dan `**` wildcard di filter node Anda untuk menyertakan beberapa jalur aliran data dengan satu filter. Untuk mempelajari cara menyiapkan sumber OPC UA untuk gateway SiteWise Edge Anda, lihat[Sumber data OPC UA untuk gateway AWS IoT SiteWise Edge](configure-sources-opcua.md).
**catatan**
AWS IoT SiteWise restart gateway SiteWise Edge Anda setiap kali Anda menambahkan atau mengedit sumber. Gateway SiteWise Edge Anda tidak akan menelan data saat memperbarui konfigurasi sumber. Waktu untuk memulai ulang gateway SiteWise Edge Anda tergantung pada jumlah tag pada sumber gateway SiteWise Edge Anda. Waktu restart dapat berkisar dari beberapa detik (untuk gateway SiteWise Edge dengan beberapa tag) hingga beberapa menit (untuk gateway SiteWise Edge dengan banyak tag).
Tabel berikut mencantumkan wildcard yang dapat Anda gunakan untuk memfilter sumber data OPC UA.
**OPC UA node filter wildcard**
| Wildcard | Deskripsi |
| --- | --- |
| \$1 | Cocokkan satu level dalam jalur aliran data. |
| \$1\$1 | Cocokkan beberapa level di jalur aliran data. |
**catatan**
Jika Anda mengonfigurasi sumber dengan filter luas dan kemudian mengubah sumber untuk menggunakan filter yang lebih ketat, AWS IoT SiteWise berhenti menyimpan data yang tidak cocok dengan filter baru.
**Example : Skenario menggunakan filter node**
Pertimbangkan aliran data hipotetis berikut:
+ `/WA/Factory 1/Line 1/PLC1`
+ `/WA/Factory 1/Line 1/PLC2`
+ `/WA/Factory 1/Line 2/Counter1`
+ `/WA/Factory 1/Line 2/PLC1`
+ `/OR/Factory 1/Line 1/PLC1`
+ `/OR/Factory 1/Line 2/Counter2`
Menggunakan aliran data sebelumnya, Anda dapat menentukan filter node untuk membatasi data apa yang akan disertakan dari sumber OPC UA Anda.
+ Untuk memilih semua node dalam contoh ini, gunakan `/` atau`/**/`. Anda dapat menyertakan beberapa direktori atau folder dengan `**` karakter wildcard.
+ Untuk memilih semua aliran `PLC` data, gunakan `/*/*/*/PLC*` atau`/**/PLC*`.
+ Untuk memilih semua penghitung dalam contoh ini, gunakan `/**/Counter*` atau`/*/*/*/Counter*`.
+ Untuk memilih semua penghitung dari`Line 2`, gunakan`/**/Line 2/Counter*`.
# Mengonversi tipe data yang tidak didukung
Secara opsional aktifkan konversi tipe data AWS IoT SiteWise untuk array sederhana dan tipe DateTime data. AWS IoT SiteWise tidak mendukung semua tipe data OPC UA. Ketika Anda mengirim data yang tidak didukung ke aliran AWS IoT Greengrass data Anda, data tersebut hilang. Namun, dengan mengonversi tipe data asli yang tidak didukung menjadi string, Anda dapat menelan data AWS IoT SiteWise daripada membuangnya. AWS IoT SiteWise serialisasi data Anda yang dikonversi sehingga nantinya Anda dapat menggunakan fungsi Anda sendiri untuk mengonversi string kembali ke tipe data aslinya di hilir, jika diperlukan.
Anda dapat memperbarui pengaturan konversi tipe data untuk sumber data kapan saja dan setiap sumber data dapat memiliki pengaturannya sendiri.
Saat Anda menambahkan sumber data di Konsol AWS IoT SiteWise, ada dua kotak centang di bawah **Konversi tipe data** di **Konfigurasi Lanjutan**. Anda dapat menunjukkan tipe data mana yang akan dikonversi ke string.
Selain itu, kolektor IoT SiteWise OPC UA dapat menerima NaN atau nilai nol di tepi.
+ Mengkonversi nilai array dengan tipe data sederhana ke string JSON
+ Konversi DateTime nilai ke string ISO 8601
## Prasyarat
+ Gunakan kolektor [ SiteWise IoT OPC](https://docs.aws.amazon.com/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html) UA versi 2.5.0 atau yang lebih baru.
## Batasan
Ini adalah batasan untuk konversi tipe data OPC UA ke string di. AWS IoT SiteWise
+ Konversi tipe data yang kompleks tidak didukung.
+ Batas string setelah konversi adalah 1024 byte. Jika string lebih panjang dari 1024 byte, string ditolak oleh. AWS IoT SiteWise
# Konfigurasikan otentikasi sumber data untuk Edge SiteWise
Jika server OPC UA Anda memerlukan kredensyal otentikasi untuk terhubung, Anda dapat menggunakannya AWS Secrets Manager untuk membuat dan menyebarkan rahasia ke gateway Edge Anda. SiteWise AWS Secrets Manager mengenkripsi rahasia pada perangkat untuk menjaga nama pengguna dan kata sandi Anda tetap aman sampai Anda perlu menggunakannya. Untuk informasi selengkapnya tentang komponen manajer AWS IoT Greengrass rahasia, lihat [Manajer rahasia](https://docs.aws.amazon.com/greengrass/v2/developerguide/secret-manager-component.html) di *Panduan AWS IoT Greengrass Version 2 Pengembang*.
Untuk informasi tentang mengelola akses ke rahasia Secrets Manager, lihat:
+ [Siapa yang memiliki izin untuk AWS Secrets Manager rahasia Anda](https://docs.aws.amazon.com/secretsmanager/latest/userguide/determine-acccess_examine-iam-policies.html).
+ [Menentukan apakah permintaan diizinkan atau ditolak dalam akun](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_evaluation-logic.html#policy-eval-denyallow).
## Langkah 1: Buat rahasia otentikasi sumber
Anda dapat menggunakan AWS Secrets Manager untuk membuat rahasia otentikasi untuk sumber data Anda. Secara rahasia, tentukan **username** dan pasangan **password** nilai kunci yang berisi detail otentikasi untuk sumber data Anda.
**Untuk membuat rahasia (konsol)**
1. Navigasikan ke [konsol AWS Secrets Manager](https://console.aws.amazon.com/secretsmanager/) tersebut.
1. Pilih **Simpan rahasia baru**.
1. Di bawah **Tipe rahasia**, pilih **Jenis rahasia lainnya**.
1. Di bawah **pasangan kunci/nilai**, lakukan hal berikut:
1. Di kotak input pertama, masukkan **username** dan di kotak input kedua masukkan nama pengguna.
1. Pilih **Tambahkan baris**.
1. Di kotak input pertama, masukkan **password** dan di kotak input kedua masukkan kata sandi.
1. **Untuk **kunci Enkripsi**, pilih **aws/secretsmanager**, lalu pilih Berikutnya.**
1. Di **Store halaman rahasia baru**, masukkan **nama Rahasia**.
1. (Opsional) Masukkan **Deskripsi** yang membantu Anda mengidentifikasi rahasia ini, lalu pilih **Berikutnya**.
1. (Opsional) Di **Menyimpan halaman rahasia baru**, nyalakan **Rotasi otomatis**. Untuk informasi selengkapnya, lihat [Memutar rahasia](https://docs.aws.amazon.com/secretsmanager/latest/userguide/rotating-secrets.html) di *Panduan AWS Secrets Manager Pengguna*.
1. Tentukan jadwal rotasi.
1. **Pilih fungsi Lambda yang dapat memutar rahasia ini, lalu pilih Berikutnya.**
1. Tinjau konfigurasi rahasia Anda, lalu pilih **Store**.
Untuk mengotorisasi gateway SiteWise Edge Anda untuk berinteraksi AWS Secrets Manager, peran IAM untuk gateway SiteWise Edge Anda harus mengizinkan tindakan tersebut`secretsmanager:GetSecretValue`. Anda dapat menggunakan perangkat **inti Greengrass** untuk mencari kebijakan IAM. Untuk informasi selengkapnya tentang memperbarui kebijakan IAM, lihat [Mengedit kebijakan IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-edit.html) di *AWS Identity and Access Management Panduan Pengguna*.
**Example kebijakan**
Ganti *secret-arn* dengan Nama Sumber Daya Amazon (ARN) dari rahasia yang Anda buat di langkah sebelumnya. Untuk informasi selengkapnya tentang cara mendapatkan ARN rahasia, lihat [Temukan rahasia AWS Secrets Manager di AWS Secrets Manager](https://docs.aws.amazon.com/secretsmanager/latest/userguide/manage_search-secret.html) *Panduan Pengguna*.
****
```
{
"Version":"2012-10-17",
"Statement":[
{
"Action":[
"secretsmanager:GetSecretValue"
],
"Effect":"Allow",
"Resource":[
"arn:aws:secretsmanager:us-east-1:123456789012:secret/*"
]
}
]
}
```
## Langkah 2: Terapkan rahasia ke perangkat gateway SiteWise Edge Anda
Anda dapat menggunakan AWS IoT SiteWise konsol untuk menyebarkan rahasia ke gateway SiteWise Edge Anda.
**Untuk menyebarkan rahasia (konsol)**
1. Navigasikan ke [konsol AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/) tersebut.
1. Di panel navigasi, pilih **Gateway**.
1. Dari daftar **Gateways**, pilih gateway SiteWise Edge target.
1. Di bagian **konfigurasi Gateway**, pilih tautan perangkat **inti Greengrass untuk membuka inti** yang terkait dengan gateway AWS IoT Greengrass Edge. SiteWise
1. Di panel navigasi, pilih **Deployment**.
1. Pilih penyebaran target, lalu pilih **Revisi**.
1. Pada halaman **Tentukan target**, pilih **Selanjutnya**.
1. Pada halaman **Pilih komponen**, di bagian **Komponen publik**, matikan **Tampilkan hanya komponen yang dipilih**.
1. Cari dan pilih **aws.greengrass. SecretManager**komponen, dan kemudian pilih **Berikutnya**.
1. Dari daftar **Komponen yang dipilih**, pilih **aws.greengrass. SecretManager**komponen, dan kemudian pilih **Configure component**.
1. Di bidang **Configuration to merge**, tambahkan objek JSON berikut.
**catatan**
Ganti *secret-arn* dengan ARN rahasia yang Anda buat di langkah sebelumnya. Untuk informasi selengkapnya tentang cara mendapatkan ARN rahasia, lihat [Temukan rahasia AWS Secrets Manager di AWS Secrets Manager](https://docs.aws.amazon.com/secretsmanager/latest/userguide/manage_search-secret.html) *Panduan Pengguna*.
```
{
"cloudSecrets":[
{
"arn":"secret-arn"
}
]
}
```
1. Pilih **Konfirmasi**.
1. Pilih **Berikutnya**.
1. Pada halaman **Konfigurasi pengaturan lanjutan**, pilih **Berikutnya**.
1. **Tinjau konfigurasi penerapan Anda, lalu pilih Deploy.**
## Langkah 3: Tambahkan konfigurasi otentikasi
Anda dapat menggunakan AWS IoT SiteWise konsol untuk menambahkan konfigurasi otentikasi ke gateway SiteWise Edge Anda.
**Untuk menambahkan konfigurasi otentikasi (konsol)**
1. Navigasikan ke [konsol AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/) tersebut.
1. Dari daftar **Gateways**, pilih gateway SiteWise Edge target.
1. Dari daftar **Sumber data**, pilih sumber data target, lalu pilih **Edit**.
1. Pada halaman **Tambahkan sumber data**, pilih **Konfigurasi lanjutan**.
1. Untuk **konfigurasi Otentikasi**, pilih rahasia yang Anda gunakan di langkah sebelumnya.
1. Pilih **Simpan**.
# Sumber data mitra di gateway SiteWise Edge
Saat menggunakan gateway AWS IoT SiteWise Edge, Anda dapat menghubungkan sumber data mitra ke gateway SiteWise Edge Anda dan menerima data dari mitra di gateway SiteWise Edge dan AWS cloud Anda. Sumber data mitra ini adalah AWS IoT Greengrass komponen yang dikembangkan dalam kemitraan antara AWS dan mitra. Saat Anda menambahkan sumber data mitra, AWS IoT SiteWise akan membuat komponen ini dan menerapkannya di gateway SiteWise Edge Anda.
**catatan**
Anda dapat menambahkan satu sumber data untuk setiap mitra di setiap gateway.
Untuk menambahkan sumber data mitra, lakukan hal berikut:
1. [Tambahkan sumber data mitra di SiteWise Edge](cpa-add-source.md)
1. Buka portal web mitra, jika berlaku, dan konfigurasikan sumber data mitra sehingga terhubung ke gateway SiteWise Edge.
**Topics**
+ [Keamanan](#cpa-security)
+ [Siapkan Docker di gateway SiteWise Edge Anda](cpa-install-docker.md)
+ [Tambahkan sumber data mitra di SiteWise Edge](cpa-add-source.md)
+ [SiteWise Opsi sumber data mitra gateway tepi](connect-partner-data-source.md)
## Keamanan
Sebagai bagian dari [Model Tanggung Jawab Bersama](https://aws.amazon.com/compliance/shared-responsibility-model/) antara AWS, pelanggan kami, dan mitra kami, berikut ini menjelaskan siapa yang bertanggung jawab atas berbagai aspek keamanan:
**Tanggung jawab pelanggan**
+ Memeriksa pasangan.
+ Mengkonfigurasi akses jaringan yang diberikan kepada mitra.
+ Pemantauan untuk penggunaan yang wajar dari sumber daya mesin gateway SiteWise Edge (CPU, memori, dan sistem file).
**AWS tanggung jawab**
+ Mengisolasi mitra dari sumber daya AWS cloud pelanggan kecuali yang dibutuhkan oleh mitra. Dalam hal ini, AWS IoT SiteWise konsumsi.
+ Membatasi solusi mitra untuk penggunaan yang wajar dari sumber daya mesin gateway SiteWise Edge (CPU dan memori).
**Tanggung jawab mitra**
+ Menggunakan default yang aman.
+ Menjaga solusi tetap aman dari waktu ke waktu melalui tambalan dan pembaruan lain yang sesuai.
+ Menjaga kerahasiaan data pelanggan.
# Siapkan Docker di gateway SiteWise Edge Anda
AWS IoT SiteWise menyediakan Docker gambar yang memungkinkan Anda menjalankan aplikasi SiteWise Edge di berbagai platform dan lingkungan. DockerGambar ini merangkum semua komponen dan dependensi yang diperlukan untuk mengumpulkan, memproses, dan mengirim data dari peralatan industri Anda ke Cloud. AWS Dengan menggunakan image Docker, Anda dapat menerapkan dan menjalankan aplikasi SiteWise Edge pada host yang kompatibel dengan Docker, seperti server, perangkat edge, atau layanan kontainer berbasis cloud.
Untuk menambahkan sumber data mitra, [Docker Engine](https://docs.docker.com/engine/) 1.9.1 atau yang lebih baru harus diinstal pada perangkat lokal Anda.
**catatan**
Versi 20.10 adalah versi terbaru yang diverifikasi untuk bekerja dengan perangkat lunak gateway SiteWise Edge.
## Verifikasi Docker diinstal
Untuk memverifikasi Docker diinstal, jalankan perintah berikut dari terminal yang terhubung ke gateway SiteWise Edge Anda:
```
docker info
```
Jika perintah mengembalikan `docker is not recognized` hasil, atau versi yang lebih lama diinstal, [Instal Docker Engine](https://docs.docker.com/engine/install/) sebelum melanjutkan. Docker
## Siapkan Docker
Pengguna sistem yang menjalankan komponen Docker kontainer harus memiliki izin root atau administrator, atau Anda harus mengonfigurasi Docker untuk menjalankannya sebagai pengguna non-root atau non-admistrator.
Pada perangkat Linux, Anda harus menambahkan `ggc_user` pengguna ke `docker` grup untuk memanggil Docker perintah tanpa`sudo`.
Untuk menambahkan`ggc_user`, atau pengguna non-root yang Anda gunakan untuk menjalankan komponen Docker kontainer, ke `docker` grup, jalankan perintah berikut:
```
sudo usermod -aG docker ggc_user
```
Untuk informasi selengkapnya, lihat [langkah-langkah pasca-instalasi Linux untuk Docker Engine](https://docs.docker.com/engine/install/linux-postinstall/).
# Tambahkan sumber data mitra di SiteWise Edge
Untuk menghubungkan sumber data mitra ke gateway SiteWise Edge Anda, tambahkan sebagai sumber data. Saat Anda menambahkannya sebagai sumber data, AWS IoT SiteWise akan menyebarkan AWS IoT Greengrass komponen pribadi ke gateway SiteWise Edge Anda.
## Prasyarat
Untuk menambahkan sumber data mitra, Anda harus melakukan hal berikut:
+ Untuk EasyEdge danCloudRail, buat akun dengan mitra, lalu ikat akun.
+ [Siapkan Docker di gateway SiteWise Edge Anda](cpa-install-docker.md)
## Buat gateway SiteWise Edge dengan sumber data mitra
Jika Anda ingin membuat gateway SiteWise Edge baru, selesaikan langkah-langkahnya[Buat gateway SiteWise Edge yang dihosting sendiri](create-gateway-ggv2.md). Setelah Anda membuat gateway SiteWise Edge, ikuti langkah-langkah [Tambahkan sumber data mitra ke gateway SiteWise Edge yang ada](#cpa-existing-gateway) untuk menambahkan sumber data mitra.
## Tambahkan sumber data mitra ke gateway SiteWise Edge yang ada
1. Navigasikan ke [konsol AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/) tersebut.
1. Di navigasi kiri, pilih **gateway Edge** di bagian **Edge**.
1. Pilih gateway SiteWise Edge yang ingin Anda sambungkan dengan sumber data mitra.
1. Di bawah **Sumber data**, pilih **Tambahkan sumber data**.
1. Pada layar **Tambahkan sumber data**, pilih **tipe Sumber**, untuk memilih mitra yang menghubungkan gateway SiteWise Edge Anda. Setiap sumber data memiliki opsi konfigurasi sendiri. Ada dua kategori sumber data: sumber dan AWS sumber Mitra.
Menggunakan sumber data mitra, Anda dapat memilih satu sumber per gateway. Untuk daftar opsi integrasi mitra sumber data, lihat[SiteWise Opsi sumber data mitra gateway tepi](connect-partner-data-source.md). Perhatikan bahwa Anda dapat menambahkan hingga 100 sumber data OPC UA (AWS sumber). Untuk memulai dengan sumber data OPC UA, lihat[Sumber data OPC UA untuk gateway AWS IoT SiteWise Edge](configure-sources-opcua.md).
1. Masukkan nama untuk sumbernya.
1. Pilih tab sumber data Anda di bawah ini dan ikuti prosedur konfigurasi.
------
#### [ CloudRail ]
Sebagian besar CloudRail konfigurasi dilakukan di CloudRail portal setelah menyimpan sumber data untuk gateway SiteWise Edge Anda. Namun, otorisasi koneksi diperlukan.
**catatan**
CloudRailKoneksi hanya tersedia di Linux.
1. [Buat CloudRail akun](https://devices.cloudrail.com/signup) untuk memulai dengan menghubungkan ke AWS IoT SiteWise.
1. Pastikan Docker diinstal pada gateway Anda. Untuk informasi selengkapnya, lihat [Siapkan Docker di gateway SiteWise Edge Anda](cpa-install-docker.md).
1. **Baca Perjanjian **Akses dan Penyebaran Otorisasi**, lalu pilih Otorisasi.** Memeriksa kotak memberi AWS mitra akses ke sumber data Anda dan memungkinkan AWS untuk menerapkan pada komponen mitra.
**catatan**
**Awalan Pengukuran — *opsional*** diatur dalam CloudRail portal Anda.
**catatan**
Perangkat lunak mitra dikembangkan, dipelihara, dan didukung oleh AWS mitra. AWS tidak bertanggung jawab atas antarmuka, konfigurasi, atau perangkat lunak.
Untuk informasi selengkapnya, lihat [CloudRail](connect-partner-data-source.md#cp-cloudrail).
------
#### [ EasyEdge ]
Sebagian besar EasyEdge konfigurasi dilakukan di EasyEdge portal setelah menyimpan sumber data untuk gateway SiteWise Edge Anda. Namun, otorisasi koneksi diperlukan.
**catatan**
EasyEdgeKoneksi hanya tersedia di Linux.
1. [Buat EasyEdge akun](https://accounts.easyedge.io/signup?partner=aws) untuk memulai dengan menghubungkan ke AWS IoT SiteWise.
1. Pastikan Docker diinstal pada gateway Anda. Untuk informasi selengkapnya, lihat [Siapkan Docker di gateway SiteWise Edge Anda](cpa-install-docker.md).
1. **Baca Perjanjian **Akses dan Penyebaran Otorisasi**, lalu pilih Otorisasi.** Memeriksa kotak memberi AWS mitra akses ke sumber data Anda dan memungkinkan AWS untuk menerapkan pada komponen mitra.
**catatan**
**Awalan Pengukuran — *opsional*** diatur dalam EasyEdge portal Anda.
**catatan**
Perangkat lunak mitra dikembangkan, dipelihara, dan didukung oleh AWS mitra. AWS tidak bertanggung jawab atas antarmuka, konfigurasi, atau perangkat lunak.
Untuk informasi selengkapnya, lihat [EasyEdge](connect-partner-data-source.md#cp-easyedge).
------
#### [ Tepi Lakmus ]
Anda dapat mengaktifkan Litmus konfigurasi dengan dua cara. Aktifkan Litmus Edge langsung melalui AWS IoT SiteWise penggunaan informasi dari Litmus Edge Manager portal. Atau, Anda dapat mengaktifkan secara manual Litmus Edge untuk AWS IoT SiteWise melaluiLitmus Edge Manager.
**catatan**
Litmus EdgeKoneksi hanya tersedia di Linux.
**Untuk mengaktifkan menggunakan kode Litmus Edge aktivasi pada AWS IoT SiteWise**
Gunakan prosedur ini saat menambahkan sumber Litmus Edge data dengan kode Litmus Edge aktivasi pada file Konsol AWS IoT SiteWise.
1. Pilih **Aktifkan sekarang menggunakan kode**. Opsi konfigurasi tambahan muncul.
1. Masukkan tombol Litmus Edge Manager to connect Litmus Edge ke gateway SiteWise Edge Anda. Untuk informasi selengkapnya, lihat [Langkah 3a: Mengatur Titik Akhir Manajemen Data dan Perangkat](https://docs.litmus.io/edgemanager/quickstart-guide/activate-an-edge-device/step-3-activation-request) dalam dokumentasi. Litmus Edge Manager
1. Berikan kode Litmus Edge Manager aktivasi untuk Litmus Edge diaktifkan AWS IoT SiteWise
1. Secara opsional, AWS IoT SiteWise berikan **sertifikat Litmus Edge Manager CA**. Sertifikat Litmus Edge mencegah pengaktifan pada yang tidak sahLitmus Edge Manager.
1. Pastikan Docker diinstal pada gateway Anda. Untuk informasi selengkapnya, lihat [Siapkan Docker di gateway SiteWise Edge Anda](cpa-install-docker.md).
**catatan**
AWS IoT SiteWise menyebarkan aplikasi mitra sebagai wadah Docker. Aplikasi ini digunakan dengan `NET_ADMIN` kemampuan sehingga wadah Litmus Edge Docker dapat dikelola melalui. Litmus Edge Manager Litmus Edgememerlukan akses istimewa ini untuk berjalan di perangkat Anda. Untuk informasi selengkapnya tentang persyaratan Litmus Edge Docker, lihat [Instalasi Docker](https://docs.litmus.io/litmusedge-v1/quickstart-guide/installation-and-deployments/docker-installation) di *QuickStart Panduan* dalam dokumentasi Litmus Edge.
1. **Baca Perjanjian **Akses dan Penyebaran Otorisasi**, lalu pilih Otorisasi.** Memeriksa kotak memberi AWS mitra akses ke sumber data Anda dan memungkinkan AWS untuk menerapkan pada komponen mitra.
**Untuk mengaktifkan secara manual melalui Litmus Edge**
1. Pilih **Aktifkan nanti Litmus Edge**.
1. Pastikan Docker diinstal pada gateway Anda. Untuk informasi selengkapnya, lihat [Siapkan Docker di gateway SiteWise Edge Anda](cpa-install-docker.md).
**catatan**
AWS IoT SiteWise menyebarkan aplikasi mitra sebagai wadah Docker. Aplikasi ini digunakan dengan `NET_ADMIN` kemampuan sehingga wadah Litmus Edge Docker dapat dikelola melalui. Litmus Edge Manager Litmus Edgememerlukan akses istimewa ini untuk berjalan di perangkat Anda. Untuk informasi selengkapnya tentang persyaratan Litmus Edge Docker, lihat [Instalasi Docker](https://docs.litmus.io/litmusedge-v1/quickstart-guide/installation-and-deployments/docker-installation) di *QuickStart Panduan* dalam dokumentasi Litmus Edge.
1. **Baca Perjanjian **Akses dan Penyebaran Otorisasi**, lalu pilih Otorisasi.** Memeriksa kotak memberi AWS mitra akses ke sumber data Anda dan memungkinkan AWS untuk menerapkan pada komponen mitra.
1. Setelah penerapan selesai, ikuti petunjuk [Access the Litmus Edge Web UI](https://docs.litmus.io/litmusedge/quickstart-guide/access-the-litmus-edge-web-ui) dalam dokumentasi. Litmus Edge *QuickStart Guide*
**catatan**
Perangkat lunak mitra dikembangkan, dipelihara, dan didukung oleh AWS mitra. AWS tidak bertanggung jawab atas antarmuka, konfigurasi, atau perangkat lunak.
Untuk informasi selengkapnya, lihat [Litmus Edge](connect-partner-data-source.md#cp-litmus).
------
1. Pilih **Simpan**.
# SiteWise Opsi sumber data mitra gateway tepi
AWS IoT SiteWise memungkinkan Anda untuk menghubungkan dan menelan data dari berbagai sumber data mitra, seperti peralatan industri, sensor, dan sistem pihak ketiga lainnya. Untuk menghubungkan sumber data mitra, Anda perlu mengikuti beberapa langkah, termasuk mengonfigurasi sumber data untuk mengirim data AWS IoT SiteWise, menyiapkan izin dan otentikasi yang diperlukan, dan memetakan data ke model aset Anda. Proses ini memastikan bahwa data mitra Anda terintegrasi dengan mulus ke AWS IoT SiteWise lingkungan Anda, memungkinkan Anda untuk memantau dan menganalisisnya bersama sumber data Anda yang lain.
Bagian ini mencantumkan mitra yang tersedia untuk integrasi sumber data pihak ketiga di gateway SiteWise Edge. Gunakan informasi di bawah ini untuk mengonfigurasi sumber data mitra.
**catatan**
Anda dapat menambahkan satu sumber data untuk setiap mitra di setiap gateway
## CloudRail
**Portal:**
[https://devices.cloudrail.com/](https://devices.cloudrail.com/)
**Persyaratan**
Untuk informasi lebih lanjut tentang CloudRail persyaratan, lihat [FAQ](https://cloudrail.com/faqs/) di situs web. CloudRail
**CloudRaildokumentasi:**
[Komputasi Tepi: SiteWise Tepi](https://devices.cloudrail.com/documentation?service=AWSIoTSitewiseEdge#awsiotsitewiseEdge1)
## EasyEdge
**Portal:**
[https://studio.easyedge.io/](https://studio.easyedge.io/)
**Persyaratan**
[EasyEdgepersyaratan](https://docs.easyedge.io/getting-started/requirements.html) — Informasi tentang EasyEdge persyaratan, termasuk titik akhir dan port yang diperlukan untuk mengkonfigurasi firewall. **Catatan**: Anda memerlukan EasyEdge akun untuk mengakses dokumentasi ini.
**EasyEdgedokumentasi:**
[EasyEdgeuntuk AWS](https://www.easyedge.io/easyedge-for-aws/)
## Litmus Edge
**Akses keLitmus Edge Manager:**
Untuk mengakses Litmus Edge, siapkan akun [Lakmus Edge Manager](https://docs.litmus.io/edgemanager/quickstart-guide/access-to-litmus-edge-manager).
**Persyaratan**
[Litmus EdgePersyaratan](https://docs.litmus.io/litmusedge/quickstart-guide/system-requirements) - Konfigurasi yang disarankan dan persyaratan sistem untuk diterapkanLitmus Edge.
**Litmusdokumentasi:**
+ [Integrasi ke AWS IoT SiteWise](https://docs.litmus.io/litmusedge-v1/litmusedge-with-aws-iot-sitewise)
+ [Dokumentasi Litmus Edge](https://docs.litmus.io/litmusedge/)
# AWS IoT Greengrass komponen untuk AWS IoT SiteWise Edge
SiteWise Edge menggunakan AWS IoT Greengrass komponen untuk mengumpulkan, memproses, dan mengirimkan data industri di tepi. Komponen-komponen ini bekerja sama untuk memungkinkan pemrosesan data lokal dan integrasi tanpa batas dengan layanan AWS IoT SiteWise cloud.
**Penerbit IoT SiteWise **
Komponen SiteWise penerbit IoT (`aws.iot.SiteWiseEdgePublisher`) bertanggung jawab untuk:
+ Mentransmisikan data yang dikumpulkan dengan aman ke layanan cloud AWS IoT SiteWise
+ Mengelola buffering data dan percobaan ulang selama masalah konektivitas
Untuk informasi selengkapnya tentang mengonfigurasi penerbit untuk SiteWise Edge, lihat. [Konfigurasikan AWS IoT SiteWise komponen penerbit](configure-publisher-component.md) *Dan, untuk informasi selengkapnya tentang komponen penerbit, lihat penerbit [ SiteWise IoT](https://docs.aws.amazon.com/greengrass/v2/developerguide/iotsitewise-publisher-component.html) di AWS IoT Greengrass Version 2 Panduan Pengembang.*
**Prosesor IoT SiteWise **
Komponen SiteWise prosesor IoT (`aws.iot.SiteWiseEdgeProcessor`) melakukan tugas-tugas berikut:
+ Menjalankan transformasi data dan perhitungan di tepi
+ Menerapkan definisi dan perhitungan properti aset secara lokal
+ Mengurangi volume data dengan mengumpulkan atau memfilter data sebelum transmisi
Untuk informasi selengkapnya tentang komponen prosesor, lihat [ SiteWise Prosesor IoT](https://docs.aws.amazon.com/greengrass/v2/developerguide/iotsitewise-processor-component.html) di Panduan *AWS IoT Greengrass Version 2 Pengembang*.
**Kolektor IoT SiteWise OPC UA**
Komponen IoT SiteWise OPC UA collector (`aws.iot.SiteWiseEdgeCollectorOpcua`) dirancang untuk:
+ Connect ke server OPC UA di lingkungan industri
+ Kumpulkan data dari sumber data OPC UA secara efisien
+ Ubah data OPC UA menjadi format yang kompatibel AWS IoT SiteWise
*Untuk informasi selengkapnya tentang komponen kolektor OPC UA, lihat kolektor [ SiteWise IoT OPC UA](https://docs.aws.amazon.com/greengrass/v2/developerguide/iotsitewise-opcua-collector-component.html) di AWS IoT Greengrass Version 2 Panduan Pengembang.*
**Simulator sumber data IoT SiteWise OPC UA**
Komponen simulator sumber data IoT SiteWise OPC UA (`aws.iot.SiteWiseEdgeOpcuaDataSourceSimulator`) menyediakan fungsionalitas berikut:
+ Memulai server OPC UA lokal yang menghasilkan data sampel
+ Mensimulasikan sumber data yang dapat dibaca oleh komponen kolektor AWS IoT SiteWise OPC UA pada gateway AWS IoT SiteWise
+ Memungkinkan eksplorasi AWS IoT SiteWise fitur menggunakan data sampel yang dihasilkan
Komponen ini sangat berguna untuk tujuan pengujian dan pengembangan, memungkinkan Anda untuk mensimulasikan sumber data industri tanpa memerlukan peralatan fisik.
*Untuk informasi selengkapnya tentang komponen simulasi sumber data, lihat simulator [sumber data SiteWise IoT OPC UA](https://docs.aws.amazon.com/greengrass/v2/developerguide/iotsitewise-opcua-data-source-simulator-component.html) di AWS IoT Greengrass Version 2 Panduan Pengembang.*
AWS IoT Greengrass Komponen-komponen ini berfungsi untuk mengaktifkan fungsionalitas SiteWise Edge. SiteWise Penerbit IoT memastikan data dikirim dengan andal ke cloud, SiteWise prosesor IoT menangani komputasi lokal dan pengoptimalan data, dan pengumpul IoT OPC UA memfasilitasi integrasi dengan protokol industri umum. SiteWise
**catatan**
Untuk menggunakan komponen ini, Anda harus menginstal AWS IoT Greengrass V2 atau nanti di perangkat edge Anda. Konfigurasi yang tepat dari setiap komponen penting untuk kinerja SiteWise Edge yang optimal.
# Filter aset di gateway SiteWise Edge
Anda dapat menggunakan pemfilteran tepi untuk mengelola aset Anda secara lebih efisien dengan mengirimkan hanya sebagian aset ke gateway SiteWise Edge tertentu untuk digunakan dalam pemrosesan data. Jika aset Anda diatur dalam struktur pohon, atau orang tua-anak, Anda dapat menyiapkan kebijakan IAM yang dilampirkan ke peran IAM gateway SiteWise Edge yang hanya mengizinkan akar pohon, atau induk, dan anak-anaknya dikirim ke gateway Edge tertentu. SiteWise
**catatan**
Jika Anda mengatur aset yang ada ke dalam struktur pohon, setelah Anda membuat struktur, masuk ke setiap aset yang ada yang Anda tambahkan ke struktur dan pilih **Edit** lalu pilih **Simpan** untuk memastikan AWS IoT SiteWise mengenali struktur baru.
## Siapkan penyaringan tepi
Siapkan pemfilteran tepi di gateway SiteWise Edge Anda dengan menambahkan kebijakan IAM berikut ke peran IAM gateway SiteWise Edge, ganti ** dengan ID aset root yang ingin Anda kirim ke gateway Edge. SiteWise
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Deny",
"Action": [
"iotsitewise:DescribeAsset",
"iotsitewise:ListAssociatedAssets"
],
"Resource": "arn:aws:iotsitewise:*:*:asset/*",
"Condition": {
"StringNotLike": {
"iotsitewise:assetHierarchyPath": "/*"
}
}
}
]
}
```
------
Jika ada aset saat ini di gateway SiteWise Edge Anda yang ingin Anda hapus, masuk ke gateway SiteWise Edge Anda dan jalankan perintah berikut untuk memaksa gateway SiteWise Edge disinkronkan AWS IoT SiteWise dengan menghapus cache.
```
sudo rm /greengrass/v2/work/aws.iot.SiteWiseEdgeProcessor/sync-app/sync_resource_bundles/edge.json
```
# Konfigurasikan dukungan proxy dan kelola toko kepercayaan untuk AWS IoT SiteWise Edge
Di AWS IoT SiteWise Edge, konfigurasikan dan kelola toko kepercayaan untuk menyiapkan dukungan proxy untuk perangkat edge Anda. Pertama, atur konfigurasi proxy, lalu konfigurasikan toko kepercayaan. Anda dapat mengonfigurasi penyimpanan kepercayaan baik selama instalasi gateway atau secara manual setelah gateway Anda dibuat.
+ **Proxy** — Memfasilitasi konektivitas antara perangkat dan AWS layanan edge Anda di berbagai lingkungan jaringan.
+ **Trust store** — Pastikan koneksi aman dengan mengelola sertifikat tepercaya. Konfigurasi yang tepat membantu Anda mematuhi kebijakan keamanan jaringan, mengaktifkan komunikasi di lingkungan jaringan terbatas, dan mengoptimalkan transfer data antara perangkat edge dan layanan cloud.
SiteWise Edge menggunakan beberapa toko kepercayaan untuk berbagai jenis komponen, memastikan aliran data yang aman dan efisien dari perangkat edge Anda ke cloud. Anda dapat mengonfigurasi toko kepercayaan dan proxy pada gateway yang ada atau selama proses instalasi saat membuat gateway baru.
## Persyaratan untuk penyimpanan kepercayaan dan konfigurasi proxy
Sebelum Anda mengonfigurasi toko kepercayaan atau menginstal SiteWise Edge dengan pengaturan proxy, pastikan Anda memenuhi prasyarat. Ada beragam persyaratan implementasi berdasarkan penggunaan komponen dan persyaratan fungsionalitas Anda.
**Persyaratan dukungan proxy**
+ URL server proxy Anda. URL harus menyertakan info pengguna, nomor port untuk host. Misalnya, `scheme://[userinfo@]host[:port]`.
+ `scheme`— Harus HTTP atau HTTPS
+ (Opsional) `userinfo` — Informasi nama pengguna dan kata sandi
+ `host`— Nama host atau alamat IP dari server proxy
+ `port`— Nomor port
+ Daftar alamat untuk mem-bypass proxy.
+ (Opsional) File sertifikat CA proxy jika Anda menggunakan proxy HTTPS dengan sertifikat yang ditandatangani sendiri.
**Persyaratan toko kepercayaan**
+ Untuk fungsionalitas paket pemrosesan data lengkap dengan proxy HTTPS, Anda harus memperbarui ketiga toko kepercayaan.
+ Jika Anda hanya menggunakan kolektor IoT SiteWise OPC UA dan SiteWise penerbit IoT, perbarui sertifikat AWS IoT Greengrass Core dan Java trust store ke versi terbaru.
## Praktik terbaik untuk penyimpanan kepercayaan dan konfigurasi tepi server proxy
Untuk pemeliharaan berkelanjutan dan untuk mempertahankan tingkat keamanan tertinggi di lingkungan tepi Anda:
+ Tinjau dan perbarui pengaturan proxy secara teratur agar sesuai dengan persyaratan keamanan jaringan Anda.
+ Pantau konektivitas gateway dan aliran data untuk memastikan komunikasi proxy yang tepat
+ Menjaga dan memperbarui toko kepercayaan sesuai dengan kebijakan manajemen sertifikat organisasi Anda
+ Anda dapat menerapkan dan mengikuti praktik terbaik yang kami rekomendasikan untuk komunikasi yang aman di lingkungan tepi, seperti:
+ Dokumentasikan konfigurasi proxy dan trust store Anda untuk visibilitas operasional
+ Ikuti praktik keamanan organisasi Anda untuk manajemen kredensyal
Praktik ini membantu menjaga operasi yang aman dan andal untuk gateway SiteWise Edge Anda sambil tetap selaras dengan kebijakan keamanan Anda yang lebih luas.
# Konfigurasikan pengaturan proxy selama instalasi gateway AWS IoT SiteWise Edge
Anda dapat mengonfigurasi AWS IoT SiteWise Edge untuk bekerja dengan server proxy selama instalasi gateway. Skrip instalasi mendukung proxy HTTP dan HTTPS dan dapat secara otomatis mengkonfigurasi penyimpanan kepercayaan untuk koneksi proxy yang aman.
Ketika Anda menjalankan skrip instalasi dengan pengaturan proxy, ia melakukan beberapa tugas penting:
+ Memvalidasi format dan parameter URL proxy untuk memastikannya ditentukan dengan benar.
+ Mengunduh dan menginstal dependensi yang diperlukan melalui proxy yang dikonfigurasi.
+ Jika sertifikat CA proxy disediakan, itu ditambahkan ke sertifikat CA AWS IoT Greengrass root dan diimpor ke Java KeyStore.
+ Mengkonfigurasi AWS IoT Greengrass (yang digunakan SiteWise Edge) untuk menggunakan proxy untuk semua koneksi keluar.
+ Menyelesaikan instalasi SiteWise Edge dengan konfigurasi proxy dan trust store yang sesuai.
**Untuk mengkonfigurasi pengaturan proxy saat menginstal perangkat lunak gateway**
1. Buat gateway SiteWise Edge. Untuk informasi selengkapnya, lihat [Buat gateway SiteWise Edge yang dihosting sendiri](create-gateway-ggv2.md) dan [Instal perangkat lunak gateway AWS IoT SiteWise Edge di perangkat lokal Anda](install-gateway-software-on-local-device.md).
1. Jalankan skrip instalasi dengan pengaturan proxy yang sesuai untuk lingkungan Anda. Ganti placeholder dengan informasi proxy spesifik Anda
Ganti setiap item berikut:
+ `-p`, `--proxy-url` — URL dari server proxy. URL harus salah satu `http` atau`https`.
+ `-n`, `--no-proxy` — Daftar alamat yang dipisahkan koma untuk melewati proxy.
+ (Opsional)`-c`, `--proxy-ca-cert` — Jalur ke file sertifikat CA proxy.
+ (Opsional)`-j`, `--javastorepass` — KeyStore Kata sandi Java. Kata sandi defaultnya adalah`changeit`.
------
#### [ Linux ]
Untuk sistem Linux, gunakan struktur perintah berikut:
```
sudo ./install.sh -p proxy-url -n no-proxy-addresses [-c proxy-ca-cert-path] [-j javastorepass]
```
------
#### [ Windows ]
Untuk Microsoft Windows sistem yang menggunakan PowerShell, gunakan struktur perintah ini:
```
.\install.ps1 -ProxyUrl proxy-url -NoProxyAddresses no-proxy-addresses [-ProxyCaCertPath proxy-ca-cert-path] [-JavaStorePass javastorepass]
```
------
## Pemecahan masalah selama instalasi berkemampuan proxy
Untuk informasi selengkapnya tentang menyelesaikan masalah trust store yang terkait dengan gateway SiteWise Edge, lihat[Masalah instalasi berkemampuan proxy](troubleshooting-gateway.md#troubleshoot-proxy-during-installation).
# Konfigurasikan penyimpanan kepercayaan secara manual untuk dukungan proxy HTTPS di AWS IoT SiteWise Edge
Saat mengonfigurasi komponen AWS IoT SiteWise Edge untuk terhubung melalui proxy HTTPS, tambahkan sertifikat server proxy ke toko kepercayaan yang sesuai. SiteWise Edge menggunakan beberapa toko kepercayaan untuk mengamankan komunikasi. Ada tiga toko kepercayaan dan penggunaan Anda bergantung pada jenis komponen SiteWise Edge dalam implementasi gateway Anda.
Toko kepercayaan diperbarui secara otomatis selama proses instalasi ketika pengaturan proxy disediakan.
+ [Konfigurasikan penyimpanan kepercayaan komponen AWS IoT Greengrass inti](#manage-trust-stores-proxy_greengrass-core-components)— Sertifikat CA AWS IoT Greengrass root disertakan dalam toko kepercayaan untuk memverifikasi keaslian AWS layanan.
Toko kepercayaan ini membantu AWS IoT Greengrass komponen berkomunikasi dengan aman dengan AWS layanan melalui proxy sambil memverifikasi keaslian layanan tersebut.
+ [Konfigurasikan toko kepercayaan komponen berbasis Java](#manage-trust-stores-proxy_java-based-components)Java KeyStore (JKS) adalah toko kepercayaan utama yang digunakan oleh komponen berbasis Java untuk koneksi. SSL/TLS
Aplikasi Java mengandalkan JKS untuk membangun koneksi yang aman. Misalnya, jika Anda menggunakan SiteWise penerbit IoT atau kolektor IoT SiteWise OPC UA, yang berbasis Java, Anda harus mengonfigurasi toko kepercayaan ini. Ini memastikan komponen ini dapat berkomunikasi dengan aman melalui proxy HTTPS saat mengirim data ke cloud atau mengumpulkan data dari server OPC UA.
+ [Konfigurasi penyimpanan kepercayaan komponen tingkat sistem](#manage-trust-stores-proxy_system-level-components)Saat menggunakan proxy HTTPS, sertifikat mereka harus ditambahkan ke toko kepercayaan yang sesuai untuk mengaktifkan koneksi yang aman.
Saat menggunakan proxy HTTPS, sertifikat mereka harus ditambahkan ke toko kepercayaan yang sesuai untuk mengaktifkan koneksi yang aman. Ini diperlukan karena komponen tingkat sistem, sering ditulis dalam bahasa seperti Rust atau Go, bergantung pada penyimpanan kepercayaan sistem daripada JKS Java. Misalnya, jika Anda menggunakan utilitas sistem yang perlu berkomunikasi melalui proxy (seperti untuk pembaruan perangkat lunak atau sinkronisasi waktu), Anda harus mengonfigurasi penyimpanan kepercayaan tingkat sistem. Ini memastikan komponen dan utilitas ini dapat membangun koneksi aman melalui proxy.
## Konfigurasikan penyimpanan kepercayaan komponen AWS IoT Greengrass inti
Untuk fungsi AWS IoT Greengrass Core yang menggunakan root CA Amazon:
1. Temukan berkas sertifikat di `/greengrass/v2/AmazonRootCA1.pem`
1. Tambahkan sertifikat root proxy HTTPS (ditandatangani sendiri) ke file ini.
```
-----BEGIN CERTIFICATE-----
MIIEFTCCAv2gAwIQWgIVAMHSAzWG/5YVRYtRQOxXUTEpHuEmApzGCSqGSIb3DQEK
\nCwUAhuL9MQswCQwJVUzEPMAVUzEYMBYGA1UECgwP1hem9uLmNvbSBJbmMuMRww
... content of proxy CA certificate ...
+vHIRlt0e5JAm5\noTIZGoFbK82A0/nO7f/t5PSIDAim9V3Gc3pSXxCCAQoFYnui
GaPUlGk1gCE84a0X\n7Rp/lND/PuMZ/s8YjlkY2NmYmNjMCAXDTE5MTEyN2cM216
gJMIADggEPADf2/m45hzEXAMPLE=
-----END CERTIFICATE-----
-----BEGIN CERTIFICATE-----
MIIDQTCCAimgF6AwIBAgITBmyfz/5mjAo54vB4ikPmljZKyjANJmApzyMZFo6qBg
ADA5MQswCQYDVQQGEwJVUzEPMA0tMVT8QtPHRh8jrdkGA1UEChMGDV3QQDExBBKW
... content of root CA certificate ...
o/ufQJQWUCyziar1hem9uMRkwFwYVPSHCb2XV4cdFyQzR1KldZwgJcIQ6XUDgHaa
5MsI+yMRQ+hDaXJiobldXgjUka642M4UwtBV8oK2xJNDd2ZhwLnoQdeXeGADKkpy
rqXRfKoQnoZsG4q5WTP46EXAMPLE
-----END CERTIFICATE-----
```
### Konfigurasikan proxy HTTPS pada gateway yang sudah mapan
Anda dapat menambahkan dukungan proxy ke gateway yang sudah mapan dengan menghubungkan ke port 443, bukan port 8883. Untuk informasi selengkapnya tentang menggunakan server proxy, lihat [Connect on port 443 atau melalui proxy jaringan](https://docs.aws.amazon.com/greengrass/v2/developerguide/configure-greengrass-core-v2.html#configure-alpn-network-proxy) di *Panduan AWS IoT Greengrass Version 2 Pengembang*. Jika Anda membuat gateway baru, Anda dapat mengatur konfigurasi proxy selama instalasi gateway. Untuk informasi selengkapnya, lihat [Konfigurasikan pengaturan proxy selama instalasi gateway AWS IoT SiteWise Edge](manage-trust-stores-proxy_config.md).
Saat Anda menggunakan proxy HTTPS dengan AWS IoT Greengrass on SiteWise Edge, perangkat lunak secara otomatis memilih antara HTTP dan HTTPS untuk koneksi proxy berdasarkan URL yang disediakan.
**penting**
Perbarui semua toko kepercayaan yang diperlukan sebelum mencoba terhubung melalui proxy HTTPS.
## Konfigurasikan toko kepercayaan komponen berbasis Java
Untuk SiteWise penerbit IoT, pengumpul IoT SiteWise OPC UA, dan layanan Java dalam paket pemrosesan data, lokasi penyimpanan kepercayaan Java default adalah `$JAVA_HOME/jre/lib/security/cacerts`
**Untuk menambahkan sertifikat**
1. Buat file untuk menyimpan sertifikat server proxy, seperti`proxy.crt`.
**catatan**
Buat file sebelumnya menggunakan sertifikat server proxy.
1. Tambahkan file ke toko kepercayaan Java menggunakan perintah berikut:
```
sudo keytool -import -alias proxyCert -keystore /usr/lib/jvm/java-11-openjdk-amd64/lib/security/cacerts -file proxy.crt
```
1. Saat diminta, gunakan kata sandi default: `changeit`
## Konfigurasi penyimpanan kepercayaan komponen tingkat sistem
Untuk komponen yang ditulis dalam Rust, Go, dan bahasa lain yang menggunakan penyimpanan kepercayaan sistem:
------
#### [ Linux ]
Sistem Linux: Tambahkan sertifikat ke `/etc/ssl/certs/ca-certificates.crt`
------
#### [ Windows ]
Microsoft Windowssistem: Untuk mengonfigurasi toko kepercayaan, ikuti prosedur [Certificate Store](https://learn.microsoft.com/en-us/windows-hardware/drivers/install/certificate-stores) di dokumentasi *Microsoft Ignite*.
Windows menawarkan beberapa toko sertifikat, termasuk toko terpisah untuk cakupan Pengguna dan Komputer, masing-masing dengan beberapa sub-toko. Untuk sebagian besar pengaturan SiteWise Edge, kami sarankan untuk menambahkan sertifikat ke toko. `COMPUTER | Trusted Root Certification Authorities` Namun, tergantung pada konfigurasi spesifik dan persyaratan keamanan Anda, Anda mungkin perlu menggunakan toko yang berbeda.
------
## Memecahkan masalah toko kepercayaan
Untuk informasi selengkapnya tentang menyelesaikan masalah trust store yang terkait dengan gateway SiteWise Edge, lihat[Masalah toko kepercayaan](troubleshooting-gateway.md#troubleshoot-trust-stores).
# Gunakan AWS IoT SiteWise APIs di tepi
AWS IoT SiteWise menyediakan subset dari APIs, bersama dengan spesifik tepi APIs, memungkinkan interaksi tanpa batas dengan model aset dan aset terkait yang digunakan di edge. Model aset ini harus dikonfigurasi untuk berjalan di tepi. Untuk informasi selengkapnya, lihat [Konfigurasikan model aset untuk pemrosesan data di SiteWise Edge](edge-processing.md#process-gateway-data-edge) petunjuk terperinci tentang proses penyiapan ini.
Setelah mengonfigurasinya APIs, Anda dapat mengambil data komprehensif tentang model aset dan aset individual Anda. Mengambil model aset, aset, dasbor, portal, dan informasi proyek dapat membantu Anda memantau portal dan dasbor yang digunakan, serta mengakses data aset yang dikumpulkan di tingkat tepi. Ini menyediakan host pusat di jaringan Anda untuk interaksi dengan AWS IoT SiteWise tanpa memerlukan panggilan API web.
**Topics**
+ [Semua perangkat AWS IoT SiteWise Edge yang tersedia APIs](edge-apis-available.md)
+ [Hanya tepi APIs untuk digunakan dengan AWS IoT SiteWise perangkat tepi](edge-local-apis.md)
+ [Aktifkan CORS di Edge AWS IoT SiteWise APIs](enable-cors-edge-apis.md)
+ [Konfigurasikan batas waktu sesi untuk Edge AWS IoT SiteWise](edge-apis-session-timeout.md)
+ [Tutorial: Daftar model aset pada gateway AWS IoT SiteWise Edge](edge-apis-tutorial.md)
# Semua perangkat AWS IoT SiteWise Edge yang tersedia APIs
AWS IoT SiteWise menyediakan berbagai APIs untuk digunakan pada perangkat edge sehingga Anda dapat menyelesaikan tugas secara lokal di perangkat. Beberapa edge yang tersedia APIs termasuk mengambil model aset, membuat dan memperbarui properti aset, dan mengirim aliran data ke cloud. Dengan memanfaatkan ini APIs, Anda dapat membangun solusi yang dapat beroperasi di lingkungan dengan konektivitas jaringan intermiten atau terbatas.
## Tersedia AWS IoT SiteWise APIs
Berikut ini AWS IoT SiteWise APIs tersedia di perangkat edge:
+ [ListAssetModels](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_ListAssetModels.html)
+ [DescribeAssetModel](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAssetModel.html)
+ [ListAssets](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_ListAssets.html)
+ [DescribeAsset](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAsset.html)
+ [DescribeAssetProperty](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAssetProperty.html)
+ [ListAssociatedAssets](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_ListAssociatedAssets.html)
+ [GetAssetPropertyAggregates](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_GetAssetPropertyAggregates.html)
+ [GetAssetPropertyValue](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_GetAssetPropertyValue.html)
+ [GetAssetPropertyValueHistory](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_GetAssetPropertyValueHistory.html)
+ [ListDashboards](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_ListDashboards.html)
+ [ListPortals](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_ListPortals.html)
+ [ListProjectAssets](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_ListProjectAssets.html)
+ [ListProjects](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_ListProjects.html)
+ [DescribeDashboard](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeDashboard.html)
+ [DescribePortal](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribePortal.html)
+ [DescribeProject](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeProject.html)
## Tersedia hanya tepi APIs
Berikut ini APIs digunakan secara lokal pada perangkat di tepi:
+ [Mengautentikasi](edge-local-apis.md#edge-local-apis-authenticate)— Gunakan API ini untuk mendapatkan kredensyal sementara SigV4 yang akan Anda gunakan untuk melakukan panggilan API.
# Hanya tepi APIs untuk digunakan dengan AWS IoT SiteWise perangkat tepi
Selain AWS IoT SiteWise APIs yang tersedia di tepi, ada yang khusus tepi. Spesifik tepi tersebut dijelaskan di bawah APIs ini.
## Mengautentikasi
Mendapat kredensyal dari gateway SiteWise Edge. Anda harus menambahkan pengguna lokal atau terhubung ke sistem Anda menggunakan LDAP atau kumpulan pengguna Linux. Untuk informasi selengkapnya tentang menambahkan pengguna, lihat [kumpulan pengguna [LDAP](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/manage-gateways-ggv2.html#opshub-app) atau Linux](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/manage-gateways-ggv2.html#opshub-app).
### Sintaksis Permintaan
```
POST /authenticate HTTP/1.1
Content-type: application/json
{
"username": "string",
"password": "string",
"authMechanism": "string"
}
```
### Parameter permintaan URI
Permintaan tidak menggunakan parameter URI apa pun.
### Isi permintaan
Permintaan menerima data berikut dalam format JSON.
**nama pengguna**
Nama pengguna yang digunakan untuk memvalidasi panggilan permintaan.
Tipe: String
Diperlukan: Ya
**password**
Kata sandi pengguna yang meminta kredensil.
Tipe: String
Diperlukan: Ya
**AuthMechanism**
Metode otentikasi untuk memvalidasi pengguna ini di host.
Tipe: String
Nilai valid: `ldap`, `linux`, `winnt`
Wajib: Ya
### Sintaksis Respons
```
HTTP/1.1 200
Content-type: application/json
{
"accessKeyId": "string",
"secretAccessKey": "string",
"sessionToken": "string",
"region": "edge"
}
```
### Elemen jawaban
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.
Data berikut dikembalikan dalam format JSON.
**accessKeyId**
ID kunci akses yang mengidentifikasi kredensil keamanan sementara.
Kendala Panjang: Panjang minimum 16. Panjang maksimum 128.
Pola: `[\w]*`
**secretAccessKey**
Kunci akses rahasia yang dapat digunakan untuk menandatangani permintaan.
Tipe: String
**sessionToken**
Token yang harus diteruskan pengguna ke API layanan untuk menggunakan kredensyal sementara.
Tipe: String
**region**
Wilayah yang Anda targetkan untuk panggilan API.
Jenis: KONSTAN - `edge`
### Kesalahan
**IllegalArgumentException**
Permintaan ditolak karena dokumen badan yang disediakan cacat. Pesan kesalahan menjelaskan kesalahan tertentu.
Kode Status HTTP: 400
**AccessDeniedException**
Pengguna tidak memiliki kredensi yang valid berdasarkan Penyedia Identitas saat ini. Pesan kesalahan menjelaskan Mekanisme otentikasi.
Kode Status HTTP: 403
**TooManyRequestsException**
Permintaan telah mencapai batas upaya otentikasi. Pesan kesalahan berisi jumlah waktu untuk menunggu sampai upaya otentikasi baru dilakukan.
Kode Status HTTP: 429
# Aktifkan CORS di Edge AWS IoT SiteWise APIs
Mengaktifkan CORS (Cross-Origin Resource Sharing) di AWS IoT SiteWise Edge APIs memungkinkan aplikasi web untuk berkomunikasi langsung dengan APIs berbagai domain. Hal ini memungkinkan integrasi tanpa batas, pertukaran data real-time, dan akses data lintas domain tanpa server perantara atau solusi. Pengaturan CORS dapat dikonfigurasi untuk menentukan asal yang diizinkan, memastikan akses lintas asal yang terkontrol.
**catatan**
CORS tersedia untuk versi 3.3.1 dan yang lebih baru dari Fitur ini tersedia untuk versi 3.3.1 dan yang lebih baru dari komponen. `aws.iot.SiteWiseEdgeProcessor` Untuk informasi selengkapnya, lihat [AWS IoT SiteWise prosesor](https://docs.aws.amazon.com/greengrass/v2/developerguide/iotsitewise-processor-component.html) di *Panduan AWS IoT Greengrass Version 2 Pengembang*.
**Untuk mengaktifkan CORS di SiteWise Edge APIs**
1. Navigasikan ke [konsol AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/) tersebut.
1. Di panel navigasi, pilih **gateway Edge**.
1. Pilih gateway SiteWise Edge yang ingin Anda aktifkan CORS. Anda dapat mengaktifkan CORS pada jenis AWS IoT Greengrass V2 penerapan.
1. Di bagian **konfigurasi Gateway**, pilih perangkat inti **Greengrass** terkait.
1. Di tab **Deployment**, di bawah Perangkat Greengrass, pilih **tautan penerapan yang sesuai**.
1. Di bawah **Tindakan** pilih **Revisi**, lalu **Revisi penerapan**.
**penting**
Membuat konfigurasi berkemampuan CORS yang direvisi menggantikan konfigurasi perangkat saat ini.
1. Di **Langkah 1, Tentukan target**, berikan **Nama** opsional untuk mengidentifikasi penyebaran.
1. **Pada **Langkah 2, Pilih komponen - opsional**, Anda dapat membiarkan semua pilihan saat ini apa adanya dan memilih Berikutnya.**
1. Pada **Langkah 3, Konfigurasikan komponen - opsional**, pilih **aws.iot. SiteWiseEdgeProcessor**, dan pilih **Configure component**.
1. Di bagian Pembaruan konfigurasi, di bawah Konfigurasi untuk digabungkan, masukkan JSON berikut:
```
{
"AWS_SITEWISE_EDGE_ACCESS_CONTROL_ALLOW_ORIGIN": "*"
}
```
**catatan**
Menggunakan `*` sebagai nilai untuk `AWS_SITEWISE_EDGE_ACCESS_CONTROL_ALLOW_ORIGIN` memungkinkan semua asal. Untuk lingkungan produksi, disarankan untuk menentukan asal yang tepat URLs untuk keamanan yang lebih baik.
1. Pilih **Konfirmasi**.
1. Pilih **Berikutnya** untuk melanjutkan melalui langkah-langkah yang tersisa sampai Anda tiba di **Step5, Review**.
1. Tinjau perubahan konfigurasi Anda, lalu pilih **Deploy** untuk menerapkan perubahan ke gateway SiteWise Edge Anda.
**catatan**
Atau, Anda dapat mengaktifkan CORS dengan menyetel global variabel lingkungan `AWS_SITEWISE_EDGE_ACCESS_CONTROL_ALLOW_ORIGIN` ke `*` AWS IoT SiteWise gateway Anda.
**catatan**
Untuk proxy yang diautentikasi, `userinfo` harus disertakan dalam `url` bidang dalam konfigurasi proxy daripada sebagai terpisah `username` dan `password` bidang.
Setelah penerapan selesai, CORS diaktifkan di SiteWise Edge API Anda, memungkinkan asal yang ditentukan untuk membuat permintaan lintas asal ke API.
# Konfigurasikan batas waktu sesi untuk Edge AWS IoT SiteWise
SiteWise Edge memungkinkan Anda mengonfigurasi batas waktu sesi untuk SiteWise Edge API. Fitur ini meningkatkan keamanan dengan secara otomatis menghentikan sesi tidak aktif setelah jangka waktu tertentu. Bagian ini memandu Anda melalui proses mengonfigurasi batas waktu sesi menggunakan. Konsol AWS IoT SiteWise
**catatan**
Konfigurasi batas waktu sesi tersedia untuk versi 3.4.0 dan yang lebih baru dari komponen. `aws.iot.SiteWiseEdgeProcessor` Untuk informasi selengkapnya, lihat [AWS IoT SiteWise prosesor](https://docs.aws.amazon.com/greengrass/v2/developerguide/iotsitewise-processor-component.html) di *Panduan AWS IoT Greengrass Version 2 Pengembang*.
**Untuk mengonfigurasi batas waktu sesi untuk gateway SiteWise Edge**
1. Navigasikan ke [konsol AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/) tersebut.
1. Di panel navigasi, pilih **gateway Edge**.
1. Pilih gateway SiteWise Edge tempat Anda ingin mengonfigurasi batas waktu sesi.
**catatan**
Anda dapat mengonfigurasi batas waktu sesi pada jenis AWS IoT Greengrass V2 penerapan.
1. Di bagian **konfigurasi Gateway**, pilih perangkat inti **Greengrass** terkait.
1. Di tab **Deployment**, di bawah Perangkat Greengrass, pilih **tautan penerapan yang sesuai**.
1. Di bawah **Tindakan** pilih **Revisi**. Baca peringatan, lalu pilih **Revise deployment**.
**penting**
Membuat konfigurasi batas waktu sesi yang direvisi menggantikan konfigurasi perangkat saat ini.
1. **Pada **Langkah 1, Tentukan target**, berikan **Nama** opsional untuk mengidentifikasi penyebaran yang direvisi, lalu pilih Berikutnya.**
1. **Pada **Langkah 2, Pilih komponen - opsional**, Anda dapat membiarkan semua pilihan saat ini apa adanya dan memilih Berikutnya.**
1. Pada **Langkah 3, Konfigurasikan komponen - opsional**, pilih **aws.iot. SiteWiseEdgeProcessor**, dan pilih **Configure component**.
1. Di bagian **Pembaruan konfigurasi**, di bawah **Konfigurasi untuk digabungkan**, masukkan JSON berikut:
```
{
"AWS_SITEWISE_EDGE_SESSION_TIMEOUT_MINUTES": "240"
}
```
1. Tetapkan nilainya `AWS_SITEWISE_EDGE_SESSION_TIMEOUT_MINUTES` dalam hitungan menit. Nilai batas waktu sesi dapat dari 1 menit hingga 10080 menit (7 hari). Nilai default adalah 240 menit (4 jam).
1. Pilih **Konfirmasi**.
1. Pilih **Berikutnya** untuk melanjutkan melalui langkah-langkah yang tersisa sampai Anda tiba di Langkah 5, **Tinjau**.
1. Tinjau perubahan konfigurasi Anda, lalu pilih **Deploy** untuk menerapkan perubahan ke gateway SiteWise Edge Anda.
**catatan**
Atau, Anda dapat mengonfigurasi batas waktu sesi dengan menyetel variabel lingkungan global **AWS\$1SITEWISE\$1EDGE\$1SESSION\$1TIMEOUT\$1MINUTES ke nilai yang Anda inginkan (dalam hitungan menit**) di gateway Edge Anda. SiteWise
Setelah penerapan selesai, konfigurasi batas waktu sesi baru diterapkan ke SiteWise Edge API Anda.
# Tutorial: Daftar model aset pada gateway AWS IoT SiteWise Edge
Anda dapat menggunakan subset yang tersedia AWS IoT SiteWise APIs bersama dengan edge-specific APIs untuk berinteraksi dengan model aset dan asetnya di edge. Tutorial ini akan memandu Anda mendapatkan kredensyal sementara ke gateway AWS IoT SiteWise Edge dan mendapatkan daftar model aset di gateway SiteWise Edge.
## Prasyarat
Dalam langkah-langkah tutorial ini Anda dapat menggunakan berbagai alat. Untuk menggunakan alat ini, pastikan Anda telah menginstal prasyarat yang sesuai.
Untuk menyelesaikan tutorial ini, Anda memerlukan hal berikut:
+ Sebuah dikerahkan dan berjalan [AWS IoT SiteWise Persyaratan gateway yang dihosting sendiri di Edge](configure-gateway-ggv2.md)
+ Akses ke gateway SiteWise Edge Anda di jaringan yang sama melalui port 443.
+ [OpenSSL diinstal](https://www.openssl.org/)
+ (AWS OpsHub untuk AWS IoT SiteWise) [AWS IoT SiteWise Aplikasi AWS OpsHub untuk](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/manage-gateways-ggv2.html#opshub-app)
+ (curl) [curl](https://ec.haxx.se/install/) terpasang
+ [(Python) urllib3 diinstal](https://urllib3.readthedocs.io/en/stable/index.html)
+ [(Python) Python3 diinstal](https://www.python.org/downloads/)
+ [(Python) Boto3 diinstal](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html)
+ (Python) diinstal [BotoCore](https://botocore.amazonaws.com/v1/documentation/api/latest/index.html)
## Langkah 1: Dapatkan sertifikat yang ditandatangani layanan gateway SiteWise Edge
Untuk membuat koneksi TLS ke yang APIs tersedia di gateway SiteWise Edge, Anda memerlukan sertifikat tepercaya. Anda dapat membuat sertifikat ini menggunakan AWS OpsHub OpenSSL atau for. AWS IoT SiteWise
------
#### [ OpenSSL ]
**catatan**
Anda perlu [OpenSSL](https://www.openssl.org/) diinstal untuk menjalankan perintah ini.
Buka terminal dan jalankan perintah berikut untuk mendapatkan sertifikat yang ditandatangani dari gateway SiteWise Edge. Ganti `` dengan IP gateway SiteWise Edge.
```
openssl s_client -connect :443 /dev/null | openssl x509 -outform PEM > GatewayCert.pem
```
------
#### [ AWS OpsHub for AWS IoT SiteWise ]
Anda dapat menggunakan AWS OpsHub untuk AWS IoT SiteWise. Untuk informasi selengkapnya, lihat [Kelola SiteWise gateway Edge](manage-gateways-ggv2.md).
------
Jalur absolut ke sertifikat gateway SiteWise Edge yang diunduh digunakan dalam tutorial ini. Jalankan perintah berikut untuk mengekspor jalur lengkap sertifikat Anda, ganti `` dengan jalur ke sertifikat:
```
export PATH_TO_CERTIFICATE=''
```
## Langkah 2: Dapatkan nama host gateway SiteWise Edge Anda
**catatan**
Anda perlu [OpenSSL](https://www.openssl.org/) diinstal untuk menjalankan perintah ini.
Untuk menyelesaikan tutorial, Anda memerlukan nama host gateway SiteWise Edge Anda. Untuk mendapatkan nama host gateway SiteWise Edge Anda, jalankan yang berikut ini, ganti `` dengan IP gateway SiteWise Edge:
```
openssl s_client -connect :443 /dev/null | grep -Po 'CN = \K.*'| head -1
```
Jalankan perintah berikut untuk mengekspor nama host untuk digunakan nanti, ganti `` dengan nama host gateway SiteWise Edge Anda:
```
export GATEWAY_HOSTNAME=''
```
## Langkah 3: Dapatkan kredensyal sementara untuk gateway Edge Anda SiteWise
Sekarang setelah Anda memiliki sertifikat yang ditandatangani dan nama host gateway SiteWise Edge Anda, Anda perlu mendapatkan kredensyal sementara sehingga Anda dapat berjalan APIs di gateway. Anda bisa mendapatkan kredensyal ini melalui AWS OpsHub untuk AWS IoT SiteWise atau langsung dari gateway SiteWise Edge menggunakan. APIs
**penting**
Kredensil kedaluwarsa setiap 4 jam, jadi Anda harus mendapatkan kredensialnya sebelum menggunakan gateway di APIs Edge Anda. SiteWise Jangan menyimpan kredensil selama lebih dari 4 jam.
### Dapatkan kredensyal sementara menggunakan for AWS OpsHub AWS IoT SiteWise
**catatan**
Anda memerlukan [AWS IoT SiteWise aplikasi AWS OpsHub for](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/manage-gateways-ggv2.html#opshub-app) diinstal.
Untuk menggunakan AWS IoT SiteWise aplikasi AWS OpsHub untuk mendapatkan kredensi sementara Anda lakukan hal berikut:
1. Masuk ke aplikasi.
1. Pilih **Pengaturan**.
1. Untuk **Otentikasi**, pilih **Salin kredensyal**.
1. Perluas opsi yang sesuai dengan lingkungan Anda dan pilih **Salin**.
1. Simpan kredensialnya untuk digunakan nanti.
### Dapatkan kredensyal sementara menggunakan SiteWise Edge gateway API
Untuk menggunakan SiteWise Edge gateway API untuk mendapatkan kredensyal sementara, Anda dapat menggunakan skrip Python atau curl, pertama-tama Anda harus memiliki nama pengguna dan kata sandi untuk gateway Edge Anda. SiteWise Gateway SiteWise Edge menggunakan otentikasi dan otorisasi SiGv4. Untuk informasi selengkapnya tentang menambahkan pengguna, lihat [kumpulan pengguna [LDAP](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/manage-gateways-ggv2.html#opshub-app) atau Linux](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/manage-gateways-ggv2.html#opshub-app). Kredensyal ini akan digunakan dalam langkah-langkah berikut untuk mendapatkan kredensyal lokal di gateway SiteWise Edge Anda yang diperlukan untuk menggunakan. AWS IoT SiteWise APIs
------
#### [ Python ]
**catatan**
[Anda perlu menginstal [urllib3 dan Python3](https://urllib3.readthedocs.io/en/stable/index.html).](https://www.python.org/downloads/)
**Untuk mendapatkan kredensialnya menggunakan Python**
1. Buat file bernama **get\$1credentials.py** dan salin kode berikut ke dalamnya.
```
'''
The following demonstrates how to get the credentials from the SiteWise Edge gateway. You will need to add local users or connect your system to LDAP/AD
https://docs.aws.amazon.com/iot-sitewise/latest/userguide/manage-gateways-ggv2.html#create-user-pool
Example usage:
python3 get_credentials.py -e https:// -c -u '' -p '' -m ''
'''
import urllib3
import json
import urllib.parse
import sys
import os
import getopt
"""
This function retrieves the AWS IoT SiteWise Edge gateway credentials.
"""
def get_credentials(endpoint,certificatePath, user, password, method):
http = urllib3.PoolManager(cert_reqs='CERT_REQUIRED', ca_certs= certificatePath)
encoded_body = json.dumps({
"username": user,
"password": password,
"authMechanism": method,
})
url = urllib.parse.urljoin(endpoint, "/authenticate")
response = http.request('POST', url,
headers={'Content-Type': 'application/json'},
body=encoded_body)
if response.status != 200:
raise Exception(f'Failed to authenticate! Response status {response.status}')
auth_data = json.loads(response.data.decode('utf-8'))
accessKeyId = auth_data["accessKeyId"]
secretAccessKey = auth_data["secretAccessKey"]
sessionToken = auth_data["sessionToken"]
region = "edge"
return accessKeyId, secretAccessKey, sessionToken, region
def print_help():
print('Usage:')
print(f'{os.path.basename(__file__)} -e -c -u -p -m -a ')
print('')
print('-e, --endpoint edge gateway endpoint. Usually the Edge gateway hostname.')
print('-c, --cert_path path to downloaded gateway certificate')
print('-u, --user Edge user')
print('-p, --password Edge password')
print('-m, --method (Optional) Authentication method (linux, winnt, ldap), default is linux')
sys.exit()
def parse_args(argv):
endpoint = ""
certificatePath = None
user = None
password = None
method = "linux"
try:
opts, args = getopt.getopt(argv, "he:c:u:p:m:", ["endpoint=","cert_path=", "user=", "password=", "method="])
except getopt.GetoptError:
print_help()
for opt, arg in opts:
if opt == '-h':
print_help()
elif opt in ("-e", "--endpoint"):
endpoint = arg
elif opt in ("-u", "--user"):
user = arg
elif opt in ("-p", "--password"):
password = arg
elif opt in ("-m", "--method"):
method = arg.lower()
elif opt in ("-c", "--cert_path"):
certificatePath = arg
if method not in ['ldap', 'linux', 'winnt']:
print("not valid method parameter, required are ldap, linux, winnt")
print_help()
if (user == None or password == None):
print("To authenticate against edge user, password have to be passed together, and the region has to be set to 'edge'")
print_help()
if(endpoint == ""):
print("You must provide a valid and reachable gateway hostname")
print_help()
return endpoint,certificatePath, user, password, method
def main(argv):
# get the command line args
endpoint, certificatePath, user, password, method = parse_args(argv)
accessKeyId, secretAccessKey, sessionToken, region=get_credentials(endpoint, certificatePath, user, password, method)
print("Copy and paste the following credentials into the shell, they are valid for 4 hours:")
print(f"export AWS_ACCESS_KEY_ID={accessKeyId}")
print(f"export AWS_SECRET_ACCESS_KEY={secretAccessKey}")
print(f"export AWS_SESSION_TOKEN={sessionToken}")
print(f"export AWS_REGION={region}")
print()
if __name__ == "__main__":
main(sys.argv[1:])
```
1. Jalankan **get\$1credentials.py** dari terminal menggantikan `` dan `` dengan kredensil yang Anda buat.
```
python3 get_credentials.py -e https://$GATEWAY_HOSTNAME -c $PATH_TO_CERTIFICATE -u '' -p '' -m 'linux'
```
------
#### [ curl ]
**catatan**
Anda perlu menginstal [curl](https://ec.haxx.se/install/).
**Untuk mendapatkan kredensil menggunakan curl**
1. Jalankan perintah berikut dari penggantian terminal dan dengan kredensyal yang Anda buat.
```
curl --cacert $PATH_TO_CERTIFICATE --location \
-X POST https://$GATEWAY_HOSTNAME:443/authenticate \
--header 'Content-Type: application/json' \
--data-raw '{
"username": "",
"password": "",
"authMechanism": "linux"
}'
```
Responsnya akan terlihat seperti berikut:
```
{
"username": "sweuser",
"accessKeyId": "",
"secretAccessKey": "",
"sessionToken": "",
"sessionExpiryTime": "2022-11-17T04:51:40.927095Z",
"authMechanism": "linux",
"role": "edge-user"
}
```
1. Jalankan perintah berikut dari terminal Anda.
```
export AWS_ACCESS_KEY_ID=
export AWS_SECRET_ACCESS_KEY=
export AWS_SESSION_TOKEN=
export AWS_REGION=edge
```
------
## Langkah 4: Dapatkan daftar model aset di gateway SiteWise Edge
Sekarang setelah Anda memiliki sertifikat yang ditandatangani, nama host gateway SiteWise Edge Anda, dan kredensyal sementara untuk gateway SiteWise Edge Anda, Anda dapat menggunakan `ListAssetModels` API untuk mendapatkan daftar model aset di gateway Edge Anda SiteWise .
------
#### [ Python ]
**catatan**
Anda perlu [Python3, [Boto3](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html)](https://www.python.org/downloads/), dan diinstal. [BotoCore](https://botocore.amazonaws.com/v1/documentation/api/latest/index.html)
**Untuk mendapatkan daftar model aset menggunakan Python**
1. Buat file bernama **list\$1asset\$1model.py** dan salin kode berikut ke dalamnya.
```
import json
import boto3
import botocore
import os
# create the client using the credentials
client = boto3.client("iotsitewise",
endpoint_url= "https://"+ os.getenv("GATEWAY_HOSTNAME"),
region_name=os.getenv("AWS_REGION"),
aws_access_key_id=os.getenv("AWS_ACCESS_KEY_ID"),
aws_secret_access_key=os.getenv("AWS_SECRET_ACCESS_KEY"),
aws_session_token=os.getenv("AWS_SESSION_TOKEN"),
verify=os.getenv("PATH_TO_CERTIFICATE"),
config=botocore.config.Config(inject_host_prefix=False))
# call the api using local credentials
response = client.list_asset_models()
print(response)
```
1. Jalankan **list\$1asset\$1model.py** dari terminal.
```
python3 list_asset_model.py
```
------
#### [ curl ]
**catatan**
Anda perlu menginstal [curl](https://ec.haxx.se/install/).
**Untuk mendapatkan daftar model aset menggunakan curl**
Jalankan perintah berikut dari terminal.
```
curl \
--request GET https://$GATEWAY_HOSTNAME:443/asset-models \
--cacert $PATH_TO_CERTIFICATE \
--aws-sigv4 "aws:amz:edge:iotsitewise" \
--user "$AWS_ACCESS_KEY_ID:$AWS_SECRET_ACCESS_KEY" \
-H "x-amz-security-token:$AWS_SESSION_TOKEN"
```
Responsnya akan terlihat seperti berikut:
```
{
"assetModelSummaries": [
{
"arn": "arn:aws:iotsitewise:{region}:{account-id}:asset-model/{asset-model-id}",
"creationDate": 1.669245291E9,
"description": "This is a small example asset model",
"id": "{asset-model-id}",
"lastUpdateDate": 1.669249038E9,
"name": "Some Metrics Model",
"status": {
"error": null,
"state": "ACTIVE"
}
},
.
.
.
],
"nextToken": null
}
```
------
# Host gateway SiteWise Edge di Siemens Industrial Edge
Host gateway Anda di Siemens Industrial Edge menggunakan aplikasi AWS IoT SiteWise Edge. Sama seperti halnya AWS IoT Greengrass V2, Anda dapat mengoptimalkan proses manufaktur atau meningkatkan alur kerja operasional menggunakan SiteWise Edge onSiemens Industrial Edge.
Anda dapat menyerap data dari perangkat Siemens Industrial Edge ke AWS akun Anda dengan menjalankan gateway SiteWise Edge di perangkat. Untuk melakukan ini, minta akses ke aplikasi AWS IoT SiteWise Edge dari tim dukungan SiteWise Edge. Kemudian, buat sumber daya gateway SiteWise Edge dengan target penerapan **perangkat Siemens Industrial Edge** - baru. Selanjutnya, unduh file konfigurasi, dan unggah ke aplikasi Anda melalui Siemens Industrial Edge Management portal. Untuk informasi selengkapnya tentang menjalankan aplikasiSiemens Industrial Edge, termasuk cara menyiapkan Siemens sumber daya yang diperlukan, lihat [Apa itu Industrial Edge?](https://docs.eu1.edge.siemens.cloud/) dalam dokumentasi Siemens.
**catatan**
Siemens bukan vendor atau pemasok untuk SiteWise Edge. Siemens Industrial EdgeMarketplace adalah pasar independen.
**Topics**
+ [Keamanan](#sa-security)
+ [Siemens Secure Storagedan aplikasi AWS IoT SiteWise Edge](#sa-secure-storage)
+ [Tujuan untuk Siemens Industrial Edge perangkat](#siemens-destinations)
+ [Migrasi dari aplikasi pratinjau](#sa-migrate)
+ [Pemecahan masalah](#sa-troubleshoot)
+ [AWS IoT SiteWise Changelog aplikasi tepi](#sa-changelog)
+ [Persyaratan untuk aplikasi AWS IoT SiteWise Edge](siemens-app-gateway-requirements.md)
+ [Buat gateway untuk Siemens Industrial Edge](sa-create-config.md)
+ [Buat Siemens Databus user untuk aplikasi](sa-databus-user.md)
+ [Akses aplikasi AWS IoT SiteWise Edge](sa-get-app.md)
+ [Instal aplikasi ke Siemens perangkat](sa-install-app.md)
+ [Perbarui konfigurasi aplikasi AWS IoT SiteWise Edge](sa-update-config.md)
+ [AWS IoT SiteWise — Data yang dihasilkan oleh penggunaan layanan ini](sa-data-legal.md)
## Keamanan
Sebagai bagian dari [Model Tanggung Jawab Bersama](https://aws.amazon.com/compliance/shared-responsibility-model/) antara AWS, pelanggan kami, dan mitra kami, berikut ini menjelaskan siapa yang bertanggung jawab atas berbagai aspek keamanan:
**Tanggung jawab pelanggan**
+ Memeriksa pasangan.
+ Mengkonfigurasi akses jaringan yang diberikan kepada mitra.
+ Secara fisik mengamankan perangkat yang menjalankan SiteWise Edge.
**AWS tanggung jawab**
+ Mengisolasi mitra dari sumber daya AWS Cloud pelanggan.
**Tanggung jawab mitra**
+ Menggunakan default yang aman.
+ Menjaga solusi tetap aman dari waktu ke waktu melalui tambalan dan pembaruan lain yang sesuai.
+ Menjaga kerahasiaan data pelanggan.
+ Memeriksa aplikasi lain yang tersedia di pasar mitra.
## Siemens Secure Storagedan aplikasi AWS IoT SiteWise Edge
Untuk melindungi kredensil dan rahasia yang diperlukan untuk menjalankan aplikasi AWS IoT SiteWise Edge, Siemens Industrial Edge sediakan mekanisme untuk menyimpan kredensil dengan aman di perangkat. Aplikasi AWS IoT SiteWise Edge tidak akan berjalan di perangkat jika tidak memiliki dukungan untuk menyimpan kredensil ini dengan aman. Kegagalan jalankan yang disebabkan oleh dukungan Penyimpanan Aman yang hilang dicatat dalam file log.
Versi OS minimum berikut diperlukan untuk menginstal dan menjalankan aplikasi AWS IoT SiteWise Edge. Tingkatkan perangkat Anda ke versi terbaru untuk menginstal aplikasi.
+ **Untuk perangkat virtual:** IEVD versi 1.19 atau lebih tinggi
+ **Untuk perangkat fisik:** IED-OS versi 2.2 atau lebih tinggi
Aplikasi AWS IoT SiteWise Edge aktif tidak Siemens Industrial Edge akan berjalan sampai Anda memutakhirkan perangkat Anda.
## Tujuan untuk Siemens Industrial Edge perangkat
Saat menggunakan aplikasi AWS IoT SiteWise Edge aktifSiemens Industrial Edge, tujuan membantu menyiapkan data sebelum mengirimnya AWS IoT SiteWise untuk analisis dan distribusi lebih lanjut. Anda dapat mengonfigurasi setelan tujuan data untuk konsumsi data buffer menggunakan Amazon S3 atau menggunakan konsumsi data waktu nyata. Keduanya memungkinkan Anda berlangganan topik MQTT menggunakan filter jalur pada target penyebaran Siemens Industrial Edge perangkat.
Target Siemens Industrial Edge penerapan pada gateway Anda mendukung dua metode penanganan data utama:
+ **AWS IoT SiteWise pengaturan waktu nyata** - Data dikirim langsung ke AWS IoT SiteWise saat dikumpulkan
+ **AWS IoT SiteWise buffer menggunakan pengaturan Amazon S3** - Data dikumpulkan dan disimpan sementara dalam batch sebelum dikirim ke Amazon S3
Untuk informasi selengkapnya tentang mengonfigurasi opsi ini, lihat [Tambahkan tujuan AWS IoT SiteWise buffer menggunakan Amazon S3](destinations-buffered.md) dan[Menambahkan tujuan real-time AWS IoT SiteWise Edge](destinations-real-time.md).
### Awalan untuk filter jalur
Filter jalur untuk gateway yang menggunakan target Siemens Industrial Edge penerapan menggabungkan topik dan nama aliran data untuk membuat pengenal unik untuk data Anda. Topik gabungan dengan nama aliran data disebut **awalan** di Siemens Industrial Edge gateway. Ini berbeda dari gateway yang dihosting sendiri di mana filter jalur hanya didasarkan pada topik MQTT.
**Example Struktur filter jalur untuk aliran data Siemens**
Filter jalur khas untuk aliran data Siemens mencakup jalur topik dan nama aliran data:
```
ie/d/device1/application1/datastream1
```
Di mana:
+ `ie/d/`adalah awalan yang diperlukan untuk aliran data Siemens
+ `device1/application1`mewakili jalur hierarkis
+ `datastream1`adalah nama aliran data spesifik
**catatan**
Saat bekerja dengan aliran Siemens Industrial Edge data, pastikan Anda menyertakan topik metadata (`ie/m/`) dan data (`ie/d/`) di filter jalur Anda untuk menerima informasi lengkap tentang aliran data Anda.
#### Tujuan dan filter jalur
Lihat topik berikut untuk mempelajari lebih lanjut tentang tujuan dan filter jalur di gateway berkemampuan MQTT:
+ [Memahami tujuan AWS IoT SiteWise Edge](gw-destinations.md#source-destination)
+ [Menambahkan tujuan real-time AWS IoT SiteWise Edge](destinations-real-time.md)
+ [Tambahkan tujuan AWS IoT SiteWise buffer menggunakan Amazon S3](destinations-buffered.md)
+ [Memahami filter jalur untuk tujuan AWS IoT SiteWise EdgeMemahami filter jalur](gw-destinations.md#destinations-path-filters)
+ [Tambahkan filter jalur ke tujuan AWS IoT SiteWise Edge](destinations-add-path-filters.md)
+ [Kelola tujuan AWS IoT SiteWise Edge](destinations-manage.md)
## Migrasi dari aplikasi pratinjau
Jika Anda menjalankan SiteWise Edge Siemens Industrial Edge selama fase pratinjau, Anda harus meningkatkan dari versi pratinjau, versi 1.0.1, ke versi terbaru. Lakukan hal berikut untuk bermigrasi:
1. Buat gateway SiteWise Edge baru. Untuk informasi selengkapnya, lihat [Buat gateway untuk Siemens Industrial Edge](sa-create-config.md).
1. Buat yang baru Siemens Databus user untuk setiap gateway baru. Untuk informasi selengkapnya, lihat [Buat Siemens Databus user untuk aplikasi](sa-databus-user.md).
1. Copot pemasangan aplikasi gateway AWS IoT SiteWise Edge versi 1.0.1 di IED Anda.
**catatan**
Bersiaplah untuk interupsi aliran data saat Anda mengkonfigurasi ulang AWS IoT SiteWise aset yang sebelumnya digunakan oleh versi pratinjau aplikasi Edge. AWS IoT SiteWise Sementara riwayat data dipertahankan, ada potensi kehilangan data saat Anda menginstal ulang gateway baru.
1. Hapus gateway SiteWise Edge yang Anda buat selama pratinjau di. [Konsol AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/home?region=us-east-1#/gateway)
1. Instal aplikasi gateway AWS IoT SiteWise Edge di IED menggunakan file konfigurasi gateway baru. Untuk informasi selengkapnya, lihat [Instal aplikasi ke Siemens perangkat](sa-install-app.md).
**penting**
Menginstal gateway baru menimpa versi pratinjau aplikasi SiteWise Edge. Tidak mungkin untuk kembali ke versi 1.0.1 setelah menginstal versi saat ini.
Setelah mengonfigurasi gateway baru danSiemens Databus user, data Anda mengalir ke properti Anda.
Anda juga dapat meningkatkan aplikasi SiteWise Edge Anda dari versi secara langsung. Namun, konfigurasi gateway baru masih diperlukan.
## Pemecahan masalah
Untuk memecahkan masalah gateway SiteWise Edge di Siemens Industrial Edge perangkat Anda, lihat. [Memecahkan masalah aplikasi AWS IoT SiteWise Edge pada Siemens Industrial Edge](troubleshooting-gateway.md#troubleshoot-siemens-app)
Anda juga dapat mengakses [AWS re:Post](https://repost.aws) untuk menemukan jawaban atas pertanyaan Anda.
## AWS IoT SiteWise Changelog aplikasi tepi
Tabel berikut menjelaskan perubahan di setiap versi aplikasi AWS IoT SiteWise Edge.
| **Versi** | **Perubahan** |
| --- | --- |
| 3.0.1 | Perbaikan bug dan peningkatan [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/iot-sitewise/latest/userguide/sitewise-edge-on-siemens.html) |
| 3.0.0 | Fitur baru [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/iot-sitewise/latest/userguide/sitewise-edge-on-siemens.html) Perbaikan bug dan peningkatan [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/iot-sitewise/latest/userguide/sitewise-edge-on-siemens.html) |
| 2.0.1 | Perbaikan bug dan peningkatan [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/iot-sitewise/latest/userguide/sitewise-edge-on-siemens.html) |
| 2.0.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/iot-sitewise/latest/userguide/sitewise-edge-on-siemens.html) |
| 1.0.1 | Rilis awal |
# Persyaratan untuk aplikasi AWS IoT SiteWise Edge
Untuk menjalankan AWS IoT SiteWise Edge onSiemens Industrial Edge, Anda memerlukan yang berikut ini:
+ Akun [Platform Pertukaran Digital Siemens](https://www.dex.siemens.com/).
+ Akun Siemens Industrial Edge Hub (iehub).
+ Sebuah Siemens Industrial Edge Management contoh.
+ Layanan Konfigurasi Aplikasi IE. Untuk mempelajari lebih lanjut, lihat [https://docs.eu1.edge.siemens.cloud/get_started_and_operate/industrial_edge_management/how_to_setup_operate/vm/operation/app_projects/app_configurations/ie_application_configuration_service/installing_the_ie_acs_manually.html](https://docs.eu1.edge.siemens.cloud/get_started_and_operate/industrial_edge_management/how_to_setup_operate/vm/operation/app_projects/app_configurations/ie_application_configuration_service/installing_the_ie_acs_manually.html)di *Siemens Industrial Edge Management*dokumentasi.
+ Akses ke versi 2.0.1 atau lebih tinggi dari aplikasi AWS IoT SiteWise Edge. Untuk informasi selengkapnya, lihat [Akses aplikasi AWS IoT SiteWise Edge](sa-get-app.md).
+ Baik Siemens Industrial Edge Perangkat (IED) atau Perangkat Siemens Industrial Edge virtual (IEVD).
+ Minimal ruang disk 15 GB untuk kebutuhan perangkat keras.
+ 1 GB RAM dengan tambahan 1 GB memori swap.
+ Konfigurasi perangkat untuk memungkinkan lalu lintas keluar pada port 443 dan 8883.
+ Prosesor x86-64 bit.
+ Siemens Industrial Edge Managementversi 1.13.10 atau lebih tinggi.
+ Kesesuaian perangkat dengan persyaratan. Siemens Secure Storage
+ Pada perangkat virtual, IEVD versi 1.19 atau lebih tinggi.
+ Pada perangkat fisik, IED-OS versi 2.2 atau lebih tinggi.
+ Versi terbaru dariDocker Compose.
+ Docker Engineversi 18.091 atau lebih tinggi.
+ Akses domain yang diperlukan. Untuk informasi selengkapnya, lihat [AWS IoT SiteWise titik akhir](endpoints-and-quotas.md#endpoints).
# Buat gateway untuk Siemens Industrial Edge
**Setelah Anda memiliki akun Siemens dan instans IEM yang tepat, Anda dapat membuat gateway SiteWise Edge dari perangkat jenis penyebaran Siemens Industrial Edge.**
**catatan**
Pastikan Anda memenuhi semua persyaratan untuk menjalankan perangkatSiemens Industrial Edge Management. Untuk informasi selengkapnya, lihat [Persyaratan untuk aplikasi AWS IoT SiteWise Edge](siemens-app-gateway-requirements.md).
**Untuk membuat file konfigurasi**
1. Navigasikan ke [konsol AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/) tersebut.
1. Di panel navigasi, pilih **gateway Edge**.
1. Pilih **Buat gateway**.
1. Untuk **jenis Deployment**, pilih perangkat **Siemens Industrial** Edge.
1. Masukkan nama untuk gateway SiteWise Edge Anda atau gunakan nama yang dihasilkan oleh AWS IoT SiteWise.
1. (Opsional) Di bawah **konfigurasi lanjutan**, lakukan hal berikut:
1. Masukkan nama untuk AWS IoT Core Benda Anda atau gunakan nama yang dihasilkan oleh AWS IoT SiteWise.
1. Pilih **Buat gateway**.
1. Di kotak dialog **Generate SiteWise Edge gateway configuration file**, pilih **Generate and download**. AWS IoT SiteWise secara otomatis menghasilkan file konfigurasi yang akan Anda gunakan untuk mengkonfigurasi aplikasi AWS IoT SiteWise Edge.
**penting**
Simpan file konfigurasi gateway Anda sebagai cadangan jika Anda perlu memulihkan instance aplikasi AWS IoT SiteWise Edge Anda. Anda dapat menyimpan file konfigurasi gateway SiteWise Edge Anda dengan aman [AWS Secrets Manager](https://docs.aws.amazon.com/secretsmanager/latest/userguide/intro.html)untuk tujuan ini. Secrets Manager menyimpan, mengelola, dan mengambil informasi sensitif dengan aman. Jika Anda salah menempatkan atau menghapus file konfigurasi ini, Anda tidak akan dapat menghubungkan kembali instance aplikasi AWS IoT SiteWise Edge Anda ke gateway aslinya jika Anda perlu memulihkannya. Anda harus membuat gateway baru dan file konfigurasi baru.
# Buat Siemens Databus user untuk aplikasi
AWS IoT SiteWise Edge on Siemens Industrial Edge mencerna data dari Siemens Databus aplikasi. Untuk menghubungkan SiteWise Edge keSiemens Databus, Anda memerlukan Siemens Databus user yang menyediakan akses ke data yang ingin Anda transfer dengan aman. AWS IoT SiteWise Untuk memulai, buat Siemens Databus user dan kemudian berikan kredensialnya ke aplikasi SiteWise Edge.
**Untuk membuat Siemens Databus user**
1. Dalam Siemens Industrial Edge Management contoh Anda, pilih **Edge Management** di bagian **Aplikasi Platform**.
1. Pilih ikon **Koneksi data**.
1. Pilih **Databus**. Daftar perangkat Anda yang terhubung akan muncul.
1. Pilih perangkat untuk terhubung ke aplikasi AWS IoT SiteWise Edge.
1. Pilih **Luncurkan**. Databus ConfiguratorUntuk perangkat yang Anda pilih muncul.
1. Buat pengguna untuk perangkat Edge Anda di bawah **Pengguna**. Untuk informasi selengkapnya tentang membuat pengguna, lihat [Pengguna](https://docs.eu1.edge.siemens.cloud/get_started_and_operate/industrial_edge_management/operation/iam/03_user-management.html) di dokumentasi *Manajemen Tepi Industri Siemens*.
1. Pilih topik yang Siemens Databus harus diakses. Topik-topik ini membatasi apa yang dapat diakses AWS IoT SiteWise Edge.
**penting**
Semua topik yang Siemens Databus user memiliki akses dipublikasikan AWS IoT SiteWise.
**catatan**
Siemens Databus userS membutuhkan akses ke topik data dan metadata. Topik yang dimulai dengan `ie/d` adalah topik data. Dan topik yang dimulai dengan `ie/m` adalah topik metadata. Bagikan topik secara berpasangan sehingga SiteWise Edge memiliki akses ke data dan metadata untuk setiap topik masing-masing.
![\[Tangkapan layar yang menampilkan jenis topik Siemens. Gambar melingkari bagian dari jalur file yang dimulai dengan “ie/d" and "ie/m,” masing-masing.\]](http://docs.aws.amazon.com/id_id/iot-sitewise/latest/userguide/images/gateway-sa-topics.png)
1. Tetapkan izin yang sesuai untuk Siemens Databus konfigurasi Anda.
Setelah membuat Siemens Databus konfigurasi Anda, Anda dapat menginstal aplikasi AWS IoT SiteWise Edge di aplikasi AndaSiemens Industrial Edge Management. Untuk informasi selengkapnya, lihat [Instal aplikasi ke Siemens perangkat](sa-install-app.md).
Anda juga dapat secara opsional mengonfigurasi tujuan dan filter jalur untuk Siemens Industrial Edge gateway Anda. Untuk informasi selengkapnya, lihat [Tujuan dan filter jalur](gw-destinations.md).
# Akses aplikasi AWS IoT SiteWise Edge
Untuk mendapatkan akses ke aplikasi AWS IoT SiteWise Edge aktifSiemens Industrial Edge, [kirim email yang](mailto:aws-iot-swe-siemens-app-support@amazon.com?subject=Access request for SiteWise Edge on Siemens Industrial Edge) meminta akses ke tim dukungan SiteWise Edge.
Sertakan informasi berikut di email Anda:
+ Nama dan informasi kontak Anda
+ Nama perusahaan
+ Siemens Industrial EdgeID penyewa
# Instal aplikasi ke Siemens perangkat
Setelah Anda mendapatkan akses ke aplikasi AWS IoT SiteWise Edge dengan mengirim email ke tim dukungan SiteWise EdgeSiemens Industrial Edge, tetapkan aplikasi ke instance. Siemens Industrial Edge Management Kemudian, Anda dapat menginstal aplikasi AWS IoT SiteWise Edge di perangkat Anda.
**Untuk menginstal aplikasi AWS IoT SiteWise Edge**
1. Verifikasi bahwa Docker intisari yang disediakan dalam Siemens Industrial Edge Management cocok dengan versi terbaru yang tercantum dalam. [AWS IoT SiteWise Changelog aplikasi tepi](sitewise-edge-on-siemens.md#sa-changelog)
Untuk informasi selengkapnya tentang menemukan nilai Docker intisari untuk Siemens, lihat [Mengelola aplikasi](https://docs.eu1.edge.siemens.cloud/get_started_and_operate/industrial_edge_device/operation/management.html#managing-an-app) di *Siemens Industrial EdgePerangkat* dokumentasi. Siemens
Siemens Industrial Edge Managementmendukung satu versi aplikasi AWS IoT SiteWise Edge sekaligus. Ambil langkah ini untuk memastikan bahwa Anda menggunakan versi terbaru aplikasi sebelum menginstal aplikasi AWS IoT SiteWise Edge di Siemens Industrial Edge perangkat Anda.
1. Tetapkan aplikasi **AWS IoT SiteWise Edge** keSiemens Industrial Edge Management. Untuk informasi selengkapnya, lihat [Mengelola aplikasi](https://docs.eu1.edge.siemens.cloud/get_started_and_operate/industrial_edge_management/how_to_setup_operate/vm/operation/my_installed_apps/managing_an_app.html) di bagian *Manajemen Tepi Industri* pada Siemens dokumentasi.
1. Dalam **Edge Management**, telusuri katalog untuk **AWS IoT SiteWise Edge** dan pilih.
1. Pilih **Instal**.
**catatan**
Jika tombol **Hubungi Kami** ditampilkan, pilih tombol tersebut, dan ikuti langkah-langkah untuk meminta akses ke aplikasi AWS IoT SiteWise Edge aktifSiemens Industrial Edge. Untuk informasi selengkapnya, lihat [Akses aplikasi AWS IoT SiteWise Edge](sa-get-app.md).
1. Pilih **Databus\$1Configuration di opsi Konfigurasi** Skema.
1. Masukkan **Nama Pengguna** dan **Kata Sandi** untuk konfigurasi Databus. Untuk informasi lebih lanjut tentang membuatSiemens Databus user, lihat[Buat Siemens Databus user untuk aplikasi](sa-databus-user.md).
1. Pilih ikon tanda centang abu-abu bulat kecil di sebelah **Databus\$1Configuration** untuk mengubah warna ikon menjadi hijau.
**catatan**
Konfigurasi input hanya berlaku jika ikon tanda centang berubah dari abu-abu menjadi hijau. Jika tidak, konfigurasi input diabaikan.
![\[Tangkapan layar Siemens Databus Configurator layar yang menampilkan proses yang belum selesai, dengan ikon tanda centang abu-abu yang dilingkari.\]](http://docs.aws.amazon.com/id_id/iot-sitewise/latest/userguide/images/gateway-sa-gray-checkmark.png)
![\[Tangkapan layar Siemens Databus Configurator layar yang menampilkan proses yang sudah selesai, dengan ikon tanda centang hijau yang dilingkari.\]](http://docs.aws.amazon.com/id_id/iot-sitewise/latest/userguide/images/gateway-sa-green-checkmark.png)
1. Pilih **Berikutnya** untuk pindah ke **Konfigurasi Lain** di mana Anda dapat mengunggah file konfigurasi gateway Anda.
1. Pilih **SiteWise\$1Edge\$1Gateway\$1Config sebagai lokasi untuk mengunggah file konfigurasi** gateway.
**catatan**
**Pastikan Anda memilih **SiteWise\$1Edge\$1Gateway\$1Config daripada \$1Edge\$1Support\$1Config\$1Optional**. SiteWise**
1. Pilih perangkat untuk menginstal aplikasi.
1. Pilih **Instal sekarang**.
Anda dapat mengonfigurasi komponen penerbit secara opsional untuk mengekspor data ke Cloud. AWS Untuk informasi selengkapnya, lihat [mengonfigurasi komponen AWS IoT SiteWise penerbit](configure-publisher-component.md).
Untuk mengonfigurasi tujuan Siemens Industrial Edge gateway Anda, lihat[Tujuan dan filter jalur](gw-destinations.md).
# Perbarui konfigurasi aplikasi AWS IoT SiteWise Edge
Ada beberapa hal yang perlu dipertimbangkan saat memperbarui konfigurasi aplikasi AWS IoT SiteWise Edge **Siemens Industrial Edge**.
**catatan**
Setiap perubahan pada konfigurasi aplikasi AWS IoT SiteWise Edge memerlukan restart aplikasi.
**Alasan untuk memulai ulang aplikasi AWS IoT SiteWise Edge**
+ Yang baru Siemens Databus user untuk aplikasi AWS IoT SiteWise Edge.
+ Perubahan pada file konfigurasi gateway (file **SiteWise\$1Edge\$1Gateway\$1Config** Anda).
+ Pembaruan konfigurasi proxy (yang juga memerlukan reboot IEVD penuh)
+ Untuk mengaktifkan log debug untuk masalah debugging
## Memulai ulang aplikasi
1. Dalam Siemens Industrial Edge Management contoh Anda, pilih **Edge Management** di bagian **Aplikasi Platform**.
1. Pilih **Aplikasi Terinstal Saya**.
1. Pilih aplikasi AWS IoT SiteWise Edge.
1. Pilih **Mulai Ulang**.
# AWS IoT SiteWise — Data yang dihasilkan oleh penggunaan layanan ini
AWS IoT SiteWise di Siemens Industrial Edge memperluas kemampuan cloud ke lingkungan tepi industri, memungkinkan pemrosesan data lokal, analisis, dan pengambilan keputusan. SiteWise Edge terintegrasi dengan AWS IoT SiteWise dan AWS layanan lainnya untuk memberikan AWS IoT solusi industri yang komprehensif.
Jenis Data
SiteWise Aplikasi Edge di Siemens Industrial Edge menghasilkan data tentang kinerja aplikasi, penggunaan, dan interaksi dengan AWS layanan lain, khususnya Amazon S3.
Volume dan Pengumpulan Data
Jumlah data yang dihasilkan bervariasi berdasarkan cara Anda menggunakan aplikasi dan layanan Anda.
Penyimpanan Data
Data dari aplikasi Anda disimpan dengan aman di AWS server. Itu disimpan dalam format yang dapat dibaca mesin.
Akses Data
Anda dapat mengakses data Anda melalui AWS akun Anda. Anda dapat mengunduh salinan data Anda mengikuti petunjuk yang tercantum dalam panduan pengguna ini [SiteWise Edge on Siemens](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/sitewise-edge-on-siemens.html). Untuk data konfigurasi untuk aplikasi, Anda dapat mengikuti petunjuk dalam panduan pengguna ini [Kueri Data Industri](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/query-industrial-data.html). Petunjuk lebih lanjut untuk akses dan ekspor data massal, tersedia di [Running Bulk Operations Export](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/running-bulk-operations-export.html).
Manajemen Data
Untuk mempelajari lebih lanjut tentang praktik data aplikasi Anda, silakan tinjau [Persyaratan Layanan](https://aws.amazon.com/service-terms/), [Pemberitahuan Privasi](https://aws.amazon.com/privacy/), dan [dokumentasi Layanan](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/what-is-sitewise.html) kami yang mencakup materi tentang cara mengelola data Anda.
Penghapusan Data
Untuk informasi tentang opsi penyimpanan dan penghapusan data, kunjungi halaman ini di panduan pengguna — [kelola penyimpanan data](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/manage-data-storage.html), hapus [aliran data, dan hapus](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/delete-data-streams-method.html) [model dan aset](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/delete-assets-and-models.html).
Berbagi data dengan orang lain
Anda dapat memberi wewenang kepada pihak ketiga untuk mengakses AWS sumber daya Anda melalui proses [Identifikasi dan Manajemen Akses](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_common-scenarios_third-party.html) kami. AWS membagikan data pribadi dengan pihak ketiga dalam kasus terbatas yang termasuk dalam [Pemberitahuan AWS Privasi](https://aws.amazon.com/privacy/).
Butuh Bantuan?
Kunjungi [Customer Support](https://aws.amazon.com/contact-us/) untuk menghubungi tim dukungan kami. Ini tanpa mengurangi hak Anda untuk mengajukan keluhan berdasarkan hukum yang berlaku.
Pemegang Data
Amazon Web Services EMEA SARL, 38 Avenue John F. Kennedy, L-1855, Luksemburg
# Tujuan dan filter jalur
Tujuan di AWS IoT SiteWise Edge menyediakan cara yang fleksibel dan efisien untuk mengelola bagaimana data industri Anda mengalir dari perangkat edge ke cloud. Bagian ini menjelaskan cara mengonfigurasi tujuan, menggunakan filter jalur untuk merutekan aliran data tertentu, dan memilih jenis tujuan yang tepat untuk kasus penggunaan Anda.
Anda dapat menggunakan tujuan dan filter jalur pada gateway dan gateway V3 berkemampuan MQTT yang dihosting sendiri yang digunakan bersama dengan aplikasi Edge yang di-host. AWS IoT SiteWise Siemens Industrial Edge Tujuan dan filter jalur tidak berfungsi dengan Aliran Klasik, gateway V2.
**Topics**
+ [Memahami tujuan AWS IoT SiteWise Edge](#source-destination)
+ [Memahami filter jalur untuk tujuan AWS IoT SiteWise Edge](#destinations-path-filters)
+ [Menambahkan tujuan real-time AWS IoT SiteWise Edge](destinations-real-time.md)
+ [Tambahkan tujuan AWS IoT SiteWise buffer menggunakan Amazon S3](destinations-buffered.md)
+ [Tambahkan filter jalur ke tujuan AWS IoT SiteWise Edge](destinations-add-path-filters.md)
+ [Kelola tujuan AWS IoT SiteWise Edge](destinations-manage.md)
## Memahami tujuan AWS IoT SiteWise Edge
Gunakan tujuan AWS IoT SiteWise Edge untuk menentukan ke mana harus mengirim data sumber Anda. Anda dapat memilih tujuan data berdasarkan karakteristik spesifik yang Anda butuhkan, seperti efektivitas biaya, latensi rendah, atau persyaratan penyimpanan. Integrasikan data perangkat yang diambil oleh AWS IoT SiteWise, mitra kami, atau aplikasi khusus untuk mempublikasikan dan berlangganan filter jalur (topik) di edge. Anda kemudian dapat memodelkan, mentransfer, dan menyimpan data perangkat Anda di cloud.
**catatan**
Untuk penggunaan penuh semua fitur tujuan di gateway yang dihosting sendiri, tingkatkan ke versi terbaru SiteWise penerbit IoT dan kolektor IoT OPC UA. SiteWise Dukungan streaming dilanjutkan di aliran Klasik, gateway V2 untuk menjaga kompatibilitas dengan pengaturan yang ada. Untuk informasi selengkapnya, lihat [Aliran klasik, gateway V2 untuk Edge AWS IoT SiteWise](classic-streams-v2-gateway.md)
**Topics**
+ [Bagaimana tujuan SiteWise Edge meningkatkan manajemen data](#how-destinations-work)
+ [Jenis tujuan](#destination-types)
+ [Bandingkan fungsionalitas tujuan antara versi gateway](#destinations-vs-publisher-component)
+ [Batasan tujuan](#destinations-limitiations)
+ [Kasus penggunaan untuk tujuan SiteWise Edge](#destinations-use-cases)
### Bagaimana tujuan SiteWise Edge meningkatkan manajemen data
Ekspor data dari edge ke AWS IoT SiteWise real time, atau dalam batch menggunakan Amazon S3.
Tujuan meningkatkan fleksibilitas dan skalabilitas di AWS IoT SiteWise lingkungan Anda. Tujuan menerapkan model manajemen data terpusat, di mana sumber mempublikasikan data ke sistem pusat. Tujuan menentukan ke mana data Anda dikirim menggunakan filter jalur. Tujuan dapat berlangganan beberapa filter jalur.
Gateway berkemampuan MQTT, baik yang di-host sendiri atau berjalanSiemens Industrial Edge, menggunakan MQTT untuk komunikasi lokal dan dilengkapi dengan tujuan real-time default yang memiliki filter yang disetel ke. `#` Ini berarti bahwa, secara default, semua pesan tentang semua topik dipublikasikan ke tujuan AWS IoT SiteWise waktu nyata. Untuk informasi selengkapnya, lihat [Memahami filter jalur untuk tujuan AWS IoT SiteWise EdgeMemahami filter jalur](#destinations-path-filters). Anda dapat menambahkan satu tujuan real-time di setiap gateway.
### Jenis tujuan
Saat mengonfigurasi tujuan untuk gateway, Anda memiliki dua opsi utama: penggunaan konfigurasi waktu nyata AWS IoT SiteWise, dan konfigurasi buffer menggunakan Amazon S3. Setiap jenis tujuan memiliki seperangkat pengaturan dan pertimbangannya sendiri.
**AWS IoT SiteWise pengaturan waktu nyata**
Pilih ini untuk mengirim data langsung ke penyimpanan AWS IoT SiteWise tingkat panas untuk memfasilitasi pengambilan dan pemantauan data secara real-time. Pengaturan real-time mengelola aliran data, terutama ketika gateway mengalami masalah konektivitas dengan cloud. Selama kehilangan koneksi, data disimpan sementara secara lokal di gateway. Setelah koneksi dibuat kembali, data yang disimpan secara otomatis dikirim ke cloud.
Anda dapat menyesuaikan berbagai aspek proses penerbitan data, seperti jumlah maksimum data yang akan disimpan secara lokal, kecepatan pengiriman data ke cloud saat penyambungan ulang, dan kapan harus menghapus data setelah penyimpanan mencapai kapasitasnya.
Untuk informasi lebih lanjut tentang tingkatan AWS IoT SiteWise penyimpanan, lihat,[Mengelola penyimpanan data di AWS IoT SiteWise](manage-data-storage.md).
**AWS IoT SiteWise buffer menggunakan pengaturan Amazon S3**
Jenis tujuan ini memungkinkan Anda untuk menyangga data secara lokal di gateway dan mengirimkannya secara berkala ke bucket Amazon S3 dalam batch. Data disimpan dalam format Parket yang efisien, yang dioptimalkan untuk beban kerja analitis. Setelah data berada di Amazon S3, Anda dapat mengimpornya AWS IoT SiteWise untuk penyimpanan, pemrosesan, dan analisis.
Pilih opsi ini untuk menelan data dalam batch, dan menyimpan data historis dengan cara yang hemat biaya. Anda dapat mengonfigurasi lokasi bucket Amazon S3 pilihan Anda, dan frekuensi di mana Anda ingin data diunggah ke Amazon S3. Anda juga dapat memilih apa yang harus dilakukan dengan data setelah tertelan. AWS IoT SiteWise Anda dapat memilih untuk memiliki data yang tersedia di keduanya SiteWise dan Amazon S3 atau Anda dapat memilih untuk menghapusnya secara otomatis dari Amazon S3.
### Bandingkan fungsionalitas tujuan antara versi gateway
Fitur tujuan di gateway berkemampuan MQTT merampingkan manajemen aliran data. Tujuan menyederhanakan manajemen data melalui konfigurasi terpusat perutean data ke berbagai titik akhir. Pendekatan ini menghilangkan kebutuhan untuk pengaturan aliran individu yang kompleks, membuat keseluruhan sistem lebih fleksibel dan lebih mudah dikelola.
Sebagai perbandingan, aliran Klasik, gateway V2, SiteWise Edge mentransmisikan data dari sumber data ke penerbit melalui AWS IoT Greengrass aliran, mengonfigurasi tujuan data secara individual untuk setiap sumber data.
Dengan fitur AWS IoT SiteWise tujuan, konfigurasi perutean penerbit dikonsolidasikan. Konfigurasi tujuan memungkinkan Anda mengelola tujuan dan filter jalur secara terpusat. Anda dapat dengan mudah menambahkan tujuan, mengelola filter jalur, menghapus filter atau tujuan yang tidak perlu, tergantung pada kebutuhan Anda.
Selain itu, fitur tujuan menggunakan MQTT (Message Queuing Telemetry Transport), protokol standar industri yang banyak digunakan dalam aplikasi IoT industri. Adopsi MQTT ini membantu AWS IoT SiteWise memfasilitasi integrasi yang lebih mudah dengan berbagai perangkat dan sistem.
### Batasan tujuan
Batasan saat ini untuk tujuan di gateway SiteWise Edge meliputi:
+ Paket pemrosesan data tidak didukung pada gateway berkemampuan MQTT.
+ Dukungan tipe data terbatas pada tipe AWS IoT SiteWise data. Untuk informasi tentang mengaktifkan konversi tipe data, lihat[Mengonversi tipe data yang tidak didukung](string-conversion.md).
### Kasus penggunaan untuk tujuan SiteWise Edge
SiteWise Tujuan tepi digunakan dalam berbagai aplikasi. Berikut adalah beberapa contoh kunci:
**Otomatisasi industri***Pemantauan waktu nyata dan pemeliharaan prediktif*
Dalam pengaturan industri, sensor dan perangkat di lantai pabrik dapat mempublikasikan data ke SiteWise Edge. Tujuan dapat dikonfigurasi untuk menyaring dan merutekan data yang relevan, memungkinkan pemantauan dan analisis kinerja alat berat secara real-time. Anda dapat berlangganan topik MQTT yang relevan menggunakan filter jalur, memproses data, dan kemudian mempublikasikan data yang diproses. Dengan cara ini, Anda dapat secara selektif merutekan data yang diproses ke layanan analitik AWS cloud atau sistem lokal. Produsen kemudian dapat menerapkan strategi pemeliharaan prediktif, mengoptimalkan proses produksi, dan mengurangi waktu henti.
**Bangunan pintar***Efisiensi energi dan optimalisasi hunian*
Sistem otomasi bangunan menghasilkan aliran data untuk memantau dan mengontrol berbagai aspek bangunan, seperti sistem HVAC, pencahayaan, dan kontrol akses. Dengan SiteWise Edge, aliran data ini dapat dicerna, diproses, dan diarahkan ke tujuan yang berbeda. Manajer fasilitas dapat mengonfigurasi tujuan untuk memfilter dan meneruskan data yang relevan, memungkinkan kemampuan canggih seperti ukuran efisiensi energi dan pengoptimalan hunian sambil memastikan privasi dan kepatuhan data.
Kasus penggunaan ini menunjukkan bagaimana fitur Destinasi di SiteWise Edge dapat dimanfaatkan di berbagai industri untuk menyerap, memproses, dan merutekan data secara efisien. Ini memungkinkan kemampuan canggih seperti pemantauan waktu nyata, pemeliharaan prediktif, efisiensi energi, dan diagnostik jarak jauh sambil memastikan privasi dan kepatuhan data.
## Memahami filter jalur untuk tujuan AWS IoT SiteWise Edge
**Topics**
+ [Persyaratan filter jalur](#path-filter-requirements)
+ [Praktik terbaik untuk filter jalur](#create-effective-path-filters)
+ [Filter jalur untuk server OPC UA](#path-filters-opcua)
+ [Karakter khusus dalam nama filter jalur](#path-filters-special-characters)
Setiap tujuan dikonfigurasi untuk merutekan data ke AWS IoT SiteWise atau Amazon S3. Filter jalur memungkinkan Anda memilih data tertentu untuk difilter saat menerima pesan MQTT untuk tujuan. Filter jalur mewakili nama logis aliran data Anda, bertindak sebagai langganan ke topik MQTT yang diinginkan.
Di MQTT, data diatur ke dalam topik, yang merupakan string hierarkis yang dipisahkan oleh garis miring maju (). `/` Misalnya, perangkat mungkin mempublikasikan data suhu ke topik tersebut`home/livingroom/sensor1/temperature`. Di sini, `home/livingroom/sensor1` mewakili jalur atau nama logis sensor, dan tipe data yang `temperature` dipublikasikan.
Anda dapat menggunakan filter jalur untuk berlangganan topik tertentu atau berbagai topik menggunakan wildcard (`+`dan`#`). `+`Wildcard cocok dengan satu level dalam hierarki topik. Misalnya, `home/+/sensor1/temperature` akan cocok `home/livingroom/sensor1/temperature` dan`home/bedroom/sensor1/temperature`. `#`Wildcard, ketika digunakan di akhir filter, cocok dengan beberapa level.
Anda juga dapat menggunakan berbagai karakter yang biasanya tidak diizinkan dalam spesifikasi MQTT dalam nama filter jalur. Karakter ini tidak berfungsi sebagai wildcard saat digunakan dalam sebuah nama. AWS IoT SiteWise mengonversi karakter ini menggunakan pengkodean untuk memastikan kepatuhan MQTT sambil mempertahankan struktur penamaan asli Anda. Fitur ini sangat berguna untuk mengakomodasi konvensi penamaan yang ada dari sistem lain. Untuk informasi selengkapnya, lihat [Karakter khusus dalam nama filter jalur](#path-filters-special-characters).
Dengan hati-hati memilih filter jalur yang sesuai, Anda dapat mengontrol data mana yang dikirim ke tujuan tertentu. Sesuaikan aliran data dengan persyaratan sistem IoT Anda menggunakan filter jalur.
### Persyaratan filter jalur
Saat memasukkan filter jalur menggunakan Konsol AWS IoT SiteWise, ingatlah hal berikut:
+ Filter jalur dibatasi oleh baris baru, dengan setiap baris mewakili filter jalur terpisah.
+ Filter jalur individu dapat memiliki antara 1 dan 65.535 byte.
+ Filter jalur tidak bisa kosong.
+ Nilai nol (U\$10000) tidak diperbolehkan.
+ Anda dapat memasukkan hingga 100 filter jalur atau 65.535 karakter sekaligus, batas mana pun yang tercapai terlebih dahulu.
+ Batas keseluruhan adalah 20.000 filter jalur untuk semua tujuan pada gateway yang digabungkan.
+ Anda dapat menggunakan`%`,, `#``+`, dan `$` karakter dalam nama filter jalur, namun AWS IoT SiteWise secara otomatis mengonversinya menjadi pengkodean URI.
### Praktik terbaik untuk filter jalur
Saat membuat filter jalur untuk AWS IoT SiteWise tujuan Anda, pertimbangkan strategi berikut untuk mengelola data Anda secara efektif.
+ Susun filter Anda untuk mencerminkan hierarki perangkat Anda. Misalnya, dalam pengaturan manufaktur`factory/+/machine/#`, menangkap data dari semua mesin di berbagai lini produksi.
+ Gunakan level tertentu untuk jenis, lokasi, atau fungsi perangkat. Misalnya, `factory/assembly-line/robot/temperature`. Atau, dalam pertanian cerdas,`farm/+/crop/+/moisture`, untuk memantau tingkat kelembaban untuk berbagai tanaman di berbagai bidang.
+ Leverage wildcard secara strategis: Gunakan `+` untuk variasi pada satu tingkat dan `#` untuk menangkap semua level berikutnya. Misalnya`building/+/+/energy-consumption`, melacak penggunaan energi di berbagai zona dan lantai di sebuah gedung. Ini mengasumsikan yang pertama `+` menangkap semua lantai dan yang kedua `+` menangkap semua zona.
+ Menyeimbangkan kekhususan dan fleksibilitas dengan membuat filter yang cukup spesifik untuk menangkap data yang relevan tetapi cukup fleksibel untuk mengakomodasi perubahan di masa depan. Misalnya, `site/+/equipment-type/+/measurement` memungkinkan untuk penambahan situs baru atau jenis peralatan tanpa mengubah struktur filter.
Uji filter Anda secara menyeluruh untuk memastikan filter tersebut menangkap data yang diinginkan dan selaras dengan arsitektur dan sasaran sistem IoT Anda.
### Filter jalur untuk server OPC UA
Untuk server OPC UA, filter jalur Anda harus sesuai dengan nama tag OPC UA. Tingkat akhir filter jalur Anda harus sama persis dengan nama tag OPC UA. Misalnya, jika tag OPC UA Anda`Device1.Temperature`, filter jalur Anda mungkin`factory/line1/Device1.Temperature`. Anda dapat menggunakan wildcard di level sebelumnya, seperti `factory/+/Device1.Temperature` untuk menangkap tag di beberapa lini produksi. Jika Anda memiliki karakter khusus dalam nama filter jalur Anda, lihat [Karakter khusus dalam nama filter jalur](#path-filters-special-characters) untuk informasi selengkapnya.
### Karakter khusus dalam nama filter jalur
AWS IoT SiteWise mengakomodasi karakter yang biasa digunakan dalam protokol industri seperti OPC UA, yang biasanya tidak diizinkan dalam nama topik MQTT standar. Fitur ini memfasilitasi integrasi sistem industri yang lebih lancar dengan arsitektur berbasis MQTT.
**catatan**
Meskipun penanganan karakter khusus kami sangat membantu untuk integrasi dan migrasi, disarankan untuk menyelaraskan dengan konvensi penamaan MQTT standar untuk implementasi baru bila memungkinkan untuk memastikan kompatibilitas yang lebih luas.
Saat menerima data dari sumber industri, AWS IoT SiteWise menormalkan nama topik menggunakan pengkodean URI untuk karakter khusus:
+ `%`menjadi `%25` (dikodekan terlebih dahulu sebagai karakter pelarian)
+ `#` menjadi `%23`
+ `+` menjadi `%2B`
+ `$`menjadi `%24` (hanya ketika di awal topik)
Pengkodean ini memastikan bahwa data sumber yang berisi karakter MQTT khusus ini dapat digunakan dengan aman sebagai nama topik MQTT sambil mempertahankan konvensi penamaan industri asli.
**Example : Karakter khusus dalam nama filter jalur**
Berikut adalah contoh bagaimana nama topik industri mungkin muncul di filter AWS IoT SiteWise jalur:
+ `Factory1/Line#2/Sensor+3` menjadi `Factory1/Line%232/Sensor%2B3`
+ `Plant%A/Unit$1/Temp` menjadi `Plant%25A/Unit%241/Temp`
+ `Site1/#Section/+Node` menjadi `Site1/%23Section/%2BNode`
Saat membuat langganan atau melihat nama topik di AWS IoT SiteWise, Anda akan melihat versi asli yang tidak dikodekan. Pengkodean ditangani secara otomatis untuk memastikan kepatuhan MQTT.
# 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
------
# Tambahkan tujuan AWS IoT SiteWise buffer menggunakan Amazon S3
Jenis tujuan buffer memungkinkan Anda menghemat biaya konsumsi AWS IoT SiteWise jika Anda tidak memerlukan data secara real-time. Ini memungkinkan Anda untuk menyimpan sementara data IoT Anda di bucket Amazon S3 sebelum mengimpornya ke. AWS IoT SiteWise Atau, Anda cukup mengunggah data Anda ke S3 untuk penyimpanan, terlepas dari apakah Anda berencana untuk mengimpornya. AWS IoT SiteWise Ini berguna untuk mengelompokkan dan menyangga data dari perangkat dan gateway Anda sebelum memasukkannya ke dalam. AWS IoT SiteWise Dengan opsi ini, data diunggah ke bucket S3 yang ditentukan dalam format Parket pada frekuensi yang dikonfigurasi. Anda kemudian dapat mengimpor data ini ke AWS IoT SiteWise penyimpanan untuk analisis dan pemrosesan lebih lanjut.
**Untuk menambahkan tujuan buffer menggunakan Amazon S3**
Gunakan AWS IoT SiteWise konsol atau AWS CLI untuk menambahkan tujuan yang menyangga data menggunakan Amazon S3 ke gateway Edge SiteWise Anda.
------
#### [ Console ]
Gunakan Konsol Manajemen AWS untuk menambahkan AWS IoT SiteWise tujuan buffer menggunakan Amazon S3.
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 buffer menggunakan Amazon** S3 **untuk** tipe Tujuan. AWS IoT SiteWise buffer menggunakan Amazon S3 mengirimkan data ke Amazon Simple Storage Service dalam batch, dalam format Parket, dan kemudian mengimpor data ke penyimpanan. AWS IoT SiteWise
1. Masukkan URL Amazon S3 untuk lokasi tempat Anda ingin menyimpan data gateway Anda. Anda dapat menelusuri jalur dengan memilih **Browse S3**. Setelah bucket ditambahkan, Anda juga dapat melihat bucket dengan memilih **View**.
1. Tentukan seberapa sering gateway Anda harus mengunggah data ke Amazon S3 dengan memasukkan kerangka waktu dan memilih kenaikan waktu untuk frekuensi unggah **Data**. Nilai frekuensi harus lebih besar dari 0 dan kurang dari atau sama dengan 30 hari.
1. Dalam **pengaturan penyimpanan data**, tentukan apa yang harus dilakukan dengan data gateway Anda setelah mengimpornya. AWS IoT SiteWise Ada dua keputusan yang harus diambil terkait penyimpanan data:
+ Jika Anda ingin menyalin data yang diimpor ke AWS IoT SiteWise penyimpanan, pilih kotak centang **Salin data ke penyimpanan**. Opsi ini menduplikasi data yang diimpor dari bucket AWS IoT SiteWise Amazon S3 yang dikonfigurasi ke dalam penyimpanan.
+ Jika Anda memilih untuk mengimpor data dari bucket Amazon S3 ke AWS IoT SiteWise penyimpanan, Anda juga dapat menentukan apakah data yang diimpor harus dihapus setelah impor selesai. Pilih kotak centang **Hapus data dari Amazon S3** untuk menghapus tanggal impor dari bucket Amazon S3 yang dikonfigurasi setelah mengimpornya ke penyimpanan. AWS IoT SiteWise
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).
------
#### [ AWS CLI ]
**Example : Buat AWS IoT SiteWise tujuan baru yang di-buffer menggunakan Amazon S3**
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_BUFFERED",
"name": "your-s3-destination-name",
"config": {
"targetBucketArn": "arn:aws:s3:::amzn-s3-demo-bucket/Optional/SomeFolder",
"publishPolicy": {
"publishFrequency": "15m",
"localSizeLimitGB": 10
},
"siteWiseImportPolicy": {
"enableSiteWiseStorageImport": true,
"enableDeleteAfterImport": true,
"bulkImportJobRoleArn": "arn:aws:iam::123456789012:role/your-role-name"
}
},
"filters": [
{
"type": "PATH",
"config": {
"paths": [
"#"
]
}
}
]
}
]
}
```
**Example : Perbarui AWS IoT SiteWise tujuan yang di-buffer menggunakan Amazon S3**
Untuk memperbarui tujuan AWS IoT SiteWise real-time yang ada, pertama-tama gunakan `DescribeGatewayCapabilityConfiguration` API untuk menemukan`destinationId`.
Namespace penerbit: `iotsitewise:publisher:3`
```
{
"sources": [
{
"type": "MQTT"
}
],
"destinations": [
{
"id": "your-existing-destination-id",
"type": "SITEWISE_BUFFERED",
"name": "your-s3-destination-name",
"config": {
"targetBucketArn": "arn:aws:s3:::amzn-s3-demo-bucket/Optional/SomeFolder",
"publishPolicy": {
"publishFrequency": "15m",
"localSizeLimitGB": 10
},
"siteWiseImportPolicy": {
"enableSiteWiseStorageImport": true,
"enableDeleteAfterImport": true,
"bulkImportJobRoleArn": "arn:aws:iam::123456789012:role/your-role-name"
}
},
"filters": [
{
"type": "PATH",
"config": {
"paths": [
"#"
]
}
}
]
}
]
}
```
Opsi konfigurasi berikut khusus untuk gateway berkemampuan MQTT 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 agar ID baru dibuat secara otomatis untuk tujuan tersebut.
Tipe: String
Wajib: Tidak
`type`
Jenis tujuan. Pilihan meliputi: `SITEWISE_REALTIME` dan`SITEWISE_BUFFERED`. Pilih `SITEWISE_BUFFERED`.
+ `SITEWISE_REALTIME`(default) - Kirim data langsung ke AWS IoT SiteWise penyimpanan secara real-time. Untuk informasi selengkapnya, lihat [Menambahkan tujuan real-time AWS IoT SiteWise Edge](destinations-real-time.md).
+ `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
`targetBucketArn`
Ember ARN untuk dipublikasikan ke. Pilih yang sama Wilayah AWS untuk keduanya AWS IoT SiteWise dan Amazon S3. Jika awalan dipilih, itu harus memiliki antara 1-255 karakter.
AWS IoT SiteWise, termasuk gateway, akan memiliki akses ke seluruh bucket S3 yang ditentukan. Sebaiknya gunakan bucket khusus untuk konsumsi data buffer.
Tipe: String
Diperlukan: Ya
`publishPolicy`
Rincian kebijakan penerbitan.
Tipe: Objek
Wajib: Ya
`publishFrequency`
Frekuensi penerbitan gateway SiteWise Edge ke bucket Amazon S3. Frekuensi unggah data ke Amazon S3 harus lebih besar dari 0 menit dan kurang dari atau sama dengan 30 hari. Anda dapat menggunakan`m`,`h`, dan `d` ketika Anda menentukan usia frekuensi penerbitan. Catatan yang `m` mewakili menit, `h` mewakili jam, dan `d` mewakili hari. Nilai defaultnya adalah 15 menit.
Tipe: String
Diperlukan: Ya
`localSizeLimitGB`
Ukuran maksimum file yang ditulis ke disk lokal dalam GB. Jika ambang batas ini dilanggar, penerbit menerbitkan semua data buffer ke tujuannya.
Jenis: Integer
Wajib: Ya
`siteWiseImportPolicy`
Rincian kebijakan impor untuk mengimpor data ke AWS IoT SiteWise.
Tipe: Objek
Wajib: Ya
`enableSiteWiseStorageImport`
Setel ini `true` untuk mengimpor data dari bucket Amazon S3 ke AWS IoT SiteWise penyimpanan. Awalnya membuat salinan data di AWS IoT SiteWise. Kemudian, jika Anda mengatur `enableDeleteAfterImport` ke true, data di S3 dihapus setelah menyalin ke. AWS IoT SiteWise Implikasi harga berlaku. Nilai default-nya adalah `true`.
Tipe: Boolean
Wajib: Ya
`enableDeleteAfterImport`
Setel ini `true` untuk menghapus file di bucket Amazon S3 setelah tertelan ke dalam penyimpanan. AWS IoT SiteWise Nilai default-nya adalah `true`.
Tipe: Boolean
Wajib: Ya
`bulkImportJobRoleArn`
ARN dari peran IAM yang AWS IoT SiteWise mengasumsikan untuk membaca data buffer dari Amazon S3 selama konsumsi data. Peran ini digunakan saat perangkat edge memanggil AWS IoT SiteWise APIs untuk memulai proses impor massal.
Jika `enableSiteWiseStorageImport` diatur ke`true`, parameter ini diperlukan.
Tipe: String
Wajib: Tidak
------
Tambahkan filter jalur untuk tujuan Anda. Untuk informasi selengkapnya, lihat [Tambahkan filter jalur ke tujuan AWS IoT SiteWise Edge](destinations-add-path-filters.md).
# Tambahkan filter jalur ke tujuan AWS IoT SiteWise Edge
Tambahkan filter jalur ke tujuan. Filter jalur menggunakan sintaks topik MQTT, di mana `#` adalah karakter wildcard yang cocok dengan sejumlah level, dan `+` merupakan karakter wildcard yang cocok dengan satu level. Anda dapat menambahkan beberapa tujuan ke gateway, masing-masing dengan set filter jalurnya sendiri yang berlangganan telemetri peralatan Anda.
Siemens Industrial Edgegateway menggunakan awalan untuk kompatibilitas. Untuk informasi selengkapnya, lihat [Awalan untuk filter jalur](sitewise-edge-on-siemens.md#siemens-path-filters).
------
#### [ Console ]
**Untuk menambahkan filter jalur**
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 filter jalur.
1. Di bagian **Filter jalur** di bawah **Tambahkan tujuan**, pilih **Tambahkan filter jalur**.
1. Masukkan filter jalur yang Anda inginkan untuk berlangganan tujuan ini. Anda dapat menggunakan karakter wildcard (`#`dan`+`) untuk berlangganan beberapa jalur.
1. Pilih **Tambahkan filter jalur** untuk menambahkan filter jalur ke daftar.
1. Ulangi langkah untuk menambahkan filter jalur tambahan, jika diperlukan.
1. Setelah Anda menambahkan semua filter jalur yang diperlukan, pilih **Buat**.
------
#### [ AWS CLI for self-hosted gateways ]
**Example : Konfigurasi filter jalur**
```
{
"destinations": [
{
...
}
],
"filters": [
{
"type": "PATH",
"config": {
"paths": [
"home/+/sensor1/temperature",
"home/livingroom/sensor1/temperature",
"home/livingroom/sensor1/temperature",
"building/#"
]
}
}
]
}
```
------
#### [ AWS CLI for Siemens IEgateways ]
**Example : Konfigurasi awalan untuk filter jalur**
Tangkap semua data dengan menggunakan awalan data (`ie/d`) dan metadata (`ie/m`) untuk setiap filter jalur.
```
{
"destinations": [
{
...
}
],
"filters": [
{
"type": "PATH",
"config": {
"paths": [
"ie/d/home/+/sensor12/temperature",
"ie/m/home/livingroom/sensor12/temperature",
"ie/d/home/livingroom/sensor13/temperature2",
"ie/m/home/livingroom/sensor13/temperature2",
"ie/d/building/#",
"ie/m/building/#"
]
}
}
]
}
```
------
**catatan**
Salin filter jalur antar tujuan dengan mengunduh daftar filter jalur. Untuk informasi selengkapnya, lihat [Unduh semua filter jalur di tujuan (konsol)](destinations-manage.md#destinations-download-list).
## Unggah filter jalur secara massal
Untuk mengunggah filter jalur secara massal, gunakan CSV atau file teks. AWS IoT SiteWise secara otomatis menghapus duplikat yang tepat saat Anda mengunggah file. Misalnya, `windfarm/site1/` dan `windfarm/site1/` merupakan duplikat persis yang AWS IoT SiteWise menangkap karena string persis sama. Duplikat sebagian tidak dihapus dan mengakibatkan biaya tambahan. Misalnya, `windfarm/#` dan `windfarm/site1` merupakan topik yang tumpang tindih karena `windfarm/site1` sudah dicakup oleh. `windfarm/#`
**catatan**
Hindari duplikat untuk mencegah biaya tambahan. File yang diunggah harus dalam format.csv atau .txt. Itu tidak dapat berisi header apa pun dan harus terdiri dari satu kolom. Di kolom, daftarkan filter jalur Anda, dengan setiap filter pada baris terpisah. Tidak ada informasi lain yang harus disertakan dalam file.
**Persyaratan unggah file**
Ini adalah persyaratan filter jalur tambahan.
+ Anda dapat mengunggah satu file.csv atau .txt. Format file lainnya tidak didukung.
+ File CSV (.csv) tidak dapat memiliki header dan hanya boleh berisi satu kolom.
+ Anda dapat memiliki satu filter jalur pada setiap baris.
+ File yang diunggah tidak dapat kosong.
+ Saat menggunakan karakter `#` sebagai wildcard, karakter ini harus ditempatkan terakhir dalam filter topik. Misalnya, `topic/#` atau sebagai karakter terpisah di tingkat topik tertentu. Namun, perhatikan bahwa `#` juga dapat digunakan sebagai karakter biasa dalam nama tingkat topik, seperti `factory/machine#1/topic`. Untuk informasi lebih lanjut lihat [Karakter khusus dalam nama filter jalur](gw-destinations.md#path-filters-special-characters)
+ Anda juga dapat menggunakan `+` karakter. Misalnya, gunakan `factory/+/temp` untuk mendapatkan semua suhu untuk pabrik, bukan `factory/machine2/temp` dan `factory/machine3/temp` secara individual.
# Kelola tujuan AWS IoT SiteWise Edge
Setelah menambahkan tujuan, Anda dapat melakukan berbagai operasi untuk mengelolanya, seperti mengedit konfigurasi tujuan, menghapus tujuan, dan mengelola filter jalur.
## Mengedit tujuan
Pilih tombol radio di sebelah tujuan dalam tabel dan pilih tombol **Edit** untuk mengedit tujuan.
------
#### [ Console ]
**Untuk mengedit tujuan menggunakan AWS IoT SiteWise konsol**
1. Buka [konsol AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).
1. Di navigasi kiri, pilih **gateway Edge** di bagian **Edge**.
1. Pilih gateway yang sesuai.
1. Di bagian **Tujuan**, pilih tujuan yang ingin Anda edit, lalu pilih **Edit**.
1. Ubah tujuan dan kemudian pilih **Simpan**.
------
#### [ AWS CLI ]
**Untuk mengedit tujuan menggunakan AWS CLI**
+ Anda dapat mengedit tujuan dengan memodifikasi informasi konfigurasi kemampuan JSON.
```
aws iotsitewise update-gateway-capability-configuration \
--gateway-id your-gateway-id \
--capability-namespace "iotsitewise:publisher:3" \
--capability-configuration '{
"sources": [
{
"type": "MQTT"
}
],
"destinations": [
{
"id": "your-existing-destination-id",
"type": "SITEWISE_REALTIME",
"name": "your-updated-destination-name",
"config": {
"publishingOrder": "TIME_ORDER",
"enableCompression": true,
"dropPolicy": {
"cutoffAge": "10d",
"exportPolicy": {
"retentionPeriod": "10d",
"rotationPeriod": "6h",
"exportSizeLimitGB": 10
}
},
"maxBatchWaitTime": "15s"
},
"filters": [
{
...
}
]
}
]
}'
```
**catatan**
Anda tidak dapat memperbarui tujuan `type` atau`capability-namespace`. Misalnya, Anda tidak dapat beralih dari jenis `SITEWISE_REALTIME` ke`SITEWISE_BUFFERED`. Anda dapat memiliki satu tujuan real-time untuk setiap gateway berkemampuan MQTT.
------
## Menghapus tujuan
Jika Anda tidak lagi membutuhkan tujuan, Anda dapat menghapusnya dari gateway SiteWise Edge Anda.
------
#### [ Console ]
**Untuk menghapus tujuan menggunakan AWS IoT SiteWise konsol**
1. Buka [konsol AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).
1. Di navigasi kiri, pilih **gateway Edge** di bagian **Edge**.
1. Pilih gateway yang sesuai.
1. Di bagian **Tujuan**, pilih tujuan yang ingin Anda hapus, lalu pilih **Hapus**. Layar konfirmasi muncul.
1. Untuk mengonfirmasi pilihan Anda untuk menghapus tujuan, ketik “hapus” di kotak konfirmasi.
------
#### [ AWS CLI ]
**Untuk menghapus tujuan menggunakan AWS CLI**
+ Hapus konfigurasi kapabilitas gateway dengan menentukan ID gateway dan memodifikasi konfigurasi kemampuan untuk menghapus tujuan yang ingin Anda hapus.
```
aws iotsitewise update-gateway-capability-configuration \
--gateway-id your-gateway-id \
--capability-namespace "iotsitewise:publisher:3" \
--capability-configuration '{
"sources": [
{
"type": "MQTT"
}
],
"destinations": []
}'
```
**catatan**
Array tujuan dapat kosong (`[]`), tetapi objek tujuan itu sendiri harus disertakan dalam konfigurasi kemampuan.
------
## Unduh semua filter jalur di tujuan (konsol)
Unduh file CSV yang berisi semua filter jalur Anda di AWS IoT SiteWise konsol. Anda dapat menggunakan daftar filter jalur yang diunduh untuk dengan mudah berbagi daftar filter jalur antar tujuan gateway.
**Untuk mengunduh file CSV dari semua filter jalur menggunakan konsol AWS IoT SiteWise**
1. Buka [konsol AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).
1. Di navigasi kiri, pilih **gateway Edge** di bagian **Edge**.
1. Pilih gateway yang berisi filter jalur Anda.
1. Pilih **Tambahkan tujuan** atau **Edit tujuan**.
1. Arahkan ke bagian **Filter jalur** dan pilih **Unduh CSV**.
**catatan**
File CSV mencakup semua filter jalur di tujuan tertentu, terlepas dari mana yang Anda pilih dari daftar filter jalur.
## Mengedit filter jalur
Anda dapat mengedit filter jalur individual untuk menyempurnakan data mana yang diterima tujuan Anda.
------
#### [ Console ]
Menggunakan AWS IoT SiteWise konsol, Anda dapat mengedit setiap filter jalur individu dalam setiap kotak teks masing-masing.
**Untuk mengedit filter jalur menggunakan AWS IoT SiteWise konsol**
1. Buka [konsol AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).
1. Di navigasi kiri, pilih **gateway Edge** di bagian **Edge**.
1. Pilih gateway yang berisi filter jalur Anda.
1. Pilih tujuan yang sesuai.
1. Pilih **Edit**.
1. Pilih kotak teks untuk baris yang berisi filter jalur yang ingin Anda edit.
1. Perbarui teks filter jalur, memastikan bahwa kotak centang filter jalur yang diedit dipilih.
1. Pilih **Simpan**.
------
#### [ AWS CLI ]
Untuk mengedit filter jalur untuk tujuan menggunakan AWS CLI, pertama-tama ambil konfigurasi saat ini, modifikasi, lalu perbarui menggunakan `update-gateway-capability-configuration` perintah.
**Untuk mengedit filter jalur menggunakan AWS CLI**
1. Ambil konfigurasi kemampuan saat ini:
```
aws iotsitewise describe-gateway-capability-configuration \
--gateway-id your-gateway-id \
--capability-namespace "iotsitewise:publisher:3" \
--query "capabilityConfiguration"
```
1. Edit JSON untuk memodifikasi filter jalur sesuai kebutuhan.
1. Perbarui konfigurasi kemampuan dengan filter jalur yang dimodifikasi:
```
aws iotsitewise update-gateway-capability-configuration \
--gateway-id your-gateway-id \
--capability-namespace "iotsitewise:publisher:3" \
--capability-configuration json-containing-your-updated-path-filters
```
------
## Hapus filter jalur
Anda dapat menghapus filter jalur untuk tujuan untuk mengontrol data yang diterimanya dari sumber MQTT dan pipeline pemrosesan data.
------
#### [ Console ]
**Untuk menghapus filter jalur menggunakan AWS IoT SiteWise konsol**
1. Buka [konsol AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).
1. Di navigasi kiri, pilih **gateway Edge** di bagian **Edge**.
1. Pilih gateway yang berisi filter jalur Anda.
1. Pilih tujuan yang sesuai.
1. Pilih **Edit**.
1. Pada layar **Edit tujuan**, di bagian **Filter jalur**, pilih satu atau beberapa filter jalur yang akan dihapus.
1. Pilih **Hapus**. Pesan konfirmasi penghapusan muncul. Jika ingin melanjutkan dengan menghapus filter jalur, pilih **Hapus** di layar konfirmasi.
------
#### [ AWS CLI ]
**Untuk menghapus tujuan menggunakan AWS CLI**
+ Hapus filter jalur dengan menghapusnya dari konfigurasi kemampuan.
```
aws iotsitewise update-gateway-capability-configuration \
--gateway-id your-gateway-id \
--capability-namespace "iotsitewise:publisher:3" \
--capability-configuration '{
"sources": [
{
"type": "MQTT"
}
],
"destinations": [
{
"id": "your-destination-id",
"type": "SITEWISE_REALTIME",
"name": "your-destination-name",
"config": {
...
},
"filters": [
{
"type": "PATH",
"config": {
"paths": [
"/path1",
"/path2",
"/delete-a-path-to-remove-it"
]
}
}
]
}
]
}
```
**catatan**
Array filter dapat kosong (`[]`), tetapi objek filter itu sendiri harus disertakan dalam konfigurasi kemampuan.
------
# Kelola SiteWise gateway Edge
Anda dapat menggunakan operasi AWS IoT SiteWise konsol dan API untuk mengelola gateway AWS IoT SiteWise Edge. Anda juga dapat menggunakan aplikasi [AWS OpsHub for AWS IoT SiteWise for Windows](https://aws-iot-sitewise.s3.amazonaws.com/gateway/OpsHub+for+AWS+IoT+SiteWise.exe) untuk mengelola beberapa aspek gateway SiteWise Edge Anda dari perangkat lokal Anda.
Kami sangat menyarankan Anda menggunakan AWS IoT SiteWise aplikasi AWS OpsHub for untuk memantau penggunaan disk pada perangkat lokal Anda. Anda juga dapat memantau CloudWatch metrik `Gateway.AvailableDiskSpace` dan `Gateway.UsedPercentageDiskSpace` Amazon dan membuat alarm untuk mendapatkan pemberitahuan saat ruang disk semakin rendah. Untuk informasi selengkapnya tentang CloudWatch alarm Amazon, lihat [Membuat CloudWatch alarm berdasarkan ambang batas statis](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ConsoleAlarms.html).
Pastikan perangkat Anda memiliki cukup ruang untuk data yang akan datang. Ketika Anda akan kehabisan ruang di perangkat lokal Anda, layanan secara otomatis menghapus sejumlah kecil data dengan stempel waktu tertua untuk memberi ruang bagi data yang akan datang.
Untuk memeriksa apakah layanan menghapus data Anda, lakukan hal berikut:
1. Masuk ke AWS IoT SiteWise aplikasi AWS OpsHub untuk.
1. Pilih **Pengaturan**.
1. Untuk **Log**, tentukan rentang waktu, lalu pilih **Unduh**.
1. Buka zip file log.
1. Jika file log berisi pesan berikut, layanan menghapus data Anda: *number*byte data telah dihapus untuk mencegah penyimpanan gateway SiteWise Edge kehabisan ruang.
## Kelola gateway SiteWise Edge Anda dengan AWS IoT SiteWise konsol
Anda dapat menggunakan AWS IoT SiteWise konsol untuk mengonfigurasi, memperbarui, dan memantau semua gateway SiteWise Edge di akun Anda AWS .
[Anda dapat melihat gateway SiteWise Edge Anda dengan menavigasi ke halaman **Edge Gateways** di konsol.AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/) Untuk mengakses halaman **detail gateway Edge** untuk gateway tertentu, pilih nama gateway Edge.
Dari tab **Ikhtisar** halaman **detail gateway Edge**, Anda dapat melakukan hal berikut:
+ Di bagian **Sumber data**, perbarui konfigurasi sumber data dan konfigurasikan sumber data tambahan
+ Pilih **Buka CloudWatch metrik** untuk melihat jumlah titik data yang dicerna per sumber data di konsol metrik CloudWatch
+ Di bagian **kemampuan Edge**, tambahkan paket data ke gateway SiteWise Edge Anda dengan mengklik **Edit**
+ Di bagian **konfigurasi Gateway**, lihat status konektivitas gateway SiteWise Edge Anda
+ Di bagian **konfigurasi Publisher**, lihat status sinkronisasi gateway SiteWise Edge dan konfigurasi komponen AWS IoT SiteWise penerbit
Dari tab **Pembaruan** pada halaman **detail gateway Edge**, Anda dapat melihat komponen saat ini dan versi paket yang digunakan ke gateway Edge. Ini juga tempat Anda menerapkan versi baru, saat tersedia.
## Kelola gateway SiteWise Edge menggunakan for AWS OpsHub AWS IoT SiteWise
Anda menggunakan AWS IoT SiteWise aplikasi AWS OpsHub for untuk mengelola dan memantau gateway SiteWise Edge yang dihosting sendiri. Aplikasi ini menyediakan opsi pemantauan dan manajemen berikut:
+ Di bawah **Ikhtisar**, Anda dapat melakukan hal berikut:
+ Lihat detail gateway SiteWise Edge yang membantu Anda mendapatkan wawasan tentang data perangkat gateway SiteWise Edge Anda, mengidentifikasi masalah, dan meningkatkan kinerja gateway SiteWise Edge.
+ Lihat portal SiteWise Monitor yang memantau data dari server lokal dan peralatan di tepi. Untuk informasi selengkapnya, lihat [Apa yang ada AWS IoT SiteWise Monitor](https://docs.aws.amazon.com/iot-sitewise/latest/appguide/what-is-monitor-app.html) di *Panduan AWS IoT SiteWise Monitor Aplikasi*.
+ Di bawah **Health**, ada dasbor yang menampilkan data dari gateway SiteWise Edge Anda. Pakar domain, seperti insinyur proses, dapat menggunakan dasbor untuk melihat ikhtisar perilaku gateway SiteWise Edge.
+ Di bawah **Aset**, lihat aset yang digunakan ke perangkat lokal dan nilai terakhir yang dikumpulkan atau dihitung untuk properti aset.
+ Di bawah **Pengaturan**, Anda dapat melakukan hal berikut:
+ Jika Paket Pemrosesan Data diinstal, lihat informasi konfigurasi gateway SiteWise Edge dan sinkronkan sumber daya dengan AWS Cloud.
+ Unduh file otentikasi yang dapat Anda gunakan untuk mengakses gateway SiteWise Edge dengan menggunakan alat lain.
+ Unduh log yang dapat Anda gunakan untuk memecahkan masalah gateway SiteWise Edge.
+ Lihat AWS IoT SiteWise komponen yang digunakan ke gateway SiteWise Edge.
**penting**
Berikut ini diperlukan untuk digunakan AWS OpsHub untuk AWS IoT SiteWise:
Perangkat lokal Anda dan AWS IoT SiteWise aplikasi AWS OpsHub for harus terhubung ke jaringan yang sama.
Paket pemrosesan data harus diaktifkan.
**Untuk mengelola gateway SiteWise Edge menggunakan AWS OpsHub**
1. Unduh dan instal aplikasi [AWS OpsHubAWS IoT SiteWise untuk Windows](https://aws-iot-sitewise.s3.amazonaws.com/gateway/OpsHub+for+AWS+IoT+SiteWise.exe).
1. Buka aplikasi .
1. Jika Anda tidak memiliki kredensi lokal yang disiapkan untuk gateway Anda, ikuti langkah-langkah di bawah ini [Akses gateway SiteWise Edge Anda menggunakan kredensyal sistem operasi lokal](#create-user-pool) untuk mengaturnya.
1. Anda dapat masuk ke gateway SiteWise Edge Anda dengan kredensi Linux atau Lightweight Directory Access Protocol (LDAP) Anda. Untuk masuk ke gateway SiteWise Edge Anda, lakukan salah satu hal berikut:
------
#### [ Linux ]
1. Untuk **nama host atau alamat IP**, masukkan nama host atau alamat IP perangkat lokal Anda.
1. Untuk **Otentikasi**, pilih **Linux**.
1. Untuk **nama pengguna**, masukkan nama pengguna sistem operasi Linux Anda.
1. Untuk **Kata Sandi**, masukkan kata sandi sistem operasi Linux Anda.
1. Pilih **Masuk**.
------
#### [ LDAP ]
1. Untuk **nama host atau alamat IP**, masukkan nama host atau alamat IP perangkat lokal Anda.
1. Untuk **Otentikasi**, pilih **LDAP**.
1. Untuk **nama Pengguna**, masukkan nama pengguna LDAP Anda.
1. Untuk **Kata Sandi**, masukkan kata sandi LDAP Anda.
1. Pilih **Masuk**.
------
## Akses gateway SiteWise Edge Anda menggunakan kredensyal sistem operasi lokal
Selain Lightweight Directory Access Protocol (LDAP), Anda dapat menggunakan kredensi Linux atau Windows untuk mengakses gateway Edge yang dihosting sendiri SiteWise .
**penting**
Untuk mengakses gateway SiteWise Edge Anda dengan kredensi Linux, Anda harus mengaktifkan paket pemrosesan data untuk gateway SiteWise Edge Anda.
### Akses gateway SiteWise Edge Anda menggunakan kredensyal sistem operasi Linux
Langkah-langkah berikut mengasumsikan bahwa Anda menggunakan perangkat dengan Ubuntu. Jika Anda menggunakan distribusi Linux yang berbeda, lihat dokumentasi yang relevan untuk perangkat Anda.
**Untuk membuat kumpulan pengguna Linux**
1. Untuk membuat grup admin, jalankan perintah berikut.
```
sudo groupadd --system SWE_ADMIN_GROUP
```
Pengguna dalam `SWE_ADMIN_GROUP` grup dapat mengizinkan akses admin untuk gateway SiteWise Edge.
1. Untuk membuat grup pengguna, jalankan perintah berikut.
```
sudo groupadd --system SWE_USER_GROUP
```
Pengguna dalam `SWE_USER_GROUP` grup dapat mengizinkan akses hanya-baca untuk gateway SiteWise Edge.
1. Untuk menambahkan pengguna ke grup admin, jalankan perintah berikut. Ganti *user-name* dan *password* dengan nama pengguna dan kata sandi yang ingin Anda tambahkan.
```
sudo useradd -p $(openssl passwd -1 password) user-name
```
1. Untuk menambahkan pengguna ke salah satu `SWE_ADMIN_GROUP` atau`SWE_USER_GROUP`, ganti *user-name* dengan nama pengguna yang Anda tambahkan pada langkah sebelumnya.
```
sudo usermod -a -G SWE_ADMIN_GROUP user-name
```
Anda sekarang dapat menggunakan nama pengguna dan kata sandi untuk masuk ke gateway SiteWise Edge pada AWS IoT SiteWise aplikasi AWS OpsHub for.
### Akses gateway SiteWise Edge Anda menggunakan kredensyal Windows
Langkah-langkah berikut mengasumsikan bahwa Anda menggunakan perangkat dengan Windows.
**penting**
Keamanan adalah tanggung jawab bersama antara Anda AWS dan Anda. Buat kebijakan kata sandi yang kuat dengan setidaknya 12 karakter dan kombinasi huruf besar, huruf kecil, angka, dan simbol. Selain itu, tetapkan aturan Windows Firewall untuk memungkinkan lalu lintas masuk pada port 443 dan untuk memblokir lalu lintas masuk di semua port lainnya.
**Untuk membuat kumpulan pengguna Windows Server**
1. Jalankan PowerShell sebagai administrator.
1. Di server Windows tempat Anda ingin menginstal SiteWise Edge Gateway, masuk sebagai administrator.
1. Masukkan **PowerShell**di bilah pencarian Windows.
1. Di hasil pencarian, klik kanan pada PowerShell aplikasi Windows. Pilih **Jalankan sebagai Administrator**.
1. Untuk membuat grup admin, jalankan perintah berikut.
```
net localgroup SWE_ADMIN_GROUP /add
```
Anda harus menjadi pengguna dalam `SWE_ADMIN_GROUP` grup untuk mengizinkan akses admin untuk gateway SiteWise Edge.
1. Untuk membuat grup pengguna, jalankan perintah berikut.
```
net localgroup SWE_USER_GROUP /add
```
Anda harus menjadi pengguna dalam `SWE_USER_GROUP` grup untuk mengizinkan akses siap-saja untuk gateway SiteWise Edge.
1. Untuk menambahkan pengguna, jalankan perintah berikut. Ganti *user-name* dan *password* dengan nama pengguna dan kata sandi yang ingin Anda buat.
```
net user user-name password /add
```
1. Untuk menambahkan pengguna ke grup admin, jalankan perintah berikut. Ganti *user-name* dengan nama pengguna yang ingin Anda tambahkan.
```
net localgroup SWE_ADMIN_GROUP user-name /add
```
Anda sekarang dapat menggunakan nama pengguna dan kata sandi untuk masuk ke gateway SiteWise Edge pada AWS IoT SiteWise aplikasi AWS OpsHub for.
## Kelola sertifikat gateway SiteWise Edge
Anda dapat menggunakan SiteWise Monitor dan aplikasi pihak ketiga, seperti Grafana, di perangkat gateway SiteWise Edge Anda. Aplikasi ini memerlukan koneksi TLS ke layanan. SiteWise Edge gateway saat ini menggunakan sertifikat yang ditandatangani sendiri. Jika Anda menggunakan browser untuk membuka aplikasi, seperti portal SiteWise Monitor, Anda mungkin menerima peringatan untuk sertifikat yang tidak tepercaya.
Berikut ini menunjukkan cara mengunduh sertifikat tepercaya dari AWS IoT SiteWise aplikasi AWS OpsHub for.
1. Masuk ke aplikasi.
1. Pilih **Pengaturan**.
1. Untuk **Otentikasi**, pilih **Unduh sertifikat**.
Berikut ini mengasumsikan bahwa Anda menggunakan Google Chrome atau FireFox. Jika Anda menggunakan browser yang berbeda, lihat dokumentasi yang relevan untuk browser Anda. Untuk menambahkan sertifikat yang Anda unduh pada langkah sebelumnya ke browser, lakukan salah satu hal berikut:
+ Jika Anda menggunakan Google Chrome, ikuti [Menyiapkan sertifikat](https://support.google.com/chrome/a/answer/3505249?hl=en) di *dokumentasi Bantuan Google Chrome Enterprise*.
+ Jika Anda menggunakan Firefox, ikuti To [Load the Certificate ke Mozilla atau Firefox Browser](https://docs.oracle.com/cd/E19528-01/819-4639/gaesv/index.html) dalam dokumentasi *Oracle*.
## Ubah versi paket komponen gateway SiteWise Edge
Anda dapat menggunakan AWS IoT SiteWise konsol untuk mengubah versi paket komponen di gateway SiteWise Edge Anda.
**Untuk mengubah versi paket komponen gateway SiteWise Edge**
1. Navigasikan ke [konsol AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/) tersebut.
1. Di panel navigasi kiri, pilih **Gateway**.
1. Pilih gateway SiteWise Edge yang ingin Anda ubah versi paketnya.
1. Di bawah **konfigurasi Gateway**, pilih **Lihat versi perangkat lunak**.
1. Pada halaman **Edit versi perangkat lunak**, untuk paket yang ingin Anda perbarui versi, pilih versi yang ingin Anda gunakan dan pilih **Deploy**.
1. Pilih **Selesai**.
## Daftar SiteWise gateway Edge
------
#### [ Console ]
**Untuk membuat daftar SiteWise gateway Edge**
1. Navigasikan ke [konsol AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/) tersebut.
1. Di panel navigasi, pilih **gateway Edge**.
1. Lihat daftar semua gateway SiteWise Edge Anda.
------
#### [ AWS CLI ]
Untuk membuat daftar gateway Anda menggunakan AWS CLI, ikuti langkah-langkah ini:
+ Gunakan perintah list-gateway untuk melihat semua gateway Anda:
```
aws iotsitewise list-gateways
```
Perintah ini mengembalikan daftar gateway Anda dengan nama IDs, nama, dan informasi lainnya.
Anda juga dapat menentukan parameter pagination:
```
aws iotsitewise list-gateways --max-results 10 --next-token your-token
```
Untuk informasi selengkapnya, lihat [daftar-gateway](https://docs.aws.amazon.com/cli/latest/reference/iotsitewise/list-gateways.html) di Referensi Perintah. AWS CLI
------
## Jelaskan gateway SiteWise Edge
------
#### [ Console ]
**Untuk melihat detail gateway**
1. Navigasikan ke [konsol AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/) tersebut.
1. Di panel navigasi, pilih **gateway Edge**.
1. Pilih nama gateway yang ingin Anda lihat detailnya.
1. Lihat detail gateway di halaman **detail gateway Edge**.
------
#### [ AWS CLI ]
Untuk mendapatkan informasi terperinci tentang penggunaan gateway tertentu AWS CLI, ikuti langkah-langkah berikut:
+ Gunakan perintah deskripsi-gateway dengan ID gateway:
```
aws iotsitewise describe-gateway --gateway-id a1b2c3d4-5678-90ab-cdef-1a1a1EXAMPLE
```
Perintah ini mengembalikan informasi rinci tentang gateway.
Untuk informasi selengkapnya, lihat [deskripsi-gateway](https://docs.aws.amazon.com/cli/latest/reference/iotsitewise/describe-gateway.html) di Referensi Perintah. AWS CLI
------
## Buat gateway SiteWise Edge
------
#### [ Console ]
**Untuk membuat gateway SiteWise Edge**
1. Navigasikan ke [konsol AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/) tersebut.
1. Di panel navigasi, pilih **gateway Edge**.
1. Pilih **Buat gateway**.
1. Masukkan nama untuk gateway Anda.
1. Pilih grup Greengrass untuk gateway Anda.
1. Secara opsional, tambahkan tag ke gateway Anda.
1. Pilih **Buat**.
------
#### [ AWS CLI ]
Untuk membuat SiteWise gateway IoT baru menggunakan AWS CLI, ikuti langkah-langkah berikut:
+ Gunakan perintah create-gateway untuk membuat gateway baru:
```
aws iotsitewise create-gateway \
--gateway-name "NewSiteWiseGateway" \
--gateway-platform '{
"greengrass": {
"groupArn": "arn:aws:greengrass:us-east-1:123456789012:group/a1b2c3d4-5678-90ab-cdef-1a1a1EXAMPLE"
}
}' \
--tags '{
"Environment": "Production",
"Location": "Factory1"
}'
```
Perintah ini mengembalikan ID gateway baru dan ARN:
```
{
"gatewayId": "a1b2c3d4-5678-90ab-cdef-1a1a1EXAMPLE",
"gatewayArn": "arn:aws:iotsitewise:us-east-1:123456789012:gateway/a1b2c3d4-5678-90ab-cdef-1a1a1EXAMPLE"
}
```
Untuk informasi selengkapnya, lihat [create-gateway](https://docs.aws.amazon.com/cli/latest/reference/iotsitewise/create-gateway.html) di Command Reference. AWS CLI
------
## Perbarui gateway SiteWise Edge
------
#### [ Console ]
**Untuk memperbarui gateway SiteWise Edge**
1. Navigasikan ke [konsol AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/) tersebut.
1. Di panel navigasi, pilih **gateway Edge**.
1. Pilih gateway yang ingin Anda perbarui.
1. Pilih **Edit**.
1. Perbarui nama gateway atau pengaturan lain sesuai kebutuhan.
1. Pilih **Simpan**.
------
#### [ AWS CLI ]
Untuk memperbarui gateway yang ada menggunakan AWS CLI, ikuti langkah-langkah berikut:
+ Gunakan perintah update-gateway untuk memperbarui nama gateway:
```
aws iotsitewise update-gateway \
--gateway-id a1b2c3d4-5678-90ab-cdef-1a1a1EXAMPLE \
--gateway-name "UpdatedGatewayName"
```
Perintah ini tidak menghasilkan output saat berhasil.
Untuk informasi selengkapnya, lihat [update-gateway](https://docs.aws.amazon.com/cli/latest/reference/iotsitewise/update-gateway.html) di Command Reference. AWS CLI
------
## Perbarui konfigurasi kemampuan gateway
------
#### [ Console ]
**Untuk memperbarui konfigurasi kemampuan gateway**
1. Navigasikan ke [konsol AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/) tersebut.
1. Di panel navigasi, pilih **gateway Edge**.
1. Pilih nama gateway yang ingin Anda perbarui.
1. Di bagian **Sumber data**, pilih **Edit**.
1. Perbarui konfigurasi sumber data sesuai kebutuhan.
1. Pilih **Simpan**.
------
#### [ AWS CLI ]
Untuk memperbarui konfigurasi kemampuan gateway menggunakan AWS CLI, ikuti langkah-langkah berikut:
+ Gunakan update-gateway-capability-configuration perintah untuk memperbarui konfigurasi kemampuan:
```
aws iotsitewise update-gateway-capability-configuration \
--gateway-id a1b2c3d4-5678-90ab-cdef-1a1a1EXAMPLE \
--capability-namespace "iotsitewise:opcuacollector:1" \
--capability-configuration '{
"sources": [
{
"name": "OPC-UA Server",
"endpoint": {
"certificateTrust": {
"type": "TrustAny"
},
"endpointUri": "opc.tcp://10.0.0.1:4840",
"securityPolicy": "NONE",
"messageSecurityMode": "NONE",
"identityProvider": {
"type": "Anonymous"
}
},
"measurementDataStreamPrefix": ""
}
]
}'
```
Perintah ini mengembalikan namespace kemampuan dan status sinkronisasi:
```
{
"capabilityNamespace": "iotsitewise:opcuacollector:1",
"capabilitySyncStatus": "CONFIGURING"
}
```
Untuk informasi selengkapnya, lihat [update-gateway-capability-configuration](https://docs.aws.amazon.com/cli/latest/reference/iotsitewise/update-gateway-capability-configuration.html)di Referensi AWS CLI Perintah.
------
## Tag sumber daya gateway
------
#### [ Console ]
**Untuk menandai sumber daya gateway**
1. Navigasikan ke [konsol AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/) tersebut.
1. Di panel navigasi, pilih **gateway Edge**.
1. Pilih nama gateway yang ingin Anda tag.
1. Pilih tab **Tanda**.
1. Pilih **Kelola tanda**.
1. Pilih **Tambahkan tag baru** dan masukkan kunci dan nilai untuk setiap tag.
1. Pilih **Simpan**.
------
#### [ AWS CLI ]
Untuk menambahkan tag ke gateway menggunakan AWS CLI, ikuti langkah-langkah berikut:
+ Gunakan perintah tag-resource untuk menambahkan tag ke gateway:
```
aws iotsitewise tag-resource \
--resource-arn "arn:aws:iotsitewise:us-east-1:123456789012:gateway/a1b2c3d4-5678-90ab-cdef-1a1a1EXAMPLE" \
--tags '{
"Department": "Operations",
"Project": "FactoryAutomation"
}'
```
Perintah ini tidak menghasilkan output saat berhasil.
Untuk informasi selengkapnya, lihat [tag-resource](https://docs.aws.amazon.com/cli/latest/reference/iotsitewise/tag-resource.html) di AWS CLI Command Reference.
------
## Tag daftar untuk gateway
------
#### [ Console ]
**Untuk membuat daftar tag untuk gateway**
1. Navigasikan ke [konsol AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/) tersebut.
1. Di panel navigasi, pilih **gateway Edge**.
1. Pilih nama gateway yang ingin Anda lihat tag.
1. Pilih tab **Tanda**.
1. Lihat daftar tag yang terkait dengan gateway.
------
#### [ AWS CLI ]
Untuk mencantumkan tag yang terkait dengan gateway menggunakan AWS CLI, ikuti langkah-langkah berikut:
+ Gunakan list-tags-for-resource perintah untuk membuat daftar tag untuk gateway:
```
aws iotsitewise list-tags-for-resource \
--resource-arn "arn:aws:iotsitewise:us-east-1:123456789012:gateway/a1b2c3d4-5678-90ab-cdef-1a1a1EXAMPLE"
```
Perintah ini mengembalikan tag yang terkait dengan gateway:
```
{
"tags": {
"Environment": "Production",
"Location": "Factory1",
"Department": "Operations",
"Project": "FactoryAutomation"
}
}
```
Untuk informasi selengkapnya, lihat [list-tags-for-resource](https://docs.aws.amazon.com/cli/latest/reference/iotsitewise/list-tags-for-resource.html)di Referensi AWS CLI Perintah.
------
## Hapus tag dari gateway
------
#### [ Console ]
**Untuk menghapus tag dari gateway**
1. Navigasikan ke [konsol AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/) tersebut.
1. Di panel navigasi, pilih **gateway Edge**.
1. Pilih nama gateway yang ingin Anda hapus tag.
1. Pilih tab **Tanda**.
1. Pilih **Kelola tanda**.
1. Pilih ikon hapus (X) di samping setiap tag yang ingin Anda hapus.
1. Pilih **Simpan**.
------
#### [ AWS CLI ]
Untuk menghapus tag dari gateway menggunakan AWS CLI, ikuti langkah-langkah berikut:
+ Gunakan perintah untag-resource untuk menghapus tag dari gateway:
```
aws iotsitewise untag-resource \
--resource-arn "arn:aws:iotsitewise:us-east-1:123456789012:gateway/a1b2c3d4-5678-90ab-cdef-1a1a1EXAMPLE" \
--tag-keys '["Project", "Department"]'
```
Perintah ini tidak menghasilkan output saat berhasil.
Untuk informasi selengkapnya, lihat [untag-resource](https://docs.aws.amazon.com/cli/latest/reference/iotsitewise/untag-resource.html) di Command Reference. AWS CLI
------
## Perbarui versi AWS IoT SiteWise komponen
Perbarui komponen AWS IoT SiteWise gateway pada perangkat AWS IoT Greengrass inti Anda untuk memastikan akses Anda ke fitur terbaru, peningkatan kinerja, dan tambalan keamanan.
**Untuk memperbarui AWS IoT SiteWise komponen pada AWS IoT Greengrass**
1. Navigasikan ke [konsol AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/) tersebut.
1. Di panel navigasi kiri, pilih **gateway Edge**.
1. Pilih gateway yang akan diedit dan pilih **Edit**.
1. Di **Edge Capabilities**, di bawah **versi Perangkat Lunak**, pilih **Pembaruan perangkat lunak tersedia**. Halaman **Edit versi perangkat lunak** muncul.
1. Pilih versi komponen.
**catatan**
Disarankan untuk memilih versi terbaru yang tersedia. Menjaga komponen gateway up-to-date membantu Anda mempertahankan fungsionalitas optimal untuk pengumpulan dan pemrosesan data industri.
1. Pilih **Deploy**. Ini memulai AWS IoT Greengrass V2 penerapan untuk memperbarui AWS IoT SiteWise komponen di gateway.
## Hapus gateway SiteWise Edge
------
#### [ Console ]
**Untuk menghapus gateway SiteWise Edge**
1. Navigasikan ke [konsol AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/) tersebut.
1. Di panel navigasi, pilih **gateway Edge**.
1. Pilih gateway yang ingin Anda hapus.
1. Pilih **Hapus**.
1. Untuk mengonfirmasi bahwa Anda ingin menghapus gateway, ketik “hapus” lalu pilih **Hapus** di jendela yang muncul.
------
#### [ AWS CLI ]
Untuk menghapus gateway menggunakan AWS CLI, ikuti langkah-langkah berikut:
1. Buat daftar gateway Anda untuk mengidentifikasi ID gateway gateway yang ingin Anda hapus.
```
aws iotsitewise list-gateways
```
Perintah ini mengembalikan daftar gateway Anda dengan nama IDs, nama, dan informasi lainnya:
```
{
"gatewaySummaries": [
{
"gatewayId": "a1b2c3d4-5678-90ab-cdef-1a1a1EXAMPLE",
"gatewayName": "ExampleCorpGateway",
"gatewayCapabilitySummaries": [
{
"capabilityNamespace": "iotsitewise:opcuacollector:1",
"capabilitySyncStatus": "IN_SYNC"
}
],
"creationDate": 1588369971.457,
"lastUpdateDate": 1588369971.457
}
]
}
```
1. Hapus gateway dengan menentukan ID-nya:
```
aws iotsitewise delete-gateway --gateway-id a1b2c3d4-5678-90ab-cdef-1a1a1EXAMPLE
```
Perintah ini tidak menghasilkan output saat berhasil.
**catatan**
Saat Anda menghapus gateway, beberapa file gateway tetap berada di sistem file gateway Anda.
1. Untuk memverifikasi bahwa gateway telah dihapus, Anda dapat mencantumkan gateway Anda lagi:
```
aws iotsitewise list-gateways
```
Gateway yang dihapus seharusnya tidak lagi muncul dalam daftar.
Untuk informasi selengkapnya, lihat [delete-gateway di Referensi](https://docs.aws.amazon.com/cli/latest/reference/storagegateway/delete-gateway.html) AWS CLI Perintah.
------
# Cadangkan dan pulihkan gateway SiteWise Edge
Topik ini mencakup cara memulihkan gateway SiteWise Edge dan mencadangkan data metrik Anda. Jika Anda mengalami masalah dengan gateway SiteWise Edge yang rusak pada mesin yang sama dan perlu memecahkan masalah, baca AWS IoT SiteWise dokumentasi [ SiteWise Pemecahan](https://docs.aws.amazon.com//iot-sitewise/latest/userguide/troubleshooting-gateway.html#troubleshoot-gateway-issues) Masalah gateway Edge.
**catatan**
Panduan yang dibahas dalam topik ini adalah untuk gateway SiteWise Edge yang diinstal pada AWS IoT Greengrass V2 versi 2.1.0 atau lebih tinggi.
## Backup harian data metrik
Membuat cadangan adalah penting, jika Anda ingin mentransfer atau mengembalikan data pada mesin baru. Mencadangkan data Anda sangat mengurangi risiko hilangnya data operasi selama proses transfer atau pemulihan.
Bagian ini berlaku untuk gateway yang menggunakan paket pemrosesan data. Untuk informasi selengkapnya tentang paket pemrosesan data, lihat[Konfigurasikan model aset untuk pemrosesan data di SiteWise Edge](edge-processing.md#process-gateway-data-edge).
Jalur folder **influxdb** adalah sebagai berikut:
------
#### [ Linux ]
`/greengrass/v2/work/aws.iot.SiteWiseEdgeProcessor/influxdb `
------
#### [ Windows ]
`C:\greengrass\v2\work\aws.iot.SiteWiseEdgeProcessor\influxdb`
------
Kami menyarankan Anda membuat cadangan seluruh folder dengan semua yang ada di bawahnya.
Kami menyarankan Anda secara berkala mencadangkan data metrik Anda dari 1.0 SiteWise Edge ke hard drive eksternal atau ke AWS cloud.
## Kembalikan gateway SiteWise Edge
Sebelum mencoba memulihkan gateway SiteWise Edge, pastikan bahwa semua perangkat tepi yang terhubung ke gateway dihentikan atau terputus.
Gunakan prosedur berikut untuk memulihkan gateway SiteWise Edge:
1. Gunakan skrip instalasi yang diunduh saat Anda membuat gateway SiteWise Edge untuk memulihkan gateway SiteWise Edge pada mesin baru. Baca [Menginstal perangkat lunak gateway SiteWise Edge pada prosedur perangkat lokal Anda](https://docs.aws.amazon.com//iot-sitewise/latest/userguide/install-gateway-software-on-local-device.html) untuk mengatur gateway SiteWise Edge.
Jika Anda kehilangan atau tidak dapat menemukan skrip instalasi, silakan hubungi [AWS Customer Support](https://aws.amazon.com/contact-us/).
1. Setelah gateway SiteWise Edge diinstal, masuk ke [AWS IoT Greengrass konsol](https://console.aws.amazon.com/greengrass).
1. Untuk menerapkan ulang komponen, navigasikan ke **Kelola** lalu di bawah **AWS IoT Greengrass perangkat pilih Perangkat** **inti**.
1. Di tabel **perangkat AWS IoT Greengrass inti** pilih perangkat inti yang sesuai dengan gateway SiteWise Edge Anda.
1. Setelah berada di halaman perangkat, buka tab **Deployment** dan pilih **ID Deployment Anda, ini akan membuka halaman Deployment dengan ID** **yang Anda pilih.**
1. Setelah Anda berada di halaman **Deployments**, di kanan atas tekan tombol **Tindakan**, dan pilih opsi **Revisasi.** untuk memulai penerapan baru. Konfigurasikan penerapan. Jika Anda ingin mempertahankan penerapan apa adanya, lewati ke **Review** and **Deploy**.
1. Tunggu **Status Deployment** menjadi`Completed`.
**catatan**
Ini juga akan memakan waktu beberapa menit untuk semua komponen di SiteWise Edge untuk sepenuhnya setup dan berjalan.
## Kembalikan AWS IoT SiteWise data
Gunakan prosedur berikut untuk memulihkan data pada mesin baru.
1. Salin `influxdb` folder ke mesin baru.
1. Hentikan SiteWise EdgeProcessor komponen, dengan menjalankan perintah berikut di terminal Anda:
------
#### [ Linux ]
sudo `/greengrass/v2/bin/greengrass-cli component stop -n aws.iot.SiteWiseEdgeProcessor`
------
#### [ Windows ]
`C:\greengrass\v2\bin\greengrass-cli component stop -n aws.iot.SiteWiseEdgeProcesso`
------
1. Temukan jalur tempat Anda mencadangkan data, dan jalankan perintah berikut:
------
#### [ Linux ]
`sudo yes | sudo cp -rf /greengrass/v2/work/aws.iot.SiteWiseEdgeProcessor/influxdb `
------
#### [ PowerShell ]
`Copy-Item -Recurse -Force \* C:\greengrass\v2\work\aws.iot.SiteWiseEdgeProcessor\`
------
#### [ Windows ]
`robocopy C:\greengrass\v2\work\aws.iot.SiteWiseEdgeProcessor\ /E`
------
1. Mulai ulang SiteWiseEdgeProcessor komponen:
------
#### [ Linux ]
`sudo /greengrass/v2/bin/greengrass-cli component restart -n aws.iot.SiteWiseEdgeProcessor`
------
#### [ Windows ]
`C:\greengrass\v2\bin\greengrass-cli component restart -n aws.iot.SiteWiseEdgeProcessor`
------
## Validasi backup dan restorasi yang berhasil
Gunakan prosedur ini untuk memvalidasi data cadangan dan SiteWise restorasi gateway Edge Anda.
**catatan**
Prosedur ini mengharuskan Anda menginstal AWS OpsHub untuk AWS IoT SiteWise. Untuk informasi selengkapnya, lihat, [Mengelola gateway SiteWise Edge menggunakan AWS OpsHub ](https://docs.aws.amazon.com//iot-sitewise/latest/userguide/manage-gateways-ggv2.html) for. AWS IoT SiteWise
1. Terbuka AWS OpsHub untuk AWS IoT SiteWise.
1. Pada halaman **Pengaturan SiteWise ** Edge Gateway, periksa status setiap komponen yang tercantum dalam tabel **Komponen**. Verifikasi bahwa warna status berwarna hijau dan pembacaan menampilkan **RUNNING**.
1. Validasi data masa lalu Anda di dasbor portal untuk memeriksa apakah data sebelumnya dan data baru keduanya diatur dengan benar. Akan ada downtime antara data masa lalu dan baru. Anda harus kecuali untuk melihat durasi di mana tidak ada titik data yang dikumpulkan.
[Jika Anda mengalami masalah dengan mencadangkan atau memulihkan gateway SiteWise Edge, lihat topik pemecahan masalah berikut Memecahkan masalah gateway Edge. AWS IoT SiteWise](https://docs.aws.amazon.com//iot-sitewise/latest/userguide/troubleshooting-gateway.html)
# Gerbang warisan ()AWS IoT Greengrass Version 1
**catatan**
SiteWise Gateway tepi yang berjalan hanya AWS IoT Greengrass V1 tersedia jika Anda mulai menggunakan fitur ini sebelum 29 Juli 2021. Untuk informasi selengkapnya tentang menjalankan AWS IoT SiteWise gateway menggunakan AWS IoT Greengrass V2, lihat[Self-host gateway AWS IoT SiteWise Edge dengan AWS IoT Greengrass V2](gw-self-host-gg2.md).
SiteWise Edge gateway sekarang secara eksklusif berjalan AWS IoT Greengrass V2, menyediakan fungsionalitas yang ditingkatkan dan peningkatan kinerja untuk aplikasi IoT industri Anda. Versi terbaru ini AWS IoT Greengrass V2 mewakili evolusi arsitektur, dibangun di atas kerangka berbasis komponen modern yang memungkinkan penyebaran perangkat lunak modular. Ini merampingkan instalasi melalui installer terpadu sambil menawarkan pengembang fleksibilitas yang lebih besar dalam menerapkan komponen khusus dan melakukan pengujian lokal. Model berbasis komponen memungkinkan manajemen sumber daya yang lebih efisien dan memperkenalkan pendekatan konfigurasi yang disederhanakan melalui resep komponen. Desain ini memfasilitasi penanganan ketergantungan yang lebih baik antar komponen, mendukung praktik penerapan berkelanjutan, dan menyediakan kemampuan CLI yang ditingkatkan untuk pengembangan lokal. Selain itu, AWS IoT Greengrass V2 memusatkan manajemen konfigurasi melalui AWS IoT Core dan memberikan fitur pencatatan dan pemantauan yang lebih baik, semuanya dilindungi oleh model izin keamanan yang lebih terperinci.
Untuk informasi lebih lanjut tentang memulai menggunakan AWS IoT Greengrass V2 gateway SiteWise Edge,. [AWS IoT SiteWise Persyaratan gateway yang dihosting sendiri di Edge](configure-gateway-ggv2.md) Sumber daya ini memberikan step-by-step petunjuk tentang pengaturan gateway Anda, mengonfigurasi sumber data, dan mengelola infrastruktur IoT industri Anda.
**catatan**
Karena AWS terus berinovasi dan meningkatkan layanan IoT-nya, disarankan untuk tetap diperbarui dengan fitur dan peningkatan terbaru. Periksa AWS IoT SiteWise dan AWS IoT Greengrass dokumentasi secara teratur untuk kemampuan baru yang dapat lebih mengoptimalkan solusi IoT industri Anda.