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. # Configurer 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 de contacts utilisant un profil de mission activé par télémétrie. Pour une compréhension approfondie de Kinesis Data Streams, veuillez consulter le guide de l'utilisateur de [ Kinesis Data Streams. ](https://docs.aws.amazon.com/streams/latest/dev/introduction.html) ## Étape 1 : Création d'un prérequis AWS resources L' CloudFormation extrait suivant montre comment créer les AWS ressources nécessaires à la fourniture 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 livraison de télémétrie pour. AWS Ground Station **Flux Kinesis Data Streams ** : le flux utilise le mode de capacité à la demande, qui évolue automatiquement en fonction du débit. Ceci 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 un chiffrement AWS géré. Pour utiliser le chiffrement géré par le client avec AWS Key Management Service, ajoutez la `StreamEncryption` propriété et mettez à jour la politique de rôle IAM pour inclure des 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 responsable 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` et `kinesis:PutRecords` des actions sur le flux. `kinesis:PutRecord` Voir [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 de rôle. **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, voir [ Accorder à un utilisateur les autorisations nécessaires pour 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éer 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 à partir des sorties de la CloudFormation pile à l'étape 1. **Note** Lorsque vous créez un * TelemetrySinkConfig*, AWS Ground Station vérifie l'accès à votre flux Kinesis Data Streams en fournissant un enregistrement de test vide avec une clé de partition de`test`. 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 : Ajoutez 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 diffusion de données télémétriques lors des contacts. Utilisez l'ARN * TelemetrySinkConfig * créé à l'étape 2. ## Étape 4 : Planifier un contact Planifiez un contact à l'aide de votre profil de mission activé par télémétrie. Pendant le contact, les données de télémétrie AWS Ground Station seront transmises à 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 au fur et à mesure que le contact démarre. + **Diffusion en temps quasi réel ** : la télémétrie arrive dans votre flux de données Kinesis 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 la diffusion lorsque le contact se termine. **Surveillance de la livraison ** Vous pouvez surveiller la diffusion de données télémétriques à l'aide de : + **Métriques des flux de données Kinesis ** : vérifiez les enregistrements entrants dans CloudWatch. Pour plus d'informations, consultez la section [ Surveillance des flux ](https://docs.aws.amazon.com/streams/latest/dev/monitoring-with-cloudwatch.html) de données Amazon Kinesis. + **Journaux des applications ** : vérifiez le traitement des données dans vos applications qui consomment du flux. + **Visionneuse de données Kinesis ** : utilisez la console de flux Kinesis Data Streams pour afficher 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 [ Création de consommateurs pour 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 dépannage si vous rencontrez des problèmes. Consultez [Résoudre les problèmes de télémétrie](troubleshooting-telemetry.md).