Catch up on everthing we announced at this year's Firebase Summit. Learn more

Tambahkan pemantauan khusus untuk kode aplikasi tertentu

Kinerja Pemantauan jejak koleksu untuk membantu Anda memantau kinerja aplikasi Anda. Jejak adalah laporan data kinerja yang diambil antara dua titik waktu di aplikasi Anda.

Anda dapat membuat pelacakan sendiri untuk memantau data kinerja yang terkait dengan kode tertentu di aplikasi Anda. Dengan jejak kode kustom, Anda dapat mengukur seberapa lama waktu yang dibutuhkan aplikasi Anda untuk menyelesaikan tugas tertentu atau serangkaian tugas, misalnya memuat serangkaian gambar atau query database Anda.

Default metric untuk jejak kode kustom adalah yang "durasi" (waktu antara titik-titik memulai dan menghentikan jejak), tetapi Anda dapat menambahkan metrik kustom, juga.

Dalam kode Anda, Anda menentukan awal dan akhir pelacakan kode khusus menggunakan API yang disediakan oleh Performance Monitoring SDK.jejak kode kustom dapat dimulai kapan saja setelah mereka telah diciptakan, dan mereka benang aman.

Karena metrik default yang dikumpulkan untuk pelacakan ini adalah "durasi", metrik tersebut terkadang disebut "Jejak durasi".

Anda dapat melihat data dari jejak ini dalam jejak Kustom subtab dari tabel jejak, yang di bagian bawah dashboard Kinerja (mempelajari lebih lanjut tentang menggunakan konsol nanti halaman ini).

Atribut default, atribut khusus, dan metrik khusus

Untuk jejak kode kustom, Kinerja Pemantauan otomatis log atribut bawaan (metadata umum seperti negara, browser, URL halaman, dll) sehingga Anda dapat menyaring data untuk jejak di konsol Firebase. Anda juga dapat menambahkan dan memantau atribut khusus (seperti, tingkat permainan atau pengguna properti).

Anda dapat lebih mengkonfigurasi kode kustom jejak untuk merekam metrik kustom untuk acara yang berhubungan dengan kinerja yang terjadi dalam lingkup jejak ini. Misalnya, Anda dapat membuat metrik khusus untuk jumlah klik dan kesalahan cache atau berapa kali UI menjadi tidak responsif selama jangka waktu tertentu.

Atribut khusus dan metrik khusus ditampilkan di Firebase console bersama atribut default dan metrik default untuk pelacakan.

Tambahkan jejak kode khusus

Gunakan Kinerja Pemantauan Jejak API untuk menambahkan jejak kode kustom untuk memantau kode aplikasi yang spesifik.

Perhatikan hal berikut:

  • Sebuah aplikasi dapat memiliki beberapa pelacakan kode kustom.
  • Lebih dari satu pelacakan kode khusus dapat berjalan secara bersamaan.
  • Nama untuk jejak kode kustom harus memenuhi persyaratan sebagai berikut: tidak ada terkemuka atau trailing spasi, tidak ada garis bawah terkemuka ( _ ) karakter, dan max panjang 100 karakter.
  • Jejak kode kustom mendukung menambahkan metrik kustom dan atribut khusus .

Untuk memulai dan menghentikan pelacakan kode kustom, bungkus kode yang ingin Anda lacak dengan baris kode yang mirip dengan berikut ini:

Versi web 9

import { trace } from "firebase/performance";

const t = trace(perf, "CUSTOM_TRACE_NAME");
t.start();

// Code that you want to trace 
// ...

t.stop();

Versi web 8

const trace = perf.trace("CUSTOM_TRACE_NAME");
trace.start();

// Code that you want to trace 
// ...

trace.stop();

Tambahkan jejak kode khusus menggunakan User Timing API

Selain Kinerja Pemantauan Jejak API, Anda dapat menambahkan jejak kode kustom menggunakan browser native Waktu Pengguna API . Durasi pelacakan yang diukur menggunakan API ini secara otomatis diambil oleh Performance Monitoring SDK. Menggunakan User Timing API sangat membantu jika Anda lebih suka memuat Performance Monitoring SDK secara asinkron. Setelah SDK diinisialisasi, SDK akan merekam pengukuran yang terjadi sebelum pemuatannya.

Untuk menggunakan fitur ini, bungkus kode yang ingin Anda lacak dengan tanda Waktu Pengguna:

Versi web 9

const performance = window.performance;

performance.mark("measurementStart");

// Code that you want to trace 
// ...

performance.mark("measurementStop");
performance.measure("customTraceName", "measurementStart", "measurementStop");

Versi web 8

const performance = window.performance;

performance.mark("measurementStart");

// Code that you want to trace 
// ...

performance.mark("measurementStop");
performance.measure("customTraceName", "measurementStart", "measurementStop");

Perhatikan bahwa performance dalam contoh di atas mengacu pada browser window.performance objek.

Saat menggunakan User Timing API, metrik dan atribut khusus tidak dapat ditambahkan ke pelacakan kode khusus. Gunakan Kinerja Pemantauan Jejak API jika Anda ingin menambahkan elemen-elemen kustom untuk jejak kode kustom.

Tambahkan metrik khusus ke jejak kode khusus

Gunakan Kinerja Pemantauan Jejak API untuk menambahkan metrik kustom untuk jejak kode kustom.

Perhatikan hal berikut:

  • Nama untuk metrik khusus harus memenuhi persyaratan sebagai berikut: tidak ada terkemuka atau trailing spasi, tidak ada garis bawah terkemuka ( _ ) karakter, dan max panjang 100 karakter.
  • Setiap jejak kode kustom dapat merekam hingga 32 metrik (termasuk default Duration metrik).

