Este artículo cubre el proceso de registro, incluidos los estándares de registro, las pautas de nivel, las clases, los propósitos y las aproximaciones de varias pilas.

Estándares de registro

Iniciar sesión en Android es complejo debido a la combinación de estándares utilizados que se combinan en logcat . Los principales estándares utilizados se detallan a continuación:

Figura 1: estándares de nivel de registro.

Aunque cada uno de estos estándares tiene una construcción de nivel similar, varían en granularidad. Los equivalentes aproximados en los estándares son los siguientes:

Figura 2: niveles de registro de syslog , Android y Java.

Pautas de nivel de registro

Existen pautas dadas para cada estándar de registro. El nivel de registro elegido sigue el estándar apropiado que se usa, como usar el estándar syslog para el desarrollo del kernel.

Los pedidos de nivel de registro, de menor a mayor, se muestran en las tres figuras a continuación:

Figura 3: android.util.Log

Figura 4: java.util.Logging.Level .

Figura 5: RFC 5424 - Sección 6.2.1 .

Registro de aplicaciones

El registro selectivo se realiza con TAG por la clase android.util.Log usando Log#isLoggable , como se muestra a continuación:

if (Log.isLoggable("FOO_TAG", Log.VERBOSE)) {
 Log.v("FOO_TAG", "Message for logging.");
}

Los registros se pueden ajustar en tiempo de ejecución para proporcionar un nivel seleccionado de registro como se muestra a continuación:

adb shell setprop log.tag.FOO_TAG VERBOSE

Las propiedades log.tag.* se restablecen al reiniciar. Hay variantes persistentes que también permanecen en los reinicios. Vea abajo:

adb shell setprop persist.log.tag.FOO_TAG VERBOSE

Las comprobaciones Log#isLoggable dejan rastros de registro en el código de la aplicación. Los indicadores booleanos DEBUG omiten los seguimientos de registro mediante optimizaciones del compilador que se establecen en false , como se muestra a continuación:

private final static boolean DEBUG = false;


…
If (DEBUG) {
 Log.v("FOO_TAG", "Extra debug logging.");
}

El registro se puede eliminar por APK a través de los conjuntos de reglas de ProGuard por R8 en el momento de la compilación. El siguiente ejemplo elimina todo lo que se encuentra debajo del registro de nivel INFO para android.util.Log :

# This allows proguard to strip isLoggable() blocks containing only <=INFO log
# code from release builds.
-assumenosideeffects class android.util.Log {
  static *** i(...);
  static *** d(...);
  static *** v(...);
  static *** isLoggable(...);
}
-maximumremovedandroidloglevel 4

Esto es útil para manejar múltiples tipos de compilación de aplicaciones (por ejemplo, compilaciones de desarrollo frente a compilaciones de lanzamiento) donde se espera que el código subyacente sea el mismo, pero los niveles de registro permitidos son diferentes. Se debe establecer y seguir una política explícita para las aplicaciones (particularmente las aplicaciones del sistema) para decidir cómo los tipos de compilación y las expectativas de lanzamiento afectan la salida del registro.

Registro del sistema en Android Runtime (ART)

Hay varias clases disponibles para aplicaciones y servicios del sistema:

Figura 6: Clases y propósitos de registro del sistema disponibles.

Aunque android.util.Log y android.util.Slog usan los mismos estándares de nivel de registro, Slog es una clase @hide que solo puede usar la plataforma. Los niveles de EventLog se asignan a las entradas en el archivo event.logtags en /system/etc/event-log-tags .

Registro nativo

Iniciar sesión en C/C++ sigue el estándar syslog con syslog (2) correspondiente al kernel de Linux syslog que controla el búfer printk y syslog (3) correspondiente al registrador general del sistema. Android usa la biblioteca liblog para el registro general del sistema.

liblog proporciona envoltorios para los grupos de subblogs mediante el siguiente formato de macro:

RLOGD , por ejemplo, corresponde a [Radio log buffer ID] LOG [Debug Level] . Los principales envoltorios de liblog son los siguientes:

Figura 7: envoltorios liblog .

Android tiene interfaces de nivel superior para el registro que se prefieren al uso directo de liblog , como se ve a continuación:

Figura 8: Bibliotecas de registro de nivel superior.

Aproximaciones multipila

Debido a las diferencias en la granularidad y la intención del nivel, no existen coincidencias claras o exactas de los diferentes estándares de registro. Por ejemplo, los niveles de java.util.logging.Level y android.util.Log para los registros de errores no coinciden 1:1:

Figura 9: Nivel de error en el registro estándar de Java frente al registro de Android.

En casos como este, use el estándar individual para determinar qué nivel aplicar.

Durante el desarrollo del sistema con múltiples componentes de nivel de pila, siga la Figura 1 para determinar qué estándar usar por componente. Para obtener una guía aproximada de los mensajes de nivel, siga la Figura 2.

Seguridad y privacidad

No registre información de identificación personal (PII). Esto incluye detalles como:

• Correos electrónicos
• Números telefónicos
• nombres

Del mismo modo, ciertos detalles se consideran confidenciales incluso si no son explícitamente identificables personalmente.

Por ejemplo, aunque la información de la zona horaria no se considera identificable personalmente, da una indicación de la ubicación aproximada de un usuario.

La política de registro y los detalles aceptables deben manejarse como parte de la revisión de seguridad y privacidad antes del lanzamiento.