Logcat — τι είναι, επίπεδα καταγραφής και εργασία με αρχεία καταγραφής

Τι είναι το Logcat στο Android

Logcat — είναι ένα buffer συστήματος Android στο οποίο όλες οι διεργασίες (συμπεριλαμβανομένων του πυρήνα Linux, του system_server και των εφαρμογών) γράφουν μηνύματα συγκεκριμένης μορφής. Το εργαλείο logcat, που αποτελεί μέρος του Android SDK, διαβάζει αυτόν τον buffer και εμφανίζει μηνύματα σε πραγματικό χρόνο. Από το Android 4.1 (API 16), η πρόσβαση στο Logcat είναι περιορισμένη: οι εφαρμογές μπορούν να διαβάζουν μόνο τα δικά τους αρχεία καταγραφής, ενώ τα αρχεία καταγραφής συστήματος είναι διαθέσιμα μέσω ADB με πρόσβαση debug.

Κάθε μήνυμα Logcat περιέχει πέντε πεδία: ημερομηνία και ώρα, PID (αναγνωριστικό διεργασίας), TID (αναγνωριστικό νήματος), επίπεδο καταγραφής και ετικέτα. Η μορφή είναι σταθερή και ίδια για όλες τις εκδόσεις Android. Αυτό επιτρέπει τη χρήση εργαλείων grep, awk και sed για φιλτράρισμα αρχείων καταγραφής σε αγωγούς CI/CD χωρίς εξάρτηση από IDE.

Τα αρχεία καταγραφής αποθηκεύονται σε κυκλικό buffer σταθερού μεγέθους: 256 KB για main, 256 KB για system και 256 KB για events (Android 5+). Όταν γεμίσει ο buffer, τα παλιά μηνύματα διαγράφονται. Ο προγραμματιστής μπορεί να αλλάξει το μέγεθος του buffer μέσω PROP logcat.size ή στις ρυθμίσεις προγραμματιστή της συσκευής.

Επίπεδα καταγραφής και ετικέτες: δομή μηνύματος Logcat

Έξι επίπεδα καταγραφής καθορίζουν τη σπουδαιότητα του μηνύματος. Το Android χρησιμοποιεί τυπικά επίπεδα παρόμοια με άλλες πλατφόρμες, αλλά με δικά του ονόματα σταθερών στην κλάση Log. Η επιλογή του σωστού επιπέδου βοηθά στο αποτελεσματικό φιλτράρισμα αρχείων καταγραφής και στην αποφυγή πνιγμού κρίσιμων μηνυμάτων από δευτερεύοντα.

Ετικέτες: οργάνωση μηνυμάτων ανά ενότητα

Ετικέτα (tag) — μια συμβολοσειρά έως 23 χαρακτήρων που προσδιορίζει την πηγή του μηνύματος. Συνιστάται η χρήση του ονόματος κλάσης ή ενότητας ως ετικέτας: MainActivity, AuthManager, NetworkModule. Αυτό επιτρέπει το φιλτράρισμα αρχείων καταγραφής ανά συγκεκριμένο στοιχείο της εφαρμογής. Για ομοιομορφία στην ομάδα, μπορούν να δημιουργηθούν σταθερές ετικετών σε ξεχωριστό αρχείο ή να χρησιμοποιηθεί η βιβλιοθήκη Timber που ορίζει αυτόματα την ετικέτα βάσει του ονόματος κλάσης.

Αρχεία καταγραφής σφαλμάτων και stack trace εξαίρεσης

Σε μη διαχειριζόμενη εξαίρεση, το Android γράφει αυτόματα στο Logcat πλήρες stack trace με αναφορά κλάσης, μεθόδου, γραμμής κώδικα και αλυσίδας κλήσεων. Το αρχείο καταγραφής σφάλματος περιέχει τον τύπο εξαίρεσης (NullPointerException, RuntimeException), το μήνυμα και την ακολουθία κλήσεων από το σημείο αποτυχίας έως το σημείο εισόδου της εφαρμογής. Για ανάλυση αρχείων καταγραφής σφαλμάτων από συσκευές χρηστών χρησιμοποιείται το Firebase Crashlytics, το οποίο συγχρονίζει το stack trace με τον χάρτη συσκότισης (mapping.txt για Android).

