IoT Platform:Mengekspor log Platform IoT

Catatan penggunaan

Platform IoT tidak mendukung ekspor atau unduh langsung file log. Untuk memperoleh, mengekspor, atau membuat cadangan log Platform IoT, Anda harus mengaktifkan fitur ekspor log agar log diekspor secara real time ke Logstore di Simple Log Service guna kueri, analisis, dan penyimpanan jangka panjang.

Fitur ekspor log hanya tersedia untuk Akun Alibaba Cloud.

Ekspor log ke Logstore di Simple Log Service dikenai biaya. Untuk informasi selengkapnya, lihat Penagihan Simple Log Service.

Aktifkan ekspor log Platform IoT

Anda harus mengaktifkan fitur ekspor log untuk setiap Produk secara terpisah.

1. Masuk ke Konsol IoT Platform.

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

3. Di panel navigasi sebelah kiri, pilih O&M > Log Service.
4. Pilih sebuah Produk lalu klik tab Export IoT Platform Logs.
5. Klik Enable Now.
6. Pada kotak dialog yang muncul, ikuti petunjuk untuk mengaktifkan ekspor log.
   Catatan Jika Simple Log Service belum diaktifkan, klik Enable Now akan mengarahkan Anda ke halaman tempat Anda dapat mengaktifkannya.
   1. Klik Create di samping Role dan Log Export Destination.
      Catatan Jika Created ditampilkan di samping Role dan Log Export Destination, Anda dapat melewati langkah ini.
   2. Klik OK.
   Setelah Anda mengaktifkan ekspor log untuk suatu Produk, lokasi penyimpanan log dan peran terkait layanan untuk ekspor log akan dibuat secara otomatis.

   • Peran terkait layanan untuk ekspor log: Peran ini digunakan untuk memberikan izin ekspor log. Untuk informasi selengkapnya, lihat Deskripsi peran.
   • Lokasi penyimpanan log:
     • Project: iot-log-${uid}-${regionId}. Dalam nama ini, ${uid} adalah ID akun Alibaba Cloud Anda, dan ${regionId} adalah Wilayah tempat layanan Platform IoT Anda berada.
     • Logstore: iot-logs.

     Semua Produk Anda menggunakan lokasi penyimpanan ini. Produk yang berbeda dibedakan berdasarkan kata kunci ProductKey dalam konten log. Untuk informasi selengkapnya tentang log, lihat Log Platform IoT.

7. Atur periode retensi data.
   Log yang diekspor akan dihapus setelah periode retensi data yang ditentukan berakhir. Periode retensi default adalah 7 hari. Anda dapat mengatur periode retensi antara 1 hingga 3.000 hari, atau memilih retensi permanen.

   Pada tab Export IoT Platform Logs, klik Set Data Retention Period. Anda akan diarahkan ke halaman manajemen Logstore. Lalu, klik Modify, atur Data Retention Period, lalu klik Save.

Gunakan fitur kueri dan analisis log

Setelah mengaktifkan ekspor log Platform IoT, Anda dapat melakukan operasi berikut pada tab Export IoT Platform Logs:

• Pada tab Raw Logs:

  Operasi	Deskripsi
  Kueri dan analisis log	Pada tab Raw Logs, gunakan pernyataan SQL untuk melakukan kueri log dalam rentang waktu tertentu dan lakukan analisis statistik. Untuk informasi selengkapnya tentang sintaks SQL, lihat Sintaks dan fitur kueri dan Sintaks analisis.
  Statistical Charts	Pada tab Statistical Charts, lihat grafik statistik yang dihasilkan.
  LogReduce	Pada tab LogReduce, agregasikan log dengan kemiripan tinggi untuk mendapatkan ikhtisar log secara cepat.
  Field Settings	Setelah melakukan kueri log, analisis distribusi bidang tertentu dalam hasil kueri secara cepat.
  Configure Alerts	Ketika peringatan dipicu, sistem mengirim informasi peringatan melalui metode seperti pesan teks, panggilan suara, email, dan robot DingTalk.

