Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra. # Résoudre les problèmes de télémétrie Utilisez les informations suivantes pour résoudre les problèmes courants liés à la télémétrie. ## Problèmes de configuration courants ### Erreurs d'autorisation IAM **Symptômes** Lorsque vous appelez `CreateConfig` pour créer un TelemetrySinkConfig, vous recevez un message d'erreur : ``` Unable to write to Kinesis Data Streams stream. Ensure that Ground Station has kinesis:PutRecord permissions for the given stream ``` **Les causes** + Le rôle IAM spécifié dans le TelemetrySinkConfig ne dispose pas des autorisations requises pour écrire dans le flux Kinesis Data Streams. + La politique de confiance relative au rôle IAM ne permet pas AWS Ground Station d'assumer ce rôle. + L'ARN du flux Kinesis Data Streams dans TelemetrySinkConfig le est incorrect ou le flux n'existe pas. **Des solutions** 1. Vérifiez que le rôle IAM existe et qu'il dispose des autorisations appropriées. Vérifiez [Étape 2 : Création d'un TelemetrySinkConfig](telemetry.setup.md#telemetry.setup.step2) et assurez-vous que toutes les étapes ont été suivies. 1. Vérifiez qu'il AWS Ground Station peut assumer votre rôle IAM : ``` aws iam get-role --role-name GroundStationTelemetryRole ``` Vérifiez que la politique de confiance inclut `groundstation.amazonaws.com` un principe de service fiable. 1. Vérifiez que le rôle IAM dispose des autorisations Kinesis requises : ``` aws iam list-attached-role-policies --role-name GroundStationTelemetryRole ``` Assurez-vous que la politique inclut `kinesis:DescribeStream``kinesis:PutRecord`, et `kinesis:PutRecords` les autorisations pour votre stream. 1. Vérifiez que le flux Kinesis Data Streams existe et que l'ARN est correct : ``` aws kinesis describe-stream \ --stream-name your-stream-name \ --region us-east-2 ``` 1. Si vous utilisez un chiffrement géré par le client, vérifiez que le rôle IAM est `kms:GenerateDataKey` autorisé à accéder à votre clé. AWS KMS ### PassRole erreurs d'autorisation **Symptômes** Lorsque vous appelez`CreateConfig`, vous recevez un message d'erreur indiquant que vous n'êtes pas autorisé à transmettre le rôle IAM. **Solution** Assurez-vous que votre utilisateur ou rôle IAM est `iam:PassRole` autorisé à utiliser le rôle IAM de télémétrie. Ajoutez la politique suivante à votre utilisateur ou à votre rôle : ``` { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "iam:GetRole", "iam:PassRole" ], "Resource": "arn:aws:iam::99999999999:role/your-stream-name" } ] } ``` ### Problèmes de configuration du flux Kinesis Data Streams **Symptômes** La transmission de la télémétrie échoue ou est intermittente. **Les causes** + La capacité du flux Kinesis Data Streams est insuffisante pour le débit de télémétrie. + Le flux est utilisé par d'autres applications, ce qui entraîne une limitation des écritures. **Des solutions** 1. Vérifiez l'état du stream : ``` aws kinesis describe-stream \ --stream-name your-stream-name \ --region us-east-2 ``` 1. Surveillez la limitation des écritures à l'aide CloudWatch de métriques : ``` 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. Si un étranglement est détecté, pensez à : + Passage en mode capacité à la demande pour une mise à l'échelle automatique. + Utilisation d'un flux dédié pour la AWS Ground Station télémétrie. + Si vous utilisez le mode provisionné, augmentez le nombre de partitions. ## Problèmes de transmission de données télémétriques ### Aucune donnée de télémétrie n'apparaît **Symptômes** Après avoir planifié un contact avec un profil de mission compatible avec la télémétrie, aucune donnée de télémétrie n'apparaît dans votre flux Kinesis Data Streams. **Causes possibles et solutions** La télémétrie n'est pas activée dans le profil de mission Vérifiez que le profil de mission utilisé pour le contact inclut `telemetrySinkConfigArn` : ``` aws groundstation get-mission-profile \ --mission-profile-id 12345678-1234-1234-1234-123456789012 \ --region us-east-2 ``` Vérifiez la sortie du `telemetrySinkConfigArn` champ. S'il n'est pas présent, la télémétrie n'est pas activée dans le profil de mission. Problème d'autorisations liées aux rôles IAM Consultez les étapes de résolution des problèmes liés aux autorisations IAM dans. [Erreurs d'autorisation IAM](#troubleshooting-telemetry.iam-permissions) Le flux Kinesis Data Streams n'existe pas ou se trouve dans la mauvaise région Vérifiez que le flux existe dans la bonne région : ``` aws kinesis describe-stream \ --stream-name your-stream-name \ --region us-east-2 ``` Le contact n'a pas encore commencé La transmission de données télémétriques commence à l'heure de début du contact. Vérifiez que le contact a démarré en vérifiant son statut : ``` aws groundstation describe-contact \ --contact-id 12345678-1234-1234-1234-123456789012 \ --region us-east-2 ``` ### Données de télémétrie intermittentes **Symptômes** Les données de télémétrie sont fournies de manière incohérente en cas de lacunes ou d'enregistrements manquants. **Causes possibles** + Problèmes de capacité ou de limitation des flux Kinesis Data Streams. Consultez [Problèmes de configuration du flux Kinesis Data Streams](#troubleshooting-telemetry.kinesis-config). + Problèmes de connectivité réseau entre AWS Ground Station et votre flux Kinesis Data Streams. **Des solutions** + Surveillez les métriques des flux Kinesis Data Streams pour CloudWatch détecter toute limitation ou erreur. + Assurez-vous que votre flux utilise le mode capacité à la demande ou dispose d'une capacité provisionnée suffisante. + Utilisez un flux dédié pour la AWS Ground Station télémétrie afin d'éviter les conflits avec d'autres applications. ## Problèmes liés au format des données ### Erreurs d'analyse JSON **Symptômes** Votre application rencontre des erreurs lors de l'analyse des enregistrements de télémétrie au format JSON. **Des solutions** + **Vérifiez le décodage Base64** : les données du flux Kinesis Data Streams sont codées en Base64. Assurez-vous de décoder les données avant de les analyser au format JSON. Pour de plus amples informations, veuillez consulter [Lecture de données depuis le flux Kinesis Data Streams](telemetry.understanding-data.md#telemetry.understanding-data.reading). + **Vérifiez les enregistrements vides** : AWS Ground Station peut envoyer des enregistrements de validation vides lors de la création d'un *TelemetrySinkConfig*. Votre application doit gérer les enregistrements vides ou mal formés avec élégance. + **Implémentez une analyse basée sur les versions** : analysez d'abord les `telemetryVersion` champs `telemetryTypeAndVersion``telemetryType`, et afin de déterminer le schéma approprié pour chaque enregistrement. ### Types ou versions de télémétrie inconnus **Symptômes** Votre application rencontre des types ou des versions de télémétrie qu'elle ne reconnaît pas. **Solution** Ce comportement est normal car de nouveaux types de télémétrie et de nouvelles versions de schéma peuvent être introduits au fil du temps. Votre candidature doit : + Enregistrez les types et versions inconnus à des fins de surveillance. + Poursuivre le traitement des types et des versions connus. + Implémentez une gestion gracieuse des schémas inconnus. Pour plus d'informations sur le versionnement des schémas, consultez[Versionnement et évolution des schémas](telemetry.understanding-data.md#telemetry.understanding-data.schema-evolution). ## Obtenir de l'aide Si vous continuez à rencontrer des problèmes après avoir suivi les étapes de résolution des problèmes, contactez le AWS Support. **Informations à fournir** Lorsque vous contactez le support, fournissez les informations suivantes : + Contacter IDs qui rencontre des problèmes + ID de profil de mission utilisé + TelemetrySinkConfig ARN + Kinesis Data Streams (ARN) + ARN du rôle IAM et politiques associées + Messages d'erreur provenant de CloudWatch Logs ou de votre application + Horodatage lorsque des problèmes sont survenus + Mesures de résolution des problèmes déjà prises Pour obtenir une AWS Ground Station assistance générale, consultez le [guide de AWS Ground Station l'utilisateur](https://docs.aws.amazon.com/ground-station/latest/ug/what-is.html).