시작하기 자습서

다음 명령을 실행하여 플릿 인덱싱을 사용하도록 설정하고 검색할 데이터 원본을 지정합니다.

aws iot update-indexing-configuration \
--thing-indexing-configuration "thingIndexingMode=REGISTRY_AND_SHADOW,customFields=[{name=attributes.temperature,type=Number},{name=attributes.rackId,type=String},{name=attributes.stateNormal,type=Boolean}],thingConnectivityIndexingMode=STATUS" \

위의 CLI 명령 예시는 AWS_Things 인덱스를 사용하여 레지스트리 데이터, 섀도우 데이터 및 사물 연결 상태 검색을 지원하도록 플릿 인덱싱을 사용하도록 설정합니다.

구성 변경을 완료하는 데 몇 분 정도 걸릴 수 있습니다. 플릿 지표를 생성하기 전에 플릿 인덱싱이 사용하도록 설정되어 있는지 확인합니다.

플릿 인덱싱이 사용하도록 설정되었는지 확인하려면 다음 CLI 명령을 실행합니다.

aws --region us-east-1 iot describe-index --index-name "AWS_Things"

자세한 내용은 사물 인덱싱 사용을 참조하세요.

다음 bash 스크립트를 실행하여 10개의 사물을 생성하고 설명합니다.

# Bash script. Type `bash` before running in other shells.

Temperatures=(70 71 72 73 74 75 47 97 98 99)
Racks=(Rack1 Rack1 Rack2 Rack2 Rack3 Rack4 Rack5 Rack6 Rack6 Rack6)
IsNormal=(true true true true true true false false false false)

for ((i=0; i < 10; i++))
do
  thing=$(aws iot create-thing --thing-name "TempSensor$i" --attribute-payload attributes="{temperature=${Temperatures[@]:$i:1},rackId=${Racks[@]:$i:1},stateNormal=${IsNormal[@]:$i:1}}")
  aws iot describe-thing --thing-name "TempSensor$i"
done

이 스크립트는 10개의 센서를 나타내는 10개의 사물을 생성합니다. 각 사물에는 다음 표에 설명된 대로 temperature, rackId 및 stateNormal 속성이 있습니다.

이 스크립트의 출력에는 10개의 JSON 파일이 포함됩니다. JSON 파일 중 하나가 다음과 같습니다.

{
    "version": 1, 
    "thingName": "TempSensor0", 
    "defaultClientId": "TempSensor0", 
    "attributes": {
        "rackId": "Rack1", 
        "stateNormal": "true", 
        "temperature": "70"
    }, 
    "thingArn": "arn:aws:iot:region:account:thing/TempSensor0", 
    "thingId": "example-thing-id"
}

자세한 내용은 사물 생성을 참조하세요.

다음 명령을 실행하여 high_temp_FM이라는 플릿 지표를 생성합니다. CloudWatch에서 온도가 화씨 80도를 초과하는 센서 수를 모니터링하는 플릿 지표를 생성합니다.

aws iot create-fleet-metric --metric-name "high_temp_FM" --query-string "thingName:TempSensor* AND attributes.temperature >80" --period 60 --aggregation-field "attributes.temperature" --aggregation-type name=Statistics,values=count

--metric-name

데이터 형식: 문자열. --metric-name 파라미터는 플릿 지표 이름을 지정합니다. 이 예에서는 high_temp_FM이라는 플릿 지표를 생성하고 있습니다.

--query-string

데이터 형식: 문자열. --query-string 파라미터는 쿼리 문자열을 지정합니다. 이 예에서 쿼리 문자열은 이름이 TempSensor로 시작하고 온도가 화씨 80도 이상인 모든 사물을 쿼리하는 것을 의미합니다. 자세한 내용은 쿼리 구문을 참조하세요.

--period

데이터 형식: 정수. --period 파라미터는 집계된 데이터를 검색하는 시간을 초 단위로 지정합니다. 이 예에서는 생성 중인 플릿 지표가 60초마다 집계된 데이터를 검색하도록 지정합니다.

--aggregation-field

데이터 형식: 문자열. --aggregation-field 파라미터는 평가할 속성을 지정합니다. 이 예에서는 온도 속성을 평가해야 합니다.

--aggregation-type

--aggregation-type 파라미터는 플릿 지표에 표시할 통계 요약을 지정합니다. 모니터링 태스크의 경우 다양한 집계 유형(통계(Statistics), 카디널리티(Cardinality) 및 백분위 수(Percentile)의 집계 쿼리 속성을 사용자 지정할 수 있습니다. 이 예에서 집계 유형과 통계에 대해 개수를 지정하여 쿼리와 일치하는 속성이 있는 디바이스 수를 반환합니다. 즉, 이름이 TempSensor로 시작하고 온도가 화씨 80도 이상인 디바이스 수를 반환합니다. 자세한 내용은 집계 데이터 쿼리를 참조하세요.

이 명령의 출력은 다음과 같습니다.

{
    "metricArn": "arn:aws:iot:region:111122223333:fleetmetric/high_temp_FM", 
    "metricName": "high_temp_FM"
}

플릿 지표를 생성하는 방법에 대해 자세히 알아보려면 플릿 지표 관리를 참조하세요.

플릿 지표를 생성할 수 없는 경우 플릿 지표 문제 해결을 참조하세요.

(선택 사항) 다음 명령을 실행하여 high_temp_FM이라는 플릿 지표를 설명합니다.

aws iot describe-fleet-metric --metric-name "high_temp_FM"

이 명령의 출력은 다음과 같습니다.

{
    "queryVersion": "2017-09-30", 
    "lastModifiedDate": 1625249775.834, 
    "queryString": "*", 
    "period": 60, 
    "metricArn": "arn:aws:iot:region:111122223333:fleetmetric/high_temp_FM", 
    "aggregationField": "registry.version", 
    "version": 1, 
    "aggregationType": {
        "values": [
            "count"
        ], 
        "name": "Statistics"
    }, 
    "indexName": "AWS_Things", 
    "creationDate": 1625249775.834, 
    "metricName": "high_temp_FM"
}

https://console.aws.amazon.com/cloudwatch/에서 CloudWatch 콘솔을 엽니다.

왼쪽 패널의 CloudWatch 메뉴에서 지표를 선택하여 하위 메뉴를 확장한 다음 모든 지표를 선택합니다. 이렇게 하면 위쪽 절반에 그래프가 표시되고 아래쪽 절반에 4개의 탭 섹션이 있는 페이지가 열립니다.

첫 번째 탭 섹션인 모든 지표에는 그룹에서 볼 수 있는 모든 지표가 나열됩니다. IoTFleetMetrics를 선택합니다. 여기에는 모든 플릿 지표가 포함됩니다.

모든 지표(All metrics) 탭의 집계 유형(Aggregation type) 섹션에서 집계 유형(Aggregation type)을 선택하여 생성한 모든 플릿 지표를 확인합니다.

플릿 지표를 선택하여 집계 유형(Aggregation type) 섹션 왼쪽에 그래프를 표시합니다. 지표 이름 왼쪽에 값 개수 값이 표시되며 이는 이 자습서의 플릿 지표 생성 섹션에서 지정한 집계 유형의 값입니다.

모든 지표(All metrics) 탭의 오른쪽에 있는 그래프로 표시된 지표(Graphed metrics)라는 두 번째 탭을 선택하여 이전 단계에서 선택한 플릿 지표를 확인합니다.

다음과 같이 화씨 80도보다 높은 온도의 센서 수를 표시하는 그래프를 볼 수 있어야 합니다.

(선택 사항) 지표 경보를 설정할 수 있습니다.