View a markdown version of this page

Résoudre les problèmes de télémétrie - AWS Ground Station
Problèmes de configuration courantsProblèmes de transmission de données télémétriquesProblèmes liés au format des donnéesObtenir de l'aide

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 et assurez-vous que toutes les étapes ont été suivies.

  2. 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.

  3. 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:DescribeStreamkinesis:PutRecord, et kinesis:PutRecords les autorisations pour votre stream.

  4. 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

  5. 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 appelezCreateConfig, 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

  2. 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

  3. 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

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

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.

  • 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 telemetryTypeAndVersiontelemetryType, 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, consultezVersionnement et évolution des schémas.

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.