기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # 원격 측정 작업 AWS Ground Station 원격 측정은 위성 접촉 중에 AWS Ground Station 안테나에서 거의 실시간에 가까운 지표를 제공합니다. 원격 측정 데이터를 사용하여 고객 응대 성능을 모니터링하고, 이상을 감지하고, 위성 통신에 대해 정보에 입각한 결정을 내릴 수 있습니다. ## 원격 측정 작동 방식 원격 측정을 사용하려면가 원격 측정 데이터를 전송하는 위치를 지정하는 *TelemetrySinkConfig* AWS Ground Station 를 구성합니다. 그런 다음 `telemetrySinkConfigArn` 필드를 사용하여이 구성을 미션 프로파일에 추가합니다. 원격 측정 지원 미션 프로파일을 사용하는 고객 응대 중에는 원격 측정 데이터를 계정으로 AWS Ground Station 스트리밍합니다. 원격 측정 전송 프로세스는 다음과 같이 작동합니다. 1. AWS 계정에 Kinesis Data Streams 스트림을 생성하여 원격 측정 데이터를 수신합니다. 스트림은 연락처를 예약하는 것과 동일한 계정 및 리전에서 생성해야 합니다. 1. 스트림에 데이터를 쓸 수 있는 AWS Ground Station 권한을 부여하는 IAM 역할을 생성합니다. 1. 스트림 및 IAM 역할을 참조하는 TelemetrySinkConfig를 생성합니다. 1. TelemetrySinkConfig를 미션 프로파일에 추가합니다. 1. 새로운 원격 측정 지원 미션 프로파일을 사용하여 연락처를 나열하고 예약합니다. 1. 이 미션 프로파일을 사용하는 고객 응대 중에는 원격 측정 데이터를 거의 실시간으로 Kinesis Data Streams 스트림으로 AWS Ground Station 스트리밍합니다. 1. AWS 서비스 또는 자체 애플리케이션을 사용하여 스트림의 원격 측정 데이터를 사용하고 처리합니다. ## 사용 가능한 원격 측정 유형 AWS Ground Station 는 고객 응대 중에 다음과 같은 원격 측정 유형을 제공합니다. **참고** AWS Ground Station 는 지원되는 원격 측정 유형의 수를 확장하기 위해 노력하고 있습니다. 텔레메트리 가리키기 위성 접촉 중 안테나 방향에 대한 정보를 제공합니다. 이 원격 측정 유형은 항상 접촉 중에 전송되며 실제 및 명령 방위각과 고도 각도를 포함합니다. 자세한 내용은 [텔레메트리 가리키기](telemetry.understanding-data.md#telemetry.understanding-data.pointing) 단원을 참조하십시오. 원격 측정 추적 안테나 추적 상태 및 추적 오류에 대한 정보를 제공합니다. 이 원격 측정 유형은 추적 구성에서 자동 추적이 활성화된 경우 전송됩니다. 자세한 내용은 [원격 측정 추적](telemetry.understanding-data.md#telemetry.understanding-data.tracking) 단원을 참조하십시오. ## 리전별 가용성 텔레메트리는가 AWS Ground Station 실행되는 모든 AWS 리전에서 사용할 수 있습니다. 고객 응대 실행 중에 원격 측정이 AWS Ground Station 안테나에서 고객 응대를 예약한 리전으로 전송되어 교차 리전 지원을 제공합니다. AWS Ground Station 리전 및 지상국 위치의 전체 목록은 섹션을 참조하세요[AWS Ground Station 위치](aws-ground-station-antenna-locations.md). **Topics** + [원격 측정 작동 방식](#telemetry.how-it-works) + [사용 가능한 원격 측정 유형](#telemetry.telemetry-types) + [리전별 가용성](#telemetry.regional-availability) + [원격 측정 설정](telemetry.setup.md) + [원격 측정 데이터 이해](telemetry.understanding-data.md) # 원격 측정 설정 다음 단계에 따라 AWS Ground Station 연락처에 대한 원격 측정을 구성합니다. 이 설정을 완료하면 원격 측정이 활성화된 미션 프로파일을 사용하는 고객 응대 중에 원격 측정 데이터가 Kinesis Data Streams 스트림으로 전송됩니다. Kinesis Data Streams에 대한 자세한 내용은 [Kinesis Data Streams 사용 설명서를](https://docs.aws.amazon.com/streams/latest/dev/introduction.html) 참조하세요. ## 1단계: 사전 조건 AWS 리소스 생성 다음 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 정책 예제 역할 정책을 업데이트하거나 연결하는 방법에 대한 자세한 내용은 [ 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 생성 가 원격 측정 데이터를 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단계: 미션 프로파일에 원격 측정 추가 미션 프로파일을 생성합니다. 미션 프로파일 생성에 대한 자세한 내용은 섹션을 참조하세요[AWS Ground Station 미션 프로파일 사용](how-it-works-mission-profile.md). 미션 프로파일`telemetrySinkConfigArn`에를 추가하여 연락 중에 원격 측정 전송을 활성화합니다. 2단계에서 생성한 *TelemetrySinkConfig*의 ARN을 사용합니다. ## 4단계: 연락처 예약 원격 측정이 활성화된 미션 프로파일을 사용하여 고객 응대를 예약합니다. 고객 응대 중에 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 스트림 콘솔을 사용하여 스트림의 샘플 레코드를 봅니다. ## 다음 단계 설정을 완료한 후 다음을 수행할 수 있습니다. + 원격 측정 데이터 형식과 사용 가능한 원격 측정 유형에 대해 알아봅니다. [원격 측정 데이터 이해](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)을(를) 참조하세요. # 원격 측정 데이터 이해 원격 측정 데이터는 Kinesis Data Streams 스트림에 Base64-encoded JSON 레코드로 전송됩니다. 각 레코드에는 고객 응대 및 샘플링된 원격 측정에 대한 메타데이터를 포함하여 위성 고객 응대 중에 수집된 정보가 포함됩니다. ## 데이터 형식 개요 각 원격 측정 레코드에는 다음 구성 요소가 포함됩니다. 원격 측정 유형 및 버전 특정 유형의 원격 측정 데이터와 스키마 버전을 식별합니다. 이를 통해 다양한 원격 측정 유형을 적절하게 구문 분석할 수 있습니다. 스키마 버전 관리에 대한 자세한 내용은 섹션을 참조하세요[스키마 버전 관리 및 진화](#telemetry.understanding-data.schema-evolution). 범위 ID 원격 측정 범위의 고유 식별자입니다. 이를 통해 원격 측정 데이터를 특정 연락처와 연결할 수 있습니다. Metadata 원격 측정에 대한 컨텍스트 정보입니다. 데이터 원격 측정 유형과 관련된 샘플링된 원격 측정입니다. **파티션 키** 원격 측정 레코드는 다음 형식의 파티션 키를 사용하여 Kinesis Data Streams 스트림으로 전송됩니다. ``` SCOPE#scopeId#TELEMETRY_ID#telemetryId#TELEMETRY_VERSION#telemetryVersion ``` 이 파티션 키는 단일 고객 응대에 대해 지정된 유형의 모든 원격 측정이 Kinesis Data Streams 스트림 내의 동일한 샤드로 전송되도록 하여 해당 고객 응대의 원격 측정 스트림에 대한 최선의 작업 순서를 제공합니다. ## 텔레메트리 가리키기 조준 원격 측정은 위성 접촉 중 안테나 조준 방향에 대한 정보를 제공합니다. 이 원격 측정 유형은 고객 응대 중에 항상 전송됩니다. **데이터 필드** sampleTimestamp 원격 측정 데이터가 샘플링된 시간이며, ISO-8601 형식은 밀리초 정밀도의 UTC입니다. 방위각 도 단위의 안테나의 실제 방위각입니다. 고도 안테나의 실제 고도 각도입니다. commandedAzimuth 도 단위의 명령 방위각입니다. 안테나가 달성하려고 시도하는 목표 방위각입니다. commandedElevation 도 단위의 명령된 고도 각도입니다. 이는 안테나가 달성하려고 시도하는 목표 고도 각도입니다. **참고** 실제 안테나 위치는 접촉 중 물리적 제한 또는 기계적 지연으로 인해 명령된 위치와 다를 수 있습니다. **메타데이터 필드** groundStation 지상국의 이름(예: "Ohio 1"). satelliteId 의 위성 리소스 식별자입니다 AWS Ground Station. contactId 연락처의 식별자입니다. **예제 JSON** ``` { "telemetryTypeAndVersion": "POINTING#1.0.0", "telemetryType": "POINTING", "telemetryVersion": "1.0.0", "scopeId": "12345678-1234-1234-1234-123456789012", "metadata": { "groundStation": "Ohio 1", "satelliteId": "87654321-4321-4321-4321-210987654321", "contactId": "12345678-1234-1234-1234-123456789012" }, "data": { "sampleTimestamp": "2025-12-08T12:00:00.123Z", "azimuth": 180.5, "elevation": 45.2, "commandedAzimuth": 180.0, "commandedElevation": 45.0 } } ``` ## 원격 측정 추적 추적 원격 측정은 안테나 추적 상태 및 추적 오류에 대한 정보를 제공합니다. 이 원격 측정 유형은 추적 구성에서 자동 추적이 활성화되어 있고 안테나가 자동 추적을 적극적으로 사용하고 있을 때 전송됩니다. **참고** TrackingConfig의 `autotrack` 파라미터가 로 설정된 경우 추적 원격 측정이 전송`REMOVED`되지 않습니다. 구성 추적에 대한 자세한 내용은 섹션을 참조하세요[추적 구성](how-it-works.config.md#how-it-works.config-tracking). **데이터 필드** sampleTimestamp 원격 측정 데이터가 샘플링된 시간이며, ISO-8601 형식은 밀리초 정밀도의 UTC입니다. trackingStatus 안테나의 현재 추적 상태입니다. 가능한 값은 `TRACKING`, `ACQUIRING` 및 `MASKED`입니다. trackingErrorAzimuth 각도로 측정되는 방위각 축의 추적 오류입니다. trackingErrorElevation 각도로 측정되는 고도 축의 추적 오류입니다. **참고** 추적 오류 값은 신호 강도를 극대화하기 위해 자동 추적 중에 AWS Ground Station 적용되는 에페메리스 기반 프로그램 트랙의 조정을 나타냅니다. **메타데이터 필드** 원격 측정 추적에는 원격 측정을 가리키는 것과 동일한 메타데이터 필드인 `groundStation`, 및 `satelliteId`가 포함됩니다`contactId`. **예제 JSON** ``` { "telemetryTypeAndVersion": "TRACKING#1.0.0", "telemetryType": "TRACKING", "telemetryVersion": "1.0.0", "scopeId": "12345678-1234-1234-1234-123456789012", "metadata": { "groundStation": "Ohio 1", "satelliteId": "87654321-4321-4321-4321-210987654321", "contactId": "12345678-1234-1234-1234-123456789012" }, "data": { "sampleTimestamp": "2025-12-08T12:00:00.123Z", "trackingStatus": "TRACKING", "trackingErrorAzimuth": 0.2, "trackingErrorElevation": 0.1 } } ``` ## Kinesis Data Streams 스트림에서 데이터 읽기 원격 측정 데이터는 Kinesis Data Streams 스트림으로 전송되며 표준 스트림 소비 패턴을 사용하여 사용할 수 있습니다. 스트림에서 데이터를 읽을 때는 다음 사항을 고려해야 합니다. **Base64 디코딩** Kinesis Data Streams 스트림의 데이터는 Base64-encoded됩니다. JSON으로 구문 분석하기 전에 데이터를 디코딩해야 합니다. 자세한 내용은 [ Amazon Kinesis Data Streams 작업을](https://docs.aws.amazon.com/streams/latest/dev/working-with-streams.html) 참조하세요. **Kinesis Data Viewer 사용** Kinesis Data Streams 스트림 콘솔은 원격 측정 데이터에 빠르게 액세스할 수 있도록 데이터 뷰어 기능을 제공합니다. 이 기능을 사용하는 경우: + 텔레메트리 전송은 스트림 내의 모든 샤드에 발생할 수 있습니다. + 기본 시작 위치는 샤드의 최신 레코드에서 읽습니다. + 수신된 레코드를 보려면 선택한 샤드를 조정하고 '타임스탬프 시작 시' 시작 위치를 사용해야 할 수 있습니다. **Kinesis Client Library 사용** Kinesis Client Library(KCL)는 샤드 관리, 체크포인트 및 로드 밸런싱을 포함하여 Kinesis Data Streams 스트림의 데이터 소비와 관련된 많은 복잡성을 관리합니다. 프로덕션 원격 측정 소비 애플리케이션에 KCL을 사용하는 것이 좋습니다. 자세한 내용은 [Kinesis Client Library를 사용하여 소비자 개발을 참조하세요](https://docs.aws.amazon.com/streams/latest/dev/kcl.html). **사용 모범 사례** + **지연 시간 최소화** - 향상된 팬아웃을 사용하여 폴링에 비해 전용 처리량과 짧은 지연 시간으로 Kinesis Data Streams 스트림에서 읽을 수 있습니다. 자세한 내용은 [ 향상된 팬아웃 소비자 개발을 참조하세요](https://docs.aws.amazon.com/streams/latest/dev/enhanced-consumers.html). + **전용 스트림** - AWS Ground Station 원격 측정 통합에 전용 Kinesis Data Streams 스트림을 사용합니다. 스트림을 다른 애플리케이션과 공유하면 쓰기 처리량 포화 및 원격 측정 전송 실패가 발생할 수 있습니다. + **온디맨드 용량** - 처리량에 따라 샤드를 자동으로 조정할 수 있도록 Kinesis Data Streams 스트림을 온디맨드 프로비저닝 모드로 배포합니다. + **처리량 모니터링** - CloudWatch 지표를 사용하여 스트림의 제한을 모니터링합니다. 자세한 내용은 [ Amazon Kinesis Data Streams 모니터링을](https://docs.aws.amazon.com/streams/latest/dev/monitoring-with-cloudwatch.html) 참조하세요. ## 스키마 버전 관리 및 진화 원격 측정 스키마는 시간 경과에 따른 변화를 지원하도록 버전이 지정됩니다. 각 레코드의 `telemetryVersion` 필드는 스키마 버전을 나타냅니다. **스키마 변경 처리** + 향후 새로운 원격 측정 유형이 도입될 수 있습니다. + 기존 원격 측정 유형은 주요 변경 사항이 있는 새 버전을 수신할 수 있습니다. + 애플리케이션은 알 수 없는 원격 측정 유형 및 버전을 허용해야 합니다. + `telemetryTypeAndVersion`, `telemetryType`및 `telemetryVersion` 필드를 구문 분석하여 각 레코드를 처리하는 방법을 결정합니다. 여러 스키마 버전을 정상적으로 처리할 수 있는 버전 인식 페이로드 직렬화를 구현하여 새 버전이 도입될 때 애플리케이션이 계속 작동할 수 있도록 하는 것이 좋습니다.