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 fournies sous forme d'enregistrements JSON codés en Base64 à votre flux Kinesis Data Streams. Chaque enregistrement contient des informations collectées lors de votre contact satellite, notamment des métadonnées sur le contact et les mesures télémétriques échantillonnées.

Vue d'ensemble des formats de données

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

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 toute la télémétrie d'un type donné pour un seul contact est transmise à la même partition au sein de votre flux Kinesis Data Streams, ce qui permet de trier 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 le satellite. Ce type de télémétrie est toujours envoyé lors d'un contact.

Champs de données

Champs de métadonnées

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
  }
}

Télémétrie de suivi

La télémétrie de suivi fournit des informations sur l'état du suivi des antennes 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.

Champs de données

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 les modèles de consommation de flux standard. Lorsque vous lisez les données de votre flux, tenez compte des points suivants.

Décodage Base64

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

Utilisation du Kinesis Data Viewer

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

Utilisation de la bibliothèque cliente Kinesis

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

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

Bonnes pratiques en matière de consommation

Versionnement et évolution des schémas

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

Gestion des modifications de schéma

Nous vous recommandons de mettre en œuvre une sérialisation des charges utiles adaptée aux versions, capable de gérer plusieurs versions de schéma avec élégance, afin de permettre à vos applications de continuer à fonctionner lorsque de nouvelles versions sont introduites.