CloudWatch Logs - AWS IoT Core
요구 사항batchMode에 대한 MQTT 메시지 형식 요구 사항파라미터예시다음 사항도 참조하세요.

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

CloudWatch Logs

CloudWatch Logs(cloudwatchLogs) 작업은 데이터를 Amazon CloudWatch Logs에 전송합니다. batchMode를 사용하여 하나의 메시지에 여러 디바이스 로그 레코드를 업로드하고 타임스탬프를 지정할 수 있습니다. 작업에서 데이터를 전송할 로그 그룹을 지정할 수도 있습니다.

요구 사항

이 규칙 작업은 다음 요구 사항을 충족해야 합니다.

  • 가 logs:CreateLogStream, logs:DescribeLogStreams및 logs:PutLogEvents 작업을 수행하기 위해 수임할 AWS IoT 수 있는 IAM 역할입니다. 자세한 내용은 AWS IoT 규칙에 필요한 액세스 권한 부여 단원을 참조하십시오.

    AWS IoT 콘솔에서가이 규칙 작업을 수행하도록 허용하는 역할을 선택하거나 생성할 수 AWS IoT 있습니다.

  • 고객 관리형 AWS KMS key (KMS 키)를 사용하여 CloudWatch Logs에서 로그 데이터를 암호화하는 경우 호출자를 대신하여 KMS 키를 사용할 수 있는 권한이 서비스에 있어야 합니다. 자세한 내용은 Amazon CloudWatch Logs 사용 설명서의 AWS KMS를 사용하여 CloudWatch Logs에서 로그 데이터 암호화를 참조하세요.

batchMode에 대한 MQTT 메시지 형식 요구 사항

batchMode를 끄고 CloudWatch Logs 규칙 작업을 사용하는 경우 MQTT 메시지 형식 지정 요구 사항이 없습니다. (참고: batchMode 파라미터의 기본값은 false입니다.) 그러나 batchMode가 켜진 상태에서 CloudWatch Logs 규칙 작업을 사용하는 경우(파라미터 값은 true), 디바이스 측 로그를 포함하는 MQTT 메시지는 타임스탬프와 메시지 페이로드를 포함하도록 형식을 지정해야 합니다. 참고: timestamp는 이벤트가 발생한 시간을 나타내며, 1970년 1월 1일 00:00:00 UTC 이후 경과된 밀리초 수로 표시됩니다.

다음은 게시 형식의 예입니다.

[
  {"timestamp": 1673520691093, "message": "Test message 1"}, 
  {"timestamp": 1673520692879, "message": "Test message 2"}, 
  {"timestamp": 1673520693442, "message": "Test message 3"}
]

이 요구 사항을 준수하려면 기기 측 로그가 생성되는 방식에 따라 로그를 전송하기 전에 해당 로그를 필터링하고 형식을 다시 지정해야 할 수 있습니다. 자세한 내용은 MQTT 메시지 페이로드를 참조하세요.

batchMode 파라미터와 관계없이 message 콘텐츠는 AWS IoT 메시지 크기 제한을 준수해야 합니다. 자세한 내용은 AWS IoT Core 엔드포인트 및 할당량을 참조하세요.

파라미터

이 작업으로 AWS IoT 규칙을 생성할 때 다음 정보를 지정해야 합니다.

logGroupName

작업에서 데이터를 전송할 CloudWatch 로그 그룹입니다.

대체 템플릿 지원: API 및 AWS CLI 만 해당

roleArn

CloudWatch 로그 그룹에 대한 액세스를 허용하는 IAM 역할입니다. 자세한 내용은 요구 사항 단원을 참조하세요.

대체 템플릿 지원: 아니오

(선택 사항) batchMode

로그 레코드 배치를 추출하여 CloudWatch에 업로드할지 여부를 나타냅니다. 값에는 true 또는 false(기본값)가 포함됩니다. 자세한 내용은 요구 사항 단원을 참조하십시오.

대체 템플릿 지원: 아니오

예시

다음 JSON 예제에서는 AWS IoT 규칙에서 CloudWatch Logs 작업을 정의합니다.

{
    "topicRulePayload": {
        "sql": "SELECT * FROM 'some/topic'", 
        "ruleDisabled": false, 
        "awsIotSqlVersion": "2016-03-23",
        "actions": [
            {
                "cloudwatchLogs": {
                    "logGroupName": "IotLogs",
                    "roleArn": "arn:aws:iam::123456789012:role/aws_iot_cw",
                    "batchMode": false                    
                }
            }
        ]
    }
}

다음 사항도 참조하세요.