Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Aset di Azure IoT Operations adalah entitas logis yang Anda buat untuk mewakili aset nyata. Aset Azure IoT Operations dapat memiliki properti, tag, dan peristiwa yang menjelaskan perilaku dan karakteristiknya.
Server OPC UA adalah aplikasi perangkat lunak yang berkomunikasi dengan aset. Server OPC UA mengekspos tag AGEN OPC yang mewakili titik data. Tag OPC UA menyediakan data real-time atau historis tentang status, performa, kualitas, atau kondisi aset.
Titik akhir aset adalah sumber daya kustom di kluster Kubernetes anda yang menghubungkan server OPC UA ke konektor untuk modul OPC UA. Koneksi ini memungkinkan konektor untuk OPC UA untuk mengakses titik data aset. Tanpa titik akhir aset, data tidak dapat mengalir dari server AGEN PENGGUNA OPC ke konektor untuk broker OPC UA dan MQTT. Setelah Anda mengonfigurasi sumber daya kustom di kluster Anda, koneksi dibuat ke server OPC UA hilir dan server meneruskan pesan seperti data sensor ke konektor untuk OPC UA.
Situs adalah kumpulan instans Azure IoT Operations. Situs biasanya mengelompokkan instans berdasarkan lokasi fisik dan memudahkan pengguna OT untuk menemukan dan mengelola aset. Administrator TI Anda membuat situs dan menetapkan instans Operasi Azure IoT kepada mereka. Untuk mempelajari selengkapnya, lihat Apa itu pengelola situs Azure Arc (pratinjau)?.
Dalam antarmuka pengguna web pengalaman operasi, instans mewakili kluster Operasi Azure IoT. Instans dapat memiliki satu atau beberapa titik akhir aset.
Artikel ini menjelaskan cara menggunakan antarmuka pengguna web pengalaman operasi dan Azure CLI untuk:
- Tentukan titik akhir aset yang menghubungkan aset ke instans Azure IoT Operations Anda.
- Tambahkan aset, dan tentukan tag dan peristiwa mereka untuk mengaktifkan aliran data dari server OPC UA ke broker MQTT.
Aset, tag, dan peristiwa ini memetakan data masuk dari server OPC UA ke nama yang mudah diingat yang dapat Anda gunakan di broker MQTT dan aliran data.
Prasyarat
Untuk mengonfigurasi titik akhir aset, Anda memerlukan instans Operasi Azure IoT yang sedang berjalan.
Untuk masuk ke antarmuka pengguna web pengalaman operasi, Anda memerlukan akun ID Microsoft Entra dengan setidaknya izin kontributor untuk grup sumber daya yang berisi Kubernetes - instans Azure Arc . Anda tidak dapat masuk dengan akun Microsoft (MSA). Untuk membuat akun ID Microsoft Entra yang sesuai di penyewa Azure Anda:
- Masuk ke portal Azure dengan penyewa dan nama pengguna yang sama dengan yang Anda gunakan untuk menyebarkan Operasi Azure IoT.
- Di portal Azure, buka bagian ID Microsoft Entra, pilih Pengguna > +Pengguna baru Buat pengguna >baru. Buat pengguna baru dan catat kata sandi, Anda memerlukannya untuk masuk nanti.
- Di portal Azure, buka grup sumber daya yang berisi Kubernetes - instans Azure Arc Anda. Pada halaman Kontrol akses (IAM), pilih +Tambahkan > penetapan peran.
- Pada halaman Tambahkan penetapan peran, pilih Peran administrator istimewa. Lalu pilih Kontributor lalu pilih Berikutnya.
- Pada halaman Anggota , tambahkan pengguna baru Anda ke peran tersebut.
- Pilih Tinjau dan tetapkan untuk menyelesaikan pengaturan pengguna baru.
Anda sekarang dapat menggunakan akun pengguna baru untuk masuk ke antarmuka pengguna web pengalaman operasi .
Masuk
Untuk masuk ke pengalaman operasi, buka pengalaman operasi di browser Anda dan masuk dengan menggunakan kredensial ID Microsoft Entra Anda.
Pilih situs Anda
Setelah Anda masuk, pengalaman operasi menampilkan daftar situs. Setiap situs adalah kumpulan instans Azure IoT Operations tempat Anda dapat mengonfigurasi dan mengelola aset Anda. Situs biasanya mewakili lokasi fisik tempat Anda memiliki aset fisik yang disebarkan. Situs memudahkan Anda menemukan dan mengelola aset. Administrator TI Anda bertanggung jawab untuk mengelompokkan instans ke situs. Setiap instans Operasi Azure IoT yang tidak ditetapkan ke situs muncul di simpul instans yang tidak ditetapkan. Pilih situs yang ingin Anda gunakan:
Petunjuk / Saran
Anda bisa menggunakan kotak filter untuk mencari situs.
Jika Anda tidak melihat situs apa pun, Anda mungkin tidak berada di penyewa Azure Active Directory yang tepat. Anda dapat mengubah penyewa dari menu kanan atas dalam pengalaman operasi. Jika Anda masih tidak melihat situs apa pun yang berarti Anda belum ditambahkan ke situs apa pun. Hubungi administrator TI Anda untuk meminta akses.
Pilih instans Anda
Setelah Anda memilih situs, pengalaman operasi menampilkan daftar instans Azure IoT Operations yang merupakan bagian dari situs. Pilih instans yang ingin Anda gunakan:
Petunjuk / Saran
Anda dapat menggunakan kotak filter untuk mencari instans.
Setelah Anda memilih instans, pengalaman operasi menampilkan halaman Gambaran Umum untuk instans. Halaman Gambaran Umum menunjukkan status instans dan sumber daya, seperti aset, yang terkait dengannya:
Membuat titik akhir aset
Penyebaran Operasi Azure IoT dapat menyertakan simulator OPC PLC bawaan opsional. Untuk membuat titik akhir aset yang menggunakan simulator OPC PLC bawaan:
Pilih Titik akhir aset lalu Buat titik akhir aset:
Petunjuk / Saran
Anda dapat menggunakan kotak filter untuk mencari titik akhir aset.
Masukkan informasi titik akhir berikut:
Bidang Nilai Nama opc-ua-connector-0
Konektor untuk URL OPC UA opc.tcp://opcplc-000000:50000
Autentikasi pengguna Anonymous
Untuk menyimpan definisi, pilih Buat.
Konfigurasi ini menyebarkan sumber daya baru assetendpointprofile
yang dipanggil opc-ua-connector-0
ke kluster. Setelah Anda menentukan aset, konektor untuk pod OPC UA menemukannya. Pod menggunakan titik akhir aset yang Anda tentukan dalam definisi aset untuk terhubung ke server AGEN OPC.
Ketika simulator OPC PLC berjalan, data mengalir dari simulator, ke konektor untuk OPC UA, dan kemudian ke broker MQTT.
Mengonfigurasi titik akhir aset untuk menggunakan nama pengguna dan kata sandi
Contoh sebelumnya menggunakan Anonymous
mode autentikasi. Mode ini tidak memerlukan nama pengguna atau kata sandi.
Untuk menggunakan UsernamePassword
mode autentikasi, selesaikan langkah-langkah berikut:
- Ikuti langkah-langkah dalam Mengonfigurasi autentikasi pengguna OPC UA dengan nama pengguna dan kata sandi untuk menambahkan rahasia untuk nama pengguna dan kata sandi di Azure Key Vault, dan memproyeksikannya ke kluster Kubernetes.
- Dalam pengalaman operasi, pilih Kata sandi Nama pengguna untuk bidang Autentikasi pengguna untuk mengonfigurasi titik akhir aset untuk menggunakan rahasia ini. Kemudian masukkan nilai berikut untuk referensi Nama Pengguna dan bidang referensi Kata Sandi:
Bidang | Nilai |
---|---|
Referensi nama pengguna | aio-opc-ua-broker-user-authentication/username |
Referensi kata sandi | aio-opc-ua-broker-user-authentication/password |
Mengimpor dan mengekspor titik akhir aset
Gunakan tombol Impor dan Ekspor untuk mengimpor atau mengekspor titik akhir aset dalam pengalaman operasi:
File JSON yang Anda ekspor berisi definisi titik akhir aset. Anda dapat menggunakan file ini untuk mengimpor titik akhir aset ke instans lain operasi Azure IoT atau memodifikasinya untuk membuat titik akhir aset baru dalam instans saat ini:
{
"name": "<your asset endpoint name>",
"type": "microsoft.deviceregistry/assetendpointprofiles",
"location": "<your location>",
"extendedLocation": {
"type": "CustomLocation",
"name": "/subscriptions/<your subscription id>/resourceGroups/<your resource group>/providers/Microsoft.ExtendedLocation/customLocations/<your custom location>"
},
"properties": {
"targetAddress": "<your target address>",
"endpointProfileType": "Microsoft.OpcUa",
"additionalConfiguration": "{\"runAssetDiscovery\":true}",
"authentication": {
"method": "Anonymous"
}
},
"apiVersion": "2024-11-01"
}
Petunjuk / Saran
Ekspor titik akhir aset yang ada untuk menemukan nilainya extendedLocation Name
.
Petunjuk / Saran
Anda juga dapat menggunakan perintah az iot ops asset endpoint show
dan az iot ops asset endpoint create
untuk melihat dan membuat titik akhir aset.
Mengelola sertifikat dan rahasia
Pada halaman Titik akhir aset , Anda dapat mengelola sertifikat dan rahasia yang digunakan titik akhir aset Anda:
Tab Sertifikat memperlihatkan daftar sertifikat tepercaya dan daftar sertifikat penerbit untuk server OPC UA yang ingin Anda hubungkan.
- Untuk mempelajari selengkapnya tentang infrastruktur sertifikat OPC UA, lihat infrastruktur sertifikat OPC UA untuk konektor untuk OPC UA.
- Untuk mempelajari selengkapnya tentang cara mengonfigurasi sertifikat tepercaya dan daftar penerbit, lihat Mengonfigurasi infrastruktur sertifikat OPC UA untuk konektor untuk OPC UA.
Tab Rahasia memperlihatkan rahasia yang berisi nama pengguna dan kata sandi untuk server OPC UA yang ingin Anda hubungkan. Untuk mempelajari selengkapnya tentang autentikasi pengguna OPC UA, lihat Mengonfigurasi opsi autentikasi pengguna OPC UA untuk konektor untuk OPC UA.
Menambahkan aset, tag, dan peristiwa
Untuk menambahkan aset dalam pengalaman operasi:
Pilih tab Aset . Sebelum membuat aset apa pun, Anda akan melihat layar berikut:
Petunjuk / Saran
Anda dapat menggunakan kotak filter untuk mencari aset.
Pilih Buat aset.
Pada layar detail aset, masukkan informasi aset berikut:
- Titik akhir aset. Pilih titik akhir aset Anda dari daftar.
- Nama aset
- Deskripsi
- Topik MQTT tempat aset diterbitkan. Default adalah
<namespace>/data/<asset-name>
.
Konfigurasikan kumpulan properti yang ingin Anda kaitkan dengan aset. Anda dapat menerima daftar properti default atau menambahkan properti Anda sendiri. Properti berikut ini tersedia secara default:
- Produsen
- URI Produsen
- Modél
- Kode produk
- Versi perangkat keras
- Versi perangkat lunak
- Nomor seri
- URI Dokumentasi
Pilih Berikutnya untuk masuk ke halaman Tambahkan tag .
Menambahkan tag individual ke aset
Sekarang Anda dapat menentukan tag yang terkait dengan aset. Untuk menambahkan tag OPC UA:
Pilih > CSV.
Masukkan detail tag Anda:
- ID node. Nilai ini adalah ID simpul dari server AGEN PENGGUNA OPC.
- Nama tag (Opsional). Nilai ini adalah nama yang mudah diingat yang ingin Anda gunakan untuk tag. Jika Anda tidak menentukan nama tag, ID simpul digunakan sebagai nama tag.
- Mode pengamatan (Opsional) dengan pilihan berikut:
- Tidak
- Pengukur
- Penghitung
- Histogram
- Catatan
- Interval Pengambilan Sampel (milidetik). Anda dapat mengambil alih nilai default untuk tag ini.
- Ukuran antrean. Anda dapat mengambil alih nilai default untuk tag ini.
Tabel berikut ini memperlihatkan beberapa contoh nilai tag yang bisa Anda gunakan dengan simulator OPC PLC bawaan:
ID Node Nama tag Mode pengamatan ns=3; s=FastUInt10 Suhu Tidak ns=3; s=FastUInt100 Kelembapan Tidak Pilih Kelola pengaturan default untuk mengonfigurasi pengaturan default untuk pesan dari aset. Pengaturan ini berlaku untuk semua tag OPC UA yang termasuk dalam aset. Anda dapat mengambil alih pengaturan ini untuk setiap tag yang Anda tambahkan. Pengaturan default meliputi:
- Interval pengambilan sampel (milidetik): Interval pengambilan sampel menunjukkan laju tercepat di mana server OPC UA harus mengambil sampel sumber yang mendasarinya untuk perubahan data.
- Interval penerbitan (milidetik): Tingkat di mana server OPC UA harus menerbitkan data.
- Ukuran antrean: Kedalaman antrean untuk menyimpan data pengambilan sampel sebelum menerbitkannya.
Menambahkan tag secara massal ke aset
Anda dapat mengimpor hingga 1000 tag OPC UA pada satu waktu dari file CSV:
Buat file CSV yang terlihat seperti contoh berikut:
NodeID TagName Ukuran Antrean Mode Observabilitas Interval Pengambilan Sampel Milidetik ns=3; s=FastUInt1000 Tag 1000 5 Tidak 1000 ns=3; s=FastUInt1001 Tag 1001 5 Tidak 1000 ns=3; s=FastUInt1002 Tag 1002 10 Tidak lima ribu Pilih > CSV Impor CSV (.csv). Pilih file CSV yang Anda buat dan pilih Buka. Tag yang ditentukan dalam file CSV diimpor:
Jika Anda mengimpor file CSV yang berisi tag yang merupakan duplikat tag yang ada, pengalaman operasi menampilkan pesan berikut:
Anda dapat mengganti tag duplikat dan menambahkan tag baru dari file impor, atau Anda dapat membatalkan impor.
Untuk mengekspor semua tag dari aset ke file CSV, pilih Ekspor semua dan pilih lokasi untuk file:
Pada halaman Tag , pilih Berikutnya untuk masuk ke halaman Tambahkan peristiwa .
Petunjuk / Saran
Anda dapat menggunakan kotak filter untuk mencari tag.
Menambahkan peristiwa individual ke aset
Sekarang Anda dapat menentukan peristiwa yang terkait dengan aset. Untuk menambahkan peristiwa OPC UA:
Pilih > CSV.
Masukkan detail peristiwa Anda:
- Pemberitahuan peristiwa. Nilai ini adalah pemberitahuan peristiwa dari server AGEN OPC.
- Nama peristiwa (Opsional). Nilai ini adalah nama yang mudah diingat yang ingin Anda gunakan untuk acara tersebut. Jika Anda tidak menentukan nama peristiwa, pemberitahuan peristiwa digunakan sebagai nama peristiwa.
- Mode pengamatan (Opsional) dengan pilihan berikut:
- Tidak
- Catatan
- Ukuran antrean. Anda dapat mengambil alih nilai default untuk tag ini.
Pilih Kelola pengaturan default untuk mengonfigurasi pengaturan peristiwa default untuk aset. Pengaturan ini berlaku untuk semua peristiwa OPC UA milik aset. Anda dapat mengambil alih pengaturan ini untuk setiap peristiwa yang Anda tambahkan. Pengaturan peristiwa default meliputi:
- Interval penerbitan (milidetik): Tingkat di mana server OPC UA harus menerbitkan data.
- Ukuran antrean: Kedalaman antrean untuk menyimpan data pengambilan sampel sebelum menerbitkannya.
Menambahkan peristiwa secara massal ke aset
Anda dapat mengimpor hingga 1000 peristiwa OPC UA pada satu waktu dari file CSV.
Untuk mengekspor semua peristiwa dari aset ke file CSV, pilih Ekspor semua dan pilih lokasi untuk file tersebut.
Pada halaman Acara , pilih Berikutnya untuk masuk ke halaman Tinjau .
Petunjuk / Saran
Anda dapat menggunakan kotak filter untuk mencari peristiwa.
Meninjau perubahan
Tinjau tag aset dan OPC UA Dan detail peristiwa Anda dan buat penyesuaian apa pun yang Anda butuhkan:
Memperbarui aset
Temukan dan pilih aset yang Anda buat sebelumnya. Gunakan tab Detail aset, Tag, dan Peristiwa untuk membuat perubahan apa pun:
Pada tab Tag , Anda dapat menambahkan tag, memperbarui tag yang ada, atau menghapus tag.
Untuk memperbarui tag, pilih tag yang sudah ada dan perbarui informasi tag. Lalu pilih Perbarui:
Untuk menghapus tag, pilih satu atau beberapa tag lalu pilih Hapus tag:
Anda juga dapat menambahkan, memperbarui, dan menghapus peristiwa dan properti dengan cara yang sama.
Setelah selesai membuat perubahan, pilih Simpan untuk menyimpan perubahan Anda.
Menghapus aset
Untuk menghapus aset, pilih aset yang ingin Anda hapus. Pada halaman Detail aset , pilih Hapus. Konfirmasikan perubahan Anda untuk menghapus aset:
Mengimpor dan mengekspor aset
Gunakan tombol Impor dan Ekspor untuk mengimpor atau mengekspor aset dalam pengalaman operasi:
File JSON yang Anda ekspor berisi definisi aset. Anda dapat menggunakan file ini untuk mengimpor aset ke instans Lain dari Operasi Azure IoT atau memodifikasinya untuk membuat aset baru dalam instans saat ini. Contoh JSON berikut menunjukkan contoh file impor yang akan digunakan untuk membuat aset termostat:
{
"name": "thermostat",
"type": "microsoft.deviceregistry/assets",
"location": "<your location>",
"extendedLocation": {
"type": "CustomLocation",
"name": "/subscriptions/<your subscription id>/resourceGroups/<your resource group>/providers/Microsoft.ExtendedLocation/customLocations/<your custom location>"
},
"properties": {
"enabled": true,
"displayName": "thermostat",
"description": "A simulated thermostat asset",
"assetEndpointProfileRef": "opc-ua-connector-1",
"version": 1,
"attributes": {
"batch": "102",
"customer": "Contoso",
"equipment": "Boiler",
"isSpare": "true",
"location": "Seattle"
},
"defaultDatasetsConfiguration": "{\"publishingInterval\":1000,\"samplingInterval\":1000,\"queueSize\":1}",
"defaultEventsConfiguration": "{\"publishingInterval\":1000,\"queueSize\":1}",
"defaultTopic": {
"path": "azure-iot-operations/data/thermostat",
"retain": "Never"
},
"datasets": [
{
"name": "default",
"dataPoints": [
{
"name": "temperature",
"dataSource": "ns=3;s=SpikeData",
"observabilityMode": "None",
"dataPointConfiguration": "{}"
}
]
}
]
},
"apiVersion": "2024-11-01"
}
Petunjuk / Saran
Ekspor titik akhir aset yang ada untuk menemukan nilainya extendedLocation Name
.
Petunjuk / Saran
Anda juga dapat menggunakan perintah az iot ops asset show
dan az iot ops asset create
untuk melihat dan membuat titik akhir aset.
Pemberitahuan
Setiap kali Anda membuat perubahan pada aset dalam pengalaman operasi, Anda akan melihat pemberitahuan yang melaporkan status operasi:
Melihat log aktivitas
Dalam pengalaman operasi, Anda dapat melihat log aktivitas untuk setiap instans atau setiap sumber daya dalam instans.
Untuk melihat log aktivitas di tingkat instans, pilih tab Log aktivitas . Anda dapat menggunakan filter Rentang Waktu dan Jenis sumber daya untuk menyesuaikan tampilan.
Untuk melihat log aktivitas sebagai tingkat sumber daya, pilih sumber daya yang ingin Anda periksa. Sumber daya ini dapat menjadi aset, titik akhir aset, atau alur data. Di gambaran umum sumber daya, pilih Tampilkan log aktivitas. Anda dapat menggunakan filter Timespan untuk mengkustomisasi tampilan.