Protokolle

Verständnis von Anwendungsprotokollen

Die Protokollseite bietet eine detaillierte Geschichte von Aktualisierungsereignissen und diagnostischen Informationen für Ihre 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 indem Sie auf Ihr App klicken und dann indem Sie auf die Schaltfläche “Protokolle” (früher “aktualisierungen” in einigen älteren Screenshots oder Dokumentationen) klicken.

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

Übersicht der Protokollseite

Die Oberfläche der Protokollseite umfasst:

1. Protokoll-Taste - Die Navigations-Taste, um den Protokoll-Ansicht zu erreichen
2. Neuladen-Schaltfläche - Die Log-Liste aktualisieren, um die neuesten Daten zu erhalten
3. Zeitraum & Aktionen-Filter - Die Logeinträge nach Datum und Aktionstyp filtern (siehe Abschnitte unten)

Jeder Eintrag zeigt an:

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

Klicken Sie auf einen Eintrag, um zur Gerätedetailseite für die vollständige Historie zu springen.

Zeiträume filtern

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

Zeitraumfilter

1. Schnelle Vorlagen - Wählen Sie gängige Zeitbereiche: Letzte 1h, 3h, 6h oder 12h
2. Startzeit - Legen Sie eine benutzerdefinierte Startzeit für den Bereich fest
3. Endzeit - Legen Sie eine benutzerdefinierte Endzeit für den Bereich fest
4. Kalender - Wählen Sie bestimmte Daten im Kalenderansicht

Klicken Sie auf „Auswählen“, um Ihren gewählten Zeitraum anzuwenden, oder auf „Abbrechen“, um den Picker abzulehnen.

Filtern nach Aktionstyp

Die Aktionen-Abwählelemente ermöglichen das Filtern von Protokollen nach bestimmten Ereignistypen:

Aktionen-Filter

Zu den verfügbaren Aktionen-Filtern gehören:

• Geräteherzschlag - Periodische Gesundheitsprüfungen von Geräten
• Versionenlöschung angefordert - Wenn eine Bundle-Version gelöscht wird
• Zurück auf Standardversion setzen - Wenn ein Gerät auf die eingebaute 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

Benutzen Sie das Suchfeld oben, um spezifische 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 fragte Capgo nach, ob ein Update verfügbar ist
2025-01-14 10:00:03	A1B2C3	download_manifest_start	2.4.1	Manifest-Abfrage wurde gestartet; SDK lädt Dateien herunter
2025-01-14 10:00:07	A1B2C3	download_40	2.4.1	Bundle-Download ist 40% abgeschlossen
2025-01-14 10:00:12	A1B2C3	download_zip_complete	2.4.1	Zip wurde 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	Kanalrichtlinie blockierte einen Sprung auf 2.x
2025-01-14 10:05:05	B9C8D7	rateLimited	integriert	Das Gerät erreichte die Anforderungsgrenze; SDK wartet bis zum Neustart

Beispiel Log Szenarien

Um Ihnen zu helfen, was die Protokolle Ihnen sagen, sind hier Beispiele für Sequenzen, die reale Geräteaktualisierungen darstellen:

Erfolgreicher Aktualisierungsprozess

Das ist, was ein gesunder Aktualisierungsprozess in Ihren Protokollen aussieht:

Zeit	Geräte-ID	Aktion	Version	Was es bedeutet
10:00:01	a1b2c3d4	get	1.2.0	Das Gerät wurde auf Aktualisierungen überprüft und erhielt die Version 1.2.0 als 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 das
14:30:00	e5f6g7h8	noNew	1.2.0	Gerät ist bereits auf der neuesten Version, kein Update erforderlich

Update fehlgeschlagen mit Rollover

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

Zeit	Geräte-ID	Aktion	Version	Was bedeutet es
11:15:00	i9j0k1l2	get	1.3.0	Gerät hat Update-Info erhalten
11:15:02	i9j0k1l2	download_complete	1.3.0	Download 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 wurde nicht aufgerufen - Rolloback ausgelöst notifyAppReady() wurde nicht aufgerufen - Rolloback 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 nach erfolgreicher Initialisierung die notifyAppReady() siehe die Plugin-Dokumentation für Details. Herunterladen fehlgeschlagen

Abschnitt mit dem Titel “Herunterladen fehlgeschlagen”

App ist abgestürzt oder wurde nicht aufgerufen - Rolloback ausgelöst

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

Aktion erforderlich: Das Gerät wird automatisch auf der nächsten App-Start wiederholt. Keine Aktion erforderlich, es sei denn, dies passiert häufig.

