Protokolle

Verständnis von Anwendungsprotokollen

Die Protokollseite bietet eine detaillierte Historie von Aktualisierungsereignissen und diagnostischen Informationen zu Ihrer Anwendung. Dies ist entscheidend für die Überwachung des Aktualisierungsprozesses, die Behebung von Problemen und das Verständnis, wie Ihre Geräte mit Capgo interagieren. Sie können es über auf Ihre App klicken und dann auf die Schaltfläche “Protokolle” (früher “Aktualisierungen” in älteren Screenshots oder Dokumentationen) klicken.

Von dort sollten Sie eine Seite sehen, die ähnlich aussieht und eine Liste von Protokollereignissen anzeigt:

Übersichtsseite der Protokolldaten

Die Oberfläche der Protokolldaten umfasst:

1. Protokolldaten-Tab - Der Navigations-Tab zum Zugriff auf die Protokolldaten-Ansicht
2. Neuladen-Button - Aktualisiert die Liste der Protokolldaten mit den neuesten Daten
3. Zeitraum- & Aktionen-Filter - Filtern Sie die Protokolldaten nach Datum und Aktionstyp (siehe Abschnitte unten)

Jede Zeile zeigt:

• Timestamp (UTC)
• Geräte-ID
• Aktion code (was ist passiert)
• Versionname (Bündel oder builtin)

Klicken Sie auf eine Zeile, um zur Gerätedetailseite zu springen, um die vollständige Historie zu sehen.

Nach Datum filtern

Datumsauswahl-Assistent für die Protokollfilterung

Schnelle Vorlagen

1. - Wählen Sie gängige Zeitabschnitte aus: Letzte 1h, 3h, 6h oder 12h Nach Datum filtern
2. Startzeit - Wählen Sie eine benutzerdefinierte Startzeit für das Intervall
3. Endzeit - Wählen Sie eine benutzerdefinierte Endzeit für das Intervall
4. Kalender - Wählen Sie bestimmte Daten im Kalenderansicht aus

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

Filtern nach Aktionstyp

Der Aktionen-Dropdown ermöglicht das Filtern von Protokollen nach bestimmten Ereignistypen:

Aktionen-Filter

Verfügbare Aktionenfilter umfassen:

• Geräteherzschlag - Periodische Gesundheitschecks von Geräten
• Versionenlöschung angefordert - Wenn eine Bundle-Version gelöscht wird
• Zurücksetzen auf Standardversion - Wenn ein Gerät auf die eingebettete Bundle zurückkehrt
• Version erfolgreich installiert - Erfolgreiche Bundle-Installation
• Neue Version an Gerät gesendet - Wenn Capgo eine Aktualisierung an ein Gerät sendet
• Version-Installation fehlgeschlagen - Wenn die Bundle-Installation 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.

Beispiel-Protokollsnippet (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-Abgleich wurde gestartet; SDK lädt gerade Dateien herunter
2025-01-14 10:00:07	A1B2C3	download_40	2.4.1	Die Bundle-Download-Progression beträgt 40 %
2025-01-14 10:00:12	A1B2C3	download_zip_complete	2.4.1	Zip ist fertig heruntergeladen
2025-01-14 10:00:13	A1B2C3	set	2.4.1	Bundle wurde installiert und als nächstes zu laufen markiert
2025-01-14 10:05:00	B9C8D7	disableAutoUpdateToMajor	1.9.0	Der Kanalrichtlinie wurde eine Sprung auf 2.x verwehrt
2025-01-14 10:05:05	B9C8D7	rateLimited	builtin	Das Gerät hat die Anforderungsgrenze erreicht; SDK wartet bis zum Neustart

Beispiel Log-Szenarien

Um Ihnen zu helfen, zu verstehen, was die Protokolle Ihnen sagen, sind hier Beispiele für Sequenzen, die reale Geräte-Update-Reisen darstellen:

Erfolgreicher Update-Flow

Dies ist, was ein gesunder Update-Flow in Ihren Protokollen aussieht:

Zeit	Geräte-ID	Aktion	Version	Was bedeutet es
10:00:01	a1b2c3d4	get	1.2.0	Gerät wurde auf Updates überprüft und erhielt Version 1.2.0 Info
10:00:02	a1b2c3d4	download_10	1.2.0	Herunterladen gestartet, 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, keine Aktualisierung erforderlich

Fehlschlag bei der Aktualisierung mit Rollover

Wenn eine Aktualisierung 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 stürzte ab oder wurde nicht aufgerufen - Rollback ausgelöst notifyAppReady() integriert
11:15:11	i9j0k1l2	reset	Gerät wurde auf die integrierte Version zurückgesetzt	Aktion erforderlich

: Überprüfen Sie, dass Ihre App nach erfolgreicher Initialisierung aufgerufen wird. Siehe Capacitor notifyAppReady() Capgo die Plugin-Dokumentation Weitere Informationen finden Sie hier.

Herunterladen fehlgeschlagen

Wenn Netzwerkprobleme das Herunterladen verhindern:

Zeit	Geräte-ID	Aktion	Version	Was bedeutet das?
09:45:00	m3n4o5p6	get	1.2.0	Gerät hat Update-Info erhalten
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 abgebrochen usw.)

Maßnahmen erforderlich: Die App wird sich automatisch bei der nächsten App-Startversuche wieder anzumelden. Keine Maßnahmen erforderlich, es sei denn, dies tritt häufig auf.

Plan-Grenze erreicht

Wenn Ihr Konto seine Geräte-Grenze erreicht:

Zeit	Geräte-ID	Aktion	Version	Was bedeutet es
16:00:00	q7r8s9t0	needPlanUpgrade	-	Dieses Gerät erhält keine Updates, bis Sie ein Upgrade durchführen oder der Abrechnungszyklus neu gestartet wird

Aktion erforderlich: Aktualisieren Sie Ihr Abonnement oder warten Sie auf den nächsten Rechnungszeitraum.

Kanal-Konfiguration blockiert Updates

Wenn Kanal-Einstellungen eine Aktualisierung verhindern:

Zeit	Geräte-ID	Aktion	Version	Was bedeutet das
12:00:00	u1v2w3x4	disableAutoUpdateToMajor	2.0.0	Ein Gerät auf v1.x kann nicht automatisch auf v2.x aktualisiert werden (große Versionsnummer blockiert)
12:05:00	y5z6a7b8	disableEmulator	1.2.0	Emulator erkannt, und Kanal blockt Emulatoren
12:10:00	c9d0e1f2	disableDevBuild	1.2.0	Entwicklerbau erkannt, und Kanal blockt Entwicklerbauten

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

Logcodes (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.

Glücklicher Pfad & 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 mehrdateibundle)
download_zip_start, download_zip_complete	Zip-Archiv-Download begann / beendet
download_10 … download_90	Download-Progress-Meilensteine
download_complete	Gesamtpaket heruntergeladen
set	Paket für den nächsten Start vorbereitet
reset	Gerät wurde auf das eingebaute Paket zurückgesetzt
delete	Paket aus lokaler Speicherung entfernt
uninstall	App-Entfernung erkannt
app_moved_to_foreground, app_moved_to_background	App-Lebenszyklusereignisse wurden von SDK aufgezeichnet
ping	Gesundheits-/Herzschlag-Überprüfung vom Gerät
setChannel, getChannel	Kanal überschrieben oder über SDK aufgerufen

Konfiguration oder Richtlinienblöcke

Code(s)	Warum die Aktualisierung blockiert wurde
disableAutoUpdate, disableAutoUpdateToMajor, disableAutoUpdateToMinor, disableAutoUpdateToPatch, disableAutoUpdateMetadata, disableAutoUpdateUnderNative	Kanalstrategie verbietet diesen semver-Sprung
disablePlatformIos, disablePlatformAndroid	Die Plattform ist auf dem Kanal deaktiviert
disableDevBuild, disableEmulator	Entwickler-Builds oder Emulatoren sind nicht erlaubt
cannotUpdateViaPrivateChannel, NoChannelOrOverride, channelMisconfigured	Fehler bei der Kanalwahl oder -überschreibung
missingBundle, cannotGetBundle	Das Manifest bezieht sich auf eine Bundle Capgo kann nicht bereitstellen
needPlanUpgrade	Das Unternehmen hat seine Pläne/Gerätebegrenzung erreicht
rateLimited	Zu viele Anfragen; SDK drosselt bis zum Neustart
blocked_by_server_url, backend_refusal, InvalidIp	Ein Serverseitiger Richtlinienblock hat die Anfrage blockiert

Herunterladen / Integrität / Installationsfehler

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

➡️ Bedürfen Sie umfassenderer Anleitung für code? Vollständige Code-Referenz und Fehlersuche-Leitfaden.

Mehr Details über einen Eintrag im Protokoll

Wenn Sie auf einen bestimmten Eintrag im Protokoll klicken, wird es Ihnen normalerweise zur Seite des Geräts führen. Dies ermöglicht es Ihnen, die vollständige Historie für dieses Gerät zu sehen, was sehr hilfreich sein kann, um Gerätespezifische Probleme zu diagnostizieren oder dessen Update-Reise zu verstehen.Weitergehen von Protokollen

Abschnitt mit dem Titel „Weitergehen von Protokollen“

If you are using Logs to plan dashboard and API operations, connect it with API Übersicht für die Implementierungsdetails in API Übersicht Einführung für die Implementierungsdetails in Einführung API Schlüssel für die Implementierungsdetails in API Schlüssel Geräte für die Implementierungsdetails in Geräte, und Pakete für die Implementierungsdetails in Pakete.