Habilitar CloudWatch registros

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

• Incorpora el dispositivo gestionado a la nube. Para obtener más información, consulte Configuración de incorporación del hub.

• Compruebe que el agente Hub se ha iniciado y que la inicialización se ha realizado correctamente. Para obtener más información, consulte Instalar y validar las integraciones gestionadas Hub SDK.

nota

Para crear configuraciones de registro, consulta la PutRuntimeLogConfiguration API 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

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

ejemplo 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

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.

importante

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

nota

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

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