일반적인 설정 문제 원격 측정 전송 문제 데이터 형식 문제 도움말 가져오기

원격 측정 문제 해결

다음 정보를 사용하여 원격 측정과 관련된 일반적인 문제를 해결합니다.

일반적인 설정 문제

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이 잘못되었거나 스트림이 존재하지 않습니다.

솔루션

IAM 역할이 존재하고 올바른 권한이 있는지 확인합니다. 모든 단계를 2단계: TelemetrySinkConfig 생성 검토하고 준수했는지 확인합니다.
가 IAM 역할을 수임 AWS Ground Station 할 수 있는지 확인합니다.
```
aws iam get-role --role-name GroundStationTelemetryRole
```
신뢰 정책에가 신뢰할 수 있는 서비스 보안 주체groundstation.amazonaws.com로 포함되어 있는지 확인합니다.
IAM 역할에 필요한 Kinesis 권한이 있는지 확인합니다.
```
aws iam list-attached-role-policies --role-name GroundStationTelemetryRole
```
정책에 스트림에 대한 kinesis:DescribeStreamkinesis:PutRecord, 및 kinesis:PutRecords 권한이 포함되어 있는지 확인합니다.

Kinesis Data Streams 스트림이 존재하고 ARN이 올바른지 확인합니다.


aws kinesis describe-stream \
    --stream-name your-stream-name \
    --region us-east-2

고객 관리형 암호화를 사용하는 경우 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 스트림의 용량이 원격 측정 처리량에 충분하지 않습니다.
스트림이 다른 애플리케이션에서 사용 중이므로 쓰기 제한이 발생합니다.

솔루션

스트림 상태를 확인합니다.


aws kinesis describe-stream \
    --stream-name your-stream-name \
    --region us-east-2

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

제한이 감지되면 다음을 고려하세요.
- 자동 조정을 위해 온디맨드 용량 모드로 전환합니다.
- 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 권한 오류.

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 스트림 구성 문제을(를) 참조하세요.
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 스트림에서 데이터 읽기 단원을 참조하십시오.
빈 레코드 확인 - TelemetrySinkConfig를 생성할 때 빈 검증 레코드를 보낼 AWS Ground Station 수 있습니다. 애플리케이션은 비어 있거나 잘못된 형식의 레코드를 정상적으로 처리해야 합니다.
버전 인식 구문 분석 구현 - 먼저 telemetryTypeAndVersion, telemetryType및 telemetryVersion 필드를 구문 분석하여 각 레코드에 적합한 스키마를 결정합니다.

알 수 없는 원격 측정 유형 또는 버전

증상

애플리케이션에서 인식하지 못하는 원격 측정 유형 또는 버전이 발생합니다.

솔루션

이는 시간이 지남에 따라 새로운 원격 측정 유형 및 스키마 버전이 도입될 수 있으므로 예상되는 동작입니다. 애플리케이션은 다음을 수행해야 합니다.

모니터링을 위해 알 수 없는 유형 및 버전을 로깅합니다.
알려진 유형 및 버전을 계속 처리합니다.
알 수 없는 스키마에 대한 정상적인 처리를 구현합니다.

스키마 버전 관리에 대한 자세한 내용은 섹션을 참조하세요스키마 버전 관리 및 진화.

도움말 가져오기

문제 해결 단계를 수행한 후에도 문제가 계속 발생하면 AWS Support에 문의하세요.

제공할 정보

지원 팀에 문의할 때 다음 정보를 제공합니다.

문제가 발생한 연락처 IDs
사용된 미션 프로필 ID
TelemetrySinkConfig ARN
Kinesis Data Streams 스트림 ARN
IAM 역할 ARN 및 연결된 정책
CloudWatch Logs 또는 애플리케이션의 오류 메시지
문제가 발생한 시점의 타임스탬프
이미 수행된 문제 해결 단계

일반적인 AWS Ground Station 지원은 AWS Ground Station 사용 설명서를 참조하세요.

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

문서 규칙

데이터를 수신하지 못한 고객 응대 문제 해결

할당량 및 제한