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.

É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.

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

{
  "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.

Pour plus d'informations sur la création d'un TelemetrySinkConfig, consultezConfig du récepteur de télémétrie.

É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, consultezUtiliser les profils AWS Ground Station de mission. 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

Surveillance de la livraison

Vous pouvez surveiller la diffusion de données télémétriques à l'aide de :

Étapes suivantes

Une fois la configuration terminée, vous pouvez :