Protokolle

Protokolle und Log-Insights

Die App Protokolle Öffnet die Registerkarte Log-Insights standardmäßig. Verwenden Sie Insights, um Kategorien, Versionen und Geräte für einen Zeitraum von 1, 3, 7 oder 30 Tagen zu priorisieren. Wechseln Sie zur Logs Registerkarte, wenn Sie die zugrunde liegenden Geräteevents, Filter und Zeitstempel wie unten beschrieben benötigen.

Verstehen Sie Anwendungsprotokolle

Die Logs-Registerkarte bietet eine detaillierte Historie von Update-Ereignissen und diagnostischen Informationen für Ihre Anwendung. Sie ist nützlich zum Bestätigen der Geräteevidenz hinter einem Insight, zum Troubleshooting eines Updatepfads und zum Verständnis, wie Geräte mit Capgo interagieren. Öffnen Sie eine App, wählen Sie Logs, wählen Sie dann die Logs Registerkarte.

Roh-Protokollansicht

Die Roh-Protokollansicht umfasst:

1. Protokoll-Unterseite — die Navigationssteuerung für einzelne Protokollzeilen.
2. Neuladen-Button — aktualisiert die Protokollliste mit den neuesten Daten.
3. Zeitfenster- und Aktion-Filter — verengt den Ereignisstrom nach Zeit und Aktion.

Jede Zeile zeigt:

• Timestamp (UTC)
• Geräte-ID
• Aktion code (was passiert ist)
• Version-Name (Bundle oder builtin)

Klicken Sie auf eine Zeile, um zur Gerätedetailseite für ihre vollständige Historie zu springen.

Filtern nach Datumsbereich

Sie können die Protokolle nach einem bestimmten Zeitraum filtern, indem Sie das Datumswahlwerkzeug verwenden:

Filter nach Datumsbereich

1. Quick-Presets - Wählen Sie eine gängige Zeitperiode: Die letzten 1h, 3h, 6h oder 12h
2. Startzeit - Legen Sie eine benutzerdefinierte Startzeit für die Zeitperiode fest
3. Endzeit - Legen Sie eine benutzerdefinierte Endzeit für die Zeitperiode fest
4. Kalender - Wählen Sie bestimmte Daten mithilfe der Kalenderansicht aus

Klicken Sie auf „Auswählen“, um Ihre gewählte Zeitperiode anzuwenden, oder auf „Abbrechen“, um den Picker abzubrechen

Filtern nach Aktionstyp

Mit dem Aktionen-Menü können Sie die Protokolle nach bestimmten Ereignistypen filtern:

Aktionen Filtern

Zu den verfügbaren Aktionen gehören:

• Geräteherzschlag - Periodische Gesundheitsprüfungen von Geräten
• Version wird gelöscht - Wenn eine Bundle-Version gelöscht wird
• Zurücksetzen auf Standardversion - Wenn ein Gerät auf die eingebaute Bundle zurückkehrt
• Version wurde erfolgreich installiert - Erfolgreiche Bundle-Installation
• Neue Version wird an Gerät gesendet - Wenn Capgo eine Aktualisierung an ein Gerät sendet
• Versioninstallation fehlgeschlagen - Wenn die Bundleinstallation fehlschlägt

Verwenden Sie das Suchfeld oben, um bestimmte Aktionstypen schnell zu finden. Sie können mehrere Aktionen auswählen, um Protokolle anzuzeigen, die beliebige der ausgewählten Typen entsprechen.

Beispielprotokollsnippet (fiktive Daten)

Zeit (UTC)	Geräte-ID	Aktion	Version	Was es Ihnen sagt
2025-01-14 10:00:01	A1B2C3	get	2.4.1	Das Gerät hat Capgo gefragt, ob ein Update verfügbar ist
2025-01-14 10:00:03	A1B2C3	download_manifest_start	2.4.1	Der Manifest- Abruf wurde gestartet; SDK wird Dateien herunterladen
2025-01-14 10:00:07	A1B2C3	download_40	2.4.1	Der Bundle-Download ist 40% abgeschlossen
2025-01-14 10:00:12	A1B2C3	download_zip_complete	2.4.1	Das Zip-Datei ist heruntergeladen
2025-01-14 10:00:13	A1B2C3	set	2.4.1	Das Bundle wurde installiert und als nächstes zu laufen markiert
2025-01-14 10:05:00	B9C8D7	disableAutoUpdateToMajor	1.9.0	Der Channel-Policy hat einen Sprung auf 2.x blockiert
2025-01-14 10:05:05	B9C8D7	rateLimited	builtin	Das Gerät hat die Anfragebegrenzung erreicht; SDK wartet bis zum Neustart

