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.
# 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).