기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 원격 측정 문제 해결
다음 정보를 사용하여 원격 측정과 관련된 일반적인 문제를 해결합니다.
## 일반적인 설정 문제
### IAM 권한 오류
**증상**
를 호출`CreateConfig`하여 TelemetrySinkConfig를 생성할 때 오류가 발생합니다.
```
Unable to write to Kinesis Data Streams stream. Ensure that Ground Station has
kinesis:PutRecord permissions for the given stream
```
**원인**
+ TelemetrySinkConfig에 지정된 IAM 역할에는 Kinesis Data Streams 스트림에 쓰는 데 필요한 권한이 없습니다.
+ IAM 역할의 신뢰 정책은가 역할을 수임 AWS Ground Station 하도록 허용하지 않습니다.
+ TelemetrySinkConfig의 Kinesis Data Streams 스트림 ARN이 잘못되었거나 스트림이 존재하지 않습니다.
**솔루션**
1. IAM 역할이 존재하고 올바른 권한이 있는지 확인합니다. 모든 단계를 [2단계: TelemetrySinkConfig 생성](telemetry.setup.md#telemetry.setup.step2) 검토하고 준수했는지 확인합니다.
1. 가 IAM 역할을 수임 AWS Ground Station 할 수 있는지 확인합니다.
```
aws iam get-role --role-name GroundStationTelemetryRole
```
신뢰 정책에가 신뢰할 수 있는 서비스 보안 주체`groundstation.amazonaws.com`로 포함되어 있는지 확인합니다.
1. IAM 역할에 필요한 Kinesis 권한이 있는지 확인합니다.
```
aws iam list-attached-role-policies --role-name GroundStationTelemetryRole
```
정책에 스트림에 대한 `kinesis:DescribeStream``kinesis:PutRecord`, 및 `kinesis:PutRecords` 권한이 포함되어 있는지 확인합니다.
1. Kinesis Data Streams 스트림이 존재하고 ARN이 올바른지 확인합니다.
```
aws kinesis describe-stream \
--stream-name your-stream-name \
--region us-east-2
```
1. 고객 관리형 암호화를 사용하는 경우 IAM 역할에 AWS KMS 키에 대한 `kms:GenerateDataKey` 권한이 있는지 확인합니다.
### PassRole 권한 오류
**증상**
를 호출`CreateConfig`할 때 IAM 역할을 전달할 권한이 없다는 오류가 발생합니다.
**솔루션**
IAM 사용자 또는 역할에 원격 측정 IAM 역할에 대한 `iam:PassRole` 권한이 있는지 확인합니다. 사용자 또는 역할에 다음 정책을 추가합니다.
```
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"iam:GetRole",
"iam:PassRole"
],
"Resource": "arn:aws:iam::99999999999:role/your-stream-name"
}
]
}
```
### Kinesis Data Streams 스트림 구성 문제
**증상**
원격 측정 전송이 실패하거나 간헐적입니다.
**원인**
+ Kinesis Data Streams 스트림의 용량이 원격 측정 처리량에 충분하지 않습니다.
+ 스트림이 다른 애플리케이션에서 사용 중이므로 쓰기 제한이 발생합니다.
**솔루션**
1. 스트림 상태를 확인합니다.
```
aws kinesis describe-stream \
--stream-name your-stream-name \
--region us-east-2
```
1. CloudWatch 지표를 사용하여 쓰기 제한을 모니터링합니다.
```
aws cloudwatch get-metric-statistics \
--namespace AWS/Kinesis \
--metric-name WriteProvisionedThroughputExceeded \
--dimensions Name=StreamName,Value=your-stream-name \
--start-time 2025-12-08T00:00:00Z \
--end-time 2025-12-08T23:59:59Z \
--period 60 \
--statistics Sum \
--region us-east-2
```
1. 제한이 감지되면 다음을 고려하세요.
+ 자동 조정을 위해 온디맨드 용량 모드로 전환합니다.
+ AWS Ground Station 원격 측정을 위한 전용 스트림 사용.
+ 프로비저닝된 모드를 사용하는 경우 샤드 수를 늘립니다.
## 원격 측정 전송 문제
### 원격 측정 데이터가 표시되지 않음
**증상**
원격 측정이 활성화된 미션 프로파일로 고객 응대를 예약하면 Kinesis Data Streams 스트림에 원격 측정 데이터가 표시되지 않습니다.
**가능한 원인 및 해결 방법**
미션 프로파일에 원격 측정이 활성화되어 있지 않음
연락에 사용되는 미션 프로파일에가 포함되어 있는지 확인합니다`telemetrySinkConfigArn`.
```
aws groundstation get-mission-profile \
--mission-profile-id 12345678-1234-1234-1234-123456789012 \
--region us-east-2
```
`telemetrySinkConfigArn` 필드의 출력을 확인합니다. 존재하지 않는 경우 미션 프로파일에 원격 측정이 활성화되어 있지 않습니다.
IAM 역할 권한 문제
의 IAM 권한 문제 해결 단계를 검토합니다[IAM 권한 오류](#troubleshooting-telemetry.iam-permissions).
Kinesis Data Streams 스트림이 존재하지 않거나 잘못된 리전에 있음
스트림이 올바른 리전에 있는지 확인합니다.
```
aws kinesis describe-stream \
--stream-name your-stream-name \
--region us-east-2
```
연락처가 아직 시작되지 않음
원격 측정 전송은 고객 응대 시작 시간에 시작됩니다. 고객 응대 상태를 확인하여 고객 응대가 시작되었는지 확인합니다.
```
aws groundstation describe-contact \
--contact-id 12345678-1234-1234-1234-123456789012 \
--region us-east-2
```
### 간헐적 원격 측정 데이터
**증상**
원격 측정 데이터는 격차 또는 누락된 레코드와 일관되지 않게 전송됩니다.
**가능한 원인**
+ Kinesis Data Streams 스트림 용량 문제 또는 제한. [Kinesis Data Streams 스트림 구성 문제](#troubleshooting-telemetry.kinesis-config)을(를) 참조하세요.
+ AWS Ground Station 와 Kinesis Data Streams 스트림 간의 네트워크 연결 문제입니다.
**솔루션**
+ CloudWatch에서 Kinesis Data Streams 스트림 지표의 제한 또는 오류를 모니터링합니다.
+ 스트림이 온디맨드 용량 모드를 사용하고 있거나 충분한 프로비저닝 용량이 있는지 확인합니다.
+ AWS Ground Station 원격 측정 전용 스트림을 사용하여 다른 애플리케이션과의 경합을 방지합니다.
## 데이터 형식 문제
### JSON 구문 분석 오류
**증상**
원격 측정 레코드를 JSON으로 구문 분석할 때 애플리케이션에 오류가 발생합니다.
**솔루션**
+ **Base64 디코딩 확인** - Kinesis Data Streams 스트림의 데이터는 Base64-encoded. JSON으로 구문 분석하기 전에 데이터를 디코딩해야 합니다. 자세한 내용은 [Kinesis Data Streams 스트림에서 데이터 읽기](telemetry.understanding-data.md#telemetry.understanding-data.reading) 단원을 참조하십시오.
+ **빈 레코드 확인** - *TelemetrySinkConfig*를 생성할 때 빈 검증 레코드를 보낼 AWS Ground Station 수 있습니다. 애플리케이션은 비어 있거나 잘못된 형식의 레코드를 정상적으로 처리해야 합니다.
+ **버전 인식 구문 분석 구현 -** 먼저 `telemetryTypeAndVersion`, `telemetryType`및 `telemetryVersion` 필드를 구문 분석하여 각 레코드에 적합한 스키마를 결정합니다.
### 알 수 없는 원격 측정 유형 또는 버전
**증상**
애플리케이션에서 인식하지 못하는 원격 측정 유형 또는 버전이 발생합니다.
**솔루션**
이는 시간이 지남에 따라 새로운 원격 측정 유형 및 스키마 버전이 도입될 수 있으므로 예상되는 동작입니다. 애플리케이션은 다음을 수행해야 합니다.
+ 모니터링을 위해 알 수 없는 유형 및 버전을 로깅합니다.
+ 알려진 유형 및 버전을 계속 처리합니다.
+ 알 수 없는 스키마에 대한 정상적인 처리를 구현합니다.
스키마 버전 관리에 대한 자세한 내용은 섹션을 참조하세요[스키마 버전 관리 및 진화](telemetry.understanding-data.md#telemetry.understanding-data.schema-evolution).
## 도움말 가져오기
문제 해결 단계를 수행한 후에도 문제가 계속 발생하면 AWS Support에 문의하세요.
**제공할 정보**
지원 팀에 문의할 때 다음 정보를 제공합니다.
+ 문제가 발생한 연락처 IDs
+ 사용된 미션 프로필 ID
+ TelemetrySinkConfig ARN
+ Kinesis Data Streams 스트림 ARN
+ IAM 역할 ARN 및 연결된 정책
+ CloudWatch Logs 또는 애플리케이션의 오류 메시지
+ 문제가 발생한 시점의 타임스탬프
+ 이미 수행된 문제 해결 단계
일반적인 AWS Ground Station 지원은 [AWS Ground Station 사용 설명서를](https://docs.aws.amazon.com/ground-station/latest/ug/what-is.html) 참조하세요.