Ausführliche Protokollierung

Die ausführliche Protokollierung liefert detaillierte Low-Level-Informationen aus dem Braze SDK und bietet Ihnen Einblick in die Initialisierung des SDK, die Kommunikation mit Servern und die Verarbeitung von Messaging-Kanälen wie Push-Benachrichtigungen, In-App-Nachrichten und Content-Cards.

Wenn etwas nicht wie erwartet funktioniert – beispielsweise eine Push-Benachrichtigung nicht ankommt, eine In-App-Nachricht nicht angezeigt wird oder Nutzerdaten nicht synchronisiert werden –, helfen Ihnen ausführliche Protokolle dabei, die Ursache zu identifizieren. Anstatt zu vermuten, können Sie genau sehen, was das SDK bei jedem Schritt ausführt.

Tipp

Wenn Sie debuggen möchten, ohne die ausführliche Protokollierung manuell zu aktivieren, können Sie den SDK-Debugger verwenden, um Debugging-Sitzungen direkt im Braze-Dashboard zu erstellen.

Wann sollte ausführliche Protokollierung verwendet werden?

Aktivieren Sie die ausführliche Protokollierung, wenn erforderlich:

• Überprüfen Sie die Initialisierung des SDK: Bitte überprüfen Sie, ob das SDK mit dem korrekten SDK-API-Schlüssel und Endpunkt ordnungsgemäß startet.
• Fehlerbehebung bei der Zustellung von Nachrichten: Bitte überprüfen Sie, ob Push-Token registriert sind, In-App-Nachrichten ausgelöst werden oder Content-Cards synchronisiert sind.
• Deeplinks debuggen: Bitte überprüfen Sie, ob das SDK Deeplinks aus Push-Benachrichtigungen, In-App-Nachrichten oder Content-Cards empfängt und öffnet.
• SitzungsTracking überprüfen: Bitte bestätigen Sie, dass die Sitzungen wie erwartet beginnen und enden.
• Diagnose von Verbindungsproblemen: Bitte überprüfen Sie die Netzwerkanfragen und -antworten zwischen dem SDK und den Braze-Servern.

Ausführliche Protokollierung Enablement aktivieren

Wichtig

Ausführliche Protokolle sind ausschließlich für Entwicklungs- und Testumgebungen vorgesehen. Bitte deaktivieren Sie die ausführliche Protokollierung, bevor Sie Ihre App in die Produktion freigeben, um zu verhindern, dass vertrauliche Informationen offengelegt werden.

• android
• swift
• web
• unity
• react native

1
BrazeLogger.setLogLevel(Log.VERBOSE);

1
BrazeLogger.logLevel = Log.VERBOSE

1
<integer name="com_braze_logger_initial_log_level">2</integer>

1
2077-11-19 16:22:49.591 ? V/Braze v9.0.01 .bo.app.d3: Request started

1
2
3
4
5
6
let configuration = Braze.Configuration(
  apiKey: "<BRAZE_API_KEY>",
  endpoint: "<BRAZE_ENDPOINT>"
)
configuration.logger.level = .debug
let braze = Braze(configuration: configuration)

1
2
3
4
BRZConfiguration *configuration = [[BRZConfiguration alloc] initWithApiKey:@"<BRAZE_API_KEY>"
                                                                  endpoint:@"<BRAZE_ENDPOINT>"];
[configuration.logger setLevel:BRZLoggerLevelDebug];
Braze *braze = [[Braze alloc] initWithConfiguration:configuration];

1
2
3
4
braze.initialize('YOUR-API-KEY', {
    baseUrl: 'YOUR-SDK-ENDPOINT',
    enableLogging: true
});

1
braze.toggleLogging();

1
2
const configuration = new Braze.BrazeConfiguration('YOUR-API-KEY', 'YOUR-SDK-ENDPOINT');
configuration.logLevel = Braze.LogLevel.Verbose;

Protokolle sammeln

Nachdem Sie die ausführliche Protokollierung aktiviert haben, reproduzieren Sie bitte das Problem, das Sie bei der Fehlerbehebung beheben möchten, und erfassen Sie anschließend die Protokolle über die Konsole oder das Debugging-Tool Ihrer Plattform.

• android
• ios
• web

Tipp

Wenn Sie Protokolle für den Braze-Support sammeln, beginnen Sie bitte mit der Protokollierung, bevor Sie Ihre App starten, und setzen Sie diese fort, bis das Problem aufgetreten ist. Dies unterstützt die Erfassung der gesamten Abfolge von Ereignissen.

Ausführliche Protokolle lesen

Ausführliche Protokolle folgen einer einheitlichen Struktur, die Ihnen dabei hilft, die Aktivitäten des SDK nachzuvollziehen. Informationen zur Interpretation der Protokollausgabe für bestimmte Kanäle, einschließlich der zu suchenden Schlüsseleinträge und gängiger Muster der Fehlerbehebung, finden Sie unter Ausführliche Protokolle lesen.

Weitergabe von Protokollen an den Braze-Support

Wenn Sie sich wegen eines SDK-Problems an den Braze-Support wenden, geben Sie bitte Folgendes an:

1. Ausführliche Protokolldatei: Eine vollständige Protokollierung vom Zeitpunkt vor dem Start der App bis zum Vorkommen des Problems.
2. Schritte zur Reproduktion: Eine klare Beschreibung der Handlungen, die das Problem triggern.
3. Erwartetes vs. tatsächliches Verhalten: Was Sie erwartet haben und was stattdessen eingetreten ist.
4. SDK-Version: Die Version des Braze SDK, die Sie verwenden.
5. Plattform und Betriebssystemversion: Beispielsweise iOS 18.0, Android 14 oder Chrome 120.