Memahami batas dan batasan Azure IoT Edge

Berlaku untuk: IoT Edge 1.5 IoT Edge 1.4

Penting

IoT Edge 1.5 LTS dan IoT Edge 1.4 LTS adalah rilis yang didukung. IoT Edge 1.4 LTS adalah akhir masa pakai pada 12 November 2024. Jika Anda menggunakan rilis sebelumnya, lihat Memperbarui IoT Edge.

Artikel ini menjelaskan batasan dan batasan saat menggunakan IoT Edge.

Batas

Jumlah anak dalam hierarki gateway

Setiap perangkat induk IoT Edge dalam hierarki gateway dapat memiliki hingga 100 perangkat anak yang terhubung secara default.

Namun, penting untuk diketahui bahwa setiap perangkat IoT Edge dalam topologi berlapis harus membuka koneksi logis terpisah ke EdgeHub induk (atau IoT Hub) atas nama setiap klien yang terhubung (perangkat atau modul), ditambah satu koneksi untuk dirinya sendiri. Jadi koneksi di setiap lapisan tidak diagregasi, tetapi ditambahkan.

Misalnya, jika ada 2 perangkat anak IoT Edge dalam satu lapisan L4, masing-masing pada gilirannya memiliki 100 klien, maka perangkat IoT Edge induk di lapisan di atas L5 akan memiliki total 202 koneksi masuk dari L4.

Batas ini dapat diubah dengan mengatur variabel lingkungan MaxConnectedClients dalam modul edgeHub perangkat induk. Tetapi IoT Edge dapat mengalami masalah dengan melaporkan statusnya di properti yang dilaporkan kembar jika jumlah klien melebihi beberapa ratus karena batas ukuran kembar IoT Hub. Secara umum, berhati-hatilah saat meningkatkan batas dengan mengubah variabel lingkungan ini.

Untuk informasi selengkapnya, lihat Membuat hierarki gateway.

Ukuran properti yang diinginkan

IoT Hub memberlakukan pembatasan berikut:

• Batas ukuran 8 kb pada nilai tag.
• Batas ukuran 32 kb pada nilai properties/desired dan properties/reported.

Untuk informasi selengkapnya, lihat Ukuran kembar modul.

Jumlah lapisan hierarki berlapis

Perangkat IoT Edge memiliki batas lima lapisan perangkat IoT Edge yang ditautkan sebagai turunan di bawahnya.

Untuk informasi selengkapnya, lihat Hubungan induk dan anak.

Jumlah modul dalam penyebaran

IoT Hub memiliki batasan berikut untuk penyebaran otomatis IoT Edge:

• 50 modul per penyebaran
  • Batas ini digantikan oleh batas ukuran kembar modul IoT Hub 32 kb. Untuk informasi selengkapnya, lihat Memperhatikan batas ukuran kembar saat menggunakan modul kustom.
• 100 penyebaran (termasuk penyebaran berlapis per hub SKU berbayar)
• 10 penyebaran per hub SKU gratis

Batasan

Sertifikat

Sertifikat IoT Edge memiliki batasan berikut:

• Nama umum (CN) tidak boleh sama dengan nama host yang digunakan dalam file konfigurasi pada perangkat IoT Edge.
• Nama yang digunakan oleh klien untuk menyambungkan ke IoT Edge tidak boleh sama dengan nama umum yang digunakan dalam sertifikat CA Edge.

Untuk informasi selengkapnya, lihat Sertifikat untuk keamanan perangkat.

Pengesahan TPM

Saat menggunakan pengesahan TPM dengan layanan provisi perangkat, Anda perlu menggunakan TPM 2.0.

Untuk informasi selengkapnya, lihat Persyaratan perangkat pengesahan TPM.

Sintaks perutean

Sintaks perutean IoT Edge dan IoT Hub hampir identik. Sintaks kueri yang didukung:

• Kueri perutean pesan berdasarkan properti pesan
• Kueri perutean pesan berdasarkan isi pesan

Sintaks kueri yang tidak didukung:

• Kueri perutean pesan berdasarkan kembar perangkat

Memulai ulang kebijakan

Jangan gunakan on-unhealthy atau on-failure sebagai nilai dalam modul karena restartPolicy tidak di-unimplementasi dan tidak akan memulai hidupkan ulang. Hanya never dan always kebijakan hidupkan ulang yang diterapkan.

Cara yang disarankan untuk memulai ulang modul IoT Edge yang tidak sehat secara otomatis dicatat dalam solusi ini. Konfigurasikan Healthcheck properti dalam modul createOptions untuk menangani pemeriksaan kesehatan yang gagal.

Log pemecahan masalah

Mengakses log modul dari portal Azure dapat tertunda saat modul sedang diperbarui.

Jika Anda melihat tab Pemecahan Masalah dari perangkat Anda di IoT Edge di portal Azure, Anda mungkin melihat pesan "Tidak dapat mengambil log. Permintaan gagal dengan kode status 504." Waktu permintaan habis dan Status Runtime mungkin ditampilkan sebagai "Kesalahan" untuk semua modul.

Kemampuan untuk melihat log ini akan dilanjutkan tepat waktu. Alasan akses tertunda adalah karena edgeAgent mungkin sibuk memulai modul sehingga tidak dapat mengambil log secara bersamaan. Log ditarik dari Moby/Docker, sehingga proses ini membutuhkan waktu, dan permintaan dapat kehabisan waktu jika edgeAgent sibuk.

Unggahan File

IoT Hub hanya mendukung API pengunggahan file untuk identitas perangkat, bukan identitas modul. Karena IoT Edge secara eksklusif menggunakan modul, unggahan file tidak didukung secara asli di IoT Edge.

Untuk informasi selengkapnya tentang mengunggah file dengan IoT Hub, lihat Mengunggah file dengan IoT Hub.

Variabel lingkungan agen Edge

Perubahan yang dilakukan pada config.toml edgeAgent variabel lingkungan seperti hostname tidak diterapkan edgeAgent jika kontainer sudah ada. Untuk menerapkan perubahan ini, hapus edgeAgent kontainer menggunakan perintah sudo docker rm -f edgeAgent. Daemon IoT Edge membuat ulang kontainer dan memulai edgeAgent dalam waktu sekitar satu menit.

Autentikasi NTLM

Autentikasi NTLM tidak didukung. Proksi yang dikonfigurasi dengan autentikasi NTLM tidak akan berfungsi.

IoT Edge memiliki dukungan terbatas untuk autentikasi proksi. Proksi yang dikonfigurasi untuk autentikasi nama pengguna dan kata sandi hanya didukung.

Langkah berikutnya

Untuk informasi selengkapnya, lihat Batas IoT Hub lainnya.