Beispielhafte Log-Szenarien

Um Ihnen zu helfen, was die Logs Ihnen sagen, sind hier einige Beispielabläufe, die reale Geräte-Update-Reisen zeigen:

Erfolgreicher Update-Flow

Dies ist, was ein gesunder Update-Ablauf in Ihren Logs aussieht:

Zeit	Geräte-ID	Aktion	Version	Was bedeutet es
10:00:01	a1b2c3d4	get	1.2.0	Das Gerät wurde auf Updates überprüft und erhielt die Version 1.2.0 info
10:00:02	a1b2c3d4	download_10	1.2.0	Herunterladen begonnen, 10% abgeschlossen
10:00:03	a1b2c3d4	download_50	1.2.0	Herunterladen bei 50%
10:00:05	a1b2c3d4	download_complete	1.2.0	Herunterladen erfolgreich abgeschlossen
10:00:06	a1b2c3d4	set	1.2.0	Bundle installiert und aktiviert

Gerät ist bereits auf dem neuesten Stand

Wenn ein Gerät überprüft, aber bereits die neueste Version hat:

Zeit	Geräte-ID	Aktion	Version	Was bedeutet es
14:30:00	e5f6g7h8	noNew	1.2.0	Das Gerät ist bereits auf der neuesten Version, kein Update erforderlich

Fehlgeschlagener Update mit Rollback

Wenn ein Update fehlschlägt und das Gerät zurückrollt:

Zeit	Geräte-ID	Aktion	Version	Was bedeutet das?
11:15:00	i9j0k1l2	get	1.3.0	Gerät erhielt Update-Info
11:15:02	i9j0k1l2	download_complete	1.3.0	Herunterladen abgeschlossen
11:15:03	i9j0k1l2	set	1.3.0	Bundle wurde gesetzt
11:15:10	i9j0k1l2	update_fail	1.3.0	App ist abgestürzt oder notifyAppReady() wurde nicht aufgerufen - Rollback ausgelöst
11:15:11	i9j0k1l2	reset	eingebaut	Gerät wurde auf die eingebaute Version zurückgesetzt

Aktion erforderlich: Überprüfen Sie, ob Ihre App die Funktion aufruft notifyAppReady() nach erfolgreicher Initialisierung. Siehe die Plugin-Dokumentation für Details.

Herunterladefehler

Wenn Netzwerkprobleme die Herunterladung verhindern:

Zeit	Geräte-ID	Aktion	Version	Was bedeutet
09:45:00	m3n4o5p6	get	1.2.0	Gerät erhielt Update-Info
09:45:01	m3n4o5p6	download_30	1.2.0	Herunterladen gestartet, aber…
09:45:15	m3n4o5p6	download_fail	1.2.0	Herunterladen fehlgeschlagen (Netzwerkzeitüberschreitung, Verbindung verloren, usw.)

Aktion erforderlich: Die App wird sich automatisch auf dem nächsten Startversuch wiederholen. Eine Aktion ist nur erforderlich, wenn dies häufig auftritt.

Plan-Grenze erreicht

Wenn Ihr Konto seine Gerätebegrenzung erreicht hat:

Zeit	Geräte-ID	Aktion	Version	Was bedeutet es
16:00:00	q7r8s9t0	needPlanUpgrade	-	Dieses Gerät erhält keine Updates, bis Sie das Abonnement auf den nächsten Tarif upgraden oder der Abrechnungszyklus neu startet.

Handlungsbedarf: Upgrade Ihres Tarifs oder warten Sie auf den nächsten Abrechnungszyklus.

Kanal-Konfiguration blockiert Updates

Wenn die Kanal-Einstellungen eine Aktualisierung verhindern:

Zeit	Geräte-ID	Aktion	Version	Was bedeutet das?
12:00:00	u1v2w3x4	disableAutoUpdateToMajor	2.0.0	Ausgerüstetes Gerät auf v1.x kann nicht automatisch auf v2.x (große Versionsnummer blockiert) aktualisieren
12:05:00	y5z6a7b8	disableEmulator	1.2.0	Emulator erkannt, und der Kanal blockiert Emulatoren
12:10:00	c9d0e1f2	disableDevBuild	1.2.0	Entwicklerbaukasten erkannt, und der Kanal blockiert Entwicklerbausteine

Aktion erforderlich: Diese sind absichtliche Schutzmaßnahmen. Wenn Sie diese Aktualisierungen zulassen möchten, ändern Sie Ihre Kanal-Einstellungen.

