Recopilación del registro del lado del cliente

Visión general

La creación de registros es la instrumentación del código fuente que utiliza llamadas de API para grabar mensajes con el propósito de facilitar la depuración y los diagnósticos. IBM Mobile Foundation proporciona un conjunto de métodos de API de registro para este propósito.

La API MobileFirst Logger es parecida a otras API de registro utilizadas habitualmente como, por ejemplo, console.log (JavaScript), java.util.logging (Java) y NSLog (Objective-C), y proporciona la funcionalidad adicional de capturar de forma persistente los datos registrados para enviarlos a MobileFirst Server para ser utilizados en la inspección por parte de los desarrolladores y para la recopilación de analíticas. Utilice las API de Logger obtener datos de registro en los niveles apropiados, de forma que los desarrolladores que inspeccionen registros puedan determinar y corregir problemas sin tener que reproducir los problemas en sus centros de desarrollo.

Disponibilidad

Los métodos de API de Logger que MobileFirst proporciona se pueden utilizar con aplicaciones iOS, Android, Web y Cordova.

Niveles de registro

Las bibliotecas de creación de registros habitualmente tienen controles de nivel de detalle frecuentemente denominados niveles.
Los niveles de creación de registro, de más detallado o menos detallado, son lo siguientes:

• TRACE - utilizado para puntos de entrada y salida de método
• DEBUG - utilizado para salidas de resultado de método
• LOG - utilizado para la creación de instancias de clase
• INFO - utilizado para la inicialización de creación de informes
• WARN - utilizado para registrar avisos de utilización en desuso
• ERROR - utilizado para las excepciones no esperadas
• FATAL - utilizado para cuelgues o bloqueos no recuperables

Nota: La utilización de FATAL dará lugar a la recopilación de un bloqueo de aplicación. Para evitar la distorsión con sus datos de bloqueo de aplicación, se recomienda no utilizar esta palabra clave.

Los SDK de cliente están configurados de forma predeterminada con el nivel de detalle FATAL, lo que se significa que la captura o la salida es escasa o sin registros de depuración detallados. El nivel de detalle se puede ajustar mediante programación o mediante un perfil de configuración en MobileFirst Analytics Console, que su aplicación debe recuperar de forma explícita.

Registros de aplicaciones de cliente:

• Registro en aplicaciones JavaScript (Cordova, Web)
• Registro en aplicaciones iOS
• Registro en aplicaciones Android

Ajuste del nivel de detalle del registro

Una vez establecido el nivel de registros, ya sea en el cliente o recuperando el perfil del servidor, el cliente filtra los mensajes de registro que recibe. Si se envía de forma explícita un mensaje por debajo del umbral, el cliente lo ignora.

Por ejemplo, para establecer el nivel de detalle en DEBUG:

iOS

Objective-C

[OCLogger setLevel:OCLogger_DEBUG];

Swift

 OCLogger.setLevel(OCLogger_DEBUG);

Android

Logger.setLevel(Logger.LEVEL.DEBUG);

JavaScript (Cordova)

WL.Logger.config({ level: 'DEBUG' });

JavaScript (Web)

El nivel de rastreo predeterminado para el SDK web no se puede cambiar desde el cliente.

Captura de bloqueos

El SDK de cliente de MobileFirst, en aplicaciones Android e iOS, captura un rastreo de pila cuando una aplicación se bloquea y lo registra en un nivel FATAL. Este tipo de bloqueo es un bloqueo verdadero donde la interfaz de usuario desaparece de la vista del usuario. En aplicaciones Cordova, captura errores globales de JavaScript y, si es posible, una pila de llamadas de JavaScript, y lo registra en el nivel FATAL. Este tipo de bloqueo no es un suceso de bloqueo, y podría tener o no tener consecuencias adversas en la experiencia del usuario en el tiempo de ejecución.

Los bloqueos, excepciones no capturadas y errores globales se capturan y registran de forma automática una vez la aplicación se ejecuta de nuevo.

Visualización de registros

Después de que se recopilen los registros y se envíen al servidor, los podrá visualizar en MobileFirst Analytics Console. Elija el panel Aplicaciones en la barra de navegación y pulse el separador Buscar en registro de clientes.