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 livraison de télémétrieProblèmes de format de 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 sur le rôle IAM ne permet pas AWS Ground Station d'assumer ce rôle.

  • L'ARN du flux Kinesis Data Streams TelemetrySinkConfig 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. Passez en revue Étape 2 : créer 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 en tant que principal 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é à utiliser 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é à accéder au 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::123456789012: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 de l'écriture.

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 de l'écriture à 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é, considérez les points suivants :

    • 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 livraison de télémétrie

Aucune donnée de télémétrie n'apparaît

Symptômes

Après avoir programmé un contact avec un profil de mission télémétrique, 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 sur 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 sur le profil de mission.

Problème d'autorisations de rôle 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 diffusion de la télémétrie commence à l'heure de début du contact. Vérifiez que le contact a commencé en vérifiant son statut : 

aws groundstation describe-contact \
    --contact-id 12345678-1234-1234-1234-123456789012 \
    --region us-east-2
Contact programmé sur une station terrestre jumelle numérique

Les stations terrestres jumelles numériques ne prennent pas en charge la télémétrie. Les contacts programmés sur des antennes jumelles numériques ne produisent pas de données de télémétrie. Vérifiez que la station au sol utilisée pour votre contact n'est pas un jumeau numérique en vérifiant le nom de la station au sol. Les stations terrestres jumelles numériques ont un préfixe « Digital Twin » dans leur nom. Pour plus d’informations, consultez Utilisez la commande AWS Ground Station fonction de jumeau numérique.

Données de télémétrie intermittentes

Symptômes

Les données de télémétrie ne sont pas fournies de manière cohérente avec des lacunes ou des enregistrements manquants.

Causes possibles

Des solutions

  • Surveillez les métriques des flux de données Kinesis CloudWatch pour détecter toute limitation ou erreur.

  • Assurez-vous que votre flux utilise le mode de capacité à la demande ou dispose d'une capacité provisionnée suffisante.

  • Utilisez un flux dédié à la AWS Ground Station télémétrie afin d'éviter tout conflit avec d'autres applications.

Problèmes de format de 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. Base64-encoded Assurez-vous de décoder les données avant de les analyser au format JSON. Pour plus d’informations, consultez 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 correctement les enregistrements vides ou mal formés.

  • Implémentez une analyse syntaxique tenant compte des 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 les versions inconnus à des fins de surveillance.

  • Continuez à traiter les types et les versions connus.

  • Implémentez une gestion élégante pour les schémas inconnus.

Pour plus d'informations sur la gestion des versions des schémas, consultezVersionnage et évolution des schémas.

Obtenir de l'aide

Si les problèmes persistent après avoir suivi les étapes de dépannage, contactez le AWS support.

Informations à fournir

Lorsque vous contactez le support, fournissez les informations suivantes :

  • Les identifiants de contact rencontrent des problèmes

  • Identifiant du profil de mission utilisé

  • TelemetrySinkConfig ARN

  • ARN du flux de données Kinesis

  • ARN du rôle IAM et politiques associées

  • Messages d'erreur provenant de CloudWatch Logs ou de votre application

  • Horodatages des problèmes survenus

  • Étapes de dépannage déjà prises

Pour obtenir une AWS Ground Station assistance générale, consultez le Guide de AWS Ground Station l'utilisateur.