Berkomunikasi dengan edgeAgent menggunakan metode langsung bawaan
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.
Memantau dan mengelola penyebaran IoT Edge dengan menggunakan metode langsung yang disertakan dalam modul agen IoT Edge. Metode langsung diterapkan pada perangkat, dan kemudian dapat dipanggil dari cloud. Agen IoT Edge menyertakan metode langsung yang membantu Anda memantau dan mengelola perangkat IoT Edge dari jarak jauh.
Untuk informasi selengkapnya tentang metode langsung, cara menggunakannya, dan cara mengimplementasikannya dalam modul Anda sendiri, lihat Memahami dan memanggil metode langsung dari IoT Hub.
Nama-nama metode langsung ini ditangani sebagai tidak peka huruf besar/kecil.
Ping
Metode ping berguna untuk memeriksa apakah IoT Edge berjalan pada perangkat, atau apakah perangkat memiliki koneksi terbuka ke IoT Hub. Gunakan metode langsung ini untuk mengirim ping ke agen IoT Edge dan dapatkan statusnya. Ping yang berhasil mengembalikan muatan kosong dan "status": 200.
Contohnya:
az iot hub invoke-module-method --method-name 'ping' -n <hub name> -d <device name> -m '$edgeAgent'
Di portal Microsoft Azure, panggil metode dengan nama metode ping dan muatan JSON kosong {}.
Memulai ulang modul
Metode RestartModule memungkinkan manajemen jarak jauh modul yang berjalan pada perangkat IoT Edge. Jika modul melaporkan keadaan gagal atau perilaku tidak sehat lainnya, Anda dapat memicu agen IoT Edge untuk memulai ulang. Perintah mulai ulang yang berhasil akan mengembalikan muatan kosong dan "status": 200.
Metode RestartModule tersedia di IoT Edge versi 1.0.9 dan yang lebih baru.
Tip
Halaman pemecahan masalah IoT Edge di portal Microsoft Azure memberikan pengalaman yang lebih sederhana untuk melihat log modul. Untuk informasi selengkapnya, lihat Memantau dan memecahkan masalah perangkat IoT Edge dari portal Microsoft Azure.
Anda dapat menggunakan metode langsung RestartModule pada modul apa pun yang berjalan pada perangkat IoT Edge, termasuk modul edgeAgent itu sendiri. Namun, jika Anda menggunakan metode langsung ini untuk mematikan edgeAgent, Anda tidak akan menerima hasil yang sukses karena koneksi terganggu saat modul dimulai ulang.
Contohnya:
az iot hub invoke-module-method --method-name 'RestartModule' -n <hub name> -d <device name> -m '$edgeAgent' --method-payload \
'
{
"schemaVersion": "1.0",
"id": "<module name>"
}
'
Di portal Microsoft Azure, panggil metode dengan nama metode RestartModule dan payload JSON berikut:
{
"schemaVersion": "1.0",
"id": "<module name>"
}
Metode langsung diagnostik
- GetModuleLogs: Mengambil log modul sebaris sebagai respons metode langsung.
- UploadModuleLogs: Mengambil log modul dan mengunggahnya ke Azure Blob Storage.
- UploadSupportBundle: Mengambil log modul menggunakan bundel dukungan dan mengunggah file zip ke Azure Blob Storage.
- GetTaskStatus: Memeriksa status log unggahan atau permintaan bundel dukungan.
Metode langsung diagnostik ini tersedia pada rilis 1.0.10.