Protokollcodes (Capgo Backend-Enum)

Diese Codes stammen aus der stats_action Enum, die vom Dashboard API (capgo/src/types/supabase.types.ts) verwendet wird. Wenn Sie ein neues code im UI sehen, wurde es vom SDK oder Backend ausgestoßen und gegen diese Liste validiert.

Happy Path & Lebenszyklus

Code(s)	Bedeutung
get	Das Gerät hat Capgo nach dem aktuellen Kanalmanifest gefragt
download_manifest_start, download_manifest_complete	Manifest-Download begann / beendet (für Delta- oder mehrdateibündel)
download_zip_start, download_zip_complete	Zip-Archiv-Download begann / beendet
download_10 … download_90	Herunterladeprogressmeilensteine
download_0	0% Fortschrittsmarker für das erste Fortschrittsereignis
download_complete	Gesamtbundle heruntergeladen
set	Bundle für den nächsten Start vorbereitet
reset	Gerät wurde auf das eingebaute Bundle zurückgesetzt
delete	Bundle aus lokalem Speicher entfernt
uninstall	Anwendung wurde entfernt
app_moved_to_foreground, app_moved_to_background	App lifecycle events recorded by SDK
ping	Gesundheits-/Herzschlagprüfung vom Gerät
setChannel, getChannel	Kanal überschrieben oder über SDK abgerufen

Neue Richtlinienblockierung / Drosselung-Schnellfix

