Application Real-Time Monitoring Service：Memantau program mini WeChat

Informasi latar belakang

Untuk informasi lebih lanjut tentang program mini WeChat, kunjungi program mini WeChat.

Metode dasar

Untuk memantau program mini WeChat, Anda perlu melakukan langkah-langkah berikut:

1. Mendapatkan dan menginisialisasi SDK pemantauan untuk program mini WeChat.

   1. Buat file wxLogger.js di folder /utils pada program mini WeChat yang ingin dipantau, lalu salin isi dari file JS ke file wxLogger.js.

   2. Buat file monitor.js di folder /utils, lalu tambahkan konten berikut ke file monitor.js untuk menginisialisasi SDK pemantauan.

      Catatan

      Anda dapat menyesuaikan nama dan jalur penyimpanan file JS sesuai kebutuhan.

      • Jika proyek diintegrasikan menggunakan metode node module (require), tambahkan konten berikut ke file monitor.js:

        const WXLogger = require('./wxLogger.js');
            const Monitor = WXLogger.init({
                pid: 'xxx',
                region: 'cn',    // Tentukan wilayah tempat aplikasi diterapkan. Nilai cn menunjukkan Tiongkok, dan nilai sg menunjukkan wilayah dekat Singapura.
            });
            export default Monitor;

      • Jika proyek diintegrasikan menggunakan metode ES module (import), tambahkan konten berikut ke file monitor.js:

        import WXLogger from './wxLogger.js';
            const Monitor = WXLogger.init({
                pid: 'xxx',
                region: 'cn',    // Tentukan wilayah tempat aplikasi diterapkan. Nilai cn menunjukkan Tiongkok, dan nilai sg menunjukkan wilayah dekat Singapura.
            });
            export default Monitor;

      Catatan

      Untuk informasi lebih lanjut tentang pengaturan parameter, lihat Parameter SDK Umum.

2. Gunakan metode berikut untuk secara otomatis mengumpulkan PV, kesalahan, API, kinerja, dan data kesehatan program mini WeChat:

   1. Di app.js, panggil metode Monitor.hookApp(options) untuk menangkap log kesalahan secara otomatis. Parameter options merupakan objek yang spesifik untuk aplikasi tersebut.

      import Monitor from '/util/monitor';
      
      App(Monitor.hookApp({
        onError(err) {
            console.log('Trigger onError:', err);
        },
        onLaunch() {
          console.log('Trigger onLaunch');
        },
      
        onShow(options) {
        },
        onHide() {
        }
      }));

   2. Di page.js, panggil metode Monitor.hookPage(options) untuk secara otomatis melaporkan API, PV, dan data kesehatan program mini WeChat.

      import Monitor from '/util/monitor';
      // Setelah Anda memanggil metode hookPage, instrumen berbasis siklus hidup API secara otomatis dimulai.
      Page(Monitor.hookPage({
         data: {},
          onLoad(query) {
          },
          onReady() {
          // Halaman dimuat.
          },
          onShow() {
      
          },
          onLoad(query) {
      
          },
          onHide() {
      
          },
          onUnload() {
      
          }     
      }));

3. Tetapkan nama domain aman.

   • Jika parameter region disetel ke cn, tambahkan https://arms-retcode.aliyuncs.com ke daftar nama domain valid permintaan.

   • Jika parameter region disetel ke sg, tambahkan https://arms-retcode-sg.aliyuncs.com ke daftar nama domain valid permintaan.

Metode dasar untuk instrumentasi otomatis

Metode untuk pengaturan lainnya

Skema lanjutan

Jika penggunaan dasar pemantauan aplikasi tidak dapat memenuhi kebutuhan Anda, coba gunakan skenario lanjutan berikut:

• Laporkan hasil permintaan API secara manual.

  1. Tetapkan parameter disableHook ke true. Log permintaan wx.request tidak dilaporkan secara otomatis.

  2. Panggil metode api() secara manual untuk melaporkan hasil permintaan API.

• Nonaktifkan pelaporan otomatis dan aktifkan pelacakan manual.

  1. Jangan gunakan metode hookApp dan hookPage di file app.js dan page.js.

  2. Untuk mengirim data PV halaman saat ini, panggil metode pageShow() di metode onShow Page.

     Catatan

     Kami sarankan Anda tidak memanggil metode pageShow() bersamaan dengan metode hookPage(). Jika tidak, log PV akan dilaporkan berulang kali.

     import Monitor from '/util/monitor';
     Page({
         onShow: function() {
             Monitor.pageShow();
         }
     })

  3. Untuk mengirim data kesehatan termasuk kesehatan dan waktu penelusuran halaman saat ini, panggil metode pageHide() di bawah metode onHide dan onUnload Page.

     Catatan

     Jangan panggil metode pageHide() bersamaan dengan metode hookPage(). Jika tidak, log akan dilaporkan berulang kali.

     import Monitor from '/util/monitor';
       Page({
     
           onHide: function() {
               Monitor.pageHide();
           },
           onUnload: function() {
               Monitor.pageHide();
           }
           ... 
       })

Parameter SDK Umum

Fitur pemantauan browser ARMS memungkinkan Anda menetapkan berbagai parameter SDK untuk memenuhi persyaratan tambahan. Tabel berikut menjelaskan parameter umum yang cocok untuk skenario yang dijelaskan dalam topik ini.

Fitur pemantauan browser ARMS juga menyediakan parameter SDK lainnya untuk memenuhi kebutuhan bisnis Anda. Untuk informasi lebih lanjut, lihat Referensi SDK.