Configurar o AWS IoT registro

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 você não vir a opção IoT, entre e pesquise IoT no menu suspenso Casos de uso para outros serviços da AWS :. 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.

Para configurar o AWS IoT registro:

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

2. No painel de navegação esquerdo, escolha Registros (anteriormente uma seção em Configurações).

3. Configure o registro em nível de conta: o registro em nível de conta se aplica a toda a sua AWS IoT frota (dispositivos ou endpoints), a menos que seja substituído por configurações específicas de recursos ou de nível de evento.

   1. Em Registro em nível de conta, selecione Gerenciar registro em nível de conta para fazer atualizações.

   2. Marque a caixa de seleção “Ativar registro” para começar a enviar registros para CloudWatch. Quando a opção “Ativar registro” estiver desmarcada, não AWS IoT enviará nenhum CloudWatch registro para grupos de registros, independentemente das configurações de registro em nível de evento ou em nível de recurso.

   3. Em Função de log do IAM, selecione uma função existente na lista suspensa. Você pode ver os detalhes da função para inspecionar as permissões da função. Como alternativa, selecione Criar nova função para configurar uma nova função do IAM. A função de registro fornece políticas que AWS IoT permitem enviar entradas de registro CloudWatch em seu nome. Se você configurar o registro em nível de evento com um grupo de CloudWatch registros personalizado, deverá atualizar a política de função para incluir o ARN desse grupo de registros.

   4. Escolha o nível de registro padrão que corresponde ao nível de detalhe das entradas de registro que você deseja que apareçam nos CloudWatch registros. Nota: O nível de registro “DEBUG” fornece mais detalhes, mas aumenta CloudWatch os custos. CloudWatch os destinos do grupo de registros não podem ser configurados no nível da conta. No entanto, você pode especificar grupos de registros personalizados para tipos de eventos individuais, conforme descrito na seção a seguir.

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

4. O registro em nível de evento permite que você capture seletivamente registros de eventos relevantes e os direcione para grupos de registros dedicados CloudWatch . Isso lhe dá a flexibilidade de organizar registros por casos de uso para melhor visibilidade, compartilhá-los com diferentes públicos e reduzir CloudWatch custos ativando registros e definindo níveis de registro com base na criticidade do evento.

   Configurar o registro em nível de evento: o registro em nível de evento captura AWS IoT eventos específicos, como tentativas de autenticação do cliente. Essas configurações substituem o registro em nível de conta.

   1. Na seção Registro em nível de evento, selecione Gerenciar registro em nível de evento para fazer atualizações.

   2. Por padrão, os tipos de eventos herdam a configuração de registro em nível de conta. Observação: quando o registro específico do recurso é configurado, ele substitui as configurações em nível de conta e evento.

   3. Para modificar as configurações de eventos individuais, clique no valor na linha de eventos correspondente. Você pode ajustar o nível de registro e o destino do grupo de CloudWatch registros. Ao especificar um destino de grupo de CloudWatch registros personalizado, você deve verificar se a política de função do IAM inclui permissões para o novo grupo de registros. A falha na atualização da política de funções AWS IoT impedirá a gravação de registros no grupo de registros personalizados. Depois de fazer sua seleção, clique na marca de seleção para confirmar sua escolha. A coluna “Foi modificado” exibirá “Sim” para indicar alterações pendentes.

   4. Clique em Atualizar registro para aplicar suas alterações ou escolha Cancelar para descartar.

5. Configurar substituições específicas de recursos: as substituições específicas de recursos aplicam uma configuração de registro aos recursos selecionados. Um recurso pode ser um grupo de coisas, IP de origem, ID do cliente ou ID principal. A configuração de registro específica do recurso substitui as configurações no nível da conta e no nível do evento. Quando ativado, ele gera registros para todos os tipos de eventos no nível de registro configurado para os recursos especificados. Por exemplo, você pode definir o registro em nível de depuração para uma coisa específica e, ao mesmo tempo, manter o registro em nível de informação para todas as outras coisas.

   1. Selecione Adicionar substituições específicas de recursos na seção Substituições específicas de recursos.

   2. Escolha um destino de registro: Thing group, Source IP, Client ID ou Principal ID.

   3. Insira o valor alvo de log correspondente para o tipo de alvo selecionado.

   4. Selecione o nível de registro desejado no menu suspenso na seção Nível de registro específico do recurso.

   5. Clique em Enviar para adicionar a substituição ou em Cancelar para descartar as alterações.

   6. Para modificar uma substituição específica de um recurso existente, marque a caixa de seleção ao lado do recurso e clique em “Remover” para excluir a substituição ou em “Editar” para modificar.

Para usar a CLI para configurar o registro padrão para 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 \
       --event-configurations event-configuration-list \
       --role-arn logging-role-arn \
       --default-log-level log-level

   em que:

   --role-arn

   O ARN da função que concede AWS IoT permissão para gravar em seus registros em CloudWatch Logs. A configuração do Role-ARN é necessária para a configuração inicial.

   --default-log-level

   O nível de log a ser usado. Os valores válidos são: ERRORWARN,INFO,DEBUG, ouDISABLED. Default-log-levela configuração é necessária para a configuração inicial.

   --no-disable-all-logs

   Um parâmetro opcional que habilita todo o AWS IoT registro. 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 todo o AWS IoT registro. Use esse parâmetro para desabilitar o registro em log se ele estiver habilitado no momento.

   --event-configurations

   Esse parâmetro é opcional e permite que você personalize as configurações de registro para tipos de eventos individuais:

   • EventType: o tipo de evento que substitui a configuração no nível da conta

   • LogLevel: substitua a configuração no nível da conta por DEBUG, INFO, ERROR, WARN ou DISABLED

   • LogDestination: especifique um grupo de CloudWatch registros personalizado para entrega de registros

   Você pode configurar o nível e o destino do registro de forma independente para cada tipo de evento. Se não forem especificados, os eventos herdarão as configurações no nível da conta

   aws iot set-v2-logging-options \
       --event-configurations "[{\"eventType\":\"Publish-In\",\"logLevel\":\"INFO\",\"logDestination\":\"examplePublishInLogGroup\"}]"

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

   aws iot get-v2-logging-options \
       --verbose

   em que:

   --verbose

   Um parâmetro opcional que permite recuperar todos os tipos de eventos e suas configurações.

Para usar a CLI para configurar substituições específicas de recursos para AWS IoT

1. Ative o registro em nível de conta antes de configurar o registro específico do recurso usando o seguinte comando: comando aws iot set-v2-logging-options

2. Use o set-v2-logging-levelcomando para configurar substituições específicas de recursos. Veja o exemplo a seguir para configuração de grupos de coisas:

   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 targetType 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.

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

   --target-type

   O valor target-type deve ser um dos seguintes: THING_GROUP | CLIENT_ID | SOURCE_IP |PRINCIPAL_ID.

   --target-name

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