Logcat στο Android Studio: διεπαφή, φίλτρα και αναζήτηση

Το Android Studio παρέχει γραφική διεπαφή Logcat, προσβάσιμη μέσω View → Tool Windows → Logcat (Alt + 6). Το παράθυρο Logcat ενημερώνεται σε πραγματικό χρόνο, εμφανίζει όλα τα μηνύματα της συνδεδεμένης συσκευής και επιτρέπει τη διαμόρφωση ευέλικτων φίλτρων για εξαγωγή των απαραίτητων πληροφοριών από τη γενική ροή.

Φιλτράρισμα ανά επίπεδο και ετικέτα

Η αναπτυσσόμενη λίστα Log Level φιλτράρει μηνύματα ανά ελάχιστο επίπεδο: επιλέξτε WARN για να βλέπετε μόνο προειδοποιήσεις και σφάλματα, κρύβοντας τα VERBOSE, DEBUG και INFO. Το πεδίο Search επιτρέπει αναζήτηση βάσει κειμένου μηνύματος ή ετικέτας — υποστηρίζει regex, που είναι βολικό για αναζήτηση μηνυμάτων βάσει προτύπου.

Αποθηκευμένα φίλτρα

Saved Filters — μια ισχυρή λειτουργία του Logcat στο Android Studio. Μπορείτε να δημιουργήσετε ένα φίλτρο που εμφανίζει μόνο μηνύματα με την ετικέτα της εφαρμογής σας (tag:MyApp) και επίπεδο WARN+. Τα φίλτρα αποθηκεύονται μεταξύ συνεδριών και είναι διαθέσιμα από την αναπτυσσόμενη λίστα. Για έργα με πολλές ενότητες, δημιουργήστε ξεχωριστό φίλτρο για κάθε ενότητα.

# Παράδειγμα έκφρασης για φιλτράρισμα αρχείων καταγραφής εφαρμογής
tag:"MyApp" level:WARN # Μόνο WARN+ για MyApp
package:"com.mycompany" # Όλα τα logs του πακέτου
-tag:"okhttp" # Εξαίρεση logs OkHttp

Εξαγωγή και ανάλυση

Τα αρχεία καταγραφής Logcat μπορούν να εξαχθούν σε αρχείο κειμένου μέσω του εικονιδίου Save to File. Αυτό είναι χρήσιμο για επισύναψη σε αιτήματα στο Jira ή ανάλυση μεγάλων συνεδριών. Το εξαγόμενο αρχείο καταγραφής μπορεί να ανοίξει σε οποιοδήποτε πρόγραμμα επεξεργασίας κειμένου και να εφαρμοστεί grep για αναζήτηση προτύπων. Για μορφοποιημένη προβολή, χρησιμοποιήστε το εργαλείο logcat-color.

ADB logcat: εντολές τερματικού για προχωρημένη εργασία

ADB logcat — η έκδοση κονσόλας του Logcat, διαθέσιμη μέσω του Android Debug Bridge. Το κύριο πλεονέκτημά της είναι η δυνατότητα εκτέλεσης σε διακομιστές CI, σε σενάρια αυτοματισμού και σε συσκευές χωρίς Android Studio. Το ADB logcat υποστηρίζει όλα τα ίδια φίλτρα με το GUI, αλλά με την ευελιξία της γραμμής εντολών.

Βασικές εντολές

Η εντολή adb logcat χωρίς ορίσματα εμφανίζει ολόκληρο τον buffer σε πραγματικό χρόνο. Για διακοπή, χρησιμοποιήστε Ctrl+C. Η σημαία -c καθαρίζει τον buffer πριν από την έναρξη εγγραφής — αυτό είναι βολικό όταν πρέπει να απομονώσετε τα αρχεία καταγραφής της τρέχουσας δοκιμής από προηγούμενα μηνύματα. Η σημαία -b επιλέγει τον τύπο buffer: main, system, events, crash (Android 12+).

# Εκκαθάριση buffer και έναρξη καταγραφής με ετικέτα MyApp
adb logcat -c
adb logcat MyApp:D *:S

# Αποθήκευση αρχείων καταγραφής σε αρχείο
adb logcat -d > logcat_dump.txt

# Φιλτράρισμα βάσει PID διεργασίας
adb logcat --pid=12345

Φιλτράρισμα με grep και awk

Ο συνδυασμός ADB με εργαλεία unix παρέχει μέγιστη ευελιξία. Για παράδειγμα, το φίλτρο "*:S TAG:D" εμφανίζει μόνο μηνύματα με ετικέτα TAG επιπέδου DEBUG και άνω, κρύβοντας όλα τα άλλα. Για προβολή μόνο Exception, χρησιμοποιήστε grep -i exception. Για ανάλυση συχνότητας σφαλμάτων, εφαρμόστε sort | uniq -c στη στήλη ετικέτας.

Logcat σε CI/CD

Σε διακομιστές CI, το Logcat χρησιμοποιείται για συλλογή διαγνωστικών κατά την εκτέλεση δοκιμών UI. Τυπικός αγωγός: πριν από την εκτέλεση δοκιμών, ο buffer καθαρίζεται· μετά την εκτέλεση δοκιμών, η απόρριψη αρχείων καταγραφής αποθηκεύεται ως τεχνούργημα κατασκευής. Εάν μια δοκιμή αποτύχει, βάσει των αρχείων καταγραφής μπορεί να προσδιοριστεί εάν η αποτυχία προκλήθηκε από ANR, μη διαχειριζόμενη εξαίρεση ή χρονικό όριο δικτύου.

Καταγραφή σε κώδικα: Log.d, Log.e και Timber

Η κλάση android.util.Log — το ενσωματωμένο API για εγγραφή μηνυμάτων στο Logcat. Οι Log.v, Log.d, Log.i, Log.w, Log.e και Log.wtf δέχονται μια ετικέτα (συμβολοσειρά) και ένα μήνυμα (συμβολοσειρά) ή μήνυμα + Throwable. Για μορφοποίηση μηνυμάτων, χρησιμοποιήστε String.format ή Kotlin String templates — αποφύγετε τη συνένωση συμβολοσειρών που δημιουργεί επιπλέον αντικείμενα στο heap.

Η βιβλιοθήκη Timber

Timber — μια δημοφιλής βιβλιοθήκη του Jake Wharton που εξαλείφει τα μειονεκτήματα του ενσωματωμένου Log API. Το Timber ορίζει αυτόματα την ετικέτα βάσει του ονόματος κλάσης που κάλεσε την καταγραφή και δεν απαιτεί μεταβίβαση ετικέτας σε κάθε κλήση. Το Timber υποστηρίζει επίσης υπό συνθήκη καταγραφή: στο build Release, οι κλήσεις Timber.v και Timber.d μπορούν να απενεργοποιηθούν με μία γραμμή στο Application.onCreate.

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        // Ενσωματωμένο Log API
        Log.d("MainActivity", "onCreate called")

        // Timber — αυτόματη ετικέτα βάσει ονόματος κλάσης
        Timber.d("onCreate called")
    }

    private fun loadData() {
        try {
            val result = fetchFromNetwork()
            Timber.i("Data loaded: $result")
        } catch (e: IOException) {
            Timber.e(e, "Failed to load data")
        }
    }
}

Υπό συνθήκη καταγραφή για Release

Σε build Release συνιστάται η απενεργοποίηση των αρχείων καταγραφής VERBOSE και DEBUG για μείωση του φόρτου στον buffer Logcat και αποκλεισμό διαρροής ευαίσθητων πληροφοριών. Το Timber λύνει αυτό το πρόβλημα μέσω PlantingTree: στο flavor Debug φυτεύεται DebugTree (καταγράφει τα πάντα), στο Release — CrashReportingTree (καταγράφει μόνο ERROR μέσω Crashlytics). Το ενσωματωμένο Log API δεν υποστηρίζει υπό συνθήκη καταγραφή — ο προγραμματιστής πρέπει να τυλίγει κάθε κλήση σε if (BuildConfig.DEBUG).