全部产品
Search
文档中心

Simple Log Service:Gunakan web tracking SDK untuk JavaScript mengumpulkan log mini program

更新时间:Jul 06, 2025

Untuk mengumpulkan dan menganalisis informasi pengguna mini program, seperti halaman yang diakses, perilaku penjelajahan, dan pembelian, Anda dapat menggunakan Web Tracking SDK untuk JavaScript guna mengunggah log langsung ke Simple Log Service. Pendekatan ini mengurangi beban server karena tidak memerlukan pengunggahan log ke server aplikasi. Artikel ini menjelaskan cara menggunakan Web Tracking SDK untuk JavaScript dalam mengumpulkan log mini program.

Prasyarat

  • Fitur pelacakan web harus diaktifkan pada Logstore Anda. Untuk detail lebih lanjut tentang cara mengaktifkan dan menggunakan fitur pelacakan web, lihat Gunakan Fitur Pelacakan Web untuk Mengumpulkan Log.

  • Tambahkan nama domain yang digunakan oleh fitur pelacakan web untuk komunikasi aman ke daftar domain legal pada konsol admin mini program. Langkah ini memastikan keamanan data. Setelah menambahkan nama domain, Anda dapat membuat koneksi jaringan antara domain tersebut dengan mini program. Format nama domain adalah https://${project}.${host}. Untuk informasi lebih lanjut tentang project dan host, lihat bagian berikutnya.

Batasan

  • Jika menggunakan Web Tracking SDK untuk JavaScript, Anda hanya dapat menulis hingga 10 MB data log dalam satu waktu. Untuk informasi lebih lanjut tentang Web Tracking SDK untuk JavaScript, lihat Web Tracking SDK untuk JavaScript.

  • Fitur pelacakan web mendukung mini program berikut: WeChat mini program, WeChat mini games, Alipay mini program, ByteDance mini program, DingTalk mini program, QQ mini program, QQ mini games, dan Baidu mini program.

Langkah 1: Instal dan konfigurasikan SDK

  1. Instal Node.js.

  2. Jalankan kode berikut di server Anda untuk menginstal dependensi:

    npm install --save @aliyun-sls/web-track-mini
  3. Tambahkan kode berikut ke program Anda untuk mengonfigurasi SDK:

    Penting

    Saat mengembangkan mini program quickApp, tambahkan item konfigurasi berdasarkan modul permintaan yang digunakan sebelum membuat objek SlsTracker. Contoh berikut menunjukkan item konfigurasi ketika modul requesttask digunakan:

    // Definisikan objek quickappSDK dan enkapsulasi operasi API terkait permintaan ke dalam objek.
    const quickappSDK = {     
          request: requesttask.request
        }
    
    const tracker = new SlsTracker({
          ...opts,
          platformSDK: quickappSDK,
          platformRequestName: 'request',
        })
    import SlsTracker from '@aliyun-sls/web-track-mini'
    
    const opts = {
      host: '${host}', // Titik akhir Simple Log Service untuk wilayah tempat proyek Anda berada. Contoh: cn-hangzhou.log.aliyuncs.com.
      project: '${project}', // Nama proyek.
      logstore: '${logstore}', // Nama Logstore.
      time: 10, // Interval pengiriman log. Nilai default: 10. Unit: detik.
      count: 10, // Jumlah maksimum log yang dapat dikirim dalam setiap permintaan. Nilai default: 10.
      topic: 'topic',// Topik kustom log.
      source: 'source',
      tags: {
        tags: 'tags',
      },
    }
    
    const tracker = new SlsTracker(opts)  // Buat objek SlsTracker.

    Parameter

    Diperlukan

    Deskripsi

    host

    Ya

    Titik akhir Simple Log Service untuk wilayah tempat proyek Anda berada. Dalam contoh ini, titik akhir Simple Log Service untuk wilayah China (Hangzhou) digunakan. Ganti nilai parameter ini dengan titik akhir aktual Anda. Untuk informasi lebih lanjut, lihat Titik Akhir.

    project

    Ya

    Nama proyek.

    logstore

    Ya

    Nama Logstore.

    time

    Tidak

    Interval pengiriman log. Nilai default: 10. Unit: detik.

    count

    Tidak

    Jumlah maksimum log yang dapat dikirim dalam setiap permintaan. Nilai default: 10.

    topic

    Tidak

    Topik log. Anda dapat menentukan nilai kustom untuk mengidentifikasi log.

    source

    Tidak

    Sumber log. Anda dapat menentukan nilai kustom untuk mengidentifikasi log.

    tags

    Tidak

    Informasi tag tentang log. Anda dapat menentukan nilai kustom untuk mengidentifikasi log.

Langkah 2: Unggah log

Log tunggal diunggah sebagai objek terpisah, sedangkan beberapa log diunggah sebagai array yang berisi beberapa objek.

  • Unggah log tunggal. Tipe adalah object. Contoh:

    tracker.send({
      eventType:'view_product',
      productName: 'Tablet',
      price: 500
    })
  • Segera unggah log tunggal. Parameter time dan count tidak berlaku. Tipe adalah object. Contoh:

    tracker.sendImmediate({
      eventType:'view_product',
      productName: 'Tablet',
      price: 500
    })
  • Unggah beberapa log sekaligus. Tipe adalah array. Contoh:

    tracker.sendBatchLogs([
      {
        eventType: 'view_product',
        productName: 'Tablet',
        price: 500
      },
      {
        eventType: 'view_product',
        productName: 'Laptop',
        price: 1200
      }
    ])
  • Segera unggah beberapa log sekaligus. Parameter time dan count tidak berlaku. Tipe adalah array. Contoh:

    tracker.sendBatchLogsImmediate([
      {
        eventType:'view_product',
        productName: 'Tablet',
        price: 500
      },
      {
        eventType:'view_product',
        productName: 'Laptop',
        price: 1200
      }
    ])

Langkah 3: Lihat hasil unggahan

Anda dapat melihat hasil unggahan melalui konsol atau dengan memanggil operasi API.

Konsol

  1. Masuk ke Konsol Simple Log Service.

  2. Pada bagian Proyek, klik proyek yang diinginkan.

  3. Pada tab Log Storage > Logstores, klik logstore yang diinginkan. Kemudian klik Consumption Preview untuk melihat log.

image

Untuk analisis kueri pada log, lihat Panduan Kueri dan Analisis Log.

API

  1. Panggil operasi CreateIndex untuk membuat indeks teks penuh atau indeks bidang. Jika ingin menggunakan pernyataan SELECT, buat indeks bidang.

  2. Panggil operasi GetLogsV2 untuk menanyakan log dalam logstore. Hasil yang dikembalikan adalah array log, dengan setiap elemen dalam array merupakan log.

Referensi

  • Jika respons dari Simple Log Service berisi informasi kesalahan setelah pemanggilan API, pemanggilan gagal. Tangani kesalahan berdasarkan kode kesalahan yang diberikan. Untuk detail lebih lanjut, lihat Kode Kesalahan.

  • Simple Log Service kompatibel dengan Alibaba Cloud SDK. Untuk informasi lebih lanjut, lihat Simple Log Service_SDK Center_Alibaba Cloud OpenAPI Explorer.

  • Simple Log Service menyediakan antarmuka baris perintah (CLI) untuk konfigurasi otomatis. Untuk informasi lebih lanjut, lihat Ikhtisar CLI Simple Log Service.