AWS IoT Analytics 신규 고객은 더 이상 사용할 수 없습니다. 의 기존 고객은 정상적으로 서비스를 계속 이용할 AWS IoT Analytics 수 있습니다. 자세히 알아보기

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

Amazon CloudWatch Events를 통해 지연 데이터 알림 받기

지정 기간 내의 데이터를 사용해 데이터 세트 콘텐츠를 생성할 때, 일부 데이터가 처리할 시간 내에 도착하지 않을 수도 있습니다. 지연을 허용하려면 queryAction(SQL 쿼리)를 적용하여 데이터 세트를 생성할 때 QueryFilter에 deltaTime 오프셋을 지정할 수 있습니다. AWS IoT Analytics는 여전히 델타 시간 내에 도착하는 데이터를 처리하며, 데이터 세트 콘텐츠에는 시간 지연이 있습니다. 지연 데이터 알림 기능을 사용하면 델타 시간 이후에 데이터가 도착할 때 AWS IoT Analytics가 Amazon CloudWatch Events를 통해 알림을 보낼 수 있습니다.

AWS IoT Analytics 콘솔, API, AWS Command Line Interface(AWS CLI) 또는 AWSSDK를 사용하여 데이터 세트에 대한 지연 데이터 규칙을 지정할 수 있습니다.

AWS IoT Analytics API에서 LateDataRuleConfiguration 객체는 데이터 세트의 지연 데이터 규칙 설정을 나타냅니다. 이 객체는 CreateDataset 및 UpdateDataset API 작업과 관련된 Dataset 객체에 포함되어 있습니다.

파라미터

AWS IoT Analytics을 사용하여 데이터 세트에 대해 지연 데이터 규칙을 생성할 때 다음 정보를 지정해야 합니다.

지연 데이터 규칙 구성(콘솔)

다음 절차는 AWS IoT Analytics 콘솔에서 데이터 세트의 지연 데이터 규칙을 구성하는 방법을 보여줍니다.

지연 데이터 규칙(CLI) 구성

AWS IoT Analytics API에서 LateDataRuleConfiguration 객체는 데이터 세트의 지연 데이터 규칙 설정을 나타냅니다. 이 객체는 CreateDataset 및 UpdateDataset와 연결된 Dataset 객체에 포함되어 있습니다. API, AWS CLI 또는 AWSSDK를 사용하여 데이터 세트에 대한 지연 데이터 규칙을 지정할 수 있습니다. 다음 예제에서는 AWS CLI를 사용합니다.

지정된 지연 데이터 규칙으로 데이터 세트를 생성하려면 다음 명령어를 실행합니다. 명령은 dataset.json 파일이 현재 디렉터리에 있다고 가정합니다.

aws iotanalytics create-dataset --cli-input-json file://dataset.json

dataset.json 파일에 다음을 포함해야 합니다.

{
    "datasetName": "demo_dataset",
    "actions": [
        {
            "actionName": "myDatasetAction",
            "queryAction": {
                "filters": [
                    {
                        "deltaTime": {
                            "offsetSeconds": -180,
                            "timeExpression": "from_unixtime(time)"
                        }
                    }
                ],
                "sqlQuery": "SELECT * FROM demo_datastore"
            }
        }
    ],
    "retentionPeriod": {
        "unlimited": false,
        "numberOfDays": 90
    },
    "lateDataRules": [
        {
            "ruleConfiguration": {
                "deltaTimeSessionWindowConfiguration": {
                    "timeoutInMinutes": timeout
                }
            },
            "ruleName": "demo_rule"
        }
    ]
}

지연 데이터 알림 수신 구독

AWS IoT Analytics에서 전송된 지연 데이터 알림을 처리하는 방법을 정의하는 규칙을 CloudWatch Events에서 만들 수 있습니다. CloudWatch Events는 알림을 수신하면 규칙에 정의된 지정된 대상 작업을 호출합니다.

CloudWatch Events 규칙 생성을 위한 사전 조건

AWS IoT Analytics에 대한 CloudWatch Events 규칙을 생성하기 전에 다음을 수행해야 합니다.

자세한 정보는 Amazon CloudWatch Events 사용 설명서의 Amazon CloudWatch Events란 무엇인가요? 및 Amazon CloudWatch Events 시작하기를 참조하세요.

지연 데이터 알림 이벤트

지연 데이터 알림 이벤트는 다음 형식을 사용합니다.

{
	"version": "0",
	"id": "7f51dfa7-ffef-97a5-c625-abddbac5eadd",
	"detail-type": "IoT Analytics Dataset Lifecycle Notification",
	"source": "aws.iotanalytics",
	"account": "123456789012",
	"time": "2020-05-14T02:38:46Z",
	"region": "us-east-2",
	"resources": ["arn:aws:iotanalytics:us-east-2:123456789012:dataset/demo_dataset"],
	"detail": {
		"event-detail-version": "1.0",
		"dataset-name": "demo_dataset",
		"late-data-rule-name": "demo_rule",
		"version-ids": ["78244852-8737-4650-aa4d-3071a01338fa"],
		"message": null
	}
}

지연 데이터 알림을 수신할 CloudWatch Events 규칙 생성

다음 절차에서는 Amazon SQS 대기열에 AWS IoT Analytics 지연 데이터 알림을 보내는 규칙을 생성하는 방법을 보여줍니다.