IoT Platform:Meneruskan data ke Simple Message Queue (MNS)

Cara kerja

Fitur penerusan data meneruskan pesan secara real time dari topik tertentu—untuk semua atau perangkat spesifik dalam produk yang sama—ke topik MNS yang dilanggani oleh antrian MNS.

Pada gambar di atas:

• Sumber data: Untuk informasi tentang jenis topik yang didukung, lihat Format data (untuk produk dan perangkat non-gerbang), Topik kustom (untuk gerbang cloud MQTT), Topik penerusan pesan (untuk gerbang cloud GB/T 32960), Topik penerusan pesan (untuk gerbang cloud JT/T 808).

• Tujuan data: Topik MNS yang Anda buat untuk menerima data perangkat. Semua pesan dari topik ini didorong ke antrian MNS yang berlangganan padanya.

• Skrip parser: Skrip yang Anda konfigurasikan untuk menggunakan fungsi penerusan data writeMns(destinationId, payload) guna meneruskan data topik ke topik MNS.

  Untuk informasi lebih lanjut tentang fungsi tersebut, lihat Daftar fungsi.

Batasan

• Penerusan data ke MNS hanya didukung oleh instans Platform IoT di wilayah tertentu. Untuk informasi lebih lanjut tentang wilayah yang didukung, lihat Ketersediaan fitur berdasarkan wilayah.

• Versi baru maupun versi sebelumnya dari fitur penerusan data mendukung penerusan data ke MNS. Untuk contoh penggunaan versi sebelumnya, lihat Meneruskan data ke Message Service (versi sebelumnya).

• Untuk informasi selengkapnya tentang batasan penerusan paket perangkat dari instans IoT Platform, lihat Batasan.

Buat tujuan data

1. Login ke Konsol Platform IoT.

2. Pada halaman Overview, temukan instans yang ingin Anda kelola, lalu klik ID instans atau nama instans tersebut.

3. Di panel navigasi kiri, pilih Message Forwarding > Data Forwarding.

4. Pada halaman Data Forwarding, klik Go to New Version di pojok kanan atas.

   Catatan

   Jika Anda pernah melakukan operasi ini sebelumnya, Anda akan diarahkan secara otomatis ke versi baru halaman Data Forwarding.

5. Klik tab Data Destination. Pada tab ini, klik Create Data Destination.

6. Pada dialog Create Data Destination, masukkan nama untuk tujuan data, misalnya DataPurpose. Konfigurasikan parameter seperti yang dijelaskan dalam tabel berikut, lalu klik OK.

   Parameter	Deskripsi
   Select an operation.	Pilih Forward data to Message Service (MNS).
   Region	Pilih wilayah tempat Message Service diaktifkan.
   Topic	Pilih topik SMQ yang ingin Anda gunakan untuk menerima data. SMQ meneruskan pesan yang diterima ke langganan HTTP dan antrian di bawah topik ini. Saat ini, Anda hanya dapat berlangganan pesan yang didorong Platform IoT ke topik SMQ menggunakan metode HTTP atau antrian. Anda dapat mengklik Create Topic untuk membuka konsol Simple Message Queue (formerly MNS) guna membuat topik SMQ dan langganan. Untuk informasi lebih lanjut, lihat dokumentasi Simple Message Queue (SMQ).
   Role	Berikan izin kepada Platform IoT untuk menulis data ke Simple Message Queue (formerly MNS). Jika belum ada role RAM, klik Create RAM Role untuk membuat role RAM dan kebijakan otorisasi di konsol RAM. Buat role RAM.

Konfigurasikan dan mulai parser

1. Buat parser bernama DataParser. Untuk informasi lebih lanjut, lihat Langkah 1: Buat parser.

2. Pada halaman Parser Details, asosiasikan parser dengan sumber data yang telah dibuat.

   1. Pada langkah Data Source wizard, klik Associate Data Source.

   2. Pada dialog yang muncul, pilih DataSource dari daftar drop-down Data Source, lalu klik OK.

3. Pada halaman Parser Details, asosiasikan parser dengan tujuan data yang telah dibuat.

   1. Klik Data Destination di wizard. Di bagian Data Destination, klik Associate Data Destination.

   2. Pada dialog yang muncul, pilih DataPurpose dari daftar drop-down Data Destination, lalu klik OK.

   3. Di bagian Tujuan Data, lihat dan simpan data destination ID. Dalam contoh ini, ID-nya adalah 1000.

      Saat menulis skrip parser, Anda harus menggunakan data destination ID.

4. Pada halaman Parser Details, klik Parser.

5. Di editor skrip, masukkan skrip parser.

   Sintaksis skrip parser mirip dengan JavaScript. Untuk informasi lebih lanjut tentang cara mengedit skrip, lihat Sintaksis skrip.

   Untuk informasi lebih lanjut tentang parameter fungsi, lihat Daftar fungsi.

   // Gunakan fungsi payload() untuk mendapatkan konten pesan yang dilaporkan oleh perangkat dan mengonversinya ke format JSON.
   var data = payload("json");
   // Teruskan data model TSL secara langsung.
   writeMns(1000, data);

6. Klik Test. Ikuti petunjuk di layar untuk memilih produk dan perangkat, masukkan topik dan data muatan, lalu verifikasi bahwa skrip dapat dieksekusi.

   Gambar berikut menunjukkan contoh parameter:

   Output berikut mengonfirmasi eksekusi skrip berhasil.

   

7. Klik Publish.

8. Buka tab Parser pada halaman Data Forwarding. Temukan parser DataParser, lalu klik Start di kolom Tindakan untuk menjalankan parser.

Langkah selanjutnya

• Anda dapat melihat log operasi untuk device-to-cloud messages dan data forwarding di tab IoT Platform Logs. Untuk membuka tab ini, buka Konsol Platform IoT, temukan instans Anda, lalu pilih O&M > Log Service. Untuk informasi lebih lanjut, lihat Log platform IoT.

• Anda dapat login ke Konsol Simple Message Queue (sebelumnya MNS) untuk melihat pesan yang didorong dari topik MNS ke antrian. Untuk informasi lebih lanjut, lihat Terima pesan.

Referensi

• Untuk petunjuk cara menghubungkan perangkat ke Platform IoT guna melaporkan data, lihat Panduan koneksi perangkat.

• Periksa sumber daya TPS penerusan pesan yang tersedia di halaman detail instans untuk memastikan pesan perangkat dapat diteruskan ke Simple Message Queue (formerly MNS) untuk dikonsumsi. Untuk informasi lebih lanjut, lihat Lihat informasi instans dan data operasional. Jika sumber daya tidak mencukupi, lakukan peningkatan instans. Untuk informasi lebih lanjut, lihat Peningkatan instans.

• Anda dapat melihat metrik topik Simple Message Queue (formerly MNS) untuk memeriksa jumlah pesan yang diterima. Untuk informasi lebih lanjut, lihat Lihat metrik topik.

• Gunakan fitur Manajemen Log untuk mendorong log operasi topik pesan ke Simple Log Service. Jika terjadi pengecualian selama konsumsi pesan, lakukan kueri jejak pesan berdasarkan MessageId untuk mendiagnosis masalah. Untuk informasi lebih lanjut, lihat Dorong log ke Simple Log Service dan Lihat log di Simple Log Service.