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.

Consejo

Si deseas depurar sin habilitar manualmente el registro detallado, puedes utilizar el depurador del SDK para crear sesiones de depuración directamente en el panel de Braze.

Cuándo usar el registro detallado

Activa el registro detallado cuando necesites:

• Verificar la inicialización del SDK: Confirma que el SDK se inicia correctamente con la clave de API y el endpoint adecuados.
• Solucionar problemas de entrega de mensajes: Comprueba si los tokens de notificaciones push están registrados, si los mensajes dentro de la aplicación se activan o si las Content Cards están sincronizadas.
• Depurar vínculos profundos: Verifica que el SDK reciba y abra vínculos profundos de push, mensajes dentro de la aplicación o Content Cards.
• Validar el seguimiento de sesiones: Confirma que las sesiones comienzan y terminan como se espera.
• Diagnosticar problemas de conectividad: Inspecciona las solicitudes y respuestas de red entre el SDK y los servidores de Braze.

Nota

Si faltan eventos personalizados o sesiones en Braze, habilita el registro detallado antes de otras llamadas al SDK, reproduce el problema en un dispositivo de prueba y confirma que changeUser se ejecuta con el ID de usuario esperado. Comparte los registros con soporte de Braze siguiendo los pasos de la sección Recopilar registros. Para interpretar las líneas de sesión y eventos, consulta Leer registros detallados.

Habilitar el registro detallado

Importante

Los registros detallados están diseñados solo para entornos de desarrollo y pruebas. Desactiva el registro detallado antes de publicar tu aplicación en producción para evitar la exposición de información confidencial.

• 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 investigando y luego recopila los registros desde la consola o la herramienta de depuración de tu plataforma.

• android
• ios
• web

Consejo

Al recopilar registros para soporte de Braze, comienza a registrar antes de lanzar tu aplicación y continúa hasta bastante después de que ocurra el problema. Esto ayuda a capturar la secuencia completa de eventos.

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 de registros 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 soporte de Braze

Cuando contactes con soporte de Braze por un problema del SDK, incluye lo siguiente:

1. Archivo de registro detallado: Una captura de registro completa desde antes del inicio de la aplicación hasta la aparición del problema.
2. Pasos para reproducir: Una descripción clara de las acciones que desencadenan el problema.
3. Comportamiento esperado frente al real: Lo que esperabas que ocurriera y lo que ocurrió en su lugar.
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.