Plan-Grenze erreicht

Wenn Ihr Konto seine Gerätebegrenzung erreicht:

Zeit	Geräte-ID	Aktion	Version	Was bedeutet das
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: Stellen Sie Ihr Abonnement auf ein höheres Niveau um oder warten Sie auf den nächsten Abrechnungszyklus

Kanal-Konfiguration blockiert Updates

When Channel-Einstellungen eine Aktualisierung verhindern:

Zeit	Geräte-ID	Aktion	Version	Was bedeutet
12:00:00	u1v2w3x4	disableAutoUpdateToMajor	2.0.0	Ein Gerät auf v1.x kann sich nicht automatisch auf v2.x (große Versionsnummer) aktualisieren (Hinweis: Versionsnummer gesperrt)
12:05:00	y5z6a7b8	disableEmulator	1.2.0	Emulator erkannt, und der Channel blockiert Emulatoren
12:10:00	c9d0e1f2	disableDevBuild	1.2.0	Entwickler-Build erkannt, und der Channel blockiert Entwickler-Builds

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

Logcodes (Capgo Backendenum)

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.

Happypath & Lifecycle

Code(s)	Bedeutung
get	Das Gerät hat Capgo nach dem aktuellen Kanalmanifest gefragt
download_manifest_start, download_manifest_complete	Manifest herunterladen begonnen / beendet (für Delta- oder Mehrdateibündel)
download_zip_start, download_zip_complete	Zip-Archiv herunterladen begonnen / beendet
download_10 … download_90	Herunterladestatusmeilensteine
download_complete	Gesamtpaket heruntergeladen
set	Paket für den nächsten Start vorbereitet
reset	Gerät wurde auf das Standardpaket zurückgesetzt
delete	Paket aus lokaler Speicherung entfernt
uninstall	App-Entfernung erkannt
app_moved_to_foreground, app_moved_to_background	SDK hat App-Lebenszyklusereignisse aufgezeichnet
ping	Gesundheits-/Herzschlag-Überprüfung vom Gerät
setChannel, getChannel	Kanal überschrieben oder über SDK-Aufruf abgerufen

Konfiguration oder Richtlinie blockiert

Code(s)	Warum die Aktualisierung blockiert wurde
disableAutoUpdate, disableAutoUpdateToMajor, disableAutoUpdateToMinor, disableAutoUpdateToPatch, disableAutoUpdateMetadata, disableAutoUpdateUnderNative	Kanalstrategie verbietet dies semver Sprung
disablePlatformIos, disablePlatformAndroid	Die Plattform ist auf dem Kanal deaktiviert
disableDevBuild, disableEmulator	Entwicklerversionen oder Emulatoren sind nicht erlaubt
cannotUpdateViaPrivateChannel, NoChannelOrOverride, channelMisconfigured	Die Kanäleinstellung oder -überschreibung fehlgeschlagen
missingBundle, cannotGetBundle	Das Manifest bezieht sich auf eine Paketbox Capgo kann nicht bereitstellen
needPlanUpgrade	Die Organisation hat die Grenzen für Pläne/Geräte erreicht
rateLimited	Zu viele Anfragen; SDK blockiert bis zum Neustart
blocked_by_server_url, backend_refusal, InvalidIp	Ein Serverseitiger Regelsatz blockierte die Anfrage

Herunterladen / Integrität / Installationsfehler

Code(s)	Bedeutung
download_fail	Die Paketbox herunterzuladen fehlgeschlagen (Netzwerk- oder Antwortfehler)
download_manifest_file_fail, download_manifest_checksum_fail, download_manifest_brotli_fail	Manifestdatei 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(); Rolloback ausgelöst
download_zip_* mit keiner nachfolgenden set	Herunterladen abgeschlossen, aber Installationsphase wurde nie abgeschlossen

➡️ Bedarf an tieferer Anleitung zu code? Siehe Vollständige Log-Code-Referenz und Fehlersuche-Leitfaden.

Mehr Details über einen Log-Eintrag erhalten

Wenn Sie auf eine bestimmte Protokoll-Eintrag klicken, wird es Ihnen normalerweise zum Geräte-Seite 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äte-spezifische Probleme zu diagnostizieren oder dessen Update-Reise zu verstehen.Weiter von Protokollen

Abschnitt mit dem Titel “Weiter von Protokollen”

für die Implementierungsdetails in der __CAPGO_KEEP_0__-Übersicht Übersicht to plan dashboard and API operations, connect it with API Overview for the implementation detail in API Overview, device’s page device’s page 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.