テレメトリのトラブルシューティング

テレメトリの一般的な問題をトラブルシューティングするには、次の情報を使用します。

一般的なセットアップの問題

IAM アクセス許可エラー

症状

TelemetrySinkConfig を作成CreateConfigするためにを呼び出すと、エラーが表示されます。


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:DescribeStream、kinesis: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 サポートにお問い合わせください。

提供すべき情報

サポートに連絡するときは、次の情報を入力します。

問題が発生しIDs
使用するミッションプロファイル ID
TelemetrySinkConfig ARN
Kinesis Data Streams ストリーム ARN
IAM ロール ARN とアタッチされたポリシー
CloudWatch Logs またはアプリケーションからのエラーメッセージ
問題が発生したときのタイムスタンプ
既に実行されているトラブルシューティング手順

一般的な AWS Ground Station サポートについては、 AWS Ground Station ユーザーガイドを参照してください。

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

データを受信しなかった問い合わせのトラブルシューティング

クォータと制限