Cet article couvre le processus de journalisation, y compris les normes de journalisation, les directives de niveau, les classes, les objectifs et les approximations multipiles.

Normes de journal

La connexion à Android est complexe en raison du mélange de normes utilisées qui sont combinées dans logcat . Les principales normes utilisées sont détaillées ci-dessous :

Figure 1 : Normes de niveau de journalisation.

Bien que chacune de ces normes ait un niveau de construction similaire, leur granularité varie. Les équivalents approximatifs entre les normes sont les suivants :

Figure 2 : niveaux de journalisation syslog , Android et Java.

Consignes relatives au niveau de journalisation

Il existe des lignes directrices existantes données pour chaque norme de journal. Le niveau de journalisation choisi suit la norme appropriée utilisée, comme l'utilisation de la norme syslog pour le développement du noyau.

Les ordres de niveau de journal, du moins au plus, sont indiqués dans les trois figures ci-dessous :

Figure 3 : android.util.Log

Figure 4 : java.util.Logging.Level .

Figure 5 : RFC 5424 - Section 6.2.1 .

Journalisation des applications

La journalisation sélective est effectuée avec TAG par la classe android.util.Log en utilisant Log#isLoggable , comme indiqué ci-dessous :

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

Les journaux peuvent être réglés au moment de l'exécution pour fournir un niveau de journalisation sélectionné, comme indiqué ci-dessous :

adb shell setprop log.tag.FOO_TAG VERBOSE

Les propriétés log.tag.* sont réinitialisées au redémarrage. Il existe également des variantes persistantes qui subsistent lors des redémarrages. Voir ci-dessous:

adb shell setprop persist.log.tag.FOO_TAG VERBOSE

Les vérifications Log#isLoggable laissent des traces de journal dans le code de l'application. Les indicateurs booléens DEBUG contournent les traces de journal à l'aide d'optimisations du compilateur définies sur false , comme indiqué ci-dessous :

private final static boolean DEBUG = false;


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

La journalisation peut être supprimée par APK via les ensembles de règles ProGuard par R8 au moment de la compilation. L'exemple suivant supprime tout ce qui se trouve sous la journalisation de niveau INFO pour 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

Ceci est utile pour gérer plusieurs types de build d'application (par exemple, les builds de développement par rapport aux builds de version) où le code sous-jacent est censé être le même, mais les niveaux de journalisation autorisés sont différents. Une stratégie explicite doit être définie et suivie pour les applications (en particulier les applications système) afin de décider de l'impact des types de build et des attentes de publication sur la sortie du journal.

Journalisation du système dans Android Runtime (ART)

Plusieurs classes sont disponibles pour les applications système et les services :

Figure 6 : Classes et objectifs de journal système disponibles.

Bien que android.util.Log et android.util.Slog utilisent les mêmes normes de niveau de journalisation, Slog est une classe @hide utilisable uniquement par la plate-forme. Les niveaux EventLog sont mappés aux entrées du fichier event.logtags dans /system/etc/event-log-tags .

Journalisation native

La journalisation en C/C++ suit la norme syslog avec syslog (2) correspondant au syslog du noyau Linux qui contrôle le tampon printk , et syslog (3) correspondant au journal système général. Android utilise la bibliothèque liblog pour la journalisation générale du système.

liblog fournit des wrappers pour les groupes de sous-journaux en utilisant la forme de macro suivante :

RLOGD , par exemple, correspond à [Radio log buffer ID] LOG [Debug Level] . Les principaux wrappers de liblog sont les suivants :

Figure 7 : enveloppes liblog .

Android a des interfaces de niveau supérieur pour la journalisation qui sont préférées à l'utilisation directe de liblog , comme indiqué ci-dessous :

Figure 8 : Bibliothèques de journaux de niveau supérieur.

Approximations multipiles

En raison des différences de granularité et d'intention de niveau, il n'y a pas de correspondance claire ou exacte des différentes normes de journalisation. Par exemple, les niveaux java.util.logging.Level et android.util.Log pour les journaux d'erreurs ne correspondent pas 1:1 :

Figure 9 : Niveau d'erreur dans la journalisation Java standard par rapport à la journalisation Android.

Dans de tels cas, utilisez la norme individuelle pour déterminer le niveau à appliquer.

Lors du développement du système avec plusieurs composants au niveau de la pile, suivez la figure 1 pour déterminer la norme à utiliser par composant. Pour un guide approximatif de la messagerie de niveau, suivez la figure 2.

Sécurité et confidentialité

N'enregistrez pas d'informations personnelles identifiables (PII). Cela inclut des détails tels que :

• Adresses mail
• Numéros de téléphone
• Des noms

De même, certains détails sont considérés comme sensibles même s'ils ne sont pas explicitement personnellement identifiables.

Par exemple, bien que les informations sur le fuseau horaire ne soient pas considérées comme personnellement identifiables, elles donnent une indication de l'emplacement approximatif d'un utilisateur.

La politique de journalisation et les détails acceptables doivent être traités dans le cadre de l'examen de la sécurité et de la confidentialité avant la publication.

Journaux de l'appareil

L'accès à tous les journaux de l'appareil, y compris l'utilisation d' android.permission.READ_LOGS , est limité :

• Si une application en arrière-plan demande l'accès à tous les journaux de l'appareil, la demande est automatiquement refusée, sauf si l'application :
• partage l'UID du système.
• utilise un processus système natif ( UID < APP_UID ).
• utilise DropBoxManager .
• accède uniquement au tampon du journal des événements.
• utilise l'API EventLog .
• utilise des tests instrumentés.
• Si une application au premier plan avec READ_LOGS demande l'accès aux journaux de l'appareil, le système invite l'utilisateur à approuver ou à refuser la demande d'accès.