Bagikan melalui


Mengelola konfigurasi aset dari jarak jauh

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:

  1. Masuk ke portal Azure dengan penyewa dan nama pengguna yang sama dengan yang Anda gunakan untuk menyebarkan Operasi Azure IoT.
  2. 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.
  3. Di portal Azure, buka grup sumber daya yang berisi Kubernetes - instans Azure Arc Anda. Pada halaman Kontrol akses (IAM), pilih +Tambahkan > penetapan peran.
  4. Pada halaman Tambahkan penetapan peran, pilih Peran administrator istimewa. Lalu pilih Kontributor lalu pilih Berikutnya.
  5. Pada halaman Anggota , tambahkan pengguna baru Anda ke peran tersebut.
  6. 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:

Cuplikan layar yang memperlihatkan daftar situs dalam pengalaman operasi.

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:

Cuplikan layar yang memperlihatkan daftar instans dalam pengalaman operasi.

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:

Cuplikan layar yang memperlihatkan halaman gambaran umum untuk instans dalam pengalaman operasi.

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:

  1. Pilih Titik akhir aset lalu Buat titik akhir aset:

    Cuplikan layar yang memperlihatkan halaman titik akhir aset dalam pengalaman operasi.

    Petunjuk / Saran

    Anda dapat menggunakan kotak filter untuk mencari titik akhir aset.

  2. 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
  3. 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:

  1. 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.
  2. 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:

Cuplikan layar memperlihatkan opsi untuk mengimpor dan mengekspor titik akhir aset.

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:

Menambahkan aset, tag, dan peristiwa

Untuk menambahkan aset dalam pengalaman operasi:

  1. Pilih tab Aset . Sebelum membuat aset apa pun, Anda akan melihat layar berikut:

    Cuplikan layar yang memperlihatkan tab Aset kosong dalam pengalaman operasi.

    Petunjuk / Saran

    Anda dapat menggunakan kotak filter untuk mencari aset.

  2. Pilih Buat aset.

  3. 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>.
  4. 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

    Cuplikan layar yang memperlihatkan cara menambahkan detail aset dalam pengalaman operasi.

  5. 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:

  1. Pilih > CSV.

  2. 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.

    Cuplikan layar yang memperlihatkan penambahan tag dalam pengalaman operasi.

    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
  3. 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:

  1. 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
  2. Pilih > CSV Impor CSV (.csv). Pilih file CSV yang Anda buat dan pilih Buka. Tag yang ditentukan dalam file CSV diimpor:

    Cuplikan layar yang memperlihatkan impor yang telah selesai dari file Excel dalam pengalaman operasi.

    Jika Anda mengimpor file CSV yang berisi tag yang merupakan duplikat tag yang ada, pengalaman operasi menampilkan pesan berikut:

    Cuplikan layar yang memperlihatkan pesan kesalahan saat Anda mengimpor definisi tag duplikat dalam pengalaman operasi.

    Anda dapat mengganti tag duplikat dan menambahkan tag baru dari file impor, atau Anda dapat membatalkan impor.

  3. Untuk mengekspor semua tag dari aset ke file CSV, pilih Ekspor semua dan pilih lokasi untuk file:

    Cuplikan layar yang menunjukkan cara mengekspor definisi tag dari aset dalam pengalaman operasi.

  4. 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:

  1. Pilih > CSV.

  2. 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.

    Cuplikan layar yang memperlihatkan penambahan peristiwa dalam pengalaman operasi.

  3. 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:

Cuplikan layar yang memperlihatkan cara meninjau aset, tag, dan peristiwa Anda dalam pengalaman operasi.

Memperbarui aset

Temukan dan pilih aset yang Anda buat sebelumnya. Gunakan tab Detail aset, Tag, dan Peristiwa untuk membuat perubahan apa pun:

Cuplikan layar yang menunjukkan cara memperbarui aset yang ada dalam pengalaman operasi.

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:

Cuplikan layar yang menunjukkan cara memperbarui tag yang ada dalam pengalaman operasi.

Untuk menghapus tag, pilih satu atau beberapa tag lalu pilih Hapus tag:

Cuplikan layar yang memperlihatkan cara menghapus tag dalam pengalaman operasi.

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:

Cuplikan layar yang menunjukkan cara menghapus aset dari pengalaman operasi.

Mengimpor dan mengekspor aset

Gunakan tombol Impor dan Ekspor untuk mengimpor atau mengekspor aset dalam pengalaman operasi:

Cuplikan layar memperlihatkan opsi untuk mengimpor dan mengekspor aset.

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:

Cuplikan layar yang memperlihatkan pemberitahuan dalam pengalaman 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.

Cuplikan layar yang menunjukkan log aktivitas untuk instans dalam pengalaman operasi.

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.