Google berkomitmen untuk mendorong terwujudnya keadilan ras bagi komunitas Kulit Hitam. Lihat caranya.
Halaman ini diterjemahkan oleh Cloud Translation API.
Switch to English

Tambahkan pemantauan khusus untuk kode aplikasi tertentu

Performance Monitoring mengumpulkan jejak untuk membantu Anda memantau performa aplikasi Anda. Pelacakan adalah laporan data kinerja yang diambil di antara dua titik waktu di aplikasi Anda.

Anda dapat membuat jejak Anda sendiri untuk memantau data kinerja yang terkait dengan kode tertentu di aplikasi Anda. Dengan pelacakan kode kustom , Anda bisa mengukur berapa lama aplikasi Anda menyelesaikan tugas tertentu atau serangkaian tugas, misalnya memuat sekumpulan gambar atau membuat kueri database Anda.

Metrik default untuk pelacakan kode kustom adalah "durasi" (waktu antara titik mulai dan berhenti pelacakan), tetapi Anda juga dapat menambahkan metrik kustom .

Dalam kode Anda, Anda menentukan awal dan akhir pelacakan kode kustom menggunakan API yang disediakan oleh Performance Monitoring SDK. Pelacakan kode kustom dapat dimulai kapan saja setelah dibuat, dan ini aman untuk thread.

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

Anda dapat melihat data dari jejak ini di sub-tab Jejak kustom pada tabel jejak, yang ada di bagian bawah dasbor Performa (pelajari lebih lanjut tentang menggunakan konsol nanti di halaman ini).

Atribut default, atribut khusus, dan metrik khusus

Untuk pelacakan kode khusus, Performance Monitoring otomatis mencatat atribut default (metadata umum seperti versi aplikasi, negara, perangkat, dll.) Sehingga Anda dapat memfilter data untuk pelacakan di Firebase console. Anda juga dapat menambahkan dan memantau atribut khusus (seperti, level game atau properti pengguna).

Anda selanjutnya dapat mengonfigurasi pelacakan kode kustom untuk merekam metrik kustom untuk peristiwa terkait kinerja yang terjadi dalam cakupan pelacakan. Misalnya, Anda dapat membuat metrik khusus untuk jumlah cache ditemukan dan terlewat atau berapa kali UI menjadi tidak responsif selama jangka waktu yang terlihat.

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

Tambahkan jejak kode kustom

Gunakan Performance Monitoring Trace API ( Swift | Obj-C ) untuk menambahkan pelacakan kode kustom untuk memantau kode aplikasi tertentu.

Perhatikan hal-hal berikut:

  • Sebuah aplikasi dapat memiliki beberapa jejak kode khusus.
  • Lebih dari satu pelacakan kode khusus dapat berjalan pada waktu yang sama.
  • Nama untuk jejak kode kustom harus memenuhi persyaratan berikut: tidak boleh ada spasi di depan atau di belakangnya, tidak boleh ada karakter garis bawah ( _ ) di depan, dan panjang maksimal adalah 100 karakter.
  • Pelacakan kode kustom mendukung penambahan metrik kustom dan atribut kustom .

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

Cepat

// Add the Performance Monitoring module to your header
import FirebasePerformance

let trace = Performance.startTrace(name: "CUSTOM_TRACE_NAME")

// code that you want to trace

trace.stop()

Objective-C

// Add the Performance Monitoring module to your header
@import FirebasePerformance;

FIRTrace *trace = [FIRPerformance startTraceWithName:@"CUSTOM_TRACE_NAME"];

// code that you want to trace

[trace stop];

Tambahkan metrik kustom ke pelacakan kode kustom

Gunakan Performance Monitoring Trace API ( Swift | Obj-C ) untuk menambahkan metrik kustom ke pelacakan kode kustom.

Perhatikan hal-hal berikut:

  • Nama untuk metrik khusus harus memenuhi persyaratan berikut: tidak boleh ada spasi di depan atau di belakang, tidak boleh ada karakter garis bawah ( _ ) di depan, dan panjang maksimal adalah 100 karakter.
  • Setiap pelacakan kode kustom dapat merekam hingga 32 metrik (termasuk metrik Durasi default).

