Log Catatan

Mengerti Log Aplikasi

Halaman Log menyediakan riwayat detail peristiwa pembaruan dan informasi diagnostik untuk aplikasi Anda. Ini sangat penting untuk memantau proses pembaruan, mengatasi masalah, dan memahami bagaimana perangkat Anda berinteraksi dengan Capgo. Anda dapat mengaksesnya dengan mengklik aplikasi Anda dan kemudian mengklik tab “Log” (sebelumnya bernama “pembaruan” dalam beberapa screenshot atau dokumentasi yang lebih tua).

Dari sana Anda harus melihat halaman yang mirip dengan ini, menampilkan daftar entri log:

Ringkasan Halaman Log

Antarmuka halaman log mencakup:

1. Tab Log - Tab navigasi untuk mengakses tampilan log
2. Tombol Reload - Muat ulang daftar log dengan data terbaru
3. Rentang Waktu & Pemfilteran Aksi - Filter log berdasarkan rentang tanggal dan jenis aksi (lihat bagian di bawah)

Setiap baris menampilkan:

• Tanggal Waktu (UTC)
• ID Perangkat
• Aksi code (apa yang terjadi)
• Nama Versi (bundle atau builtin)

Klik baris untuk melompat ke halaman detail perangkat untuk riwayat lengkap.

Menggunakan Rentang Waktu untuk Pencarian

Anda dapat memfilter log menggunakan periode waktu tertentu menggunakan pilihan tanggal:

Filter Rentang Waktu

1. Preset Cepat - Pilih rentang waktu umum: 1 jam terakhir, 3 jam terakhir, 6 jam terakhir, atau 12 jam terakhir
2. Waktu Mulai - Atur waktu mulai khusus untuk rentang
3. - Atur waktu akhir khusus untuk rentang - Atur waktu akhir khusus untuk rentang
4. Kalender - Pilih tanggal spesifik menggunakan tampilan kalender

Klik “Pilih” untuk menerapkan rentang tanggal yang dipilih, atau “Batal” untuk menutup picker.

Penggunaan Jenis Aksi

Menu Aksi memungkinkan Anda memfilter log berdasarkan jenis event tertentu:

Filter Aksi

Termasuk filter aksi yang tersedia:

• Detak Jantung Perangkat - Periksa kesehatan periodik dari perangkat
• Permintaan penghapusan versi - Ketika versi bundle dihapus
• Reset ke versi default - Ketika perangkat kembali ke bundle bawaan
• Versi terpasang dengan sukses - Pemasangan bundle sukses
• Versi baru dikirim ke perangkat - Ketika Capgo mengirimkan pembaruan ke perangkat
• Pemasangan versi gagal - Ketika pemasangan bundle gagal

Gunakan kotak pencarian di atas untuk mencari cepat jenis aksi tertentu. Anda dapat memilih beberapa aksi untuk menampilkan log yang sesuai dengan salah satu jenis yang dipilih.

Contoh snippet log (data palsu)

Waktu (UTC)	ID Perangkat	Aksi	Versi	Apa yang mengatakan padamu
2025-01-14 10:00:01	A1B2C3	get	2.4.1	Perangkat bertanya Capgo apakah ada pembaruan tersedia
2025-01-14 10:00:03	A1B2C3	download_manifest_start	2.4.1	Manifest fetch dimulai; SDK akan mengunduh file
2025-01-14 10:00:07	A1B2C3	download_40	2.4.1	Pengunduhan bundle 40% selesai
2025-01-14 10:00:12	A1B2C3	download_zip_complete	2.4.1	Zip telah selesai mengunduh
2025-01-14 10:00:13	A1B2C3	set	2.4.1	Bundle terpasang dan ditandai sebagai berikutnya untuk dijalankan
2025-01-14 10:05:00	B9C8D7	disableAutoUpdateToMajor	1.9.0	Kebijakan saluran menghalangi jump ke 2.x
2025-01-14 10:05:05	B9C8D7	rateLimited	bawaan	Perangkat telah mencapai batas permintaan; SDK menunggu sampai restart

