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 Sie die ausführliche Protokollierung verwenden sollten

Aktivieren Sie die ausführliche Protokollierung, wenn Sie Folgendes tun müssen:

• SDK-Initialisierung überprüfen: Bestätigen Sie, dass das SDK korrekt mit dem richtigen API-Schlüssel und Endpunkt startet.
• Nachrichtenzustellung beheben: Prüfen Sie, ob Push-Token registriert sind, In-App Messages ausgelöst oder Content Cards synchronisiert werden.
• Deeplinks debuggen: Überprüfen Sie, ob das SDK Deeplinks aus Push-Benachrichtigungen, In-App Messages oder Content Cards empfängt und öffnet.
• Sitzungs-Tracking validieren: Bestätigen Sie, dass Sitzungen wie erwartet beginnen und enden.
• Verbindungsprobleme diagnostizieren: Untersuchen Sie die Netzwerkanfragen und -antworten zwischen dem SDK und den Braze-Servern.

Hinweis

Falls angepasste Events oder Sitzungen in Braze fehlen, aktivieren Sie die ausführliche Protokollierung vor anderen SDK-Aufrufen, reproduzieren Sie das Problem auf einem Testgerät und bestätigen Sie, dass changeUser mit der erwarteten Nutzer:innen-ID ausgeführt wird. Teilen Sie die Protokolle mit dem Support anhand der Schritte im Abschnitt Protokolle erfassen. Informationen zur Interpretation von Sitzungs- und Event-Zeilen finden Sie unter Ausführliche Protokolle lesen.

Ausführliches Logging aktivieren

Wichtig

Ausführliche Logs sind nur für Entwicklungs- und Testumgebungen gedacht. Deaktivieren Sie das ausführliche Logging, bevor Sie Ihre App in die Produktion überführen, 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;

Logs erfassen

Nachdem Sie das ausführliche Logging aktiviert haben, reproduzieren Sie das Problem, das Sie beheben möchten, und erfassen Sie dann die Logs über die Konsole oder das Debugging-Tool Ihrer Plattform.

• android
• ios
• web

Tipp

Wenn Sie Logs für den Braze-Support erfassen, starten Sie das Logging vor dem Start Ihrer App und setzen Sie es bis weit nach dem Auftreten des Problems fort. So wird die vollständige Abfolge der Ereignisse erfasst.

Ausführliche Logs lesen

Ausführliche Logs folgen einer einheitlichen Struktur, die Ihnen hilft nachzuvollziehen, was das SDK tut. Um zu erfahren, wie Sie Log-Ausgaben für bestimmte Kanäle interpretieren – einschließlich wichtiger Einträge und häufiger Fehlerbehebungsmuster –, lesen Sie Ausführliche Logs lesen.

Weitergabe von Logs an den Braze-Support

Wenn Sie den Braze-Support wegen eines SDK-Problems kontaktieren, fügen Sie Folgendes bei:

1. Ausführliche Logdatei: Eine vollständige Logaufzeichnung vom App-Start bis zum Auftreten des Problems.
2. Schritte zur Reproduktion: Eine klare Beschreibung der Aktionen, die das Problem auslösen.
3. Erwartetes vs. tatsächliches Verhalten: Was Sie erwartet haben und was stattdessen passiert ist.
4. SDK-Version: Die Version des Braze SDK, die Sie verwenden.
5. Plattform und Betriebssystemversion: Zum Beispiel iOS 18.0, Android 14 oder Chrome 120.