As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# 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](managedintegrations-sdk-v2-cookbook-hubsetup.md).
+ 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](managedintegrations-sdk-v2-cookbook-deployment.md).
**nota**
Para criar configurações de registro, consulte a [PutRuntimeLogConfiguration API](https://docs.aws.amazon.com/iot-mi/latest/APIReference/API_PutRuntimeLogConfiguration.html) 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.
**Example 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.
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`
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:
