플릿 지표 관리 - AWS IoT Core
플릿 지표 관리(콘솔)플릿 지표 관리(CLI)IoT 리소스의 태깅 권한 부여

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

플릿 지표 관리

이 주제에서는 AWS IoT 콘솔을 사용하고 플릿 지표를 관리하는 AWS CLI 방법을 보여줍니다.

플릿 지표 관리(콘솔)

다음 섹션에서는 AWS IoT 콘솔을 사용하여 플릿 지표를 관리하는 방법을 보여줍니다. 플릿 지표를 생성하기 전에 연결된 데이터 원본 및 구성으로 플릿 인덱싱을 사용하도록 설정했는지 확인합니다.

플릿 인덱싱 사용 설정

플릿 인덱싱을 이미 사용하도록 설정한 경우 이 섹션을 건너뜁니다.

플릿 인덱싱을 사용하도록 설정하지 않은 경우 다음 지침을 따릅니다.

  1. https://console.aws.amazon.com/iot/ 에서 AWS IoT 콘솔을 엽니다.

  2. AWS IoT 메뉴에서 설정을 선택합니다.

  3. 자세한 설정을 보려면 설정(Settings) 페이지에서 플릿 인덱싱(Fleet indexing) 섹션까지 아래로 스크롤합니다.

  4. 플릿 인덱싱 설정을 업데이트하려면 플릿 인덱싱(Fleet indexing) 섹션 오른쪽에서 인덱싱 관리(Manage indexing)를 선택합니다.

  5. 플릿 인덱싱 관리(Manage fleet indexing)페이지에서 필요에 따라 플릿 인덱싱 설정을 업데이트합니다.

    • 구성

      사물 인덱싱을 설정하려면 사물 인덱싱(Thing indexing)을 켜고 인덱싱할 데이터 원본을 선택합니다.

      사물 그룹 인덱싱을 설정하려면 사물 그룹 인덱싱(Thing group indexing)을 켭니다.

    • 집계를 위한 사용자 지정 필드(Custom fields for aggregation) - 선택 사항

      사용자 지정 필드는 필드 이름 및 필드 유형 페어의 목록입니다.

      사용자 정의 필드 페어를 추가하려면 새 필드 추가(Add new field)를 선택합니다. attributes.temperature와 같은 사용자 정의 필드 이름을 입력한 다음 필드 유형(Field type) 메뉴에서 필드 유형을 선택합니다. 사용자 정의 필드 이름은 attributes.로 시작하고 사물 집계 쿼리를 실행하기 위한 속성으로 저장됩니다.

      설정을 업데이트하고 저장하려면 업데이트(Update)를 선택합니다.

플릿 지표 생성

  1. https://console.aws.amazon.com/iot/ 에서 AWS IoT 콘솔을 엽니다.

  2. AWS IoT 메뉴에서 관리를 선택한 다음 플릿 메트릭을 선택합니다.

  3. 플릿 지표(Fleet metrics) 페이지에서 플릿 지표 생성(Create fleet metric)을 선택하고 생성 단계를 완료합니다.

  4. 1단계 플릿 지표 구성(Configure fleet metrics)

    • 쿼리(Query) 섹션에서 쿼리 문자열을 입력하여 집계 검색을 수행할 사물 또는 사물 그룹을 지정합니다. 쿼리 문자열은 속성과 값으로 구성됩니다. 속성(Properties)에서 원하는 속성을 선택합니다. 원하는 속성이 목록에 없는 경우 필드에 속성을 입력합니다. : 다음에 값을 입력합니다. 예제 쿼리 문자열은 thingName:TempSensor*와 같습니다. 입력한 각 쿼리 문자열에 대해 Enter 키를 누릅니다. 여러 쿼리 문자열을 입력하는 경우 and, or, and not 또는 or not을 선택하여 관계를 지정합니다.

    • 보고서 속성(Report properties)의 해당 목록에서 인덱스 이름(Index name), 집계 유형(Aggregation type) 및 집계 필드(Aggregation field)를 선택합니다. 그런 다음 데이터 선택(Select data)에서 집계할 데이터를 선택합니다. 여기에서 여러 데이터 값을 선택할 수 있습니다.

    • 다음을 선택합니다.

  5. 2단계 플릿 지표 속성 지정

    • 플릿 지표 이름(Fleet metric name) 필드에 생성 중인 플릿 지표의 이름을 입력합니다.

    • 설명 - 선택 사항(Description - optional) 필드에 생성 중인 플릿 지표에 대한 설명을 입력합니다. 이 필드는 선택 사항입니다.

    • 시간 및 분 필드에 플릿 지표가 데이터를 내보낼 시간 (빈도) 을 입력합니다. CloudWatch

    • 다음을 선택합니다.

  6. 3단계에서 검토 및 생성(Review and create)

    • 1단계 및 2단계의 설정을 검토합니다. 설정을 편집하려면 편집(Edit)을 선택합니다.

    • 플릿 지표 생성(Create fleet metric)을 선택합니다.

성공적으로 생성되면 플릿 지표가 플릿 지표(Fleet metric) 페이지에 나열됩니다.

플릿 지표 업데이트

  1. 플릿 지표 페이지에서 업데이트할 플릿 지표를 선택합니다.

  2. 플릿 지표 세부 정보(Details) 탭에서 편집(Edit)을 선택합니다. 그러면 세 단계 중 하나에서 플릿 지표를 업데이트할 수 있는 생성 단계가 열립니다.

  3. 플릿 지표 업데이트를 완료한 후 플릿 지표 업데이트(Update fleet metric)를 선택합니다.

