Consignation prolixe

La journalisation détaillée fournit des informations précises et de bas niveau provenant du SDK Braze, vous permettant ainsi de comprendre comment le SDK s’initialise, communique avec les serveurs et traite les canaux de communication tels que les notifications push, les messages in-app et les cartes de contenu.

Lorsque quelque chose ne fonctionne pas comme prévu, par exemple lorsqu’une notification push n’arrive pas, qu’un message in-app ne s’affiche pas ou que les données utilisateur ne se synchronisent pas, les journaux détaillés vous aident à identifier la cause profonde. Au lieu de deviner, vous pouvez observer précisément ce que fait le SDK à chaque étape.

Quand utiliser la journalisation détaillée

Activez la journalisation détaillée lorsque nécessaire :

• Vérifiez l’initialisation du SDK : Veuillez vérifier que le SDK démarre correctement avec la clé API et l’endpoint appropriés.
• Résolution des problèmes de réception/distribution des messages : Veuillez vérifier si les jetons push sont enregistrés, si les messages in-app sont déclenchés ou si les cartes de contenu sont synchronisées.
• Déboguer les liens profonds : Veuillez vérifier que le SDK reçoit et ouvre les liens profonds provenant des notifications push, des messages in-app ou des cartes de contenu.
• Vérifier le suivi de session : Veuillez vérifier que les sessions commencent et se terminent comme prévu.
• Diagnostiquer les problèmes de connectivité : Veuillez examiner les requêtes réseau et les réponses entre le SDK et les serveurs Braze.

Activation de la journalisation détaillée

• 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;

Collecte des journaux

Après avoir activé la journalisation détaillée, veuillez reproduire le problème que vous rencontrez lors de la résolution des problèmes, puis collecter les journaux à partir de la console ou de l’outil de débogage de votre plateforme.

• android
• ios
• web

Lecture des journaux détaillés

Les journaux détaillés suivent une structure cohérente qui vous aide à suivre les activités du SDK. Pour apprendre à interpréter les sorties de journal pour des canaux spécifiques, y compris les entrées clés à rechercher et les modèles de résolution des problèmes courants, veuillez consulter la section Lecture des journaux détaillés.

Partage des journaux avec le service d’assistance Braze

Lorsque vous contactez l’assistance Braze pour un problème lié au SDK, veuillez inclure les informations suivantes :

1. Fichier journal détaillé : Enregistrement complet des journaux depuis avant le lancement de l’application jusqu’à la survenue du problème.
2. Étapes à suivre pour reproduire le problème : Une description claire des actions de déclenchement du problème.
3. Comportement attendu par rapport au comportement réel : Ce que vous vous attendiez à ce qui se produise et ce qui s’est produit à la place.
4. Version du SDK : La version du SDK Braze que vous utilisez.
5. Plateforme et version du système d’exploitation : Par exemple, iOS 18.0, Android 14 ou Chrome 120.