Ativar CloudWatch registros

O Hub SDK fornece uma funcionalidade abrangente de registro. Por padrão, o Hub SDK grava registros no sistema de arquivos local. No entanto, você pode aproveitar a API de nuvem para configurar o streaming de CloudWatch registros para o Logs, que oferece:

• Monitore o desempenho do dispositivo: capture registros detalhados de tempo de execução para gerenciamento proativo de dispositivos. Habilite a análise e o monitoramento avançados de registros em toda a sua frota de dispositivos

• Solucione problemas: gere entradas de registro granulares para uma análise rápida de diagnóstico. Registre eventos no nível do sistema e do aplicativo para uma investigação aprofundada.

• Registro flexível e centralizado: gerenciamento remoto de registros sem acesso direto ao dispositivo. Agregue registros de vários dispositivos em um único repositório pesquisável.

Pré-requisitos

• Integre o dispositivo gerenciado à nuvem. Para mais detalhes, consulte Configuração de integração do hub.

• Verifique a inicialização do agente Hub e a inicialização bem-sucedida. Para mais detalhes, consulte Instale e valide as integrações gerenciadas Hub SDK.

nota

Para criar configurações de registro, consulte a PutRuntimeLogConfiguration API para obter detalhes.

Atenção

A ativação de registros conta para a medição de cotas em camadas. O aumento dos níveis de registro resultará em maior volume de mensagens e custos adicionais.

Configurar configurações de log do Hub SDK

Defina as configurações de log do SDK do hub chamando a API para definir a configuração do log de tempo de execução.

exemplo amostra de solicitação 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

Os atributos a seguir são opcionais e podem ser configurados na RuntimeLogConfigurations API.

LogLevel

Define o nível mínimo de severidade para rastreamentos de tempo de execução. Valores: DEBUG, ERROR, INFO, WARN

Padrão: WARN (versão lançada)

LogFlushLevel

Determina o nível de severidade da descarga imediata de dados para o armazenamento local. Valores: DEBUG, ERROR, INFO, WARN

Padrão: DISABLED

LocalStoreLocation

Especifica o local de armazenamento para rastreamentos de tempo de execução. Padrão: /var/log/awsiotmi

• Registro ativo: /var/log/awsiotmi/ManagedIntegrationsDeviceSdkHub.log

• Registros girados: /var/log/awsiotmi/ManagedIntegrationsDeviceSdkHub.N.log (N indica a ordem de rotação)

LocalStoreFileRotationMaxBytes

Aciona a rotação do arquivo quando o arquivo atual excede o tamanho especificado.

Importante

Para uma eficiência ideal, mantenha o tamanho do arquivo abaixo de 125 KB. Valores acima de 125 KB serão automaticamente limitados.

LocalStoreFileRotationMaxFiles,

Define o número máximo de arquivos de rotação permitidos pelo daemon de log.

UploadLog

Controla a transferência de rastreamento em tempo de execução para a nuvem. Os registros são armazenados no grupo /aws/iotmanagedintegration CloudWatch Registros.

Padrão: false.

UploadPeriodMinutes

Define a frequência dos uploads de rastreamento em tempo de execução. Padrão: 5

DeleteLocalStoreAfterUpload

Controla a exclusão do arquivo após o upload. Padrão: true

nota

Se definido como false, os arquivos enviados serão renomeados para: /var/log/awsiotmi/ManagedIntegrationsDeviceSdkHub.uploaded.{uploaded_timestamp}

Exemplo de arquivo de log

Veja o exemplo de um arquivo de CloudWatch registros abaixo: