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

플릿 지표 관리

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

플릿 지표 관리(콘솔)

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

플릿 인덱싱 사용 설정

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

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

플릿 지표 생성

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

플릿 지표 업데이트

플릿 지표 삭제

플릿 지표 관리(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를 위한 작업, 리소스 및 조건 키를 참조하세요.