Log

Log dan Log Insights

Aplikasi ini Log tab dibuka Insight Log secara default. Gunakan Insights untuk memprioritaskan kategori, versi, dan perangkat untuk periode 1, 3, 7, atau 30 hari. Pindah ke tab Log context":"Page/area: Capgo Builder / native cloud build product page. Role: Short UI label or navigation item. Seen in: page native-build.astro. Message key `native_build_v2_trust_logs_lbl` (Native Build V2 Trust Logs Lbl)."

subtab ketika Anda membutuhkan event perangkat dasar, filter, dan waktu timestamp yang dijelaskan di bawah ini.

The raw Logs subtab provides a detailed history of update events and diagnostic information for your application. It is useful for confirming the device-level evidence behind an Insight, troubleshooting an update path, and understanding how devices interact with Capgo. Open an app, choose Tab Log Sub yang tidak terfilter menyediakan riwayat update yang rinci dan informasi diagnostik untuk aplikasi Anda. Ini berguna untuk memastikan bukti perangkat dasar di balik Insight, troubleshooting jalur update, dan memahami bagaimana perangkat berinteraksi dengan __CAPGO_KEEP_0__. Buka aplikasi, pilihLog context":"Page/area: Capgo Builder / native cloud build product page. Role: Short UI label or navigation item. Seen in: page native-build.astro. Message key `native_build_v2_trust_logs_lbl` (Native Build V2 Trust Logs Lbl)." , kemudian pilih tab

Tab Log Asli

Antarmuka Log Asli termasuk:

1. Subtab Log — kontrol navigasi untuk baris log individu.
2. Tombol Reload — memperbarui daftar log dengan data terbaru.
3. Filter waktu dan aksi — mempersempit aliran acara berdasarkan waktu dan aksi.

Setiap baris menampilkan:

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

Klik baris untuk melompat ke halaman detail perangkat untuk sejarah lengkapnya.

Penggunaan Pemfilteran Berdasarkan Rentang Waktu

Anda dapat memfilter log dengan jangka waktu tertentu menggunakan pilih tanggal:

Pemfilteran 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 - Tentukan waktu mulai yang disesuaikan untuk rentang waktu
3. Waktu Akhir - Tentukan waktu akhir yang disesuaikan untuk rentang waktu
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 dropdown Aksi memungkinkan Anda memfilter log berdasarkan jenis event tertentu:

Aksi Filter

Filter aksi yang tersedia termasuk:

• Jantung Hati Perangkat - Periksa kesehatan periodik dari perangkat
• Penghapusan Versi Diminta - Ketika versi paket dihapus
• Kembali ke Versi Bawaan - Ketika perangkat kembali ke paket bawaan
• Pemasangan Versi Berhasil - Pemasangan paket sukses
• Versi Baru Dikirim ke Perangkat - Ketika Capgo mengirimkan pembaruan ke perangkat
• Pemasangan versi gagal - Ketika pemasangan bundle gagal

Pilihlah kotak pencarian di atas untuk mencari jenis aksi tertentu dengan cepat. 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 menunjukkan
2025-01-14 10:00:01	A1B2C3	get	2.4.1	Perangkat meminta Capgo apakah ada update tersedia
2025-01-14 10:00:03	A1B2C3	download_manifest_start	2.4.1	Manifest fetch dimulai; SDK akan mengunduh file-file
2025-01-14 10:00:07	A1B2C3	download_40	2.4.1	Unduhan Paket 40% selesai
2025-01-14 10:00:12	A1B2C3	download_zip_complete	2.4.1	Pengunduhan Zip selesai
2025-01-14 10:00:13	A1B2C3	set	2.4.1	Paket 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 mencapai batas permintaan; SDK mengundurkan diri hingga restart

Skenario Log Contoh

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

Alur Pembaruan Sukses

Ini adalah bagaimana pembaruan yang sehat terlihat dalam log Anda:

Waktu	ID Perangkat	Aksi	Versi	Artinya
10:00:01	a1b2c3d4	get	1.2.0	Perangkat dicek untuk pembaruan dan menerima informasi versi 1.2.0
10:00:02	a1b2c3d4	download_10	1.2.0	Mulai download, 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	Paket diinstal dan diaktifkan

Perangkat Sudah Terupdate

Waktu perangkat memeriksa tetapi sudah memiliki versi terbaru:

Waktu	ID Perangkat	Aksi	Versi	Artinya
14:30:00	e5f6g7h8	noNew	1.2.0	Perangkat sudah menggunakan versi terbaru, tidak perlu update