Untuk menambahkan metrik khusus, tambahkan baris kode yang mirip dengan berikut ini setiap kali peristiwa terjadi. Misalnya, metrik khusus ini menghitung peristiwa terkait kinerja yang terjadi di aplikasi Anda.

Versi web 9

import { trace } from "firebase/performance";

async function getInventory(inventoryIds) {
  const t = trace(perf, "inventoryRetrieval");

  // Tracks the number of IDs fetched (the metric could help you to optimize in the future)
  t.incrementMetric("numberOfIds", inventoryIds.length);

  // Measures the time it takes to request inventory based on the amount of inventory
  t.start();
  const inventoryData = await retrieveInventory(inventoryIds);
  t.stop();

  return inventoryData;
}

Versi web 8

async function getInventory(inventoryIds) {
  const trace = perf.trace("inventoryRetrieval");

  // Tracks the number of IDs fetched (the metric could help you to optimize in the future)
  trace.incrementMetric("numberOfIds", inventoryIds.length);

  // Measures the time it takes to request inventory based on the amount of inventory
  trace.start();
  const inventoryData = await retrieveInventory(inventoryIds);
  trace.stop();

  return inventoryData;
}

Buat atribut khusus untuk jejak kode khusus

Gunakan Kinerja Pemantauan Jejak API untuk menambahkan atribut khusus untuk jejak kode kustom.

Untuk menggunakan atribut khusus, tambahkan kode ke aplikasi Anda yang mendefinisikan atribut dan kaitkan dengan pelacakan kode khusus tertentu. Anda dapat menyetel atribut khusus kapan saja antara saat pelacakan dimulai dan saat pelacakan berhenti.

Perhatikan hal berikut:

  • Nama untuk atribut khusus harus memenuhi persyaratan sebagai berikut: tidak ada terkemuka atau trailing spasi, tidak ada garis bawah terkemuka ( _ ) karakter, dan max panjang adalah 32 karakter.

  • Setiap pelacakan kode khusus dapat merekam hingga 5 atribut khusus.

  • Anda tidak boleh menggunakan atribut khusus yang berisi informasi yang mengidentifikasi individu secara pribadi ke Google.

    Pelajari lebih lanjut tentang pedoman ini

Versi web 9

import { trace } from "firebase/performance";

const t = trace(perf, "test_trace");
t.putAttribute("experiment", "A");

// Update scenario
t.putAttribute("experiment", "B");

// Reading scenario
const experimentValue = t.getAttribute("experiment");

// Delete scenario
t.removeAttribute("experiment");

// Read attributes
const traceAttributes = t.getAttributes();

Versi web 8

const trace = perf.trace("test_trace");
trace.putAttribute("experiment", "A");

// Update scenario
trace.putAttribute("experiment", "B");

// Reading scenario
const experimentValue = trace.getAttribute("experiment");

// Delete scenario
trace.removeAttribute("experiment");

// Read attributes
const traceAttributes = trace.getAttributes();

Lacak, lihat, dan filter data kinerja

Untuk melihat data kinerja waktu nyata, pastikan aplikasi Anda menggunakan versi SDK Pemantauan Kinerja yang kompatibel dengan pemrosesan data waktu nyata. Pelajari lebih lanjut .

Lacak metrik tertentu di dasbor Anda

Untuk mempelajari cara metrik kunci Anda tren, menambahkannya ke papan metrik Anda di bagian atas dashboard Kinerja. Anda dapat dengan cepat mengidentifikasi regresi dengan melihat perubahan dari minggu ke minggu atau memverifikasi bahwa perubahan terbaru dalam kode Anda meningkatkan kinerja.

gambar papan metrik di dasbor Firebase Performance Monitoring

Untuk menambahkan metrik ke papan metrik Anda, pergi ke dashboard Kinerja di Firebase konsol, kemudian klik tab Dashboard. Klik kartu metrik kosong, lalu pilih metrik yang ada untuk ditambahkan ke papan Anda. Klik pada metrik kartu penduduknya untuk lebih banyak pilihan, seperti untuk mengganti atau menghapus metrik.

Papan metrik menunjukkan data metrik yang dikumpulkan dari waktu ke waktu, baik dalam bentuk grafik maupun sebagai perubahan persentase numerik.

Pelajari lebih lanjut tentang menggunakan dasbor .

Lihat jejak dan datanya

Untuk melihat jejak Anda, pergi ke dashboard Kinerja di Firebase konsol, gulir ke bawah ke meja jejak, lalu klik subtab yang sesuai. Tabel menampilkan beberapa metrik teratas untuk setiap jejak, dan Anda bahkan dapat mengurutkan daftar menurut persentase perubahan untuk metrik tertentu.

Jika Anda mengklik nama jejak di tabel jejak, Anda kemudian dapat mengeklik berbagai layar untuk menjelajahi jejak dan menelusuri metrik yang diminati. Pada halaman yang paling, Anda dapat menggunakan Filter tombol (kiri atas layar) untuk menyaring data dengan atribut, misalnya:

gambar data Firebase Performance Monitoring yang difilter menurut atribut
  • Filter oleh Halaman URL untuk melihat data untuk halaman tertentu dari situs Anda
  • Filter oleh jenis koneksi yang efektif untuk belajar bagaimana koneksi 3g dampak aplikasi Anda
  • Filter oleh Negara untuk memastikan lokasi database Anda tidak mempengaruhi wilayah tertentu

Pelajari lebih lanjut tentang melihat data untuk jejak Anda .

Langkah selanjutnya