Getnet DocsGetnet Docs

Análisis de logs del SDK

View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in PerplexityAsk questions about this page
Connect to CursorUse these docs in CursorConnect to VS CodeUse these docs in VS Code

Cuando se encuentran problemas complejos de transacciones o conectividad, los logs del SDK proporcionan información de diagnóstico detallada sobre la comunicación Bluetooth, las interacciones con la pasarela y el procesamiento de transacciones. Esta guía explica cómo habilitar el registro, acceder a los datos de registro y extraer logs para la resolución de problemas o el soporte técnico de Get Mini.

Requisitos

Antes de extraer los logs del SDK, asegúrate de tener instalado Xcode en tu Mac para la gestión de dispositivos y la extracción de logs. Necesitarás el dispositivo iOS físico que experimentó el problema conectado a tu Mac de desarrollo. Para problemas de campo que ocurren en dispositivos de clientes, necesitarás acceso al dispositivo o la capacidad de descargar contenedores de aplicaciones a través de herramientas de despliegue empresarial.

Paso 1: Habilitar el registro del SDK

Activa el registro detallado durante la configuración del SDK para capturar información de diagnóstico detallada. Habilita el registro antes de inicializar el administrador del SDK:

let config = TPVVConfiguration()
config.fuc = "999008881"
config.terminal = "001"
config.environment = .test
config.logEnabled = true  // Habilitar registro detallado

TPVVConfiguration.shared = config

Con el registro habilitado, el SDK captura información detallada sobre los procesos de descubrimiento y conexión Bluetooth, lectura de tarjetas y operaciones de entrada de PIN, solicitudes y respuestas de autorización, condiciones de error y detalles de excepciones, e información de tiempo para el análisis de rendimiento.

Deshabilita el registro en las compilaciones de producción para evitar la sobrecarga de rendimiento y evitar que datos sensibles se escriban en los logs. Solo habilita el registro durante el desarrollo y la resolución de problemas.

Paso 2: Ver logs en tiempo real en Xcode

Cuando depures con un dispositivo conectado a Xcode, ve los logs del SDK en tiempo real a través de la consola de depuración de Xcode. Ejecuta tu aplicación con el dispositivo conectado y abre el área de depuración usando Command+Shift+C o a través de View > Debug Area > Show Debug Area.

Los mensajes de log del SDK aparecen etiquetados con prefijos [GetMiniSDK] para facilitar el filtrado. Usa la funcionalidad de búsqueda de la consola de Xcode para filtrar por tipos de log específicos o palabras clave. Busca mensajes de error, identificadores de transacción e información de tiempo relevante para tu problema.

El registro en tiempo real ayuda a diagnosticar problemas durante el desarrollo y escenarios de prueba controlados donde los dispositivos permanecen conectados a las máquinas de desarrollo.

Paso 3: Extraer logs del dispositivo

Para problemas que ocurren en el campo o cuando la depuración en tiempo real no está disponible, extrae los archivos de log del sandbox de la aplicación para su análisis offline. Conecta el dispositivo iOS afectado a tu Mac ejecutando Xcode y sigue estos pasos:

Abre Xcode y navega a Window > Devices and Simulators desde la barra de menú. Selecciona tu dispositivo iOS conectado desde la barra lateral izquierda, luego localiza tu aplicación en la lista de Installed Apps. Haz clic en el icono de engranaje junto a tu aplicación y selecciona “Download Container…” del menú desplegable. Xcode descarga y guarda el contenedor de la aplicación como un archivo .xcappdata.

Localiza el archivo contenedor descargado en Finder, haz clic derecho sobre él y selecciona “Show Package Contents” para acceder a la estructura interna del contenedor. Navega a AppData/Library/Caches/GetMiniLogs/ dentro del paquete para encontrar los archivos de log del SDK. Los archivos de log generalmente se nombran con marcas de tiempo o identificadores de sesión para su organización.

Copia los archivos de log relevantes a una ubicación fuera del paquete contenedor para su análisis o envío a soporte. El paquete contenedor puede descartarse después de extraer los archivos de log necesarios.

Proporcionar logs al soporte técnico

Cuando abras un ticket con el soporte técnico de Get Mini, incluye información de diagnóstico completa para acelerar la resolución del problema. Adjunta los archivos de log extraídos de los pasos anteriores, asegurándote de proporcionar logs que cubran el período en que ocurrió el problema. Incluye el ID de pedido o la referencia de transacción de las transacciones fallidas o problemáticas, si está disponible. Proporciona el número de serie del lector PIN pad, que se encuentra en una etiqueta en la parte posterior o inferior del dispositivo.

Además, documenta los pasos para reproducir el problema, incluyendo importes de la transacción, tiempos y acciones específicas tomadas. Anota la versión de iOS, el modelo del dispositivo y la versión del SDK utilizada en tu aplicación. Incluye cualquier mensaje de error mostrado a los usuarios o registrado en los propios logs de tu aplicación.

Cuanto más contexto proporciones junto con los logs del SDK, más rápido podrán los equipos de soporte diagnosticar y resolver problemas.

Mejores prácticas para el análisis de logs

Cuando analices los logs del SDK tú mismo, busca patrones específicos que indiquen problemas comunes. Busca las palabras clave “Error” o “Exception” para identificar puntos de fallo. Verifica los códigos de respuesta de autorización en los logs de comunicación con la pasarela. Verifica que los estados de conexión Bluetooth muestren un emparejamiento exitoso antes de los intentos de transacción. Revisa la información de tiempo para identificar cuellos de botella de rendimiento o situaciones de timeout.

Compara los logs de las transacciones correctas con los de las fallidas para identificar diferencias en los patrones de comunicación o códigos de respuesta. Presta atención a la secuencia de operaciones: algunos problemas surgen de un orden de llamadas incorrecto o pasos de inicialización faltantes.

Consideraciones de seguridad de logs

Los logs del SDK pueden contener información de transacción sensible, incluyendo datos parciales de tarjetas (enmascarados), códigos de autorización e identificadores de comercio. Trata los archivos de log como datos confidenciales que requieren protección. Nunca compartas logs públicamente o a través de canales no seguros. Cuando envíes logs a soporte, utiliza métodos de transferencia de archivos seguros proporcionados por Get Mini. Elimina los archivos de log de ubicaciones temporales después de completar el análisis.

Para aplicaciones en producción, implementa la rotación de logs para evitar que estos consuman un almacenamiento excesivo en el dispositivo. Considera cifrar los archivos de log si permanecen en los dispositivos durante períodos prolongados.

Próximos pasos