Gagal Update dengan Rollback

Waktu perangkat melakukan update gagal dan perangkat kembali ke versi sebelumnya:

Waktu	ID Perangkat	Aksi	Versi	Apa itu?
11:15:00	i9j0k1l2	get	1.3.0	Penerima update perangkat
11:15:02	i9j0k1l2	download_complete	1.3.0	Unduh selesai
11:15:03	i9j0k1l2	set	1.3.0	Paket telah ditetapkan
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

Aksi diperlukan: Periksa bahwa aplikasi Anda memanggil notifyAppReady() Setelah inisialisasi sukses. Lihat Dokumentasi plugin untuk informasi lebih lanjut.

Gagal Unduh

Ketika masalah jaringan mencegah unduh:

Waktu	ID Perangkat	Aksi	Versi	Artinya
09:45:00	m3n4o5p6	get	1.2.0	Perangkat menerima informasi update
09:45:01	m3n4o5p6	download_30	1.2.0	Mulai download tapi…
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 peluncuran aplikasi berikutnya. Tidak perlu mengambil tindakan kecuali hal ini sering terjadi.

Batasi Paket Dicapai

Ketika akun Anda mencapai batas perangkat:

Waktu	ID Perangkat	Aksi	Versi	Pengertian
16:00:00	q7r8s9t0	needPlanUpgrade	-	Perangkat ini tidak akan menerima pembaruan sampai Anda mengupgrade atau siklus pembayaran berulang.

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

Pengaturan Saluran Menghalangi Pembaruan.

Ketika pengaturan saluran mencegah pembaruan:

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

Aksi diperlukan: Ini adalah perlindungan sengaja. Jika Anda ingin memungkinkan pembaruan ini, ubah pengaturan saluran Anda Pengaturan saluran.

Kode log (Capgo enum backend)

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

Jalur bahagia & siklus hidup

Code(s)	Arti
get	Perangkat meminta Capgo untuk manifest saluran saat ini
download_manifest_start, download_manifest_complete	Manifest download dimulai / selesai (untuk delta atau bundle multi-file)
download_zip_start, download_zip_complete	Arsip zip download dimulai / selesai
download_10 … download_90	Titik-titik kemajuan download
download_0	0% marker kemajuan pertama
download_complete	Bundel seluruhnya telah didownload
set	Bundel dipersiapkan untuk peluncuran berikutnya
reset	Perangkat kembali ke bundel bawaan
delete	Bundel dihapus dari penyimpanan lokal
uninstall	Deteksi penghapusan aplikasi
app_moved_to_foreground, app_moved_to_background	Peristiwa siklus aplikasi yang direkam oleh SDK
ping	Pengecekan kesehatan/heartbeat dari perangkat
setChannel, getChannel	Saluran di atas ditetapkan atau diambil melalui panggilan SDK

Pembaruan cepat untuk pemblokiran/pengaturan kecepatan

