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á.
Configurar o AWS IoT registro
Você deve habilitar o registro usando o AWS IoT CLI console ou API antes de poder monitorar e registrar AWS IoT atividades.
Você pode ativar o registro em todos os grupos de coisas AWS IoT ou somente em grupos específicos. Você pode configurar o AWS IoT registro usando o AWS IoT console,CLI, ouAPI; no entanto, você deve usar o CLI ou API para configurar o registro para grupos de coisas específicos.
Ao considerar como configurar seu AWS IoT registro, a configuração de registro padrão determina como a AWS IoT atividade será registrada, a menos que especificado de outra forma. No começo, talvez você queira obter logs detalhados com um nível de log padrão de INFO
ou DEBUG
. Depois que analisar os logs iniciais, você poderá alterar o nível de log padrão para um nível menos detalhado, como WARN
ou ERROR
e definir um nível de log mais detalhado específico do recursos em recursos que possam precisar de mais atenção. É possível alterar os níveis de log sempre que quiser.
Este tópico aborda o login na nuvem. AWS IoT Para obter informações sobre registro e monitoramento do lado do dispositivo, consulte Carregar registros do lado do dispositivo para. CloudWatch
Para obter informações sobre registro e monitoramento AWS IoT Greengrass, consulte Registro e monitoramento em AWS IoT Greengrass. Em 30 de junho de 2023, o software AWS IoT Greengrass Core migrou para o. AWS IoT Greengrass Version 2
Configurar a função e a política de registro em log
Antes de habilitar o login AWS IoT, você deve criar uma IAM função e uma política que dê AWS permissão para monitorar a AWS IoT atividade em seu nome. Você também pode gerar uma IAM função com as políticas necessárias na seção Registros do AWS IoT
console
nota
Antes de ativar o AWS IoT registro, certifique-se de entender as permissões de acesso aos CloudWatch registros. Os usuários com acesso aos CloudWatch registros podem ver as informações de depuração dos seus dispositivos. Para obter mais informações, consulte Autenticação e controle de acesso para Amazon CloudWatch Logs.
Se você espera altos padrões de tráfego AWS IoT Core devido ao teste de carga, considere desativar o registro de IoT para evitar a limitação. Se for detectado tráfego intenso, nosso serviço poderá desativar o registro em log em sua conta.
Veja a seguir como criar uma função de registro e uma política para AWS IoT Core recursos.
Criar uma função de registro em log
Para criar uma função de registro, abra o hub IAM Roles do console
-
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.
-
Na página Adicionar permissões, você verá as políticas que são automaticamente anexadas ao perfil de serviço. Escolha Próximo.
-
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.
-
Na lista de Funções, localize a função que você criou, abra-a e copie a Função ARN (
logging-role-arn
) para usar quando vocêConfigurar o registro em log padrão no AWS IoT (console).
Política de função de registro em log
Os documentos de política a seguir fornecem a política de função e a política de confiança que AWS IoT permitem enviar entradas de registro CloudWatch em seu nome. Se você também permitiu LoRa WAN o envio AWS IoT Core de entradas de registro, verá um documento de política criado para você que registra as duas atividades.
nota
Esses documentos foram criados para você quando você criou a função de registro em log. Os documentos têm variáveis, $ {partição}
,
e $ {região}
, que você deve substituir por seus valores.${accountId}
Política da função:
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "logs:CreateLogGroup", "logs:CreateLogStream", "logs:PutLogEvents", "logs:PutMetricFilter", "logs:PutRetentionPolicy", "iot:GetLoggingOptions", "iot:SetLoggingOptions", "iot:SetV2LoggingOptions", "iot:GetV2LoggingOptions", "iot:SetV2LoggingLevel", "iot:ListV2LoggingLevels", "iot:DeleteV2LoggingLevel" ], "Resource": [ "arn:${partition}:logs:${region}:${accountId}:log-group:AWSIotLogsV2:*" ] } ] }
Política de confiança para registrar somente AWS IoT Core atividades:
{ "Version": "2012-10-17", "Statement": [ { "Sid": "", "Effect": "Allow", "Principal": { "Service": "iot.amazonaws.com" }, "Action": "sts:AssumeRole" } ] }
Configurar o registro em log padrão no AWS IoT (console)
Esta seção descreve como usar o AWS IoT console para configurar o registro em log para todos os AWS IoT. Para configurar o registro somente para grupos de coisas específicos, você deve usar o CLI ouAPI. Para obter informações sobre como configurar o registro em log para grupos de objetos específicos, consulte Configurar login específico do recurso () AWS IoT CLI.
Para usar o AWS IoT console para configurar o registro padrão para todos os AWS IoT
-
Faça login no AWS IoT console. Para obter mais informações, consulte Abra o AWS IoT console.
-
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.
-
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.
-
Escolha o nível de registro que descreve o nível de detalhe das entradas de registro que você deseja que apareçam nos CloudWatch registros.
-
Escolha Atualizar para salvar suas alterações.
Depois que habilitar o registro em log, acesse Visualizando AWS IoT registros no CloudWatch console para saber mais sobre como visualizar as entradas de log.
Configurar o login padrão AWS IoT (CLI)
Esta seção descreve como configurar o registro global AWS IoT usando CLI o.
nota
Você precisa do Amazon Resource Name (ARN) da função que deseja usar. Se você precisar criar uma função a ser usada para o registro em log, consulte Criar uma função de registro em log antes de continuar.
O principal costumava chamar o API must have Transmitir permissões de função para sua função de registro.
Você também pode realizar esse procedimento com o API usando os métodos no AWS API que correspondem aos CLI comandos mostrados aqui.
Para usar o CLI para configurar o registro padrão para AWS IoT
-
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-levellog-level
onde:
- --role-arn
-
A função ARN que concede AWS IoT permissão para gravar em seus registros no CloudWatch Logs.
- --default-log-level
-
O nível de log a ser usado. Os valores válidos são
ERROR
,WARN
,INFO
,DEBUG
ouDISABLED
. - --no-disable-all-logs
-
Um parâmetro opcional que ativa 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.
-
Use o comando get-v2-logging-options
para obter as opções de registro em log atuais. aws iot get-v2-logging-options
Depois que habilitar o registro em log, acesse Visualizando AWS IoT registros no CloudWatch console para saber mais sobre como visualizar as entradas de log.
nota
AWS IoT continua oferecendo suporte a comandos mais antigos (set-logging-optionseget-logging-options) para definir e obter o registro global em sua conta. Lembre-se de que, quando esses comandos são usados, os registros resultantes contêm texto simples, em vez de JSON cargas, e a latência de registro geralmente é maior. Não haverá mais melhorias à implementação desses comandos mais antigos. Recomendamos que você use a versão "v2" para configurar suas opções de registro em log e, quando possível, altere quaisquer aplicativos legados que usam as versões mais antigas.
Configurar login específico do recurso () AWS IoT CLI
Esta seção descreve como configurar o registro em log específico do recurso usando AWS IoT o. CLI O registro em log de recursos específicos permite que você especifique um nível de log para um grupo de objetos específico.
Grupos de objetos podem conter outros grupos de objetos para criar um relacionamento hierárquico. Este procedimento descreve como configurar o registro em log de um único grupo de objetos. É possível aplicar esse procedimento ao grupo de objetos pai em uma hierarquia para configurar o registro em log para todos os grupos de objetos na hierarquia. Também é possível aplicar esse procedimento a um grupo de objetos filho para substituir a configuração de registro em log do grupo pai.
Além dos grupos de objetos, você também pode registrar destinos como o ID do cliente, o IP de origem e o ID principal do dispositivo.
nota
Você precisa do Amazon Resource Name (ARN) da função que deseja usar. Se você precisar criar uma função a ser usada para o registro em log, consulte Criar uma função de registro em log antes de continuar.
O principal costumava chamar o API must have Transmitir permissões de função para sua função de registro.
Você também pode realizar esse procedimento com o API usando os métodos no AWS API que correspondem aos CLI comandos mostrados aqui.
Para usar o CLI para configurar o registro específico de recursos para AWS IoT
-
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-levellog-level
onde:
- --role-arn
-
A função ARN que concede AWS IoT permissão para gravar em seus registros no CloudWatch Logs.
- --default-log-level
-
O nível de log a ser usado. Os valores válidos são
ERROR
,WARN
,INFO
,DEBUG
ouDISABLED
. - --no-disable-all-logs
-
Um parâmetro opcional que ativa 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.
-
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-levellog_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 log-target pode ser texto, conforme mostrado no exemplo de comando anterior, ou uma JSON string, como no exemplo a seguir.aws iot set-v2-logging-level \ --log-target '{"targetType": "THING_GROUP","targetName": "
thing_group_name
"}' \ --log-levellog_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-levelDEBUG
-
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
-
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.
Depois que habilitar o registro em log, acesse Visualizando AWS IoT registros no CloudWatch console para saber mais sobre como visualizar as entradas de log.
Níveis de log
Esses níveis de log determinam os eventos que são registrados em log e se aplicam aos níveis de log padrão e de recursos específicos.
- ERROR
-
Qualquer erro que cause a falha de uma operação.
Os registros incluem somente ERROR informações.
- WARN
-
Tudo que possa causar inconsistências no sistema, mas que não cause falha na operação.
Os registros incluem ERROR WARN informações.
- INFO
-
Informações de alto nível sobre o fluxo das objetos.
Os registros incluem INFOERROR, e WARN informações.
- DEBUG
-
Informações que podem ser úteis ao depurar um problema.
Os registros incluem DEBUGINFO,ERROR, e WARN informações.
- DISABLED
-
Todos os registros são desativados.