Como recoller rexistros de VPN de Android para un tícket de asistencia

Preme Conectar, o perfil xira un segundo e o cliente informa de desconexión. O soporte pide rexistros, achega unha captura de pantalla e o fío detense dous días porque ninguén pode dicir que parte do salgado inicial se rendeu. Un informe construído arredor dun só intento, cunha xanela de tempo estreita e a última etapa completada, move o tícket nunha soa rolda. A alternativa, un día completo de rexistros do teléfono, normalmente dálle á persoa do outro lado máis lugares onde mirar.

Dous teléfonos na mesma pasarela poden comportarse distinto, porque o protocolo, o almacén de certificados, o método de autenticación ou a política de tráfico poden non coincidir. Funciona no meu iPhone é un punto de partida para comparar, non unha proba sobre un fallo de Android.

Capture un intento en lugar dun día de historial

Anote a contorna antes de reproducir nada: versión de Android, fabricante e modelo, nome e versión do cliente, o perfil seleccionado, a rede á que está conectado e a hora do reloxo coa súa zona horaria. Tamén anoto se están activados o aforro de batería ou Data Saver, porque ambos cambian o que o cliente pode facer cando se apaga a pantalla.

Despois decida cal dos cinco resultados está a ver realmente. O aviso de consentimento ou permiso nunca se completa, non se pode acadar o extremo, rexéitase a autenticación, falla a configuración da interface tras un inicio de sesión correcto, ou o túnel érguense e un recurso concreto segue inaccesible. Cada un ten un responsable distinto e unha solución distinta, e un paquete que os mestura recibe unha resposta pedindo que o intente de novo. Adiviñar entre eles é o que converte un tícket dunha hora nunha semana de idas e voltas.

As transicións tamén importan. Se o fallo só aparece tras bloquear a pantalla ou tras pasar de Wi-Fi a datos móbiles, pona na primeira liña do tícket e anote o minuto en que ocorreu.

Exporte primeiro o rexistro propio do cliente

O primeiro anexo debería vir da aplicación e non do sistema operativo. A maioría dos clientes inclúen nos axustes unha exportación de rexistro de diagnóstico ou de conexión, ás veces agochada tras unha pulsación longa na cadea de versión, e esa exportación xa entende a súa propia máquina de estados. Úsea tal como sae en lugar de reescribir as liñas interesantes no corpo do tícket.

Achegue o primeiro erro e os eventos inmediatamente anteriores, non só a última liña de desconexión. Unha cola limpa normalmente significa que o fallo real ocorreu antes: unha cadea de certificados que non validaba, un nome que se resolveu nun lugar inesperado ou unha interface que nunca se configurou.

Engada logcat só para unha pregunta que poida nomear

Un emulador de terminal no teléfono non é un rexistrador do sistema. Android rexistra os seus buffers como fluxos circulares separados que só os procesos privilexiados poden ler por completo. Así, unha aplicación normal ve a súa propia saída máis unha porción restrinxida, e afirmar que logcat estaba baleiro demostra moi pouco sobre o que rexistrou a plataforma.

A vía admitida é unha sesión ADB autorizada desde un ordenador que controle. Active as opcións de desenvolvedor e a depuración USB, conecte o cable e acepte o diálogo de pegada RSA no dispositivo; se ese aviso se descarta, cada comando posterior falla con unauthorized e non comeza ningunha captura.

Confirme que o dispositivo está realmente alí antes de investir tempo nunha captura. adb devices debería imprimir o número de serie seguido da palabra device, e calquera cousa que mostre offline ou unauthorized necesita primeiro arranxar o cable, o aviso ou o controlador.

Unha vez que apareza na lista, comece a capturar uns segundos antes de premer Conectar e detéñase xusto despois de que o cliente se renda. Unha captura en directo cun inicio deliberado supera un volcado tomado vinte minutos despois, porque os buffers circulares xa xiraron e as liñas iniciais que necesita poden desaparecer:

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

Filtre por hora e etiqueta en lugar de pola palabra VPN

Buscar vpn nunha captura é a forma máis rápida de perder a liña que explica o fallo. A validación de certificados, os fallos de proceso e os cambios de conectividade rexístranse baixo etiquetas que nunca mencionan VPN, así que un filtro por palabra clave conserva o ruído e bota a evidencia.

Estreite primeiro a xanela, logo a prioridade e logo a etiqueta. Cando só necesita o que ocorreu despois dun momento coñecido, adb logcat -v threadtime -t '11-03 20:14:00.000' reproduce a cola recente desde ese punto, e o formato threadtime mantén as marcas de tempo comparables coa exportación propia do cliente.

Se coñece o paquete do cliente, siga o seu proceso en lugar de adiviñar etiquetas. adb shell pidof com.vendor.client devolve un PID e adb logcat --pid=1234 -v threadtime imprime só ese proceso, mentres que adb logcat -g mostra canto espazo ten cada buffer antes de comezar a sobrescribir.

Oculte os segredos e entregue un paquete coherente

Antes de que algo saia da súa máquina, elimine contrasinais, tokens, chaves privadas, cookies de sesión e identificadores completos do dispositivo. Conserve os códigos de erro, a orde dos eventos e as relacións de enderezos que fan lexible o fallo, porque unha captura limpa máis aló dese punto é tan inútil como unha que nunca se filtrou.

Despois envíe un só paquete en lugar de varios ficheiros soltos: a exportación do cliente, a xanela ADB nomeada coa súa hora de inicio e fin, un resumo de dúas liñas da etapa que fallou e a nota de contorna da parte superior desta lista. Se parte non se pode publicar en público, use a canle de asistencia privada do provedor e diga que ficheiro necesita esa canle.

Antes de enviar, comprobe catro cousas. O paquete cobre un intento e non toda unha tarde? Solápanse as marcas de tempo do cliente e do sistema? E segue contendo un token, un contrasinal ou un identificador completo de subscritor? Arranxe primeiro ese último punto e logo achegue os ficheiros ao tícket existente en lugar de abrir un novo, para que quen o colla conserve o contexto anterior.