Code	Mengapa hal ini terjadi	Apa yang harus dilakukan selanjutnya
invalidIp	Capgo mendeteksi lalu lintas yang terlihat seperti lalu lintas bot (IP Google/infrastruktur cloud).	Abaikan pada pengguna nyata; ulangi dari perangkat nyata dan jaringan normal, atau periksa setelah beberapa waktu.
needPlanUpgrade	Penggunaan organisasi telah mencapai batas rencana/perangkat.	Naikkan rencana di dashboard atau tunggu siklus tagihan berikutnya.
semver_error	Versi aplikasi native di konfigurasi hilang atau tidak valid semver (x.y.z).	Set plugins.CapacitorUpdater.version ke semver yang valid, kemudian verifikasi di tester SemVer dan bangun kembali aplikasi.
disablePlatformIos	iOS dinonaktifkan di kebijakan saluran.	Jika ini tidak sengaja, aktifkan iOS di saluran tersebut dan republish routing. Jika Anda sengaja memblokir iOS di jalur ini, jangan mengaktifkannya dan pindahkan build iOS ke saluran terpisah.
disablePlatformAndroid	Android dinonaktifkan di kebijakan saluran.	Jika ini tidak sengaja, aktifkan Android di saluran tersebut dan republish routing. Jika Anda sengaja memblokir Android di jalur ini, jangan mengaktifkannya dan pindahkan build Android ke saluran terpisah.
disableAutoUpdate	Saat ini, mode auto-update saluran menghalangi gaya update ini.	Ganti kebijakan auto-update saluran (major/minor/patch/metadata/none) untuk memungkinkan roll-out yang diinginkan Anda.
disableAutoUpdateUnderNative	Saluran diatur untuk memblokir update yang lebih tua dari garis dasar perangkat.	Push versi di atas garis dasar native, atau nonaktifkan perlindungan native di bawah garis dasar.
disableAutoUpdateMetadata	Channel memerlukan min_update_version metadata dan aplikasi lebih tua.	Atur min_update_version untuk bundle atau rilis target dari versi native yang lebih baru.
disableAutoUpdateToMajor	Channel memblokir lonjakan versi utama.	Tetapkan versi utama di strategi channel yang sama, atau izinkan lonjakan utama untuk jalur ini.
disableAutoUpdateToMinor	Channel memblokir lonjakan versi minor.	Tetapkan versi minor di strategi channel yang sama, atau izinkan lonjakan minor untuk jalur ini.
disableAutoUpdateToPatch	Channel memblokir lonjakan level patch untuk aliran ini.	Sesuaikan ritme rilis Anda, atau buka lonjakan patch di kebijakan channel untuk jalur ini.
disableEmulator	Pembaruan emulator tidak diizinkan untuk channel ini.	Jika ini adalah kecelakaan, aktifkan pembaruan emulator di saluran uji yang Anda validasi emulator. Jika sengaja, biarkan saluran ini terkunci dan gunakan saluran lain untuk membangun emulator.
disableDevBuild	Rilis dev diblokir untuk saluran ini.	Jika ini adalah kecelakaan, izinkan pembaruan dev atau pindahkan perangkat ini ke saluran dev yang diaktifkan. Jika ini sengaja, biarkan saluran ini terkunci hanya untuk rilis.
disableProdBuild	Sebuah perangkat dibangun dalam mode produksi yang disebut /updatessementara saluran Anda menghalanginya.	Jika ini adalah kecelakaan, izinkan pembaruan produksi di saluran tersebut dan republish. Jika ini sengaja, biarkan pembatasan dan kirimkan rilis produksi ke saluran/bangun yang tepat.
cannotGetBundle	Capgo tidak dapat membangun URL download yang valid untuk bundle yang dipilih.	Ulang sampaikan bundle atau regenerasi manifest dan periksa pengaturan bundle R2/public.
cannotUpdateViaPrivateChannel	Aplikasi mencoba berganti ke saluran pribadi yang tidak memungkinkan penugasan sendiri.	Buka allow_device_self_set pada saluran atau berganti ke saluran publik yang diizinkan.
channelMisconfigured	Aturan pembaruan otomatis saluran kurang data yang diperlukan (version_number tanpa min_update_version).	Isi konfigurasi yang hilang untuk aturan atau beralih ke mode auto-update yang lebih sederhana.
missingBundle	Bundle tidak memiliki muatan yang dapat diunduh (kosong) external_url/r2_path dan tidak ada manifest).	Rebuild/re-unggah versi dan pastikan bundle memiliki konten file yang nyata.
NoChannelOrOverride	Tidak ada saluran yang cocok dengan perangkat ini (tidak ada default cloud + tidak ada fallback konfigurasi + tidak ada override).	Atur default saluran di dashboard atau simpan uji coba defaultChannel di dalam pembangunan itu.
rateLimited	Terlalu banyak panggilan update/saluran dalam waktu singkat (biasanya loop-render) setChannel/getChannel).	Hentikan panggilan dalam render. Panggil hanya pada aksi pengguna. Gunakan defaultChannel dalam capacitor.config.
keyMismatch	Aplikasi dan ID kunci enkripsi bundle berbeda (device_key_id vs bundle_key_id).	Dalam konsol, bandingkan ID kunci perangkat dan bundle. Jika mereka berbeda, publikasikan dengan kunci yang sama dan versi plugin yang sesuai CLI; encoding kunci dapat berbeda antara versi.
disableDevice	Perangkat asli telah diblokir karena saluran ini diatur untuk memblokir perangkat asli.	Jika itu tidak sengaja, aktifkan pembaruan perangkat asli di saluran tersebut. Jika itu sengaja, biarkan tetap diblokir dan arahkan perangkat asli ke saluran lain.
disablePlatformElectron	Electron diblokir di saluran ini.	Jika itu tidak sengaja, aktifkan Electron di saluran ini dan republikasikan routing. Jika itu sengaja, biarkan tetap diblokir dan arahkan pengguna Electron ke saluran dedikasi.
customIdBlocked	ID perangkat khusus telah dikirim, tetapi aplikasi ini tidak menerima ID khusus.	Matikan pengiriman ID khusus atau aktifkan ID khusus hanya jika alur kerja Anda memerlukan.
blocked_by_server_url	Aplikasi ini telah server.url konfigurasi, sehingga Capacitor menyajikan URL remote daripada file lokal.	Hapus/bersihkan server.url untuk pembangunan produksi dan biarkan muatan pembaruan tetap lokal.
backend_refusal	Pengupdate tidak lagi v4yang backend tidak lagi menerima.	Perbarui plugin/CLI ke v5(prefer v8), dengan Capacitor v5+, lalu bangun kembali dan republish metadata paket.
Konfigurasi atau kebijakan pemblokiran

