View a markdown version of this page

Comprendre les données de télémétrie - AWS Ground Station
Présentation du format de donnéesTélémétrie de pointageSuivi de la télémétrieLecture de données depuis le flux Kinesis Data StreamsVersionnage et évolution des schémas

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.

Comprendre les données de télémétrie

Les données de télémétrie sont transmises sous forme d'enregistrements Base64-encoded JSON à votre flux Kinesis Data Streams. Chaque enregistrement contient des informations collectées lors de votre contact avec le satellite, y compris des métadonnées concernant le contact et les mesures de télémétrie échantillonnées.

Présentation du format de données

Chaque enregistrement de télémétrie contient les éléments suivants :

Type et version de télémétrie

Identifie le type spécifique de données de télémétrie et la version de son schéma. Cela vous permet d'analyser les différents types de télémétrie de manière appropriée. Pour plus d'informations sur la gestion des versions des schémas, consultezVersionnage et évolution des schémas.

Identifiant de l'étendue

Un identifiant unique pour l'étendue de la télémétrie. Cela vous permet de corréler les données de télémétrie avec des contacts spécifiques.

Métadonnées

Informations contextuelles sur la télémétrie.

Données

Les mesures de télémétrie échantillonnées spécifiques au type de télémétrie.

Clé de partition

Les enregistrements de télémétrie sont transmis à votre flux Kinesis Data Streams avec une clé de partition au format suivant : 

SCOPE#scopeId#TELEMETRY_ID#telemetryId#TELEMETRY_VERSION#telemetryVersion

Cette clé de partition garantit que toutes les données télémétriques d'un type donné pour un contact unique sont transmises à la même partition au sein de votre flux Kinesis Data Streams, ce qui permet de classer au mieux le flux de télémétrie de ce contact.

Télémétrie de pointage

La télémétrie de pointage fournit des informations sur la direction de pointage de l'antenne lors des contacts avec les satellites. Ce type de télémétrie est toujours envoyé lors d'un contact.

Champs de données

Exemple d'horodatage

Heure à laquelle les données de télémétrie ont été échantillonnées, ISO-8601 au format UTC avec une précision de la milliseconde.

azimut

Angle azimutal réel de l'antenne en degrés.

élévation

Angle d'élévation réel de l'antenne en degrés.

Azimut commandé

Angle azimutal commandé en degrés. Il s'agit de l'angle azimutal cible que l'antenne tente d'atteindre.

Élévation commandée

Angle d'élévation commandé en degrés. Il s'agit de l'angle d'élévation cible que l'antenne tente d'atteindre.

Note

La position réelle de l'antenne peut différer de la position commandée en raison de limitations physiques ou de retards mécaniques pendant le contact.

Champs de métadonnées

Station terrestre

Nom de la station au sol (par exemple, « Ohio 1 »).

Identifiant du satellite

Identifiant de la ressource satellite dans AWS Ground Station.

contactId

Identifiant du contact.

Exemple JSON 

{
  "telemetryTypeAndVersion": "POINTING#1.0.0",
  "telemetryType": "POINTING",
  "telemetryVersion": "1.0.0",
  "scopeId": "12345678-1234-1234-1234-123456789012",
  "metadata": {
    "groundStation": "Ohio 1",
    "satelliteId": "87654321-4321-4321-4321-210987654321",
    "contactId": "12345678-1234-1234-1234-123456789012"
  },
  "data": {
    "sampleTimestamp": "2025-12-08T12:00:00.123Z",
    "azimuth": 180.5,
    "elevation": 45.2,
    "commandedAzimuth": 180.0,
    "commandedElevation": 45.0
  }
}

Suivi de la télémétrie

La télémétrie de suivi fournit des informations sur l'état de suivi de l'antenne et les erreurs de suivi. Ce type de télémétrie est envoyé lorsque le suivi automatique est activé dans votre configuration de suivi et lorsque l'antenne utilise activement le suivi automatique.

Note

Si le autotrack paramètre de votre choix TrackingConfig est défini surREMOVED, aucune télémétrie de suivi ne sera fournie. Pour plus d'informations sur le suivi des configurations, consultezSuivi de Config.

Champs de données

Exemple d'horodatage

Heure à laquelle les données de télémétrie ont été échantillonnées, ISO-8601 au format UTC avec une précision de la milliseconde.

État du suivi

État de suivi actuel de l'antenne. Les valeurs possibles sont :

  • TRACKING— L'antenne a réussi à capter un signal correspondant au profil de la mission et le suit activement dans le ciel. Il s'agit de l'état de fonctionnement nominal lors d'un contact.

  • ACQUIRING— L'antenne est en train de localiser et de verrouiller le signal. Le système utilise actuellement un suivi programmatique, un pointage basé sur les données des éphémérides.

  • MASKED— La position prévue du satellite se trouve derrière un masque de suivi automatique, ce qui signifie que l'antenne ne peut pas utiliser de manière fiable le suivi automatique dans cette direction de pointage spécifique. Cela se produit généralement dans les zones de fortes interférences RF, telles que les basses altitudes.

