기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 플릿 지표 관리
이 주제에서는 AWS IoT 콘솔을 사용하고 플릿 지표 AWS CLI 를 관리하는 방법을 보여줍니다.
**Topics**
+ [플릿 지표 관리(콘솔)](#managing-fleet-metrics-console)
+ [플릿 지표 관리(CLI)](#managing-fleet-metrics-cli)
+ [IoT 리소스의 태깅 권한 부여](#managing-fleet-metrics-policy)
## 플릿 지표 관리(콘솔)
다음 섹션에서는 AWS IoT 콘솔을 사용하여 플릿 지표를 관리하는 방법을 보여줍니다. 플릿 지표를 생성하기 전에 연결된 데이터 원본 및 구성으로 플릿 인덱싱을 사용하도록 설정했는지 확인합니다.
### 플릿 인덱싱 사용 설정
플릿 인덱싱을 이미 사용하도록 설정한 경우 이 섹션을 건너뜁니다.
플릿 인덱싱을 사용하도록 설정하지 않은 경우 다음 지침을 따릅니다.
1. [https://console.aws.amazon.com/iot/](https://console.aws.amazon.com/iot/) AWS IoT 콘솔을 엽니다.
1. AWS IoT 메뉴에서 **설정을** 선택합니다.
1. 자세한 설정을 보려면 **설정(Settings)** 페이지에서 **플릿 인덱싱(Fleet indexing)** 섹션까지 아래로 스크롤합니다.
1. 플릿 인덱싱 설정을 업데이트하려면 **플릿 인덱싱(Fleet indexing)** 섹션 오른쪽에서 **인덱싱 관리(Manage indexing)**를 선택합니다.
1. **플릿 인덱싱 관리(Manage fleet indexing)**페이지에서 필요에 따라 플릿 인덱싱 설정을 업데이트합니다.
+ **구성**
사물 인덱싱을 설정하려면 **사물 인덱싱(Thing indexing)**을 켜고 인덱싱할 데이터 원본을 선택합니다.
사물 그룹 인덱싱을 설정하려면 **사물 그룹 인덱싱(Thing group indexing)**을 켭니다.
+ **집계를 위한 사용자 지정 필드(Custom fields for aggregation) - *선택 사항***
사용자 지정 필드는 필드 이름 및 필드 유형 페어의 목록입니다.
사용자 정의 필드 페어를 추가하려면 **새 필드 추가(Add new field)**를 선택합니다. `attributes.temperature`와 같은 사용자 정의 필드 이름을 입력한 다음 **필드 유형(Field type)** 메뉴에서 필드 유형을 선택합니다. 사용자 정의 필드 이름은 `attributes.`로 시작하고 [사물 집계 쿼리](https://docs.aws.amazon.com/iot/latest/developerguide/index-aggregate.html)를 실행하기 위한 속성으로 저장됩니다.
설정을 업데이트하고 저장하려면 **업데이트(Update)**를 선택합니다.
### 플릿 지표 생성
1. [https://console.aws.amazon.com/iot/](https://console.aws.amazon.com/iot/) AWS IoT 콘솔을 엽니다.
1. AWS IoT 메뉴에서 **관리를** 선택한 다음 **플릿 지표**를 선택합니다.
1. **플릿 지표(Fleet metrics)** 페이지에서 **플릿 지표 생성(Create fleet metric)**을 선택하고 생성 단계를 완료합니다.
1. 1단계 **플릿 지표 구성(Configure fleet metrics)**
+ **쿼리(Query)** 섹션에서 쿼리 문자열을 입력하여 집계 검색을 수행할 사물 또는 사물 그룹을 지정합니다. 쿼리 문자열은 속성과 값으로 구성됩니다. **속성(Properties)**에서 원하는 속성을 선택합니다. 원하는 속성이 목록에 없는 경우 필드에 속성을 입력합니다. `:` 다음에 값을 입력합니다. 예제 쿼리 문자열은 `thingName:TempSensor*`와 같습니다. 입력한 각 쿼리 문자열에 대해 **Enter** 키를 누릅니다. 여러 쿼리 문자열을 입력하는 경우 **and**, **or**, **and not** 또는 **or not**을 선택하여 관계를 지정합니다.
+ **보고서 속성**의 해당 목록에서 **인덱스 이름**, **집계 유형** 및 **집계 필드**를 선택합니다. 그런 다음 **데이터 선택(Select data)**에서 집계할 데이터를 선택합니다. 여기에서 여러 데이터 값을 선택할 수 있습니다.
+ **다음**을 선택합니다.
1. 2단계 **플릿 지표 속성 지정**
+ **플릿 지표 이름(Fleet metric name)** 필드에 생성 중인 플릿 지표의 이름을 입력합니다.
+ **설명 - *선택 사항*(Description - optional)** 필드에 생성 중인 플릿 지표에 대한 설명을 입력합니다. 이 필드는 선택 사항입니다.
+ **시간(Hours)** 및 **분(Minutes)** 필드에 플릿 지표에서 CloudWatch로 데이터를 내보낼 시간(빈도)을 입력합니다.
+ **다음**을 선택합니다.
1. 3단계에서 **검토 및 생성(Review and create)**
+ 1단계 및 2단계의 설정을 검토합니다. 설정을 편집하려면 **편집(Edit)**을 선택합니다.
+ **플릿 지표 생성(Create fleet metric)**을 선택합니다.
성공적으로 생성되면 플릿 지표가 **플릿 지표(Fleet metric)** 페이지에 나열됩니다.
### 플릿 지표 업데이트
1. **플릿 지표** 페이지에서 업데이트할 플릿 지표를 선택합니다.
1. 플릿 지표 **세부 정보(Details)** 탭에서 **편집(Edit)**을 선택합니다. 그러면 세 단계 중 하나에서 플릿 지표를 업데이트할 수 있는 생성 단계가 열립니다.
1. 플릿 지표 업데이트를 완료한 후 **플릿 지표 업데이트(Update fleet metric)**를 선택합니다.
### 플릿 지표 삭제
1. **플릿 지표** 페이지에서 삭제할 플릿 지표를 선택합니다.
1. 플릿 지표에 대한 세부 정보를 보여 주는 다음 페이지에서 **삭제(Delete)**를 선택합니다.
1. 대화 상자에 플릿 지표의 이름을 입력하여 삭제를 확인합니다.
1. **삭제**를 선택합니다. 플릿 지표가 영구적으로 삭제됩니다.
## 플릿 지표 관리(CLI)
다음 섹션에서는를 사용하여 플릿 지표 AWS CLI 를 관리하는 방법을 보여줍니다. 플릿 지표를 생성하기 전에 연결된 데이터 원본 및 구성으로 플릿 인덱싱을 사용하도록 설정했는지 확인합니다. 사물 또는 사물 그룹에 대한 집합 인덱싱을 사용하도록 설정하려면 [사물 인덱싱 관리](managing-index.md#enable-index) 및 [사물 그룹 인덱싱 관리](thinggroup-index.md#enable-group-index)의 지침을 따르세요.
### 플릿 지표 생성
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"
```
이 명령은 삭제에 성공하거나 존재하지 않는 플릿 지표를 지정하는 경우 출력을 생성하지 않습니다.
자세한 내용은 [플릿 지표 문제 해결](fleet-indexing-troubleshooting.md#fleet-metrics-troubleshooting)을 참조하세요.
## IoT 리소스의 태깅 권한 부여
생성, 수정 또는 사용할 수 있는 플릿 지표를 더 잘 제어하려면 플릿 지표에 태그를 연결할 수 있습니다.
AWS Management Console 또는를 사용하여 생성한 플릿 지표에 태그를 AWS CLI지정하려면 IAM 정책에 `iot:TagResource` 작업을 포함하여 사용자에게 권한을 부여해야 합니다. IAM 정책에 `iot:TagResource`가 포함되지 않은 경우 태그가 있는 플릿 지표를 생성하는 모든 작업에 `AccessDeniedException` 오류가 반환됩니다.
리소스 태그 지정에 대한 추가적인 일반 정보는 [AWS IoT 리소스 태그 지정](https://docs.aws.amazon.com//iot/latest/developerguide/tagging-iot.html)을 참조하세요.
### 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/*"
]
}
]
}
```
자세한 내용은 [Actions, resources, and condition keys for AWS IoT](https://docs.aws.amazon.com//service-authorization/latest/reference/list_awsiot.html) 섹션을 참조하세요.