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. # Travailler avec la télémétrie AWS Ground Station la télémétrie fournit des mesures en temps quasi réel à partir des AWS Ground Station antennes lors de vos contacts avec les satellites. Vous pouvez utiliser les données de télémétrie pour surveiller les performances des contacts, détecter les anomalies et prendre des décisions éclairées concernant vos communications par satellite. ## Comment fonctionne la télémétrie Pour utiliser la télémétrie, vous configurez un *TelemetrySinkConfig*qui indique où les données de télémétrie AWS Ground Station doivent être transmises. Vous ajoutez ensuite cette configuration à votre profil de mission à l'aide du `telemetrySinkConfigArn` champ. Lors de contacts utilisant un profil de mission compatible avec la télémétrie, les données de télémétrie AWS Ground Station sont transmises à votre compte. Le processus de transmission de données télémétriques fonctionne comme suit : 1. Vous créez un flux Kinesis Data Streams dans AWS votre compte pour recevoir des données de télémétrie. Le stream doit être créé dans le même compte et dans la même région que ceux à partir desquels vous programmez vos contacts. 1. Vous créez un rôle IAM qui AWS Ground Station autorise l'écriture de données dans votre flux. 1. Vous créez un TelemetrySinkConfig qui fait référence à votre flux et à votre rôle IAM. 1. Vous les ajoutez TelemetrySinkConfig à votre profil de mission. 1. Vous listez et réservez des contacts à l'aide du nouveau profil de mission compatible avec la télémétrie. 1. Lors des contacts utilisant ce profil de mission, les données de télémétrie sont diffusées en temps quasi réel sur votre AWS Ground Station flux Kinesis Data Streams. 1. Vous consommez et traitez les données de télémétrie de votre flux à l'aide de AWS services ou de vos propres applications. ## Types de télémétrie disponibles AWS Ground Station fournit les types de télémétrie suivants lors des contacts : **Note** AWS Ground Station travaille à l'augmentation du nombre de types de télémétrie pris en charge 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 et inclut les angles d'azimut et d'élévation réels et commandés. Pour de plus amples informations, veuillez consulter [Télémétrie de pointage](telemetry.understanding-data.md#telemetry.understanding-data.pointing). Télémétrie de suivi Fournit des informations sur l'état du 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. Pour de plus amples informations, veuillez consulter [Télémétrie de suivi](telemetry.understanding-data.md#telemetry.understanding-data.tracking). ## Disponibilité par région La télémétrie est disponible dans toutes les AWS régions où AWS Ground Station elle est implantée. Pendant l'exécution du contact, la télémétrie sera transmise depuis l' AWS Ground Station antenne à la région depuis laquelle vous avez programmé votre contact, fournissant ainsi une assistance interrégionale. Pour une liste complète des AWS Ground Station régions et des emplacements des stations au sol, voir[AWS Ground Station Succursales](aws-ground-station-antenna-locations.md). **Topics** + [Comment fonctionne la télémétrie](#telemetry.how-it-works) + [Types de télémétrie disponibles](#telemetry.telemetry-types) + [Disponibilité par région](#telemetry.regional-availability) + [Configuration de la télémétrie](telemetry.setup.md) + [Comprendre les données de télémétrie](telemetry.understanding-data.md) # Configuration de la télémétrie Suivez ces étapes pour configurer la télémétrie pour vos AWS Ground Station contacts. Une fois cette configuration terminée, les données de télémétrie seront transmises à votre flux Kinesis Data Streams lors des contacts utilisant un profil de mission compatible avec la télémétrie. Pour une compréhension approfondie de Kinesis Data Streams, reportez-vous au Guide de [l'utilisateur de Kinesis Data](https://docs.aws.amazon.com/streams/latest/dev/introduction.html) Streams. ## Étape 1 : créer des AWS ressources prérequises L' CloudFormation extrait suivant montre comment créer les AWS ressources nécessaires à la diffusion de données télémétriques. Cet extrait crée un flux Kinesis Data Streams et un rôle IAM qui AWS Ground Station autorise l'écriture de données de télémétrie dans le flux. ``` TelemetryStream: Type: AWS::Kinesis::Stream Properties: Name: GroundStationTelemetryStream StreamModeDetails: StreamMode: ON_DEMAND RetentionPeriodHours: 24 TelemetryRole: Type: AWS::IAM::Role Properties: RoleName: GroundStationTelemetryRole AssumeRolePolicyDocument: Version: '2012-10-17' Statement: - Effect: Allow Principal: Service: groundstation.amazonaws.com Action: sts:AssumeRole Policies: - PolicyName: KinesisWritePolicy PolicyDocument: Version: '2012-10-17' Statement: - Effect: Allow Action: - kinesis:DescribeStream - kinesis:PutRecord - kinesis:PutRecords Resource: !GetAtt TelemetryStream.Arn ``` La liste ci-dessous présente des considérations de configuration uniques lors de la configuration de la diffusion de télémétrie pour. AWS Ground Station Flux **Kinesis Data Streams : le flux** utilise le mode capacité à la demande, qui évolue automatiquement en fonction du débit. Cela est recommandé pour la plupart des cas d'utilisation. Le flux est configuré pour conserver les données pendant 24 heures. Par défaut, le flux utilise le chiffrement AWS géré. Pour utiliser le chiffrement géré par le client AWS Key Management Service, ajoutez la `StreamEncryption` propriété et mettez à jour la politique de rôle IAM pour inclure les autorisations. `kms:GenerateDataKey` Pour plus d'informations, consultez la section [Protection des données dans Amazon Kinesis Data Streams](https://docs.aws.amazon.com/streams/latest/dev/server-side-encryption.html). Rôle **IAM : le rôle** IAM permet au principal du `groundstation.amazonaws.com` service d'assumer le rôle et d'écrire des données de télémétrie dans votre flux Kinesis Data Streams. La politique de rôle accorde des autorisations pour `kinesis:DescribeStream``kinesis:PutRecord`, et `kinesis:PutRecords` des actions sur le flux. Consultez [Config du récepteur de télémétrie](how-it-works.config.md#how-it-works.config-telemetry-sink) pour obtenir des conseils sur la mise en place de la politique de confiance et de la politique des rôles. **Configuration supplémentaire** : ajoutez `iam:PassRole` des autorisations à l'utilisateur ou au rôle IAM que vous utilisez pour les appels AWS Ground Station d'API. Cela vous permet de transmettre le rôle de télémétrie AWS Ground Station lors de la création d'un. TelemetrySinkConfig ### Exemple PassRole de politique Pour plus d'informations sur la façon de mettre à jour ou d'associer une politique de rôle, consultez [la section Gestion des politiques IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage.html) dans le Guide de l'utilisateur IAM. Pour plus d'informations sur l'`iam:PassRole`autorisation, consultez [Accorder à un utilisateur l'autorisation de transmettre un rôle à un service AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use_passrole.html) ``` { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "iam:GetRole", "iam:PassRole" ], "Resource": "arn:aws:iam::999999999999:role/your-telemetry-delivery-role-name" } ] } ``` ## Étape 2 : Création d'un TelemetrySinkConfig Créez un *TelemetrySinkConfig*qui définit la manière dont les données de télémétrie AWS Ground Station seront transmises à votre flux Kinesis Data Streams. Utilisez l'ARN du flux et l'ARN du rôle issus des sorties de la CloudFormation pile à l'étape 1. **Note** Lorsque vous créez un *TelemetrySinkConfig*, il AWS Ground Station vérifiera l'accès à votre flux Kinesis Data Streams en fournissant un enregistrement de test vide avec une clé `test` de partition de. Pour plus d'informations sur la création d'un *TelemetrySinkConfig*, consultez[Config du récepteur de télémétrie](how-it-works.config.md#how-it-works.config-telemetry-sink). ## Étape 3 : ajouter la télémétrie à votre profil de mission Créez un profil de mission. Pour plus d'informations sur la création de profils de mission, consultez[Utiliser les profils AWS Ground Station de mission](how-it-works-mission-profile.md). Ajoutez-le `telemetrySinkConfigArn` à votre profil de mission pour permettre la transmission de données télémétriques lors des contacts. Utilisez l'ARN du *TelemetrySinkConfig*créé à l'étape 2. ## Étape 4 : Planifier un contact Planifiez un contact à l'aide de votre profil de mission compatible avec la télémétrie. Pendant le contact, AWS Ground Station diffusera les données de télémétrie vers votre flux Kinesis Data Streams. **À quoi s'attendre lors des contacts** + Démarrage de la **télémétrie : les données commencent** à être diffusées dès que le contact démarre. + **Livraison en temps quasi réel - La** télémétrie arrive dans votre flux Kinesis Data Streams en temps quasi réel. + **Durée du contact** - Les données sont conservées pendant toute la durée du contact. + **Arrêt automatique** : la télémétrie arrête le streaming lorsque le contact prend fin. **Surveillance de la livraison** Vous pouvez surveiller la diffusion de données télémétriques à l'aide de : + Statistiques relatives aux flux **Kinesis Data Streams** : archivez les enregistrements CloudWatch entrants. Pour plus d'informations, consultez la section [Surveillance d'Amazon Kinesis Data Streams](https://docs.aws.amazon.com/streams/latest/dev/monitoring-with-cloudwatch.html). + **Journaux des applications** : vérifiez le traitement des données dans vos applications consommant des données provenant du flux. + **Kinesis Data Viewer** : utilisez la console de streaming Kinesis Data Streams pour consulter des exemples d'enregistrements de votre flux. ## Étapes suivantes Une fois la configuration terminée, vous pouvez : + Découvrez le format des données de télémétrie et les types de télémétrie disponibles. Consultez [Comprendre les données de télémétrie](telemetry.understanding-data.md). + Créez des applications pour traiter les données de télémétrie issues de votre flux Kinesis Data Streams. Pour plus d'informations, consultez [Building Consumers for Amazon Kinesis Data Streams](https://docs.aws.amazon.com/streams/latest/dev/building-consumers.html). + Créez des tableaux de bord et des alertes à l'aide CloudWatch d'autres AWS services. + Consultez les conseils de résolution des problèmes si vous rencontrez des problèmes. Consultez [Résoudre les problèmes de télémétrie](troubleshooting-telemetry.md). # 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 : 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 le versionnement des schémas, consultez[Versionnement et évolution des schémas](#telemetry.understanding-data.schema-evolution). ID de portée 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 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** Exemple d'horodatage Heure à laquelle les données de télémétrie ont été échantillonnées, au format ISO-8601 en UTC avec une précision de la milliseconde. azimut Angle d'azimut 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 d'azimut commandé en degrés. Il s'agit de l'angle d'azimut 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 au sol 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 } } ``` ## 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. **Note** Si le `autotrack` paramètre de votre TrackingConfig est défini sur`REMOVED`, aucune télémétrie de suivi ne sera délivrée. Pour plus d'informations sur le suivi des configurations, consultez[Suivi de Config](how-it-works.config.md#how-it-works.config-tracking). **Champs de données** Exemple d'horodatage Heure à laquelle les données de télémétrie ont été échantillonnées, au format ISO-8601 en UTC avec une précision de la milliseconde. État du suivi État de suivi actuel de l'antenne. Les valeurs possibles incluent `TRACKING`, `ACQUIRING` et `MASKED`. trackingErrorAzimuth Erreur de suivi sur l'axe azimutal, mesurée en degrés. trackingErrorElevation Erreur de suivi sur l'axe d'élévation, mesurée en degrés. **Note** Les valeurs d'erreur de suivi représentent les ajustements par rapport à la piste de programme basée sur les éphémérides qui AWS Ground Station s'appliquent 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 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](https://docs.aws.amazon.com/streams/latest/dev/working-with-streams.html). **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é : + La télémétrie peut être transmise à n'importe quel fragment de votre flux. + La position de départ par défaut est lue à 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 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](https://docs.aws.amazon.com/streams/latest/dev/kcl.html). **Bonnes pratiques en matière de consommation** + **Minimisez la latence** : utilisez le ventilateur amélioré pour lire le flux Kinesis Data Streams avec un débit dédié et une latence inférieure à celle d'un sondage. Pour plus d'informations, consultez la section [Développement de consommateurs de fan-out améliorés](https://docs.aws.amazon.com/streams/latest/dev/enhanced-consumers.html). + **Stream dédié** : utilisez un flux Kinesis Data Streams dédié pour AWS Ground Station votre intégration de 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 transmission de données télémétriques. + **Capacité à la demande** : déployez votre flux Kinesis Data Streams en mode de provisionnement à la demande pour permettre le dimensionnement automatique des partitions en fonction du débit. + **Surveillez le débit** : surveillez la régulation de votre flux à l'aide de métriques. CloudWatch Pour plus d'informations, consultez la section [Surveillance d'Amazon Kinesis Data Streams](https://docs.aws.amazon.com/streams/latest/dev/monitoring-with-cloudwatch.html). ## 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** + 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 importantes. + Vos applications doivent tolérer les types et versions de télémétrie inconnus. + Analysez les `telemetryVersion` champs `telemetryTypeAndVersion``telemetryType`, et pour déterminer comment traiter chaque enregistrement. 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.