Code	Warum das passiert	Was tun Sie als Nächstes
invalidIp	Capgo detected traffic that looks like bot traffic (Google/cloud infrastructure IP).	Ignorieren Sie bei echten Benutzern; Wiederholen Sie es von echten Geräten und normalen Netzwerken oder überprüfen Sie nach einiger Zeit.
needPlanUpgrade	Die Organisation hat das Plan-/Geräte-Limit erreicht.	Upgrade Sie das Plan in der Dashboard oder warten Sie auf den nächsten Abrechnungszyklus.
semver_error	Native App-Version in der Konfiguration fehlt oder ist nicht gültig (x.y.z).	Setze plugins.CapacitorUpdater.version auf gültig, überprüfe es dann im SemVer-Tester und baue das App neu auf.
disablePlatformIos	iOS ist in der Kanalpolitik deaktiviert.	Wenn dies versehentlich passiert ist, aktiviere iOS in diesem Kanal und veröffentliche die Routing-Datei neu. Wenn du iOS absichtlich in diesem Track blockieren möchtest, lass es ab und verschiebe iOS-Builds in einen separaten Kanal.
disablePlatformAndroid	Android ist in der Kanalpolitik deaktiviert.	Wenn dies versehentlich passiert ist, aktiviere Android in diesem Kanal und veröffentliche die Routing-Datei neu. Wenn du Android absichtlich in diesem Track blockieren möchtest, lass es ab und verschiebe Android-Builds in einen separaten Kanal.
disableAutoUpdate	Der Kanal-Update-Modus blockiert diese Update-Style.	Ändere die Kanal-Update-Politik (major/minor/patch/metadata/none), um deine geplante Veröffentlichung zuzulassen.
disableAutoUpdateUnderNative	Der Kanal ist auf Updates älter als die Gerätebasis gestellt.	Pushen Sie eine Version auf oder über der native Baseline, oder deaktivieren Sie die unter-native Schutzfunktion.
disableAutoUpdateMetadata	Der Kanal erfordert min_update_version Metadaten und das App ist älter.	Einstellen min_update_version Für das Zielbundle oder die Veröffentlichung aus einer neueren native Version.
disableAutoUpdateToMajor	Der Kanal blockiert große Versionssprünge.	Halten Sie die großen Versionen in derselben Kanalstrategie, oder erlauben Sie große Sprünge für diesen Track.
disableAutoUpdateToMinor	Der Kanal blockiert kleine Versionssprünge.	Halten Sie die kleinen Versionen in derselben Kanalstrategie, oder erlauben Sie kleine Sprünge für diesen Track.
disableAutoUpdateToPatch	Der Kanal blockiert Versionssprünge auf Patch-Ebene für diesen Flow.	Passen Sie Ihren Release-Takt an, oder öffnen Sie Versionssprünge auf Patch-Ebene in der Kanalpolitik für diesen Track.
disableEmulator	Emulator-Updates sind für diesen Kanal nicht erlaubt.	Wenn dies versehentlich geschah, aktivieren Sie die Emulator-Updates in einem Testkanal, in dem Sie Emulatoren validieren. Wenn dies absichtlich geschah, lassen Sie dieses Kanal-Emulator-Blockieren und verwenden Sie einen anderen Kanal für Emulator-Builds.
disableDevBuild	Dev-Builds sind für diesen Kanal blockiert.	Wenn dies versehentlich geschah, erlauben Sie Entwickler-Updates oder verschieben Sie dieses Gerät auf einen Entwickler-fähigen Kanal. Wenn dies absichtlich geschah, lassen Sie diesen Kanal nur auf Release-Builds zugreifen.
disableProdBuild	Ein Gerätebuild in Produktionsmodus namens /updates, während Ihr Kanal es blockierte.	Wenn dies versehentlich geschah, erlauben Sie Produktions-Updates in diesem Kanal und veröffentlichen Sie erneut. Wenn dies absichtlich geschah, lassen Sie die Einschränkung bestehen und senden Sie Produktionsbuilds an den richtigen Kanal/Build.
cannotGetBundle	Capgo konnte keine gültige Herunterladungs-URL für den ausgewählten Bundle erstellen.	Laden Sie den Bundle erneut hoch oder regenerieren Sie Manifeste und überprüfen Sie R2/public Bundle-Einstellungen.
cannotUpdateViaPrivateChannel	Die App versuchte, sich selbst auf einen privaten Kanal umzuschalten, der Selbstzuweisung nicht zulässt.	Aktivieren Sie allow_device_self_set auf dem Kanal oder wechseln Sie auf einen öffentlichen/erlaubten Kanal.
channelMisconfigured	Die Kanal-Automatisierung-Regel fehlt erforderliche Daten (version_number ohne min_update_version).	Füllen Sie die fehlende Konfiguration für diese Regel oder wechseln Sie zu einer einfachen automatischen Aktualisierungsmodus.
missingBundle	Bundle hat keine herunterladbare Payload (fehlende external_url/r2_path und keine Manifestdatei).	Rekonstruieren/Speichern Sie die Version und überprüfen Sie, ob das Bundle echte Dateien enthält.
NoChannelOrOverride	Kein Kanal passt sich diesem Gerät (kein Cloud-Standard + keine Konfigurationsrückfall + keine Überschreibung).	Setzen Sie einen Kanalstandard in der Dashboard oder behalten Sie einen Test defaultChannel in dieser Version.
rateLimited	Zu viele Aktualisierungs-/Kanalaufrufe in kurzer Zeit (oft Rendern-Loop setChannel/getChannel).	Stoppen Sie den Aufruf in Rendern. Rufen Sie nur bei Benutzeraktion auf. Verwenden Sie defaultChannel in capacitor.config.
keyMismatch	Die App- und Bundle-Verschlüsselungsschlüssel IDs unterscheiden sich (device_key_id vs bundle_key_id).	In der Konsole vergleichen Sie die Geräte- und Bundle-Schlüssel-IDs. Wenn sie sich unterscheiden, veröffentlichen Sie mit demselben Schlüssel und passender CLI/Plugin-Version; die Schlüsselcodierung kann zwischen den Versionen unterschiedlich sein.
disableDevice	Eine echte Telefon/Tablet-App wurde blockiert, weil dieser Kanal auf echte Geräte blockiert ist.	Wenn dies versehentlich passiert ist, aktivieren Sie die realgeräte-Updates in diesem Kanal. Wenn dies absichtlich passiert ist, lassen Sie es blockiert und leiten Sie echte Geräte in einen anderen Kanal um.
disablePlatformElectron	Elektron ist in diesem Kanal blockiert.	Wenn dies versehentlich passiert ist, aktivieren Sie Elektron in diesem Kanal und veröffentlichen Sie die Routen neu. Wenn dies absichtlich passiert ist, lassen Sie es blockiert und leiten Sie Elektron-User in einen dedizierten Kanal um.
customIdBlocked	Eine benutzerdefinierte Geräte-ID wurde gesendet, aber diese App akzeptiert keine benutzerdefinierten IDs.	Schalten Sie die Sendung von benutzerdefinierten IDs aus oder aktivieren Sie sie nur, wenn Ihr Workflow dies erfordert.
blocked_by_server_url	Die App hat server.url konfiguriert, also dient Capacitor stattdessen remote URL anstatt lokaler Dateien.	Entfernen/Löschen server.url für Produktionsbuilds und lassen Sie die Update-Payloads lokal.
backend_refusal	Der Updater ist v4, der von der Backend-Instanz nicht mehr akzeptiert wird.	Aktualisiere das Plugin/CLI auf v5zum Beispiel (empfohlen) v8), mit Capacitor v5+, dann neu erstellen und das Bundle-Metadaten neu veröffentlichen.
Konfiguration oder Richtlinienblöcke