플릿 지표 삭제

  1. 플릿 지표 페이지에서 삭제할 플릿 지표를 선택합니다.

  2. 플릿 지표에 대한 세부 정보를 보여 주는 다음 페이지에서 삭제(Delete)를 선택합니다.

  3. 대화 상자에 플릿 지표의 이름을 입력하여 삭제를 확인합니다.

  4. 삭제을 선택합니다. 플릿 지표가 영구적으로 삭제됩니다.

플릿 지표 관리(CLI)

다음 섹션에서는 를 사용하여 플릿 지표를 관리하는 AWS CLI 방법을 보여줍니다. 플릿 지표를 생성하기 전에 연결된 데이터 원본 및 구성으로 플릿 인덱싱을 사용하도록 설정했는지 확인합니다. 사물 또는 사물 그룹에 대한 집합 인덱싱을 사용하도록 설정하려면 사물 인덱싱 관리 및 사물 그룹 인덱싱 관리의 지침을 따르세요.

플릿 지표 생성

create-fleet-metric CLI 명령을 사용하여 플릿 메트릭을 생성할 수 있습니다.

aws iot create-fleet-metric --metric-name "YourFleetMetricName" --query-string "*" --period 60 --aggregation-field "registry.version" --aggregation-type name=Statistics,values=sum

이 명령의 출력에는 플릿 지표의 이름과 Amazon 리소스 이름(ARN)이 포함됩니다. 출력은 다음과 같습니다.

{
    "metricArn": "arn:aws:iot:us-east-1:111122223333:fleetmetric/YourFleetMetricName", 
    "metricName": "YourFleetMetricName"
}

플릿 지표 나열

list-fleet-metric CLI 명령을 사용하여 계정의 모든 플릿 지표를 나열할 수 있습니다.

aws iot list-fleet-metrics

이 명령의 출력에는 모든 플릿 지표가 포함됩니다. 출력은 다음과 같습니다.

{
    "fleetMetrics": [
        {
            "metricArn": "arn:aws:iot:us-east-1:111122223333:fleetmetric/YourFleetMetric1", 
            "metricName": "YourFleetMetric1"
        }, 
        {
            "metricArn": "arn:aws:iot:us-east-1:111122223333:fleetmetric/YourFleetMetric2", 
            "metricName": "YourFleetMetric2"
        }
    ]
}

플릿 지표 설명

describe-fleet-metric CLI 명령을 사용하여 플릿 지표에 대한 자세한 정보를 표시할 수 있습니다.

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

명령의 출력에는 지정된 플릿 지표에 대한 자세한 정보가 포함됩니다. 출력은 다음과 같습니다.

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

플릿 지표 업데이트

update-fleet-metric CLI 명령을 사용하여 플릿 메트릭을 업데이트할 수 있습니다.

aws iot update-fleet-metric --metric-name "YourFleetMetricName" --query-string "*" --period 120 --aggregation-field "registry.version" --aggregation-type name=Statistics,values=sum,count --index-name AWS_Things

이 update-fleet-metric 명령은 출력을 생성하지 않습니다. describe-fleet-metric CLI 명령을 사용하여 결과를 확인할 수 있습니다.

{
    "queryVersion": "2017-09-30", 
    "lastModifiedDate": 1625792300.881, 
    "queryString": "*", 
    "period": 120, 
    "metricArn": "arn:aws:iot:us-east-1:111122223333:fleetmetric/YourFleetMetricName", 
    "aggregationField": "registry.version", 
    "version": 2, 
    "aggregationType": {
        "values": [
            "sum", 
            "count"
        ], 
        "name": "Statistics"
    }, 
    "indexName": "AWS_Things", 
    "creationDate": 1625792300.881, 
    "metricName": "YourFleetMetricName"
}

플릿 지표 삭제

delete-fleet-metric CLI 명령을 사용하여 플릿 메트릭을 삭제합니다.

aws iot delete-fleet-metric --metric-name "YourFleetMetricName"

이 명령은 삭제에 성공하거나 존재하지 않는 플릿 지표를 지정하는 경우 출력을 생성하지 않습니다.

자세한 내용은 플릿 지표 문제 해결을 참조하세요.

IoT 리소스의 태깅 권한 부여

생성, 수정 또는 사용할 수 있는 플릿 지표를 더 잘 제어하기 위해 플릿 지표에 태그를 추가할 수 있습니다.

AWS Management Console 또는 AWS CLI 를 사용하여 생성한 플릿 지표에 태그를 지정하려면 IAM 정책에 iot:TagResource 작업을 포함하여 사용자에게 권한을 부여해야 합니다. IAM 정책에 포함되지 iot:TagResource 않은 경우 태그를 사용하여 플릿 지표를 생성하는 모든 작업은 오류를 AccessDeniedException 반환합니다.

리소스 태그 지정에 대한 일반 정보는 리소스 태그 지정을 참조하십시오. AWS IoT

IAM 정책 예시

플릿 메트릭을 생성할 때 태깅 권한을 부여하는 다음 IAM 정책 예제를 참조하십시오.

{
	"Version": "2012-10-17",
	"Statement": [
		{
			"Action": [
				"iot:TagResource"
			],
			"Effect": "Allow",
			"Resource": [
				"arn:aws:iot:*:*:fleetmetric/*"
			]
		},
		{
			"Action": [
				"iot:CreateFleetMetric"
			],
			"Effect": "Allow",
			"Resource": [
				"arn:aws:iot:*:*:index/*",
				"arn:aws:iot:*:*:fleetmetric/*"
			]
		}
	]
}

자세한 내용은 AWS IoT를 위한 작업, 리소스 및 조건 키를 참조하세요.