기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
원격 측정 데이터 이해
원격 측정 데이터는 Kinesis Data Streams 스트림에 Base64-encoded JSON 레코드로 전송됩니다. 각 레코드에는 고객 응대 및 샘플링된 원격 측정에 대한 메타데이터를 포함하여 위성 고객 응대 중에 수집된 정보가 포함됩니다.
데이터 형식 개요
각 원격 측정 레코드에는 다음 구성 요소가 포함됩니다.
- 원격 측정 유형 및 버전
-
특정 유형의 원격 측정 데이터와 스키마 버전을 식별합니다. 이를 통해 다양한 원격 측정 유형을 적절하게 구문 분석할 수 있습니다. 스키마 버전 관리에 대한 자세한 내용은 섹션을 참조하세요스키마 버전 관리 및 진화.
- 범위 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되지 않습니다. 구성 추적에 대한 자세한 내용은 섹션을 참조하세요추적 구성.
데이터 필드
- 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 작업을 참조하세요.
Kinesis Data Viewer 사용
Kinesis Data Streams 스트림 콘솔은 원격 측정 데이터에 빠르게 액세스할 수 있도록 데이터 뷰어 기능을 제공합니다. 이 기능을 사용하는 경우:
-
텔레메트리 전송은 스트림 내의 모든 샤드에 발생할 수 있습니다.
-
기본 시작 위치는 샤드의 최신 레코드에서 읽습니다.
-
수신된 레코드를 보려면 선택한 샤드를 조정하고 '타임스탬프 시작 시' 시작 위치를 사용해야 할 수 있습니다.
Kinesis Client Library 사용
Kinesis Client Library(KCL)는 샤드 관리, 체크포인트 및 로드 밸런싱을 포함하여 Kinesis Data Streams 스트림의 데이터 소비와 관련된 많은 복잡성을 관리합니다. 프로덕션 원격 측정 소비 애플리케이션에 KCL을 사용하는 것이 좋습니다.
자세한 내용은 Kinesis Client Library를 사용하여 소비자 개발을 참조하세요.
사용 모범 사례
-
지연 시간 최소화 - 향상된 팬아웃을 사용하여 폴링에 비해 전용 처리량과 짧은 지연 시간으로 Kinesis Data Streams 스트림에서 읽을 수 있습니다. 자세한 내용은 향상된 팬아웃 소비자 개발을 참조하세요.
-
전용 스트림 - AWS Ground Station 원격 측정 통합에 전용 Kinesis Data Streams 스트림을 사용합니다. 스트림을 다른 애플리케이션과 공유하면 쓰기 처리량 포화 및 원격 측정 전송 실패가 발생할 수 있습니다.
-
온디맨드 용량 - 처리량에 따라 샤드를 자동으로 조정할 수 있도록 Kinesis Data Streams 스트림을 온디맨드 프로비저닝 모드로 배포합니다.
-
처리량 모니터링 - CloudWatch 지표를 사용하여 스트림의 제한을 모니터링합니다. 자세한 내용은 Amazon Kinesis Data Streams 모니터링을 참조하세요.
스키마 버전 관리 및 진화
원격 측정 스키마는 시간 경과에 따른 변화를 지원하도록 버전이 지정됩니다. 각 레코드의 telemetryVersion 필드는 스키마 버전을 나타냅니다.
스키마 변경 처리
-
향후 새로운 원격 측정 유형이 도입될 수 있습니다.
-
기존 원격 측정 유형은 주요 변경 사항이 있는 새 버전을 수신할 수 있습니다.
-
애플리케이션은 알 수 없는 원격 측정 유형 및 버전을 허용해야 합니다.
-
telemetryTypeAndVersion,telemetryType및telemetryVersion필드를 구문 분석하여 각 레코드를 처리하는 방법을 결정합니다.
여러 스키마 버전을 정상적으로 처리할 수 있는 버전 인식 페이로드 직렬화를 구현하여 새 버전이 도입될 때 애플리케이션이 계속 작동할 수 있도록 하는 것이 좋습니다.