Code(s)	Warum wurde die Aktualisierung blockiert?
disableAutoUpdate, disableAutoUpdateToMajor, disableAutoUpdateToMinor, disableAutoUpdateToPatch, disableAutoUpdateMetadata, disableAutoUpdateUnderNative	Der Kanalstrategie verbietet dies semver-Sprung
disablePlatformIos, disablePlatformAndroid	Die Plattform ist auf dem Kanal deaktiviert
disableDevBuild, disableEmulator	Entwicklerversionen oder Emulatoren sind nicht erlaubt
disableProdBuild, disableDevice, disablePlatformElectron	Produktionsversionen, reale Geräte oder Electron sind für diesen Kanal blockiert.
customIdBlocked	Benutzerdefinierte Geräte-IDs werden für diese App nicht akzeptiert.
cannotUpdateViaPrivateChannel, NoChannelOrOverride, channelMisconfigured	Fehler bei der Auswahl oder Überschreibung des Kanals
missingBundle, cannotGetBundle	Das Manifest bezieht sich auf ein Paket Capgo kann nicht bereitstellen
needPlanUpgrade	Die Organisation hat die Grenzen für das Plan/Geräte-Set erreicht

Herunterladen / Integrität / Installationsfehler

Code(s)	Bedeutung
download_fail	Paket herunterladen fehlgeschlagen (Netzwerk- oder Antwortfehler)
download_manifest_file_fail, download_manifest_checksum_fail, download_manifest_brotli_fail	Das Manifest-Datei konnte nicht abgerufen oder validiert werden
checksum_fail, checksum_required	Integritätsprüfung fehlgeschlagen oder fehlende Prüfsumme
unzip_fail, directory_path_fail, canonical_path_fail, windows_path_fail	Dateisystem- oder Entpackungsvalidierung fehlgeschlagen
decrypt_fail	Verschlüsselung fehlgeschlagen (verschlüsselter Bundle)
update_fail	Bundle wurde installiert, aber App wurde nie aufgerufen notifyAppReady() ; Rollback ausgelöst
download_zip_* ohne weitere set	Herunterladen abgeschlossen, aber Installationsphase wurde nie abgeschlossen

Laufzeit- / Plattformereignisse

Code(s)	Bedeutung
app_crash, app_crash_native	Crash-Ereignisse aus JavaScript- oder nativen Laufzeitbereichen. Metadata enthält oft Stapel, Quelle und aktuelle Versionen.
app_anr	Android meldete ein Anwendungsprogramm, das nicht reagiert.
app_killed_low_memory, app_killed_excessive_resource_usage	Anwendungsbereich beendet aufgrund von Speicher- oder Ressourcenlimits.
app_initialization_failure, app_memory_warning	Der Start wurde unterbrochen oder vor der normalen Laufzeit wurde Druck auf den Speicher beobachtet.
webview_javascript_error, webview_unhandled_rejection, webview_resource_error, webview_security_policy_violation, webview_unclean_restart, webview_render_process_gone, webview_content_process_terminated	WebView-Lebenszyklus und JS-/Renderingfehler. Installieren Sie Sentry in beiden JS- und native-Layer, um Stapelüberwachung, Sitzung/ Gerätekontext und URL/Zustand für schnellere Fehlerbehebungen zu erfassen.
os_version_changed, native_app_version_changed	Betriebssystem- oder native-Anwendungsversion geändert; dies hilft, Plattform-level-Rollout-Effekte von Web-Bundle-Verhalten zu trennen.

➡️ Bedürfen Sie tieferer Anweisungen für code? Sehen Sie sich an: Vollständige Log Code-Referenz und Fehlersuche-Leitfaden.

Mehr Details über einen Log einholen

Wenn Sie auf eine bestimmte Log-Eintrag klicken, wird es Ihnen normalerweise zur Geräteseiteführen. Dies ermöglicht es Ihnen, die vollständige Historie für dieses Gerät anzuzeigen, was sehr hilfreich sein kann, um Gerätespezifische Probleme zu diagnostizieren oder dessen Update-Reise zu verstehen.

Fortsetzen bei Logs

Wenn Sie Logs verwenden Logs um die Planung der API-Dashboard und die API-Operationen zu verbinden, wenden Sie sich an API-Übersicht zur Implementierungsdetail in der API-Übersicht Einführung zur Implementierungsdetail in der Einführung API-Schlüssel zur Implementierungsdetail in den API-Schlüsseln Geräte zur Implementierungsdetail in den Geräten Pakete für die Implementierungsdetails in Paketen.