Log

Log dan Log Insights

Applikasi Log buka tab Insight Log Dengan default. Gunakan Insights untuk memprioritaskan kategori, versi, dan perangkat untuk jangka waktu 1, 3, 7, atau 30 hari. Pindah ke Log Untuk subtab ketika Anda memerlukan informasi tentang peristiwa perangkat dasar, filter, dan waktu yang dijelaskan di bawah ini.

Judul Bagian “Pengertian Log Aplikasi”

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 Loglalu pilihlah Log Tab Log Asli

Antarmuka Log Asli termasuk:

Antarmuka Log Raw Log termasuk:

1. Catatan Log Kontrol navigasi untuk baris log individu.
2. Muat Ulang Meng-refresh daftar log dengan data terbaru.
3. Jangkauan waktu dan filter aksi Mengurangi aliran acara dengan waktu dan aksi.

Masing-masing baris menampilkan:

• Waktu (UTC) ID Perangkat
• ID Perangkat
• Action code Apa yang terjadi
• (bundle atau) (bundle atau) builtin)

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

Bagian berjudul “Penggunaan Rentang Waktu”

Kamu dapat menyaring log berdasarkan periode waktu tertentu menggunakan pilihan tanggal:

Pilih Rentang Tanggal

1. Preset Cepat - Select common time ranges: Last 1h, 3h, 6h, or 12h
2. Waktu Mulai - Tentukan waktu mulai yang kustom untuk rentang
3. Waktu Akhir - Tentukan waktu akhir yang kustom untuk rentang
4. Kalender - Pilih tanggal tertentu menggunakan tampilan kalender

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

Penggunaan Filter oleh Tipe Aksi

Aksi dropdown memungkinkan Anda memfilter log berdasarkan jenis event tertentu:

Filter Aksi

Filter aksi yang tersedia termasuk:

• Tanda jantung perangkat - Pemeriksaan kesehatan periodik dari perangkat
• Penghapusan versi diminta - Ketika versi paket dihapus
• Pulihkan ke versi default - Ketika perangkat kembali ke paket bawaan
• Versi terpasang dengan sukses - Instalasi bundle sukses
• Versi baru dikirim ke perangkat - Ketika Capgo mengirimkan pembaruan ke perangkat
• Instalasi versi gagal - Ketika instalasi bundle gagal

Pilih kotak pencarian di atas untuk mencari tindakan spesifik dengan cepat. Anda dapat memilih beberapa tindakan untuk menampilkan log yang sesuai dengan salah satu jenis yang dipilih.

Contoh snippet log (data palsu)

Waktu (UTC)	ID Perangkat	Tindakan	Versi	Apa yang mengatakannya
2025-01-14 10:00:01	A1B2C3	get	2.4.1	Peralatan meminta Capgo apakah ada pembaruan tersedia
2025-01-14 10:00:03	A1B2C3	download_manifest_start	2.4.1	Pembaruan delta dimulai; SDK akan mengunduh file delta yang berubah
2025-01-14 10:00:07	A1B2C3	download_40	2.4.1	Pembaruan bundle 40% selesai
2025-01-14 10:00:12	A1B2C3	download_zip_complete	2.4.1	Zip selesai mengunduh
2025-01-14 10:00:13	A1B2C3	set	2.4.1	Paket diinstal 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	Peralatan mencapai batas permintaan; SDK mundur hingga restart

Skenario Log Contoh

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

Alur Update Sukses

Ini adalah apa yang terlihat seperti update sehat dalam log Anda:

Waktu	ID Perangkat	Aksi	Versi	Apa artinya
10:00:01	a1b2c3d4	get	1.2.0	Perangkat memeriksa update 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	Unduh selesai berhasil
10:00:06	a1b2c3d4	set	1.2.0	Bundle terpasang dan diaktifkan

Perangkat Sudah Terupdate

Ketika perangkat memeriksa tetapi sudah memiliki versi terbaru:

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

Update Gagal dengan Rollback

Ketika pembaruan gagal dan perangkat melakukan rollback:

Waktu	ID Perangkat	Aksi	Versi	Apa Artinya
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 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

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

Gagal Download

Ketika masalah jaringan mencegah unduhan:

Waktu	ID Perangkat	Aksi	Versi	What it means
09:45:00	m3n4o5p6	get	1.2.0	Penerima perangkat mendapatkan 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.

Batasi Paket Tercapai

Ketika akun Anda mencapai batas perangkat:

