Registro detallado

El registro detallado muestra información detallada y de bajo nivel del SDK de Braze, lo que te permite ver cómo se inicializa el SDK, cómo se comunica con los servidores y cómo procesa los canales de mensajería, como las notificaciones push, los mensajes dentro de la aplicación y las tarjetas de contenido.

Cuando algo no funciona como se espera, como por ejemplo, una notificación push que no llega, un mensaje dentro de la aplicación que no se muestra o datos de usuario que no se sincronizan, los registros detallados te ayudan a identificar la causa raíz. En lugar de hacer conjeturas, puedes ver exactamente lo que hace el SDK en cada paso.

Cuándo utilizar el registro detallado

Activa el registro detallado cuando sea necesario:

• Verifica la inicialización del SDK: Confirma que el SDK se inicia correctamente con la clave de API y el punto final SDK correctos.
• Solución de problemas con la entrega de mensajes: Comprueba si los tokens de notificaciones push están registrados, si se desencadenan los mensajes dentro de la aplicación o si las tarjetas de contenido están sincronizadas.
• Depurar vínculos profundos: Comprueba que el SDK recibe y abre vínculos profundos desde notificaciones push, mensajes dentro de la aplicación o tarjetas de contenido.
• Validar el seguimiento de la sesión: Confirma que las sesiones comienzan y terminan según lo previsto.
• Diagnosticar problemas de conectividad: Inspecciona las solicitudes y respuestas de red entre el SDK y los servidores de Braze.

Habilitar el registro detallado

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

Recopilación de registros

Después de habilitar el registro detallado, reproduce el problema que estás resolviendo en la solución de problemas y, a continuación, recopila los registros de la consola o la herramienta de depuración de tu plataforma.

• android
• ios
• web

Lectura de registros detallados

Los registros detallados siguen una estructura coherente que te ayuda a rastrear lo que está haciendo el SDK. Para aprender a interpretar la salida del registro para canales específicos, incluyendo qué entradas clave buscar y patrones comunes de solución de problemas, consulta Lectura de registros detallados.

Compartir registros con el soporte de Braze

Cuando te pongas en contacto con el soporte de Braze por un problema con el SDK, incluye lo siguiente:

1. Archivo de registro detallado: Un registro completo desde antes del inicio de la aplicación hasta la aparición del problema.
2. Pasos para reproducir el problema: Una descripción clara de las acciones que desencadenan el problema.
3. Comportamiento esperado frente a comportamiento real: Lo que esperabas que sucediera y lo que sucedió en realidad.
4. Versión del SDK: La versión del SDK de Braze que estás utilizando.
5. Plataforma y versión del sistema operativo: Por ejemplo, iOS 18.0, Android 14 o Chrome 120.