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.

Conseil

Si vous souhaitez effectuer un débogage sans activer manuellement la journalisation détaillée, vous pouvez utiliser le débogueur SDK pour créer des sessions de débogage directement dans le tableau de bord de Braze.

Quand utiliser la journalisation détaillée

Activez la journalisation détaillée lorsque vous avez besoin de :

• Vérifier l’initialisation du SDK : Confirmer que le SDK démarre correctement avec la bonne clé API et le bon endpoint.
• Résoudre les problèmes de distribution des messages : Vérifier si les jetons de notification push sont enregistrés, si les messages in-app sont déclenchés ou si les Content Cards sont synchronisées.
• Déboguer les deep links : Vérifier que le SDK reçoit et ouvre les deep links provenant des notifications push, des messages in-app ou des Content Cards.
• Valider le suivi des sessions : Confirmer que les sessions démarrent et se terminent comme prévu.
• Diagnostiquer les problèmes de connectivité : Inspecter les requêtes et réponses réseau entre le SDK et les serveurs Braze.

Remarque

Si des événements personnalisés ou des sessions sont manquants dans Braze, activez la journalisation détaillée avant les autres appels au SDK, reproduisez le problème sur un appareil de test et confirmez que changeUser s’exécute avec l’ID utilisateur attendu. Partagez les journaux avec le support en suivant les étapes de la section Collecte des journaux. Pour interpréter les lignes de session et d’événement, consultez Lire les journaux détaillés.

Activer la journalisation détaillée

Important

Les journaux détaillés sont destinés uniquement aux environnements de développement et de test. Désactivez la journalisation détaillée avant de publier votre application en production afin d’éviter l’exposition d’informations sensibles.

• 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, reproduisez le problème que vous cherchez à résoudre, puis collectez les journaux depuis la console ou l’outil de débogage de votre plateforme.

• android
• ios
• web

Conseil

Lorsque vous collectez des journaux pour le support Braze, commencez la journalisation avant de lancer votre application et poursuivez-la bien après l’apparition du problème. Cela permet de capturer la séquence complète des événements.

Lecture des journaux détaillés

Les journaux détaillés suivent une structure cohérente qui vous aide à suivre ce que fait le SDK. Pour apprendre à interpréter les sorties de journaux pour des canaux spécifiques, y compris les entrées clés à rechercher et les schémas courants de résolution des problèmes, consultez Lecture des journaux détaillés.

Partager les journaux avec le support Braze

Lorsque vous contactez le support Braze pour un problème lié au SDK, incluez les éléments suivants :

1. Fichier de journal détaillé : une capture de journal complète, depuis le lancement de l’application jusqu’à la survenue du problème.
2. Étapes de reproduction : une description claire des actions qui déclenchent le problème.
3. Comportement attendu vs. comportement réel : ce que vous attendiez et ce qui s’est réellement produit.
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.