Peristiwa siklus hidup - AWS IoT Core
Hubungkan/Putuskan acaraAcara Berlangganan/Berhenti Berlangganan

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Peristiwa siklus hidup

AWS IoT dapat mempublikasikan peristiwa siklus hidup pada topik MQTT. Acara ini tersedia secara default dan tidak dapat dinonaktifkan.

catatan

Pesan siklus hidup mungkin dikirim rusak. Anda mungkin menerima pesan duplikat.

Hubungkan/Putuskan acara

catatan

Dengan pengindeksan armada Manajemen AWS IoT Perangkat, Anda dapat mencari berbagai hal, menjalankan kueri agregat, dan membuat grup dinamis berdasarkan peristiwa Connect/Disconnect. Untuk informasi selengkapnya, lihat Pengindeksan armada.

AWS IoT menerbitkan pesan ke topik MQTT berikut saat klien menghubungkan atau memutuskan sambungan:

  • $aws/events/presence/connected/clientId— Klien yang terhubung ke broker pesan.

  • $aws/events/presence/disconnected/clientId— Klien terputus dari broker pesan.

Berikut ini adalah daftar elemen JSON yang terkandung dalam pesan koneksi/pemutusan yang dipublikasikan ke topik. $aws/events/presence/connected/clientId

clientId

ID klien dari klien yang menghubungkan atau memutuskan sambungan.

catatan

ID klien yang berisi # atau + tidak menerima peristiwa siklus hidup.

klien InitiatedDisconnect

Benar jika klien memulai pemutusan. Kalau tidak, salah. Hanya ditemukan di pesan putuskan sambungan.

disconnectReason

Alasan mengapa klien terputus. Hanya ditemukan di pesan putuskan sambungan. Tabel berikut berisi nilai yang valid dan apakah broker akan mengirim pesan Last Will and Testament (LWT) ketika pemutusan terjadi.

Putuskan alasan Deskripsi Broker akan mengirim pesan LWT
AUTH_ERROR Klien gagal mengautentikasi atau otorisasi gagal. Ya. Jika perangkat memiliki koneksi aktif sebelum menerima kesalahan ini.
CLIENT_INITIATED_DISCONNECT Klien menunjukkan bahwa itu akan terputus. Klien dapat melakukan ini dengan mengirimkan paket DISCONNECT kontrol MQTT atau Close frame jika klien menggunakan koneksi. WebSocket Tidak.
CLIENT_ERROR Klien melakukan sesuatu yang salah yang menyebabkannya terputus. Misalnya, klien akan terputus karena mengirim lebih dari 1 CONNECT paket MQTT pada koneksi yang sama atau jika klien mencoba mempublikasikan dengan muatan yang melebihi batas muatan. Ya.
CONNECTION_LOST Koneksi client-server terputus. Hal ini dapat terjadi selama periode latensi jaringan tinggi atau ketika koneksi internet terputus. Ya.
DUPLICATE_CLIENTID Klien menggunakan ID klien yang sudah digunakan. Dalam hal ini, klien yang sudah terhubung akan terputus dengan alasan pemutusan ini. Ya.
FORBIDDEN_ACCESS Klien tidak diizinkan untuk terhubung. Misalnya, klien dengan alamat IP yang ditolak akan gagal terhubung. Ya. Jika perangkat memiliki koneksi aktif sebelum menerima kesalahan ini.
MQTT_KEEP_ALIVE_TIMEOUT Jika tidak ada komunikasi client-server untuk 1.5x dari waktu keep-alive klien, klien terputus. Ya.
SERVER_ERROR Terputus karena masalah server yang tidak terduga. Ya.
SERVER_INITIATED_DISCONNECT Server sengaja memutus klien karena alasan operasional. Ya.
THROTTLED Klien terputus karena melebihi batas pelambatan. Ya.
WEBSOCKET_TTL_EXPIRATION Klien terputus karena WebSocket telah terhubung lebih lama dari time-to-live nilainya. Ya.
CUSTOMAUTH_TTL_EXPIRATION Klien terputus karena telah terhubung lebih lama dari time-to-live nilai otorisasi kustomnya. Ya.
eventType

Jenis peristiwa. Nilai-nilai yang valid adalah connected atau disconnected.

ipAddress

Alamat IP dari klien penghubung. Ini bisa dalam format IPv4 atau IPv6. Ditemukan dalam pesan koneksi saja.

principalIdentifier

Kredensi yang digunakan untuk mengautentikasi. Untuk sertifikat otentikasi timbal balik TLS, ini adalah ID sertifikat. Untuk koneksi lain, ini adalah kredensi IAM.

sessionIdentifier

