> For the complete documentation index, see [llms.txt](https://docs.payments.thalescloud.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.payments.thalescloud.io/merchant-tokenization/es/integracion-del-sdk/error-management/retrieve-sdk-logs/android.md).

# Android

## Registros seguros <a href="#secure-logs" id="secure-logs"></a>

Configure el SDK de Thales para generar archivos de registro seguros y ofuscados.

### Habilitar o deshabilitar el registro seguro <a href="#how-to-enabledisable-secure-logger" id="how-to-enabledisable-secure-logger"></a>

El registro seguro está habilitado por defecto. Puede desactivarlo durante la inicialización del SDK de Thales:

```java
Context contexto;
String serverUrl;
byte[] serverCertificate;
String keyIdentifier;
TMGClientConfiguration configuration = new TMGClientConfiguration(activity, 
                                                                  serverUrl, 
                                                                  serverCertificate, 
                                                                  keyIdentifier);

configuration.enableSecureLog(false);
```

En este ejemplo, `enableSecureLog(false)` desactiva la generación de registros después de `TMGClientConfiguration` es instanciado. Con la configuración predeterminada (`true`), el SDK escribe registros durante la vida del proceso de la aplicación.

También puede pausar el registro temporalmente:

```java
// Desactivar el registro seguro temporalmente.
TMGClient.getInstance().getSecureLog().setLevel(SecureLogLevel.OFF);

// Reanudar el registro con el nivel de registro predeterminado.
TMGClient.getInstance().getSecureLog().setLevel(SecureLogLevel.WARN);
```

Establecer el nivel de registro en `OFF` evita que el SDK de Thales escriba nuevas entradas de registro. Restablezca el nivel a `WARN` (predeterminado) u otro nivel para reanudar el registro.

### Recuperar archivos de registro seguros <a href="#how-to-retrieve-secure-log-files" id="how-to-retrieve-secure-log-files"></a>

El SDK de Thales genera archivos de registro en el sandbox de la aplicación. Recupérelos así:

```java
// Recuperar los archivos de registro seguro
List<File> secureLogFiles = TMGClient.getInstance().getSecureLog().getFiles();

// Procesar los archivos.
```

`secureLogFiles` contiene una lista de `File` objetos para los archivos de registro disponibles. Comparta estos archivos con el equipo de entrega de Thales al investigar un problema.

## Registros de Logcat <a href="#logcat" id="logcat"></a>

{% hint style="info" %}
Asegúrese de que está usando la variante de compilación debug.
{% endhint %}

### Método 1: capturar registros con adb <a href="#method-1" id="method-1"></a>

Antes de capturar registros desde un dispositivo Android, confirme lo siguiente:

1. La herramienta Android Debug Bridge (ADB) está disponible en el sistema anfitrión.
2. La opción de depuración USB está habilitada en el dispositivo bajo prueba.
   * Si no está habilitada, vaya a Configuración > Opciones de desarrollador > Depuración USB.
3. El dispositivo Android está conectado al sistema anfitrión mediante un cable USB y el controlador USB está instalado.

Puede ejecutar el siguiente comando en el símbolo del sistema para verificar su configuración:

```shellscript
adb devices
```

Una respuesta similar al siguiente fragmento de código indica que el dispositivo puede ser alcanzado por la herramienta ADB:

```bash
Lista de dispositivos adjuntos
228b0e100d047ece dispositivo
```

#### Pasos recomendados para capturar registros

1. Abra el símbolo del sistema y borre todos los búferes de registro en el dispositivo:

```shellscript
adb logcat -b all -c
```

2. Inicie la captura de registros:

```shellscript
adb logcat > LogFileName.txt
```

Reemplace `LogFileName.txt` con el nombre de archivo que prefiera.

3. Realice el/los caso(s) de uso.
4. Presione CTRL+C en el símbolo del sistema para detener la captura de registros.
5. Recupere `LogFileName.txt` desde el directorio donde ejecutó el paso 2.

### Método 2: usar Android Studio Logcat <a href="#method-2" id="method-2"></a>

Vea los registros directamente en la ventana de herramienta Logcat de Android Studio.

1. Abra la pestaña Logcat que se puede encontrar en la barra de herramientas lateral o inferior.
2. Asegúrese de que un dispositivo esté conectado y ejecute los casos de uso requeridos para el programa.
3. Filtre los mensajes con `TMGSDK` etiqueta.
4. Los registros aparecerán en la pestaña Logcat.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.payments.thalescloud.io/merchant-tokenization/es/integracion-del-sdk/error-management/retrieve-sdk-logs/android.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.