• Pada tab Log Reports:

  Operasi	Deskripsi
  View Reports	Lihat laporan log untuk rentang waktu tertentu. Laporan log menampilkan status operasional dan masalah anomali perangkat. Untuk daftar item yang disertakan, lihat Tabel 1. Deskripsi laporan. Secara default, laporan menampilkan data dari jam terakhir, dan granularitas waktu untuk grafik garis adalah 1 menit. Anda dapat mengklik daftar drop-down pengaturan waktu berwarna biru di pojok kanan atas halaman, atau klik > Select Time Range di pojok kanan atas laporan tunggal untuk mengatur rentang waktu. Pada tab Raw Logs, gunakan SQL untuk mengatur granularitas waktu grafik garis. Untuk informasi selengkapnya tentang sintaks, lihat Fungsi tanggal dan waktu. Contohnya, gunakan bizCode:device | SELECT date_format(date_trunc('hour',__time__), '%m-%d %H:%i') AS Time, count(1) AS count , operation GROUP BY Time, operation ORDER BY Time limit 1440 untuk mengatur granularitas waktu menjadi 1 jam.
  Subscribe to Reports	Sistem secara berkala merender laporan sebagai gambar dan mengirimkannya ke personel yang ditentukan melalui email atau robot DingTalk.

  Tabel 1. Deskripsi laporan

  Laporan	Gaya Tampilan	Deskripsi
  Jumlah perangkat online/offline	Grafik garis	Menampilkan jumlah kali perangkat online dan offline dalam rentang waktu tertentu.
  Jumlah pesan mobile originated/terminated	Grafik garis	Menampilkan jumlah pesan mobile originated dan mobile terminated dalam rentang waktu tertentu.
  20 perangkat teratas berdasarkan volume pesan mobile originated/terminated	Daftar	Menampilkan 20 perangkat dengan volume pesan mobile originated atau mobile terminated tertinggi beserta volumenya.
  Distribusi kode kesalahan skrip penguraian data	Grafik lingkaran	Menampilkan distribusi kode kesalahan yang terjadi selama penguraian skrip dalam rentang waktu tertentu. Anda dapat melakukan kueri log berdasarkan kode kesalahan untuk melihat detail kesalahan penguraian skrip dan mengoptimalkan skrip Anda sesuai kebutuhan.
  10 perangkat teratas dengan kesalahan skrip penguraian data	Daftar	Menampilkan 10 perangkat dengan jumlah kesalahan penguraian skrip terbanyak dalam rentang waktu tertentu beserta jumlah kesalahannya. Anda dapat melakukan kueri log berdasarkan NamaPerangkat untuk melihat detail kesalahan penguraian skrip dan mengoptimalkan skrip Anda sesuai kebutuhan.
  Distribusi kode kesalahan validasi model Thing Specification Language (TSL)	Grafik lingkaran	Menampilkan distribusi kode kesalahan validasi model TSL dalam rentang waktu tertentu. Anda dapat melakukan kueri log berdasarkan kode kesalahan untuk melihat detail kesalahan validasi model TSL dan melakukan pemecahan masalah.
  10 perangkat teratas dengan kesalahan validasi model TSL	Daftar	Menampilkan 10 perangkat dengan jumlah kesalahan validasi model TSL terbanyak dalam rentang waktu tertentu beserta jumlah kesalahannya. Anda dapat melakukan kueri log berdasarkan NamaPerangkat untuk melihat detail kesalahan validasi model TSL dan melakukan pemecahan masalah.
  Volume pesan langganan sisi server	Grafik garis	Menampilkan volume pesan yang diteruskan melalui langganan sisi server AMQP dan MNS dalam rentang waktu tertentu.
  20 catatan pesan perangkat anomali terakhir	Grafik lingkaran	Menampilkan 20 catatan pesan perangkat anomali terakhir dalam rentang waktu tertentu. Anda dapat melakukan kueri log berdasarkan NamaPerangkat dan kode kesalahan untuk melihat detail pesan perangkat anomali dan melakukan pemecahan masalah.
  Jumlah pesan penerusan data	Grafik garis	Menampilkan volume pesan yang diteruskan ke layanan cloud lain dalam rentang waktu tertentu.
  20 catatan penerusan Mesin aturan anomali terakhir	Daftar	Menampilkan 20 catatan penerusan Mesin aturan anomali terakhir dalam rentang waktu tertentu. Anda dapat melakukan kueri log berdasarkan NamaPerangkat dan kode kesalahan untuk melihat detail penerusan Mesin aturan anomali dan melakukan pemecahan masalah.
  Distribusi kesalahan panggilan API cloud	Grafik lingkaran	Menampilkan distribusi kesalahan panggilan API cloud dalam rentang waktu tertentu. Anda dapat melakukan kueri log berdasarkan nama API dan menggunakan detail log serta kode kesalahan untuk melakukan pemecahan masalah.

Nonaktifkan ekspor log Platform IoT

Anda dapat menonaktifkan fitur ekspor log untuk Produk tertentu kapan saja guna menghemat ruang penyimpanan.

1. Di Konsol Platform IoT, buka halaman Instance Overview lalu klik kartu instans target.
2. Di panel navigasi sebelah kiri, pilih O&M > Log Service.
3. Pilih sebuah Produk lalu klik tab Export IoT Platform Logs.
4. Klik Disable Export, lalu klik Confirm.
   Setelah menonaktifkan ekspor log untuk Produk tersebut, log Platform IoT baru tidak lagi diekspor ke Logstore. Log yang telah diekspor akan tetap disimpan hingga periode retensi data yang ditentukan berakhir, lalu dihapus.