Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà. # Configurare la telemetria Segui questi passaggi per configurare la telemetria per i tuoi contatti. AWS Ground Station Dopo aver completato questa configurazione, i dati di telemetria verranno inviati allo stream Kinesis Data Streams durante i contatti che utilizzano un profilo di missione abilitato alla telemetria. Per una comprensione approfondita di Kinesis Data Streams, consulta la Guida per l'utente di Kinesis [Data Streams](https://docs.aws.amazon.com/streams/latest/dev/introduction.html). ## Fase 1: Creare le risorse indispensabili AWS Il seguente CloudFormation frammento dimostra come creare le risorse AWS prerequisite per la distribuzione della telemetria. Questo frammento crea un flusso Kinesis Data Streams e un ruolo IAM che AWS Ground Station concede l'autorizzazione a scrivere dati di telemetria nello stream. ``` {{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 ``` L'elenco seguente riporta considerazioni di configurazione uniche durante la configurazione della consegna della telemetria per. AWS Ground Station Flusso **Kinesis Data** Streams: lo stream utilizza la modalità di capacità su richiesta, che si ridimensiona automaticamente in base alla velocità effettiva. Questa opzione è consigliata per la maggior parte dei casi d'uso. Lo stream è configurato per conservare i dati per 24 ore. Per impostazione predefinita, lo stream utilizza la crittografia AWS gestita. Per utilizzare la crittografia gestita dal cliente con AWS Key Management Service, aggiungi la `StreamEncryption` proprietà e aggiorna la policy del ruolo IAM per includere `kms:GenerateDataKey` l'autorizzazione. Per ulteriori informazioni, consulta la sezione [Protezione dei dati in Amazon Kinesis Data Streams](https://docs.aws.amazon.com/streams/latest/dev/server-side-encryption.html). **Ruolo IAM**: il ruolo IAM consente al responsabile del `groundstation.amazonaws.com` servizio di assumere il ruolo e scrivere dati di telemetria nel flusso Kinesis Data Streams. La policy relativa al ruolo concede le autorizzazioni e le azioni relative allo stream`kinesis:DescribeStream`. `kinesis:PutRecord` `kinesis:PutRecords` Consulta [Config del sink di telemetria](how-it-works.config.md#how-it-works.config-telemetry-sink) le linee guida sulla configurazione della politica di fiducia e della politica dei ruoli. **Configurazione aggiuntiva**: aggiungi `iam:PassRole` le autorizzazioni all'utente o al ruolo IAM che utilizzi per le chiamate AWS Ground Station API. Ciò consente di passare il ruolo di telemetria a AWS Ground Station quando si crea un. TelemetrySinkConfig ### Politica di esempio PassRole Per ulteriori informazioni su come aggiornare o allegare una policy relativa ai ruoli, consulta [Managing IAM policy](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage.html) nella IAM User Guide. Per ulteriori informazioni sull'`iam:PassRole`autorizzazione, consulta [Concedere a un utente le autorizzazioni per passare un ruolo a un servizio 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}}" } ] } ``` ## Fase 2: Creare un TelemetrySinkConfig Crea uno *TelemetrySinkConfig*che definisca come AWS Ground Station verranno forniti i dati di telemetria al tuo flusso Kinesis Data Streams. Usa lo stream ARN e il role ARN dagli output CloudFormation dello stack nel passaggio 1. **Nota** Quando crei un *TelemetrySinkConfig*, AWS Ground Station verificherà l'accesso al tuo stream Kinesis Data Streams fornendo un record di test vuoto con una chiave di partizione di. `test` Per ulteriori informazioni sulla creazione di un *TelemetrySinkConfig*, consulta. [Config del sink di telemetria](how-it-works.config.md#how-it-works.config-telemetry-sink) ## Passaggio 3: aggiungi la telemetria al tuo profilo di missione Crea un profilo di missione. Per ulteriori informazioni sulla creazione di profili di missione, consulta[Usa i profili di AWS Ground Station missione](how-it-works-mission-profile.md). Aggiungilo `telemetrySinkConfigArn` al tuo profilo di missione per abilitare la consegna della telemetria durante i contatti. Usa l'ARN del file *TelemetrySinkConfig*creato nel passaggio 2. ## Fase 4: Pianifica un contatto Pianifica un contatto utilizzando il tuo profilo di missione abilitato alla telemetria. Durante il contatto, AWS Ground Station trasmetterà i dati di telemetria allo stream Kinesis Data Streams. **Cosa aspettarsi durante i contatti** + **Avvio della telemetria**: lo streaming dei dati inizia all'avvio del contatto. + **Consegna quasi in tempo reale**: la telemetria arriva nel flusso Kinesis Data Streams quasi in tempo reale. + **Durata del contatto**: i dati continuano per l'intero contatto. + **Arresto automatico**: la telemetria interrompe lo streaming al termine del contatto. **Monitoraggio della consegna** Puoi monitorare la consegna della telemetria utilizzando: + Metriche del flusso di **Kinesis Data Streams: archivia** i record in entrata. CloudWatch Per ulteriori informazioni, consulta [Monitoraggio di Amazon Kinesis Data Streams](https://docs.aws.amazon.com/streams/latest/dev/monitoring-with-cloudwatch.html). + **Log delle applicazioni**: verifica l'elaborazione dei dati nelle applicazioni che utilizzano lo stream. + **Kinesis Data Viewer**: utilizza la console di streaming Kinesis Data Streams per visualizzare i record di esempio del tuo stream. ## Fasi successive Dopo aver completato la configurazione, puoi: + Scopri il formato dei dati di telemetria e i tipi di telemetria disponibili. Per informazioni, consulta [Comprendi i dati di telemetria](telemetry.understanding-data.md). + Crea applicazioni per elaborare i dati di telemetria dal tuo flusso Kinesis Data Streams. Per ulteriori informazioni, consulta [Building Consumers for Amazon Kinesis Data Streams](https://docs.aws.amazon.com/streams/latest/dev/building-consumers.html). + Crea dashboard e avvisi utilizzando CloudWatch altri servizi. AWS + Se riscontri problemi, consulta le linee guida per la risoluzione dei problemi. Per informazioni, consulta [Risolvere i problemi di telemetria](troubleshooting-telemetry.md).