使用 Amazon IoT 规则上载设备端日志

打开 Amazon Web Services 管理控制台 并导航到 CloudWatch。

在导航栏上，选择 Logs（日志），然后选择 Log groups（日志组）。

选择创建日志组。

更新 Log group name（日志组名称），并可选择更新 Retention setting（保留设置）字段。

选择创建。

要创建日志组，请运行以下命令。有关更多信息，请参阅《Amazon CLI v2 命令参考》中的 create-log-group。

将示例中的日志组名称 (uploadLogsGroup) 替换为您首选的名称。

aws logs create-log-group --log-group-name uploadLogsGroup

要确认已正确创建日志组，请运行以下命令。

aws logs describe-log-groups --log-group-name-prefix uploadLogsGroup

示例输出：

{
    "logGroups": [
        {
            "logGroupName": "uploadLogsGroup",
            "creationTime": 1674521804657,
            "metricFilterCount": 0,
            "arn": "arn:aws:logs:us-east-1:111122223333:log-group:uploadLogsGroup:*",
            "storedBytes": 0
        }
    ]
}

打开规则中心。

1. 打开 Amazon Web Services 管理控制台 并导航到 Amazon IoT。

2. 在导航栏上，选择 Message routing（消息路由），然后选择 Rules（规则）。

3. 选择创建规则。

输入规则属性。

1. 输入由字母数字组成的 Rule name（规则名称）。

2. （可选）输入 Rule description（规则描述）和 Tags（标签）。

3. 选择下一步。

输入 SQL 语句。

1. 使用您为摄取定义的 MQTT 主题输入 SQL 语句。

   例如，SELECT * FROM '$aws/rules/things/thing_name/logs'

2. 选择下一步。

输入规则操作。

1. 在 Action 1（操作 1）菜单中，选择 CloudWatch logs（CloudWatch 日志）。

2. 选择 Log group name（日志组名称），然后选择您创建的日志组。

3. 选择 Use batch mode（使用批量模式）。

4. 为规则指定 IAM 角色。

   如果规则具有 IAM 角色，请执行以下操作。

   1. 在 IAM role（IAM 角色）菜单上，选择您的 IAM 角色。

   如果规则没有 IAM 角色，请执行以下操作。

   1. 选择 Create new role（创建新角色）。

   2. 对于 Role name（角色名称），输入唯一名称并选择 Create（创建）。

   3. 确认 IAM role（IAM 角色）字段中的 IAM 角色名称是否正确。

5. 选择下一步。

查看模板配置。

1. 查看任务模板的设置以验证它们正确无误。

2. 完成后，选择创建。

创建一个 IAM 角色，该角色授予对 Amazon IoT 规则的权限。