Untuk menambahkan metrik khusus, tambahkan baris kode yang mirip dengan berikut ini setiap kali peristiwa tersebut terjadi. Misalnya, metrik kustom ini menghitung peristiwa terkait performa yang terjadi di aplikasi Anda, seperti cache ditemukan atau coba lagi.

Cepat

let trace = Performance.startTrace(name: "CUSTOM_TRACE_NAME")

trace.incrementMetric(named:"EVENT_NAME", by: 1)
// code that you want to trace (and log custom metrics)

trace.stop()

Objective-C

FIRTrace *trace = [FIRPerformance startTraceWithName:@"CUSTOM_TRACE_NAME"];

[trace incrementMetric:@"EVENT_NAME" by:1];
// code that you want to trace (and log custom metrics)

[trace stop];

Buat atribut khusus untuk pelacakan kode khusus

Gunakan Performance Monitoring Trace API ( Swift | Obj-C ) untuk menambahkan atribut kustom ke pelacakan kode kustom.

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

Perhatikan hal-hal berikut:

  • Nama untuk atribut khusus harus memenuhi persyaratan berikut: tidak boleh ada spasi di depan atau di belakang, tidak boleh ada karakter garis bawah ( _ ) di depan, dan panjang maksimal 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

Cepat

let trace = Performance.startTrace(name: "CUSTOM_TRACE_NAME")

trace.setValue("A", forAttribute: "experiment")

// Update scenario.
trace.setValue("B", forAttribute: "experiment")

// Reading scenario.
let experimentValue:String? = trace.valueForAttribute("experiment")

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

// Read attributes.
let attributes:[String, String] = trace.attributes;

Objective-C

FIRTrace *trace = [FIRPerformance startTraceWithName:@"CUSTOM_TRACE_NAME"];

[trace setValue:@"A" forAttribute:@"experiment"];

// Update scenario.
[trace setValue:@"B" forAttribute:@"experiment"];

// Reading scenario.
NSString *experimentValue = [trace valueForAttribute:@"experiment"];

// Delete scenario.
[trace removeAttribute:@"experiment"];

// Read attributes.
NSDictionary <NSString *, NSString *> *attributes = [trace attributes];

Lacak, lihat, dan filter data kinerja

Lacak metrik tertentu di dasbor Anda

Untuk mempelajari tren metrik utama Anda, tambahkan metrik tersebut ke papan metrik Anda di bagian atas dasbor Performa . Anda dapat dengan cepat mengidentifikasi regresi dengan melihat perubahan dari minggu ke minggu atau memverifikasi bahwa perubahan terbaru pada kode Anda meningkatkan kinerja.

gambar papan metrik di dasbor Firebase Performance Monitoring

Untuk menambahkan metrik ke papan metrik Anda, buka dasbor Performa di konsol Firebase, lalu klik tab Dasbor . Klik kartu metrik kosong, lalu pilih metrik yang ada untuk ditambahkan ke papan Anda. Klik pada kartu metrik terisi untuk opsi lainnya, seperti mengganti atau menghapus metrik.

Papan metrik menampilkan 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, buka dasbor Performa di Firebase console, gulir ke bawah ke tabel pelacakan, lalu klik subtab yang sesuai. Tabel menampilkan beberapa metrik teratas untuk setiap jejak, dan Anda bahkan dapat mengurutkan daftar berdasarkan perubahan persentase untuk metrik tertentu.

Jika Anda mengeklik nama jejak di tabel jejak, Anda kemudian dapat mengeklik melalui berbagai layar untuk menjelajahi jejak dan menyibak metrik yang menarik. Di sebagian besar halaman, Anda dapat menggunakan tombol filter (kiri atas layar) untuk memfilter data berdasarkan atribut, misalnya:

gambar data Firebase Performance Monitoring yang difilter berdasarkan atribut
  • Filter menurut versi Aplikasi untuk melihat data tentang rilis sebelumnya atau rilis terbaru Anda
  • Filter menurut Perangkat untuk mempelajari cara perangkat lama menangani aplikasi Anda
  • Filter menurut Negara untuk memastikan lokasi database Anda tidak memengaruhi kawasan tertentu

Pelajari lebih lanjut tentang melihat data untuk jejak Anda .

Langkah selanjutnya

  • Lihat laporan mendetail tentang sesi pengguna tempat Anda dapat melihat jejak tertentu dalam konteks garis waktu dari jejak lain yang dikumpulkan selama sesi yang sama.