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

# 원격 측정 설정
<a name="telemetry.setup"></a>

 다음 단계에 따라AWS Ground Station연락처에 대한 원격 측정을 구성합니다. 이 설정을 완료하면 원격 측정이 활성화된 미션 프로파일을 사용하는 고객 응대 중에 원격 측정 데이터가 Kinesis Data Streams 스트림으로 전송됩니다. Kinesis Data Streams에 대한 자세한 내용은 [Kinesis Data Streams 사용 설명서를](https://docs.aws.amazon.com/streams/latest/dev/introduction.html) 참조하세요.

## 1단계: 사전 조건AWS리소스 생성
<a name="telemetry.setup.step1"></a>

 다음CloudFormation코드 조각은 원격 측정 전송을 위한 사전 필수AWS리소스를 생성하는 방법을 보여줍니다. 이 코드 조각은 Kinesis Data Streams 스트림과 스트림에 원격 측정 데이터를 쓸 수 있는AWS Ground Station권한을 부여하는 IAM 역할을 생성합니다.

```
{{TelemetryStream}}:
  Type: AWS::Kinesis::Stream
  Properties:
    Name: {{GroundStationTelemetryStream}}
    StreamModeDetails:
      StreamMode: {{ON_DEMAND}}
    RetentionPeriodHours: {{24}}

{{TelemetryRole}}:
  Type: AWS::IAM::Role
  Properties:
    RoleName: {{GroundStationTelemetryRole}}
    AssumeRolePolicyDocument:
      Version: '2012-10-17'
      Statement:
        - Effect: Allow
          Principal:
            Service: groundstation.amazonaws.com
          Action: sts:AssumeRole
    Policies:
      - PolicyName: {{KinesisWritePolicy}}
        PolicyDocument:
          Version: '2012-10-17'
          Statement:
            - Effect: Allow
              Action:
                - kinesis:DescribeStream
                - kinesis:PutRecord
                - kinesis:PutRecords
              Resource: !GetAtt {{TelemetryStream}}.Arn
```

 아래 목록은 원격 측정 전송을 구성할 때 고유한 설정 고려 사항을 호출합니다AWS Ground Station.

 **Kinesis Data Streams 스트림** - 스트림은 처리량에 따라 자동으로 조정되는 온디맨드 용량 모드를 사용합니다. 이는 대부분의 사용 사례에 권장됩니다. 스트림은 24시간 동안 데이터를 보존하도록 구성됩니다. 기본적으로 스트림은AWS관리형 암호화를 사용합니다. 에서 고객 관리형 암호화를 사용하려면 `StreamEncryption` 속성을AWS Key Management Service추가하고 `kms:GenerateDataKey` 권한을 포함하도록 IAM 역할 정책을 업데이트합니다. 자세한 내용은 [ Amazon Kinesis Data Streams의 데이터 보호를](https://docs.aws.amazon.com/streams/latest/dev/server-side-encryption.html) 참조하세요.

 **IAM 역할** - IAM 역할을 통해 `groundstation.amazonaws.com` 서비스 보안 주체는 역할을 수임하고 Kinesis Data Streams 스트림에 원격 측정 데이터를 쓸 수 있습니다. 역할 정책은 스트림의 `kinesis:DescribeStream`, `kinesis:PutRecord`및 `kinesis:PutRecords` 작업에 대한 권한을 부여합니다. 신뢰 정책 및 역할 정책 설정에 대한 지침은 [원격 측정 싱크 구성](how-it-works.config.md#how-it-works.config-telemetry-sink) 섹션을 참조하세요.

 **추가 구성** -AWS Ground Station API 호출에 사용하는 IAM 사용자 또는 역할에 `iam:PassRole` 권한을 추가합니다. 이렇게 하면 TelemetrySinkConfig를 생성할AWS Ground Station때 원격 측정 역할을에 전달할 수 있습니다. TelemetrySinkConfig 

### PassRole 정책 예제
<a name="telemetry-passrole-policy-example"></a>

 역할 정책을 업데이트하거나 연결하는 방법에 대한 자세한 내용은 [ IAM 사용 설명서의 IAM 정책 관리를](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage.html) 참조하세요. `iam:PassRole` 권한에 대한 자세한 내용은 [ AWS 서비스에 역할을 전달할 수 있는 사용자 권한 부여를 참조하세요. ](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use_passrole.html) 

```
{
  "Version": "2012-10-17", 		 	 	 
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "iam:GetRole",
        "iam:PassRole"
      ],
      "Resource": "arn:aws:iam::{{999999999999}}:role/{{your-telemetry-delivery-role-name}}"
    }
  ]
}
```

## 2단계: TelemetrySinkConfig 생성
<a name="telemetry.setup.step2"></a>

 가 원격 측정 데이터를 Kinesis Data Streams 스트림에 전송하는 방법을 정의하는 *TelemetrySinkConfig*를 생성합니다.AWS Ground Station 1단계의CloudFormation스택 출력에서 스트림 ARN 및 역할 ARN을 사용합니다.

**참고**  
 *TelemetrySinkConfig*를 생성하면AWS Ground Station는 파티션 키가 인 빈 테스트 레코드를 전송하여 Kinesis Data Streams 스트림에 대한 액세스를 확인합니다`test`.

 *TelemetrySinkConfig* 생성에 대한 자세한 내용은 섹션을 참조하세요[원격 측정 싱크 구성](how-it-works.config.md#how-it-works.config-telemetry-sink).

## 3단계: 미션 프로파일에 원격 측정 추가
<a name="telemetry.setup.step3"></a>

 미션 프로파일을 생성합니다. 미션 프로파일 생성에 대한 자세한 내용은 섹션을 참조하세요[AWS Ground Station 미션 프로파일 사용](how-it-works-mission-profile.md). 미션 프로파일`telemetrySinkConfigArn`에를 추가하여 연락 중에 원격 측정 전송을 활성화합니다. 2단계에서 생성한 *TelemetrySinkConfig*의 ARN을 사용합니다.

## 4단계: 연락처 예약
<a name="telemetry.setup.step4"></a>

 원격 측정이 활성화된 미션 프로파일을 사용하여 고객 응대를 예약합니다. 고객 응대 중에AWS Ground Station는 원격 측정 데이터를 Kinesis Data Streams 스트림으로 스트리밍합니다.

 **고객 응대 중에 예상되는 사항** 
+  **원격 측정 시작** - 고객 응대가 시작되면 데이터가 스트리밍을 시작합니다.
+  **실시간에 가까운 전송** - 원격 측정이 거의 실시간으로 Kinesis Data Streams 스트림에 도착합니다.
+  **고객 응대 기간** - 데이터는 전체 고객 응대에서 계속됩니다.
+  **자동 중지** - 고객 응대가 종료되면 원격 측정이 스트리밍을 중지합니다.

 **전송 모니터링** 

 다음을 사용하여 원격 측정 전송을 모니터링할 수 있습니다.
+  **Kinesis Data Streams 스트림 지표** - CloudWatch에서 수신 레코드를 확인합니다. 자세한 내용은 [ Amazon Kinesis Data Streams 모니터링을](https://docs.aws.amazon.com/streams/latest/dev/monitoring-with-cloudwatch.html) 참조하세요.
+  **애플리케이션 로그** - 스트림에서를 사용하는 애플리케이션의 데이터 처리를 확인합니다.
+  **Kinesis Data Viewer** - Kinesis Data Streams 스트림 콘솔을 사용하여 스트림의 샘플 레코드를 봅니다.

## 다음 단계
<a name="telemetry.setup.next-steps"></a>

 설정을 완료한 후 다음을 수행할 수 있습니다.
+  원격 측정 데이터 형식과 사용 가능한 원격 측정 유형에 대해 알아봅니다. [원격 측정 데이터 이해](telemetry.understanding-data.md)을(를) 참조하세요.
+  애플리케이션을 구축하여 Kinesis Data Streams 스트림의 원격 측정 데이터를 처리합니다. 자세한 내용은 [ Amazon Kinesis Data Streams용 소비자 구축을 참조하세요](https://docs.aws.amazon.com/streams/latest/dev/building-consumers.html).
+  CloudWatch 및 기타AWS서비스를 사용하여 대시보드 및 알림을 생성합니다.
+  문제가 발생할 경우 문제 해결 지침을 검토하세요. [원격 측정 문제 해결](troubleshooting-telemetry.md)을(를) 참조하세요.