Aviso de fim do suporte: em 15 de dezembro de 2025, AWS encerrará o suporte para AWS IoT Analytics. Depois de 15 de dezembro de 2025, você não poderá mais acessar o AWS IoT Analytics console ou os AWS IoT Analytics recursos. Para obter mais informações, consulte AWS IoT Analytics Fim do suporte.
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á.
Monitoramento com Amazon CloudWatch Logs
AWS IoT Analytics suporta o registro na Amazon CloudWatch. Você pode ativar e configurar o CloudWatch registro na Amazon AWS IoT Analytics usando a operação de PutLoggingOptions
API. Esta seção descreve como você pode usar PutLoggingOptions
com AWS Identity and Access Management (IAM) para configurar e habilitar o Amazon CloudWatch Logging para AWS IoT Analytics.
Para obter mais informações sobre CloudWatch registros, consulte o Guia do usuário do Amazon CloudWatch Logs. Para obter mais informações sobre o AWS IAM, consulte o Guia AWS Identity and Access Management do usuário.
nota
Antes de ativar o AWS IoT Analytics registro, certifique-se de entender as permissões de acesso aos CloudWatch registros. Os usuários com acesso aos CloudWatch registros podem ver suas informações de depuração. Para obter mais informações, consulte Autenticação e controle de acesso para Amazon CloudWatch Logs.
Criar um perfil do IAM para ativar o registro em log
Para criar uma função do IAM para habilitar o registro na Amazon CloudWatch
-
Use o console AWS do IAM
ou o seguinte comando da CLI AWS do IAM, CreateRole, para criar uma nova função do IAM com uma política de relacionamento de confiança (política de confiança). A política de confiança concede permissão a uma entidade CloudWatch, como a Amazon, para assumir a função. aws iam create-role --role-name exampleRoleName --assume-role-policy-document exampleTrustPolicy.json
O arquivo
exampleTrustPolicy.json
contém o conteúdo a seguir.nota
Este exemplo inclui uma chave de contexto de condição global para proteger contra o problema de segurança substituto confuso.
123456789012
Substitua pelo ID da sua AWS conta eaws-region
pela AWS região dos seus AWS recursos. Para obter mais informações, consulte Prevenção contra o ataque do “substituto confuso” em todos os serviços.{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "iotanalytics.amazonaws.com" }, "Action": "sts:AssumeRole", "Condition": { "StringEquals": { "aws:SourceAccount": "
123456789012
" }, "ArnLike": { "aws:SourceArn": "arn:aws:iotanalytics:aws-region
:123456789012
:*" } } } ] }Você usa o ARN dessa função posteriormente ao chamar o AWS IoT Analytics
PutLoggingOptions
comando. -
Use o AWS IAM PutRolePolicypara anexar uma política de permissões (a
role policy
) à função que você criou na Etapa 1.aws iam put-role-policy --role-name exampleRoleName --policy-name examplePolicyName --policy-document exampleRolePolicy.json
O exampleRolePolicy arquivo.json contém o seguinte conteúdo.
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "logs:CreateLogGroup", "logs:CreateLogStream" ], "Resource": [ "arn:aws:logs:*:*:*" ] } ] }
-
Para dar AWS IoT Analytics permissão para colocar eventos de registro na Amazon CloudWatch, use o CloudWatch comando Amazon PutResourcePolicy.
nota
Para ajudar a evitar o problema de segurança substituto confuso, recomendamos que você especifique
aws:SourceArn
em sua política de recursos. Essa ação restringe o acesso para permitir somente as solicitações provenientes de uma conta específica. Para obter mais informações sobre o problema substituto confuso, consulte Prevenção contra o ataque do “substituto confuso” em todos os serviços.aws logs put-resource-policy --policy-in-json exampleResourcePolicy.json
O arquivo
exampleResourcePolicy.json
contém a seguinte política de recursos:{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "iotanalytics.amazonaws.com" }, "Action": "logs:PutLogEvents", "Resource": "*", "Condition":{ "ArnLike":{ "aws:SourceArn":"arn:aws:iotanalytics:
us-east-1
:123456789012
:*/*" }, "StringEquals":{ "aws:SourceAccount":"123456789012
" } } ] }
Configurar e habilitar o registro em log
Use o PutLoggingOptions
comando para configurar e ativar o CloudWatch registro na Amazon para AWS IoT Analytics. O roleArn
no campo loggingOptions
deve ser o ARN da função que você criou na seção anterior. Você também pode usar o comando DecribeLoggingOptions
para verificar as configurações das opções de registro em log.
PutLoggingOptions
Define ou atualiza as opções de AWS IoT Analytics registro. Se você atualizar o valor de qualquer campo loggingOptions
, levará até um minuto para ver a mudança entrar em vigor. Além disso, se você alterar a política anexada à função especificada no campo roleArn
(por exemplo, para corrigir uma política inválida) levará até 5 minutos para que a mudança entre em vigor. Para obter mais informações, consulte PutLoggingOptions
.
DescribeLoggingOptions
Recupera as configurações atuais das opções de AWS IoT Analytics registro. Para ter mais informações, consulte DescribeLoggingOptions
Namespaces, métricas e dimensões
AWS IoT Analytics coloca as seguintes métricas no CloudWatch repositório da Amazon:
Namespace |
---|
AWS/Io TAnalytics |
Métrica | Descrição |
---|---|
ActionExecution |
O número de ações executadas. |
ActionExecutionThrottled |
O número de ações que são limitadas. |
ActivityExecutionError |
O número de erros gerados ao executar a atividade do pipeline. |
IncomingMessages |
O número de mensagens recebidas no canal. |
PipelineConcurrentExecutionCount |
O número de atividades do pipeline que foram executadas simultaneamente. |
Dimensão | Descrição |
---|---|
ActionType |
O tipo de ação que está sendo monitorado. |
ChannelName |
O nome do canal que está sendo monitorado. |
DatasetName |
O nome do conjunto de dados que está sendo monitorado. |
DatastoreName |
O nome do datastore que está sendo monitorado. |
PipelineActivityName |
O nome da atividade do pipeline que está sendo monitorada. |
PipelineActivityType |
O tipo da atividade do pipeline que está sendo monitorada. |
PipelineName |
O nome do pipeline que está sendo monitorado. |