Registro detalhado

O registro detalhado fornece informações detalhadas e de baixo nível do SDK da Braze, permitindo que você veja como o SDK é inicializado, se comunica com os servidores e processa canais de mensagens como push, mensagens no app e Cartões de Conteúdo.

Quando algo não está funcionando como esperado—como uma notificação por push não chegando, uma mensagem no app não sendo exibida ou dados de usuários não sincronizando—os logs detalhados ajudam você a identificar a causa raiz. Em vez de adivinhar, você pode ver exatamente o que o SDK está fazendo em cada etapa.

Dica

Se você quiser depurar sem ativar o registro detalhado manualmente, pode usar o Depurador de SDK para criar sessões de depuração diretamente no dashboard da Braze.

Quando usar o registro detalhado

Ative o registro detalhado quando precisar:

• Verificar a inicialização do SDK: Confirme se o SDK é iniciado corretamente com a chave de API e o endpoint corretos.
• Solucionar problemas de entrega de mensagens: Verifique se os tokens por push estão registrados, se as mensagens no app são disparadas ou se os Content Cards estão sincronizados.
• Depurar deep links: Verifique se o SDK recebe e abre deep links de push, mensagens no app ou Content Cards.
• Validar o rastreamento de sessão: Confirme se as sessões iniciam e terminam conforme o esperado.
• Diagnosticar problemas de conectividade: Inspecione as solicitações e respostas de rede entre o SDK e os servidores da Braze.

Nota

Se eventos personalizados ou sessões estiverem ausentes na Braze, ative o registro detalhado antes de outras chamadas do SDK, reproduza o problema em um dispositivo de teste e confirme se changeUser é executado com o ID de usuário esperado. Compartilhe os logs com o suporte usando as etapas na seção Coletando logs. Para interpretar as linhas de sessão e eventos, consulte Lendo logs detalhados.

Ativando o registro detalhado

Importante

Os logs detalhados são destinados apenas a ambientes de desenvolvimento e teste. Desative o registro detalhado antes de lançar seu app em produção para evitar que informações sensíveis sejam expostas.

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

Coletando logs

Depois de ativar o registro detalhado, reproduza o problema que você está investigando e, em seguida, colete os logs no console ou na ferramenta de depuração da sua plataforma.

• android
• ios
• web

Dica

Ao coletar logs para o suporte da Braze, comece a registrar antes de iniciar o app e continue até bem depois de o problema ocorrer. Isso ajuda a capturar a sequência completa de eventos.

Lendo logs detalhados

Os logs detalhados seguem uma estrutura consistente que ajuda a rastrear o que o SDK está fazendo. Para saber como interpretar a saída de logs para canais específicos, incluindo quais entradas-chave procurar e padrões comuns de solução de problemas, consulte Lendo logs detalhados.

Compartilhando logs com o suporte da Braze

Ao entrar em contato com o suporte da Braze sobre um problema com o SDK, inclua o seguinte:

1. Arquivo de log detalhado: Uma captura completa do log, desde antes da inicialização do app até a ocorrência do problema.
2. Etapas para reproduzir: Uma descrição clara das ações que provocam o problema.
3. Comportamento esperado vs. real: O que você esperava que acontecesse e o que aconteceu de fato.
4. Versão do SDK: A versão do SDK da Braze que você está usando.
5. Plataforma e versão do sistema operacional: Por exemplo, iOS 18.0, Android 14 ou Chrome 120.