1. 创建一个 IAM 策略。

   要创建 IAM 策略，请运行以下命令。确保更新 policy-name 参数值。有关更多信息，请参阅《Amazon CLI v2 命令参考》中的 create-policy。

   注意

   如果您使用的是 Microsoft Windows 操作系统，则可能需要将行尾标记 (\) 替换为勾号 (`) 或其他字符。

   aws iam create-policy \
       --policy-name uploadLogsPolicy \
       --policy-document \
   '{
       "Version": "2012-10-17",		 	 	 
       "Statement": {
           "Effect": "Allow",
           "Action": [
               "iot:CreateTopicRule",
               "iot:Publish",
               "logs:CreateLogGroup",
               "logs:CreateLogStream",
               "logs:PutLogEvents",
               "logs:GetLogEvents"
           ],
           "Resource": "*"
       }
   }'

2. 将输出中的策略 ARN 复制到文本编辑器中。

   示例输出：

   {
       "Policy": {
           "PolicyName": "uploadLogsPolicy",
           "PermissionsBoundaryUsageCount": 0,
           "CreateDate": "2023-01-23T18:30:10Z",
           "AttachmentCount": 0,
           "IsAttachable": true,
           "PolicyId": "AAABBBCCCDDDEEEFFFGGG",
           "DefaultVersionId": "v1",
           "Path": "/",
           "Arn": "arn:aws:iam::111122223333:policy/uploadLogsPolicy",
           "UpdateDate": "2023-01-23T18:30:10Z"
       }
   }

3. 创建 IAM 角色和信任策略。

   要创建 IAM 策略，请运行以下命令。确保更新 role-name 参数值。有关更多信息，请参阅《Amazon CLI v2 命令参考》中的 create-role。

   aws iam create-role \
   --role-name uploadLogsRole \
   --assume-role-policy-document \
   '{
       "Version": "2012-10-17",		 	 	 
       "Statement": [
           {
               "Sid": "",
               "Effect": "Allow",
               "Principal": {
                   "Service": "iot.amazonaws.com"
               },
               "Action": "sts:AssumeRole"
           }
       ]
   }'
   

4. 向角色附加 IAM 策略。

   要创建 IAM 策略，请运行以下命令。确保更新 role-name 和 policy-arn 参数值。有关更多信息，请参阅《Amazon CLI v2 命令参考》中的 attach-role-policy。

   aws iam attach-role-policy \
   --role-name uploadLogsRole \
   --policy-arn arn:aws:iam::111122223333:policy/uploadLogsPolicy

5. 查看角色。

   要确认已正确创建 IAM 角色，请运行以下命令。确保更新 role-name 参数值。有关更多信息，请参阅《Amazon CLI v2 命令参考》中的 get-role。

   aws iam get-role --role-name uploadLogsRole

   示例输出：

   {
       "Role": {
           "Path": "/",
           "RoleName": "uploadLogsRole",
           "RoleId": "AAABBBCCCDDDEEEFFFGGG",
           "Arn": "arn:aws:iam::111122223333:role/uploadLogsRole",
           "CreateDate": "2023-01-23T19:17:15+00:00",
           "AssumeRolePolicyDocument": {
               "Version": "2012-10-17",		 	 	 
               "Statement": [
                   {
                       "Sid": "Statement1",
                       "Effect": "Allow",
                       "Principal": {
                           "Service": "iot.amazonaws.com"
                       },
                       "Action": "sts:AssumeRole"
                   }
               ]
           },
           "Description": "",
           "MaxSessionDuration": 3600,
           "RoleLastUsed": {}
       }
   }

在 Amazon CLI 中创建 Amazon IoT 主题规则。

1. 要创建 Amazon IoT 主题规则，请运行以下命令。确保更新 --rule-name、sql 语句、description、roleARN 和 logGroupName 参数值。有关更多信息，请参阅《Amazon CLI v2 命令参考》中的 create-topic-rule。

   aws iot create-topic-rule \
   --rule-name uploadLogsRule \
   --topic-rule-payload \
   	'{
   		"sql":"SELECT * FROM 'rules/things/thing_name/logs'",
   		"description":"Upload logs test rule",
   		"ruleDisabled":false,
   		"awsIotSqlVersion":"2016-03-23",
   		"actions":[
   			{"cloudwatchLogs":
   				{"roleArn":"arn:aws:iam::111122223333:role/uploadLogsRole",
   				"logGroupName":"uploadLogsGroup",
   				"batchMode":true}
   				}
   			]
   }'

2. 要确认已正确创建规则，请运行以下命令。确保更新 role-name 参数值。有关更多信息，请参阅《Amazon CLI v2 命令参考》中的 get-topic-rule。

   aws iot get-topic-rule --rule-name uploadLogsRule

   示例输出：

   {
       "ruleArn": "arn:aws:iot:us-east-1:111122223333:rule/uploadLogsRule",
       "rule": {
           "ruleName": "uploadLogsRule",
           "sql": "SELECT * FROM rules/things/thing_name/logs",
           "description": "Upload logs test rule",
           "createdAt": "2023-01-24T16:28:15+00:00",
           "actions": [
               {
                   "cloudwatchLogs": {
                       "roleArn": "arn:aws:iam::111122223333:role/uploadLogsRole",
                       "logGroupName": "uploadLogsGroup",
                       "batchMode": true
                   }
               }
           ],
           "ruleDisabled": false,
           "awsIotSqlVersion": "2016-03-23"
       }
   }