Skenario Log Contoh

Untuk membantu Anda memahami apa yang dikatakan log, berikut adalah urutan contoh yang menunjukkan perjalanan update perangkat nyata:

Alur Update Sukses

Inilah apa yang terlihat seperti update yang sehat dalam log Anda:

Waktu	ID Perangkat	Aksi	Versi	Artinya
10:00:01	a1b2c3d4	get	1.2.0	Perangkat dicek untuk update dan menerima informasi versi 1.2.0
10:00:02	a1b2c3d4	download_10	1.2.0	Download dimulai, 10% selesai
10:00:03	a1b2c3d4	download_50	1.2.0	Download pada 50%
10:00:05	a1b2c3d4	download_complete	1.2.0	Download selesai dengan sukses
10:00:06	a1b2c3d4	set	1.2.0	Bundle diinstal dan diaktifkan

Perangkat Sudah Terupdate

Ketika perangkat melakukan pengecekan tetapi sudah memiliki versi terbaru:

Waktu	ID Perangkat	Aksi	Versi	Apa itu
14:30:00	e5f6g7h8	noNew	1.2.0	Perangkat sudah menggunakan versi terbaru, tidak perlu diperbarui

Pembaruan Gagal dengan Rollback

Ketika pembaruan gagal dan perangkat kembali ke versi sebelumnya:

Waktu	ID Perangkat	Aksi	Versi	Apa itu
11:15:00	i9j0k1l2	get	1.3.0	Perangkat menerima informasi pembaruan
11:15:02	i9j0k1l2	download_complete	1.3.0	Download selesai
11:15:03	i9j0k1l2	set	1.3.0	Paket telah diatur
11:15:10	i9j0k1l2	update_fail	1.3.0	Aplikasi bermasalah atau notifyAppReady() tidak dipanggil - rollback diaktifkan
11:15:11	i9j0k1l2	reset	bawaan	Perangkat kembali ke versi bawaan

Tindakan diperlukan: Pastikan aplikasi Anda memanggil notifyAppReady() setelah inisialisasi sukses. Lihat dokumentasi plugin untuk detail lebih lanjut.

Gagal Download

Ketika masalah jaringan mencegah unduhan:

Waktu	ID Perangkat	Aksi	Versi	Apa itu?
09:45:00	m3n4o5p6	get	1.2.0	Perangkat menerima informasi pembaruan
09:45:01	m3n4o5p6	download_30	1.2.0	Mulai download tetapi…
09:45:15	m3n4o5p6	download_fail	1.2.0	Gagal download (timeout jaringan, koneksi hilang, dll.)

Aksi diperlukan: Perangkat akan mencoba ulang secara otomatis pada aplikasi berikutnya. Tidak ada aksi yang diperlukan kecuali hal ini sering terjadi.

Batasan Paket Tercapai

Ketika akun Anda mencapai batas perangkat:

Waktu	ID Perangkat	Aksi	Versi	Apa itu
16:00:00	q7r8s9t0	needPlanUpgrade	-	Perangkat ini tidak akan menerima update hingga Anda mengupgrade atau siklus pembayaran berulang

Aksi yang diperlukan: Upgrade rencana Anda atau tunggu siklus pembayaran berikutnya.

Konfigurasi Saluran Menghalangi Update

Ketika pengaturan saluran mencegah pembaruan:

Waktu	ID Perangkat	Aksi	Versi	Apa itu
12:00:00	u1v2w3x4	disableAutoUpdateToMajor	2.0.0	Perangkat pada v1.x tidak dapat memperbarui secara otomatis ke v2.x (langkah versi utama diblokir)
12:05:00	y5z6a7b8	disableEmulator	1.2.0	Deteksi emulator, dan saluran memblokir emulator
12:10:00	c9d0e1f2	disableDevBuild	1.2.0	Deteksi build dev, dan saluran memblokir build dev