Pengidentifikasi unik secara global AWS IoT yang ada selama masa sesi.

timestamp

Perkiraan kapan peristiwa itu terjadi.

versionNumber

Nomor versi untuk acara siklus hidup. Ini adalah nilai integer panjang yang meningkat secara monoton untuk setiap koneksi ID klien. Nomor versi dapat digunakan oleh pelanggan untuk menyimpulkan urutan peristiwa siklus hidup.

catatan

Pesan sambungkan dan putuskan sambungan untuk koneksi klien memiliki nomor versi yang sama.

Nomor versi mungkin melewati nilai dan tidak dijamin akan meningkat secara konsisten sebesar 1 untuk setiap acara.

Jika klien tidak terhubung selama kurang lebih satu jam, nomor versi diatur ulang ke 0. Untuk sesi persisten, nomor versi disetel ulang ke 0 setelah klien terputus lebih lama dari yang dikonfigurasi time-to-live (TTL) untuk sesi persisten.

Pesan connect memiliki struktur berikut.

{
    "clientId": "186b5",
    "timestamp": 1573002230757,
    "eventType": "connected",
    "sessionIdentifier": "a4666d2a7d844ae4ac5d7b38c9cb7967",
    "principalIdentifier": "12345678901234567890123456789012",
    "ipAddress": "192.0.2.0",
    "versionNumber": 0
}

Pesan pemutusan memiliki struktur berikut.

{
    "clientId": "186b5",
    "timestamp": 1573002340451,
    "eventType": "disconnected",
    "sessionIdentifier": "a4666d2a7d844ae4ac5d7b38c9cb7967",
    "principalIdentifier": "12345678901234567890123456789012",
    "clientInitiatedDisconnect": true,
    "disconnectReason": "CLIENT_INITIATED_DISCONNECT",
    "versionNumber": 0
}

Menangani pemutusan klien

Praktik terbaik adalah selalu menerapkan status tunggu untuk peristiwa siklus hidup, termasuk pesan Kehendak Terakhir dan Perjanjian (LWT). Ketika pesan pemutusan diterima, kode Anda harus menunggu jangka waktu tertentu dan memverifikasi perangkat masih offline sebelum mengambil tindakan. Salah satu cara untuk melakukannya adalah dengan menggunakan SQS Delay Queues. Saat klien menerima LWT atau peristiwa siklus hidup, Anda dapat mengantrekan pesan (misalnya, selama 5 detik). Ketika pesan itu tersedia dan diproses (oleh Lambda atau layanan lain), Anda dapat terlebih dahulu memeriksa apakah perangkat masih offline sebelum mengambil tindakan lebih lanjut.

Acara Berlangganan/Berhenti Berlangganan

AWS IoT menerbitkan pesan ke topik MQTT berikut ketika klien berlangganan atau berhenti berlangganan topik MQTT:

$aws/events/subscriptions/subscribed/clientId

atau 

$aws/events/subscriptions/unsubscribed/clientId

Di clientId mana ID klien MQTT yang terhubung ke broker pesan. AWS IoT

Pesan yang dipublikasikan untuk topik ini memiliki struktur sebagai berikut:

{
    "clientId": "186b5",
    "timestamp": 1460065214626,
    "eventType": "subscribed" | "unsubscribed",
    "sessionIdentifier": "00000000-0000-0000-0000-000000000000",
    "principalIdentifier": "000000000000/ABCDEFGHIJKLMNOPQRSTU:some-user/ABCDEFGHIJKLMNOPQRSTU:some-user",
    "topics" : ["foo/bar","device/data","dog/cat"]
}

Berikut ini adalah daftar elemen JSON yang terkandung dalam pesan berlangganan dan berhenti berlangganan yang diterbitkan ke dan topik. $aws/events/subscriptions/subscribed/clientId $aws/events/subscriptions/unsubscribed/clientId

clientId

ID klien dari klien berlangganan atau berhenti berlangganan.

catatan

ID klien yang berisi # atau + tidak menerima peristiwa siklus hidup.

eventType

Jenis peristiwa. Nilai-nilai yang valid adalah subscribed atau unsubscribed.

principalIdentifier

Kredensi yang digunakan untuk mengautentikasi. Untuk sertifikat otentikasi timbal balik TLS, ini adalah ID sertifikat. Untuk koneksi lain, ini adalah kredensi IAM.

sessionIdentifier

Pengidentifikasi unik secara global AWS IoT yang ada selama masa sesi.

timestamp

Perkiraan kapan peristiwa itu terjadi.

topik

Sebuah array dari topik MQTT yang klien telah berlangganan.

catatan

Pesan siklus hidup mungkin dikirim rusak. Anda mungkin menerima pesan duplikat.