Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris. # 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**.