Waktu	ID Perangkat	Aksi	Versi	Apa artinya
16:00:00	q7r8s9t0	needPlanUpgrade	-	Perangkat ini tidak akan menerima pembaruan hingga 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	Apa 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 yang diperlukan: Ini adalah perlindungan yang 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.ts). Jika Anda melihat kode 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 mendapatkan bundle yang terkait dengan saluran
download_manifest_start, download_manifest_complete	Mulai / selesai download delta (untuk bundle yang diunggah dengan file delta)
download_zip_start, download_zip_complete	Mulai / selesai download arsip zip
download_10 … download_90	Poin kemajuan download
download_0	Poin kemajuan 0% untuk event kemajuan pertama
download_complete	Bundle yang telah diunduh secara keseluruhan
set	Rangkaian siap untuk peluncuran berikutnya
reset	Perangkat kembali ke rangkaian bawaan
delete	Rangkaian dihapus dari penyimpanan lokal
uninstall	Deteksi penghapusan aplikasi
app_moved_to_foreground, app_moved_to_background	Event siklus aplikasi direkam oleh SDK
ping	Pengecekan kesehatan/heartbeat dari perangkat
setChannel, getChannel	Saluran diatur ulang atau diambil melalui SDK panggilan

Perbaikan cepat untuk kebijakan/penghalang baru

Code	Mengapa hal ini terjadi	Apa yang harus dilakukan selanjutnya
invalidIp	Capgo mendeteksi lalu lintas yang tampak seperti lalu lintas bot (IP Google/infrastruktur cloud).	Biarkan saja pada pengguna asli; ulangi dari perangkat asli dan jaringan normal, atau periksa setelah beberapa waktu.
needPlanUpgrade	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 valid semver, kemudian verifikasi di SemVer tester rebuild aplikasi.
disablePlatformIos	dan bangun ulang aplikasi.	If this was accidental, enable iOS in that channel and republish routing. If you intentionally block iOS in this track, keep it off and move iOS builds to a separate channel.
disablePlatformAndroid	Android diaktifkan kembali di channel policy.	Jika ini adalah kecelakaan, aktifkan Android di saluran tersebut dan republish routing. Jika Anda sengaja memblokir Android di jalur ini, biarkan tetap mati dan pindahkan bangun Android ke saluran terpisah.
disableAutoUpdate	Mode auto-update saluran menghalangi gaya update ini.	Ubah kebijakan auto-update saluran (utama/kecil/patch/metadata/tidak ada) untuk memungkinkan peluncuran yang diinginkan.
disableAutoUpdateUnderNative	Saluran telah ditetapkan untuk memblokir update yang lebih tua dari garis dasar perangkat.	Tetapkan versi di atas atau di atas garis dasar native, atau nonaktifkan perlindungan di bawah native.
disableAutoUpdateMetadata	Saluran 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	Saluran menghalangi lonjakan versi utama.	Tetapkan versi utama di dalam strategi saluran yang sama, atau izinkan lonjakan utama untuk jalur ini.
disableAutoUpdateToMinor	Saluran menghalangi lonjakan versi kecil.	Jaga versi minor di strategi saluran yang sama, atau izinkan lonjakan minor untuk trek ini.
disableAutoUpdateToPatch	Saluran ini menghalangi lonjakan tingkat patch untuk aliran ini.	Sinkronkan ritme rilis Anda, atau buka lonjakan patch di kebijakan saluran untuk trek ini.
disableEmulator	Pembaruan emulator tidak diizinkan untuk saluran ini.	Jika ini adalah kecelakaan, aktifkan pembaruan emulator di saluran uji di mana Anda memvalidasi emulator. Jika sengaja, jaga saluran ini terkunci dan gunakan saluran lain untuk pembangunan emulator.
disableDevBuild	Pembangunan dev diblokir untuk saluran ini.	Jika ini adalah kecelakaan, izinkan pembaruan dev atau pindahkan perangkat ke saluran dev yang diaktifkan. Jika ini sengaja, jaga saluran ini terkunci hanya untuk pembangunan rilis.
disableProdBuild	Sebuah pembangunan perangkat di mode produksi disebut /updates, sementara saluran Anda menghalanginya.	Jika ini adalah kecelakaan, izinkan pembaruan produksi di saluran itu dan republish. Jika ini sengaja, jaga pembatasan dan kirimkan pembangunan produksi ke saluran/bangun yang tepat.
cannotGetBundle	Capgo tidak dapat membangun URL download yang valid untuk bundle yang dipilih.	Ulang sampaikan bundle (dengan --delta Jika Anda ingin file delta, dan periksa pengaturan bundle R2/public.
cannotUpdateViaPrivateChannel	Applikasi mencoba berganti ke saluran pribadi yang tidak memungkinkan pengasasan diri sendiri.	Mengaktifkan allow_device_self_set di saluran atau berganti ke saluran publik/terijinkan.
channelMisconfigured	Aturan auto-update saluran kekurangan data yang diperlukan (version_number Tidak ada min_update_version).	Isi konfigurasi yang hilang untuk aturan tersebut atau berganti ke mode auto-update yang lebih sederhana.
missingBundle	Bundle tidak memiliki muatan yang dapat diunduh (kurangnya external_url/r2_path dan tidak ada file delta).	Rebuild/re-upload versi dan pastikan bundle memiliki konten file yang nyata.
NoChannelOrOverride	No channel matched this device (no cloud default + no config fallback + no override).	Set default saluran di dashboard atau simpan sebagai tes defaultChannel di dalam pembangunan itu.
rateLimited	Terlalu banyak panggilan pembaruan/kanal dalam waktu singkat (seringnya loop-render) setChannel/getChannel).	Hentikan panggilan dalam render. Panggil hanya pada aksi pengguna. Gunakan defaultChannel di capacitor.config.
keyMismatch	Aplikasi dan ID kunci pengemasan berbeda (device_key_id vs bundle_key_id).	In the console, compare device and bundle key IDs. If they differ, publish with the same key and matching CLI/plugin version; key encoding can differ between versions.
disableDevice	Telepon/tablet nyata diblokir karena saluran ini disetel untuk memblokir perangkat nyata.	Jika tidak sengaja, aktifkan pembaruan perangkat nyata di saluran itu. Jika sengaja, biarkan tetap diblokir dan arahkan perangkat nyata ke saluran lain.
disablePlatformElectron	Electron diblokir di saluran ini.	Jika ini tidak sengaja, aktifkan Electron di saluran ini dan republikasikan routing. Jika sengaja, biarkan tetap diblokir dan arahkan pengguna Electron ke saluran dedikasi.
customIdBlocked	ID perangkat khusus dikirimkan, tetapi aplikasi ini tidak menerima ID khusus.	Matikan pengiriman ID kustom atau aktifkan ID kustom hanya jika alur kerja Anda memerlukannya.
blocked_by_server_url	Aplikasi Anda telah server.url dikonfigurasi, sehingga Capacitor menyediakan URL remote daripada file lokal.	Hapus/tangguhkan server.url untuk pembangunan produksi dan simpan muatan pembaruan lokal.
backend_refusal	Pembarui adalah v4, yang tidak lagi diterima oleh backend.	Perbarui plugin/CLI ke v5 (prefer v8), dengan Capacitor v5+, kemudian direkonstruksi dan republish metadata paket.
Konfigurasi atau kebijakan menghalangi

