

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Habilitar CloudWatch registros
<a name="hub-log"></a>

 El SDK de Hub proporciona una funcionalidad de registro integral. De forma predeterminada, el SDK de Hub escribe los registros en el sistema de archivos local. Sin embargo, puedes aprovechar la API en la nube para configurar la transmisión de CloudWatch registros a Logs, que ofrece: 
+  **Supervise el rendimiento de los dispositivos**: capture registros detallados del tiempo de ejecución para una gestión proactiva de los dispositivos. Habilite el análisis y la supervisión avanzados de los registros en toda su flota de dispositivos 
+  **Solucione problemas**: genere entradas de registro granulares para un análisis de diagnóstico rápido. Registre los eventos a nivel del sistema y de la aplicación para una investigación exhaustiva. 
+  **Registro flexible y centralizado**: gestión remota de registros sin acceso directo al dispositivo. Agregue registros de varios dispositivos en un único repositorio con capacidad de búsqueda. 

## Requisitos previos
<a name="hub-prerequisites"></a>
+ Incorpora el dispositivo gestionado a la nube. Para obtener más información, consulte [Configuración de incorporación del hub](managedintegrations-sdk-v2-cookbook-hubsetup.md). 
+ Compruebe que el agente Hub se ha iniciado y que la inicialización se ha realizado correctamente. Para obtener más información, consulte [Instale y valide el SDK de Hub de integraciones administradas](managedintegrations-sdk-v2-cookbook-deployment.md). 

**nota**  
Para crear configuraciones de registro, consulta la [PutRuntimeLogConfiguration API](https://docs.aws.amazon.com/iot-mi/latest/APIReference/API_PutRuntimeLogConfiguration.html) para obtener más información.

**aviso**  
 La activación de los registros se tiene en cuenta para la medición de cuotas escalonadas. El aumento de los niveles de registro se traducirá en un mayor volumen de mensajes y en costes adicionales. 

## Configure las configuraciones de registro del SDK de Hub
<a name="hub-configuration"></a>

Configura los ajustes de registro del SDK de hub llamando a la API para configurar los registros en tiempo de ejecución.

**Example Ejemplo de solicitud de API**  

```
aws iot-managed-integrations put-runtime-log-configuration \
    --managed-thing-id MANAGED_THING_ID \
    --runtime-log-configurations LogLevel=DEBUG,UploadLog=TRUE
```

### RuntimeLogConfigurations atributos
<a name="hub-configuration-attributes"></a>

Los siguientes atributos son opcionales y se pueden configurar en la `RuntimeLogConfigurations` API.

**LogLevel**  
Establece el nivel de gravedad mínimo para los rastreos en tiempo de ejecución. Valores: `DEBUG, ERROR, INFO, WARN`  
Predeterminado: `WARN` (versión publicada)

**LogFlushLevel**  
Determina el nivel de gravedad del traslado inmediato de los datos al almacenamiento local. Valores: `DEBUG, ERROR, INFO, WARN`  
Valor predeterminado: `DISABLED`

**LocalStoreLocation**  
Especifica la ubicación de almacenamiento de los seguimientos en tiempo de ejecución. Valor predeterminado: `/var/log/awsiotmi`  
+ Registro activo: `/var/log/awsiotmi/ManagedIntegrationsDeviceSdkHub.log`
+ Registros rotados: `/var/log/awsiotmi/ManagedIntegrationsDeviceSdkHub.N.log` (N indica el orden de rotación)

**LocalStoreFileRotationMaxBytes**  
Activa la rotación del archivo cuando el archivo actual supera el tamaño especificado.  
Para una eficiencia óptima, mantenga el tamaño del archivo por debajo de 125 KB. Los valores superiores a 125 KB se limitarán automáticamente.

**LocalStoreFileRotationMaxFiles,**  
Establece el número máximo de archivos de rotación permitidos por el daemon de registro.

**UploadLog**  
Controla la transferencia de trazas en tiempo de ejecución a la nube. Los registros se almacenan en el grupo de `/aws/iotmanagedintegration` CloudWatch registros.  
Predeterminado: `false`.

**UploadPeriodMinutes**  
Define la frecuencia de carga de los rastreos en tiempo de ejecución. Valor predeterminado: `5`

**DeleteLocalStoreAfterUpload**  
Controla la eliminación de archivos después de subirlos. Valor predeterminado: `true`  
Si se establece en falso, el nombre de los archivos subidos pasa a ser: `/var/log/awsiotmi/ManagedIntegrationsDeviceSdkHub.uploaded.{uploaded_timestamp}`

### Ejemplo de archivo de registro
<a name="hub-log-file"></a>

 Vea el ejemplo de un archivo de CloudWatch registro a continuación: 

![Un ejemplo de registro de Cloudwatch para UploadLog](https://docs.aws.amazon.com/es_es/iot-mi/latest/devguide/images/iotmanagedintegrations-sdk-cloudwatch-log.png)
