메시지 보강을 위한 전파 속성 추가 - AWS IoT Core
AWS Management 콘솔AWS CLI

메시지 보강을 위한 전파 속성 추가

AWS IoT Core에서는 사물 속성 또는 연결 세부 정보의 컨텍스트 메타데이터인 전파 속성을 추가하여 디바이스의 MQTT 메시지를 보강할 수 있습니다. 메시지 보강이라고 하는 이 프로세스는 다양한 시나리오에서 유용할 수 있습니다. 예를 들어, 디바이스 측을 변경하거나 규칙을 사용하지 않고도 모든 인바운드 게시 작업의 메시지를 보강할 수 있습니다. 전파 속성을 활용하면 복잡하게 규칙을 구성하거나 재게시 구성을 관리하지 않고도 더 효율적이고 비용 효율적인 방법으로 IoT 데이터를 보강할 수 있습니다.

메시지 보강 기능은 기본 수집 및 메시지 브로커를 사용하는 AWS IoT Core 고객이 사용할 수 있습니다. 디바이스를 게시할 때 모든 MQTT 버전을 사용할 수 있지만, 구독자(메시지를 사용하는 애플리케이션 또는 서비스)는 전파 속성으로 보강된 메시지를 수신하려면 MQTT 5를 지원해야 합니다. 보강된 메시지는 디바이스에서 게시된 모든 메시지에 MQTT 5 사용자 속성으로 추가됩니다. 규칙을 사용하는 경우, get_user_properties 함수를 활용하여, 데이터를 기반으로 메시지 라우팅 또는 처리를 위해 보강된 데이터를 검색할 수 있습니다.

AWS IoT Core에서 AWS Management 콘솔 또는 AWS CLI를 사용하여 사물 유형을 생성하거나 업데이트할 때 전파 속성을 추가할 수 있습니다.

중요

전파 속성을 추가할 때, 메시지를 게시하는 클라이언트가 인증서로 인증되었는지 확인해야 합니다. 자세한 내용은 클라이언트 인증 섹션을 참조하세요.

참고

콘솔 내에서 MQTT 테스트 클라이언트를 사용하여 이 기능을 테스트하려고 할 경우, 이 기능을 사용하기 위해서는 연결된 인증서로 인증된 MQTT 클라이언트가 필요하므로 해당 기능이 작동하지 않을 수 있습니다.

AWS Management 콘솔

AWS Management 콘솔을 사용하여 메시지 보강에 대한 전파 속성을 추가하려면

  1. AWS IoT 콘솔에서 AWS IoT 홈 페이지를 엽니다. 왼쪽 탐색 창의 관리에서 모든 디바이스를 선택합니다. 그 다음에 사물 유형을 선택합니다.

  2. 사물 유형 페이지에서 사물 유형 생성을 선택합니다.

    사물 유형을 업데이트하여 메시지 보강을 구성하려면, 사물 유형을 선택합니다. 그 다음에 사물 유형 세부 정보 페이지에서 업데이트를 선택합니다.

  3. 사물 유형 생성 페이지의 사물 유형 속성에서 사물 유형 정보를 선택하거나 입력합니다.

    사물 유형을 업데이트하도록 선택하면, 이전 단계에서 업데이트를 선택한 후에 사물 유형 속성이 표시됩니다.

  4. 추가 구성에서 전파 속성을 펼칩니다. 그 다음에 사물 속성을 선택하고, 게시된 MQTT5 메시지에 채우고자 하는 사물 속성을 입력합니다. 콘솔을 사용하여, 최대 3개의 사물 속성을 추가할 수 있습니다.

    전파 속성 섹션에서 연결 속성을 선택하고, 속성 유형을 입력합니다. 속성 이름은 선택 입력 사항입니다.

  5. 원한다면, 태그를 추가합니다. 그 다음에 사물 유형 생성을 선택합니다.

    사물 유형을 업데이트하도록 선택한 경우, 사물 유형 업데이트를 선택합니다.

AWS CLI

  1. AWS CLI로 새 사물 유형을 생성하여 메시지 보강을 위한 전파 속성을 추가하려면, create-thing-type 명령을 실행합니다. 예제 명령은 다음과 같을 수 있습니다.

    aws iot create-thing-type \
    --thing-type-name "LightBulb" \
    --thing-type-properties "{\"mqtt5Configuration\":{\"propagatingAttributes\":[{\"userPropertyKey\":\"iot:ClientId\", \"connectionAttribute\":\"iot:ClientId\"}, {\"userPropertyKey\":\"test\", \"thingAttribute\":\"A\"}]}}" \

    명령의 출력은 다음과 같을 수 있습니다.

    {
	"thingTypeName": "LightBulb",
	"thingTypeArn": "arn:aws:iot:us-west-2:123456789012:thingtype/LightBulb",
	"thingTypeId": "ce3573b0-0a3c-45a7-ac93-4e0ce14cd190"
}

  2. AWS CLI로 사물 유형을 업데이트하여 메시지 보강을 구성하려면, update-thing-type 명령을 실행합니다. 단, 이 명령을 실행할 때 mqtt5Configuration만 업데이트할 수 있습니다. 예제 명령은 다음과 같을 수 있습니다.

    aws iot update-thing-type \
    --thing-type-name "MyThingType" \
    --thing-type-properties "{\"mqtt5Configuration\":{\"propagatingAttributes\":[{\"userPropertyKey\":\"iot:ClientId\", \"connectionAttribute\":\"iot:ClientId\"}, {\"userPropertyKey\":\"test\", \"thingAttribute\":\"A\"}]}}" \

    이 명령은 출력을 생성하지 않습니다.

  3. 사물 유형을 설명하려면 describe-thing-type 명령을 실행합니다. 이 명령은 thing-type-properties 필드에 메시지 보강 구성 정보가 포함된 출력을 생성합니다. 예제 명령은 다음과 같을 수 있습니다.

    aws iot describe-thing-type \
    --thing-type-name "LightBulb"

    출력은 다음과 같습니다.

    {
	"thingTypeName": "LightBulb",
	"thingTypeId": "bdf72512-0116-4392-8d79-bf39b17ef73d",
	"thingTypeArn": "arn:aws:iot:us-east-1:123456789012:thingtype/LightBulb",
	"thingTypeProperties": {
		"mqtt5Configuration": {
			"propagatingAttributes": [
				{
					"userPropertyKey": "iot:ClientId",
					"connectionAttribute": "iot:ClientId"
				},
				{
					"userPropertyKey": "test",
					"thingAttribute": "attribute"
				}
			]
		}
	},
	"thingTypeMetadata": {
		"deprecated": false,
		"creationDate": "2024-10-18T17:37:46.656000+00:00"
	}
}

자세한 내용은 사물 유형 섹션을 참조하세요.