Configurar registro em log da AWS IoT

1. Em Selecionar tipo de entidade confiável, selecione a opção AWS Serviço. Em seguida, escolha a opção IoT em Caso de uso. Se a opção IoT não for exibida, entre e pesquise IoT em Casos de uso para outros AWS serviços: menu suspenso. Escolha Próximo.

2. Na página Adicionar permissões, você verá as políticas que são automaticamente anexadas ao perfil de serviço. Escolha Próximo.

3. Na página Nome, revisão e criação, insira um Nome do perfil e uma Descrição da função para a função e escolha Criar função.

4. Na lista de Funções, encontre a função criada, abra-a e copie o ARN da função (logging-role-arn) a ser usado em Configurar o registro em log padrão no AWS IoT (console).

Para usar o console do AWS IoT para configurar o registro em log padrão para todo o AWS IoT

1. Faça login no console do AWS IoT. Para obter mais informações, consulte Abra o console do AWS IoT.

2. No painel de navegação à esquerda, escolha Configurações. Na seção Logs da página Configurações, escolha Gerenciar logs.

   A página Logs exibe a função de registro em log e o nível de detalhamento usados por todo o AWS IoT.

   

3. Na página Logs, escolha Selecionar função para especificar uma função que você criou em Criar uma função de registro em log, ou Criar função para criar uma nova função para usar no registro em log.

   

4. Escolha o nível de log que descreve o nível de detalhe das entradas de log que você deseja que apareçam nos logs do CloudWatch.

5. Escolha Atualizar para salvar suas alterações.

Para usar a CLI a fim de configurar o registro em log padrão para o AWS IoT

1. Use o comando set-v2-logging-options para definir as opções de registro em log para sua conta.

   aws iot set-v2-logging-options \
       --role-arn logging-role-arn \
       --default-log-level log-level

   onde:

   --role-arn

   O ARN da função que concede permissão ao AWS IoT para gravar em seus logs no CloudWatch Logs.

   --default-log-level

   O nível de log a ser usado. Os valores válidos são ERROR, WARN, INFO, DEBUG ou DISABLED.

   --no-disable-all-logs

   Um parâmetro opcional que permite todos os registros em log do AWS IoT. Use esse parâmetro para habilitar o registro em log se ele estiver desabilitado no momento.

   --disable-all-logs

   Um parâmetro opcional que desativa todos os registros em log do AWS IoT. Use esse parâmetro para desabilitar o registro em log se ele estiver habilitado no momento.

2. Use o comando get-v2-logging-options para obter as opções de registro em log atuais.

   aws iot get-v2-logging-options

Como usar a CLI para configurar o registro em log de recursos específicos para o AWS IoT

1. Use o comando set-v2-logging-options para definir as opções de registro em log para sua conta.

   aws iot set-v2-logging-options \
       --role-arn logging-role-arn \
       --default-log-level log-level

   onde:

   --role-arn

   O ARN da função que concede permissão ao AWS IoT para gravar em seus logs no CloudWatch Logs.

   --default-log-level

   O nível de log a ser usado. Os valores válidos são ERROR, WARN, INFO, DEBUG ou DISABLED.

   --no-disable-all-logs

   Um parâmetro opcional que permite todos os registros em log do AWS IoT. Use esse parâmetro para habilitar o registro em log se ele estiver desabilitado no momento.

   --disable-all-logs

   Um parâmetro opcional que desativa todos os registros em log do AWS IoT. Use esse parâmetro para desabilitar o registro em log se ele estiver habilitado no momento.

2. Use o comando set-v2-logging-level para configurar o registro em log específico de recursos para um grupo de objetos.

   aws iot set-v2-logging-level \
                 --log-target targetType=THING_GROUP,targetName=thing_group_name \
                 --log-level log_level

   --log-target

   O tipo e o nome do recurso para o qual você está configurando o registro em log. O valor target_type deve ser um dos seguintes: THING_GROUP | CLIENT_ID | SOURCE_IP |PRINCIPAL_ID. O valor do parâmetro-alvo de log pode ser texto, como mostrado no exemplo de comando anterior, ou uma string JSON, como o exemplo a seguir.

   aws iot set-v2-logging-level \
                 --log-target '{"targetType": "THING_GROUP","targetName": "thing_group_name"}' \
                 --log-level log_level

   --log-level

   O nível de registro em log usado ao gerar logs para o recurso especificado. Os valores válidos são: DEBUG, INFO, ERROR, WARN e DISABLED

   aws iot set-v2-logging-level \ 
                 --log-target targetType=CLIENT_ID,targetName=ClientId1 \
                 --log-level DEBUG

3. Use o comando list-v2-logging-levels para listar os níveis de registro em log configurados no momento.

   aws iot list-v2-logging-levels

4. Use o comando delete-v2-logging-level para excluir um nível de registro em log específico de recursos, conforme os exemplos seguintes.

   aws iot delete-v2-logging-level \
                 --target-type "THING_GROUP" \
                 --target-name "thing_group_name"

   aws iot delete-v2-logging-level \
                 --target-type=CLIENT_ID 
                 --target-name=ClientId1

   --targetType

   O valor target_type deve ser um dos seguintes: THING_GROUP | CLIENT_ID | SOURCE_IP |PRINCIPAL_ID.

   --targetName

   O nome do grupo de objetos do qual remover o nível de registro em log.