Come raccogliere i log VPN di Android per un ticket di assistenza

Tocchi Connect, il profilo gira per un secondo e il client segnala la disconnessione. L'assistenza chiede i log, alleghi uno screenshot e il thread si blocca per due giorni perché nessuno sa dire quale parte della stretta di mano ha ceduto. Un rapporto costruito attorno a un solo tentativo, con una finestra temporale ristretta e l'ultima fase completata, fa avanzare il ticket in un solo giro. L'alternativa, un giorno intero di log del telefono, di solito dà alla persona dall'altra parte più posti dove guardare.

Due telefoni sullo stesso gateway possono comunque comportarsi diversamente, perché protocollo, archivio certificati, metodo di autenticazione o politica del traffico possono non coincidere. Funziona sul mio iPhone è un punto di partenza per il confronto, non una prova di un guasto Android.

Cattura un tentativo invece di un giorno di cronologia

Annota l'ambiente prima di riprodurre qualsiasi cosa: versione di Android, produttore e modello, nome e versione del client, il profilo scelto, la rete a cui sei connesso e l'ora dell'orologio con il suo fuso. Annoto anche se il risparmio energetico o Data Saver sono attivi, perché entrambi cambiano ciò che il client può fare quando lo schermo si spegne.

Poi decidi quale dei cinque esiti stai davvero guardando. La richiesta di consenso o autorizzazione non si completa mai, l'endpoint non è raggiungibile affatto, l'autenticazione viene rifiutata, la configurazione dell'interfaccia fallisce dopo un accesso riuscito, oppure il tunnel si alza e una risorsa specifica resta irraggiungibile. Ognuno ha un proprietario e una correzione diversi, e un pacchetto che li mescola riceve una risposta che chiede di riprovare. È indovinare tra loro che trasforma un ticket di un'ora in una settimana di scambi.

Anche le transizioni contano. Se il guasto compare solo dopo il blocco dello schermo o dopo un passaggio da Wi-Fi a dati mobili, scrivilo nella prima riga del ticket e annota il minuto in cui è successo.

Esporta prima il log del client stesso

Il primo allegato dovrebbe venire dall'app e non dal sistema operativo. La maggior parte dei client offre nelle impostazioni un'esportazione del log diagnostico o di connessione, a volte nascosta dietro una pressione prolungata sulla stringa di versione, e quell'esportazione comprende già la propria macchina a stati. Usala così come esce invece di riscrivere le righe interessanti nel corpo del ticket.

Allega il primo errore e gli eventi immediatamente precedenti, non solo l'ultima riga di disconnessione. Una coda pulita di solito significa che il guasto reale è avvenuto prima: una catena di certificati che non si validava, un nome risolto in un punto inatteso o un'interfaccia mai configurata.

Aggiungi logcat solo per una domanda che sai nominare

Un emulatore di terminale sul telefono non è un logger di sistema. Android registra i suoi buffer come flussi circolari separati che solo i processi privilegiati possono leggere per intero. Quindi un'app normale vede il proprio output più una fetta limitata, e affermare che logcat era vuoto dimostra molto poco su ciò che la piattaforma ha registrato.

La via supportata è una sessione ADB autorizzata da un computer che controlli. Attiva le opzioni sviluppatore e il debug USB, collega il cavo e accetta la finestra dell'impronta RSA sul dispositivo; se quel prompt viene chiuso, ogni comando successivo fallisce con unauthorized e nessuna cattura inizia mai.

Verifica che il dispositivo sia davvero lì prima di investire tempo in una cattura. adb devices dovrebbe stampare il numero di serie seguito dalla parola device, e qualsiasi cosa che mostri offline o unauthorized ha prima bisogno che cavo, prompt o driver siano a posto.

Una volta elencato, inizia a catturare qualche secondo prima di toccare Connect e fermati subito dopo che il client si arrende. Una cattura dal vivo con un inizio deliberato batte un dump preso venti minuti dopo, perché i buffer circolari hanno già girato e le righe iniziali che ti servono potrebbero essere sparite:

adb logcat -v threadtime -b main,system,crash > attempt.txt

Filtra per ora e tag invece che per la parola VPN

Cercare vpn in una cattura è il modo più veloce per perdere la riga che spiega il guasto. Validazione dei certificati, crash dei processi e cambi di connettività vengono registrati sotto tag che non menzionano mai VPN, quindi un filtro per parola chiave tiene il rumore e butta via la prova.

Restringi prima la finestra, poi la priorità, poi il tag. Quando ti serve solo ciò che è successo dopo un momento noto, adb logcat -v threadtime -t '11-03 20:14:00.000' riproduce la coda recente da quel punto, e il formato threadtime mantiene i timestamp confrontabili con l'esportazione del client stesso.

Se conosci il pacchetto del client, segui il suo processo invece di indovinare i tag. adb shell pidof com.vendor.client restituisce un PID e adb logcat --pid=1234 -v threadtime stampa solo quel processo, mentre adb logcat -g mostra quanto spazio ha ogni buffer prima di iniziare a sovrascrivere.

Oscura i segreti, poi consegna un pacchetto coerente

Prima che qualcosa lasci la tua macchina, rimuovi password, token, chiavi private, cookie di sessione e identificatori completi del dispositivo. Conserva i codici di errore, l'ordine degli eventi e le relazioni tra indirizzi che rendono leggibile il guasto, perché una cattura ripulita oltre quel punto è inutile quanto una mai filtrata.

Poi invia un solo pacchetto invece di diversi file sparsi: l'esportazione del client, la finestra ADB nominata con ora di inizio e fine, un riepilogo di due righe della fase fallita e la nota sull'ambiente in cima a questo elenco. Se una parte non può essere pubblicata pubblicamente, usa il canale di assistenza privato del fornitore e indica quale file ha bisogno di quel canale.

Prima di inviare, controlla quattro cose. Il pacchetto copre un tentativo e non un intero pomeriggio? I timestamp del client e del sistema si sovrappongono? E contiene ancora un token, una password o un identificatore completo dell'abbonato? Correggi prima quest'ultimo punto, poi allega i file al ticket esistente invece di aprirne uno nuovo, così chi lo prende in carico conserva il contesto precedente.