Code(s)	Mengapa pembaruan diblokir
disableAutoUpdate, disableAutoUpdateToMajor, disableAutoUpdateToMinor, disableAutoUpdateToPatch, disableAutoUpdateMetadata, disableAutoUpdateUnderNative	Strategi saluran melarang ini Langkah semver
disablePlatformIos, disablePlatformAndroid	Saluran platform dinonaktifkan
disableDevBuild, disableEmulator	Bangunan dev atau emulator tidak diizinkan
disableProdBuild, disableDevice, disablePlatformElectron	Pembangunan produksi, perangkat nyata, atau Electron diblokir untuk saluran ini.
customIdBlocked	ID perangkat khusus tidak diterima untuk aplikasi ini.
cannotUpdateViaPrivateChannel, NoChannelOrOverride, channelMisconfigured	Gagal memilih atau mengganti saluran
missingBundle, cannotGetBundle	Saluran mengarah ke bundle Capgo yang tidak dapat disajikan
needPlanUpgrade	Organisasi telah mencapai batas rencana/perangkat

Gagal download / integritas / instalasi

Code(s)	Arti
download_fail	Pembundelan gagal (kesalahan jaringan atau tanggapan)
download_manifest_file_fail, download_manifest_checksum_fail, download_manifest_brotli_fail	Tidak dapat memperoleh atau memvalidasi file delta
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 unzip gagal
decrypt_fail	Pembukaan gagal (bundel terkunci)
update_fail	Bundel terpasang tetapi aplikasi tidak pernah memanggil notifyAppReady()Dengan perintah rollback
download_zip_* Tidak ada 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 dari lapisan runtime JavaScript atau native. Metadata sering kali mencakup informasi stack, sumber, dan versi aktif.
app_anr	Android melaporkan bahwa aplikasi tidak responsif.
app_killed_low_memory, app_killed_excessive_resource_usage	Aplikasi proses berhenti 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	Error lifecycle WebView dan rendering JavaScript. Pasang Sentry di kedua lapisan JavaScript dan native untuk menangkap jejak stack, konteks sesi/ perangkat, dan URL/keadaan untuk mempercepat perbaikan.
os_version_changed, native_app_version_changed	Versi OS atau aplikasi native berubah; hal ini membantu memisahkan efek rollout platform dari perilaku bundle web.

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

Mendapatkan Informasi Lebih Lanjut tentang Log

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

Teruskan dari Log

Jika Anda menggunakan Logs Untuk merencanakan dashboard dan operasi API, hubungkannya dengan API Overview untuk merencanakan dashboard dan operasi API, hubungkannya dengan Introduction untuk detail implementasi di Pengenalan, API Kunci untuk detail implementasi di API Kunci, Peralatan untuk detail implementasi di Devices, dan Bundles Untuk detail implementasi di Paket.