翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # テレメトリのトラブルシューティング テレメトリの一般的な問題をトラブルシューティングするには、次の情報を使用します。 ## 一般的なセットアップの問題 ### 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 が正しくないか、ストリームが存在しません。 **ソリューション** 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 サポートにお問い合わせください。 **提供すべき情報** サポートに連絡するときは、次の情報を入力します。 + 問題が発生し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)を参照してください。