Aksi yang DiperlukanPembaruan ini sengaja diblokir. Jika Anda ingin memungkinkan pembaruan ini, ubah pengaturan saluran Anda pengaturan saluran.

Kode Log (Capgo backend enum)

Kode-kode ini berasal dari stats_action enum yang digunakan oleh dashboard API (capgo/src/types/supabase.types.ts). Jika Anda melihat kode code baru di UI, maka kode tersebut dikeluarkan oleh SDK atau backend dan diverifikasi terhadap daftar ini.

Jalur Bahagia & Lifecycle

Code(s)	Arti
get	Perangkat meminta Capgo untuk manifest saluran saat ini
download_manifest_start, download_manifest_complete	Pengunduhan Manifest dimulai / selesai (untuk delta atau bundle berkas multi)
download_zip_start, download_zip_complete	Pengunduhan arsip zip dimulai / selesai
download_10 … download_90	Milestones kemajuan download
download_complete	Seluruh bundle diunduh
set	Bundle disiapkan untuk peluncuran berikutnya
reset	Perangkat dikembalikan ke bundle bawaan
delete	Bundle dihapus dari penyimpanan lokal
uninstall	Deteksi penghapusan aplikasi
app_moved_to_foreground, app_moved_to_background	SDK merekam event kehidupan aplikasi
ping	Pengecekan kesehatan/heartbeat dari perangkat
setChannel, getChannel	Saluran diubah atau diambil melalui SDK

Konfigurasi atau kebijakan menghalangi

Code(s)	Mengapa pembaruan diblokir
disableAutoUpdate, disableAutoUpdateToMajor, disableAutoUpdateToMinor, disableAutoUpdateToPatch, disableAutoUpdateMetadata, disableAutoUpdateUnderNative	Strategi saluran melarang lonjakan semver ini
disablePlatformIos, disablePlatformAndroid	Platform diaktifkan di saluran
disableDevBuild, disableEmulator	Beban pengembang atau emulator tidak diizinkan
cannotUpdateViaPrivateChannel, NoChannelOrOverride, channelMisconfigured	Gagal memilih atau mengganti saluran
missingBundle, cannotGetBundle	Manifest mengacu pada paket Capgo tidak dapat menyajikan
needPlanUpgrade	Organisasi telah mencapai batas rencana/perangkat
rateLimited	Terlalu banyak permintaan; SDK menghambat sampai restart
blocked_by_server_url, backend_refusal, InvalidIp	Aturan sisi server menghalangi permintaan

Gagal download / integritas / instalasi

Code(s)	Arti
download_fail	Gagal download paket (error jaringan atau respons)
download_manifest_file_fail, download_manifest_checksum_fail, download_manifest_brotli_fail	File Manifest tidak dapat diambil atau diverifikasi
checksum_fail, checksum_required	Pengecekan Integritas gagal atau ceksum hilang
unzip_fail, directory_path_fail, canonical_path_fail, windows_path_fail	Pengecekan Sistem File atau unzipping gagal
decrypt_fail	Penguncian gagal (arsip terenkripsi)
update_fail	Arsip terpasang tetapi aplikasi tidak pernah dipanggil notifyAppReady(); rollback diaktifkan
download_zip_* dengan tidak ada yang berikutnya set	Download selesai tetapi fase instalasi tidak pernah selesai

➡️ Butuh panduan lebih dalam per-code? Lihat Referensi dan Panduan Debugging Log Code Lengkap.

Mendapatkan Detail Lebih Lanjut Tentang Log

Jika Anda mengklik entri log tertentu, biasanya akan membawa Anda ke halaman perangkat __CAPGO_KEEP_0__Halaman ini memungkinkan Anda untuk melihat riwayat lengkap untuk perangkat tersebut, yang dapat sangat membantu dalam mendiagnosis masalah perangkat khusus atau memahami perjalanan pembaruan perangkat.