suivi ErrorAzimuth

Erreur de suivi sur l'axe azimutal, mesurée en degrés.

suivi ErrorElevation

Erreur de suivi sur l'axe d'élévation, mesurée en degrés.

Note

Les valeurs d'erreur de suivi représentent des ajustements par rapport à la piste de programme basée sur les éphémérides qui AWS Ground Station s'applique pendant le suivi automatique afin de maximiser la puissance du signal.

Champs de métadonnées

La télémétrie de suivi inclut les mêmes champs de métadonnées que la télémétrie de pointage :groundStation, et. satelliteId contactId

Exemple JSON 

{
  "telemetryTypeAndVersion": "TRACKING#1.0.0",
  "telemetryType": "TRACKING",
  "telemetryVersion": "1.0.0",
  "scopeId": "12345678-1234-1234-1234-123456789012",
  "metadata": {
    "groundStation": "Ohio 1",
    "satelliteId": "87654321-4321-4321-4321-210987654321",
    "contactId": "12345678-1234-1234-1234-123456789012"
  },
  "data": {
    "sampleTimestamp": "2025-12-08T12:00:00.123Z",
    "trackingStatus": "TRACKING",
    "trackingErrorAzimuth": 0.2,
    "trackingErrorElevation": 0.1
  }
}

Lecture de données depuis le flux Kinesis Data Streams

Les données de télémétrie sont transmises à votre flux Kinesis Data Streams et peuvent être consommées selon des modèles de consommation de flux standard. Lorsque vous lisez les données de votre stream, tenez compte des points suivants.

Décodage Base64

Les données du flux Kinesis Data Streams sont Base64-encoded. Vous devez décoder les données avant de les analyser au format JSON. Pour plus d'informations, consultez la section Utilisation d'Amazon Kinesis Data Streams.

Utilisation de la visionneuse de données Kinesis

Pour accéder rapidement à vos données de télémétrie, la console de diffusion Kinesis Data Streams propose une fonction Data Viewer. Lorsque vous utilisez cette fonctionnalité :

  • La télémétrie peut être transmise à n'importe quel fragment de votre flux.

  • La position de départ par défaut se lit à partir des derniers enregistrements de la partition.

  • Vous devrez peut-être ajuster la partition sélectionnée et utiliser la position de départ « À l'horodatage » pour afficher les enregistrements reçus.

Utilisation de la bibliothèque cliente Kinesis

La bibliothèque cliente Kinesis (KCL) gère de nombreuses complexités associées à la consommation de données provenant du flux Kinesis Data Streams, notamment la gestion des partitions, les points de contrôle et l'équilibrage de charge. Nous vous recommandons d'utiliser KCL pour les applications de consommation de télémétrie de production.

Pour plus d'informations, consultez la section Développement des consommateurs à l'aide de la bibliothèque cliente Kinesis.

Meilleures pratiques en matière de consommation

  • Minimiser la latence  : utilisez la Fan-Out fonction Enhanced pour lire à partir du flux Kinesis Data Streams avec un débit dédié et une latence inférieure à celle du polling. Pour plus d'informations, voir Developing Enhanced Fan-Out Consumers.

  • Stream dédié  : utilisez un flux Kinesis Data Streams dédié pour votre intégration de AWS Ground Station télémétrie. Le partage d'un flux avec d'autres applications peut entraîner une saturation du débit d'écriture et des échecs de diffusion de la télémétrie.

  • On-demand capacité  : déployez votre flux Kinesis Data Streams en mode de provisionnement à la demande pour permettre la mise à l'échelle automatique des partitions en fonction du débit.

  • Surveillez le débit  : surveillez la limitation de votre flux à l'aide CloudWatch de métriques. Pour plus d'informations, consultez la section Surveillance des flux de données Amazon Kinesis.

Versionnage et évolution des schémas

Les schémas de télémétrie sont versionnés pour prendre en charge leur évolution dans le temps. Le telemetryVersion champ de chaque enregistrement indique la version du schéma.

Gestion des modifications de schéma

  • De nouveaux types de télémétrie pourraient être introduits à l'avenir.

  • Les types de télémétrie existants peuvent recevoir de nouvelles versions avec des modifications majeures.

  • Vos applications doivent être tolérantes à l'égard de types et de versions de télémétrie inconnus.

  • Analysez les telemetryVersion champs telemetryTypeAndVersiontelemetryType, et pour déterminer comment traiter chaque enregistrement.

Nous vous recommandons de mettre en œuvre une sérialisation des charges utiles tenant compte des versions, capable de gérer correctement plusieurs versions de schéma, afin de permettre à vos applications de continuer à fonctionner lorsque de nouvelles versions sont introduites.