使用 AWS IoT 規則上傳裝置端日誌

開啟 AWS Management Console 並導覽至 CloudWatch。

在導覽列上，選擇 Logs (日誌)，然後選擇 Log groups (日誌群組)。

選擇 Create log group (建立日誌群組)。

更新 Log group name (日誌群組名稱)，並選擇性地更新 Retention settings (保留設定) 欄位。

選擇 Create (建立)。

若要建立日誌群組，請執行以下命令。如需詳細資訊，請參閱 AWS 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. 開啟 AWS Management Console 並導覽至 AWS IoT 。

2. 在導覽列上，選擇 Message routing (訊息路由)，然後選擇 Rules (規則)。

3. 選擇建立規則。

輸入規則屬性。

1. 輸入英數字元的 Rule name (規則名稱)。

2. (選擇性) 輸入 Rule description (規則描述) 和 Tags (標籤)。

3. 選擇 Next (下一步)。

輸入SQL陳述式。

1. 使用您為擷取定義的MQTT主題輸入SQL陳述式。

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

2. 選擇 Next (下一步)。

輸入規則動作。

1. 在動作 1 功能表中，選擇CloudWatch日誌。

2. 選擇 Log group name (日誌群組名稱)，然後選擇您建立的日誌群組。

3. 選取 Use batch mode (使用批次模式)。

4. 指定規則IAM的角色。

   如果您有規則IAM的角色，請執行下列動作。

   1. 在IAM角色功能表中，選擇您的IAM角色。

   如果您沒有規則IAM的角色，請執行下列動作。

   1. 選擇 Create new role (建立新角色)。

   2. 在 Role name (角色名稱) 中，輸入唯一的名稱，然後選擇 Create (建立)。

   3. 在IAM角色欄位中確認IAM角色名稱正確無誤。

5. 選擇 Next (下一步)。

檢閱範本組態。

1. 檢閱 Job 範本的設定，以確認其正確無誤。

2. 完成時，選擇 Create (建立)。

建立 IAM角色以授予 AWS IoT 規則的權限。

1. 建立 IAM 政策。

   若要建立IAM政策，請執行下列命令。請務必更新 policy-name 參數值。如需詳細資訊，請參閱 AWS 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 參數值。如需詳細資訊，請參閱 AWS 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 參數值。如需詳細資訊，請參閱 AWS 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 參數值。如需詳細資訊，請參閱 AWS 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": {}
       }
   }

在 中建立 AWS IoT 主題規則 AWS CLI。

1. 若要建立 AWS IoT 主題規則，請執行下列命令。請務必更新 --rule-name、sql 陳述式、description、roleARN 、和 logGroupName 參數值。如需詳細資訊，請參閱 AWS 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 參數值。如需詳細資訊，請參閱 AWS 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"
       }
   }