Code(s)	Mengapa pembaruan diblokir
disableAutoUpdate, disableAutoUpdateToMajor, disableAutoUpdateToMinor, disableAutoUpdateToPatch, disableAutoUpdateMetadata, disableAutoUpdateUnderNative	Strategi saluran melarang ini Langkah semver
disablePlatformIos, disablePlatformAndroid	Platform diaktifkan di saluran
disableDevBuild, disableEmulator	Bangun Dev atau emulator tidak diperbolehkan
disableProdBuild, disableDevice, disablePlatformElectron	Bangun produksi, perangkat nyata, atau Electron diblokir untuk saluran ini.
customIdBlocked	ID perangkat khusus tidak diterima untuk aplikasi ini.
cannotUpdateViaPrivateChannel, NoChannelOrOverride, channelMisconfigured	Pemilihan atau penggantian saluran gagal.
missingBundle, cannotGetBundle	Manifest mengacu pada paket Capgo tidak dapat disajikan.
needPlanUpgrade	Organisasi telah mencapai batas rencana/perangkat.

Kegagalan 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 diakses atau diverifikasi.
checksum_fail, checksum_required	Periksa integritas gagal atau ceksum hilang.
unzip_fail, directory_path_fail, canonical_path_fail, windows_path_fail	Kegagalan validasi sistem file atau unzip
decrypt_fail	Gagal dekripsi (arsip yang dienkripsi)
update_fail	Bundle terpasang tetapi aplikasi tidak pernah memanggilnya notifyAppReady(); rollback diaktifkan
download_zip_* tanpa langkah berikutnya set	Download selesai tetapi fase instalasi tidak pernah selesai

Event waktu eksekusi / platform

Code(s)	Arti
app_crash, app_crash_native	Event kegagalan aplikasi dari layer JavaScript atau native runtime. Metadata seringkali mencakup stack, sumber, dan informasi versi aktif.
app_anr	Android melaporkan bahwa aplikasi tidak responsif.
app_killed_low_memory, app_killed_excessive_resource_usage	Proses aplikasi dihentikan karena batasan memori atau sumber daya.
app_initialization_failure, app_memory_warning	Mulai aplikasi terganggu atau tekanan memori diamati sebelum runtime normal.
webview_javascript_error, webview_unhandled_rejection, webview_resource_error, webview_security_policy_violation, webview_unclean_restart, webview_render_process_gone, webview_content_process_terminated	Kegagalan siklus WebView dan kesalahan rendering JavaScript. Pasang Sentry di lapisan JavaScript dan native untuk menangkap jejak stack, konteks sesi perangkat, dan URL/keadaan untuk mempercepat penyelesaian masalah.
os_version_changed, native_app_version_changed	Versi OS atau aplikasi native berubah; hal ini membantu memisahkan efek peluncuran platform dari perilaku bundle web.

➡️ Butuh panduan lebih lanjut tentang code? Lihat Referensi dan Panduan Debugging Log Code yang Lengkap.

Mendapatkan Informasi Lebih Lanjut tentang Log

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

Teruskan dari Log

Jika Anda menggunakan Log to plan dashboard and API operations, connect it with API Overview untuk merencanakan dashboard dan API operasi, hubungkannya dengan __CAPGO_KEEP_0__ Ringkasan untuk detail implementasi di __CAPGO_KEEP_0__ Ringkasan, API Keys for the implementation detail in API Keys, __CAPGO_KEEP_0__ Kunci untuk detail implementasi di __CAPGO_KEEP_0__ Kunci, dan Palet untuk detail implementasi di Palet.