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à. # Lavora con la telemetria AWS Ground Station la telemetria fornisce metriche quasi in tempo reale provenienti dalle AWS Ground Station antenne durante i contatti satellitari. È possibile utilizzare i dati di telemetria per monitorare le prestazioni dei contatti, rilevare anomalie e prendere decisioni informate sulle comunicazioni satellitari. ## Come funziona la telemetria Per utilizzare la telemetria, si configura un comando *TelemetrySinkConfig*che specifica dove devono essere forniti i dati di telemetria. AWS Ground Station Quindi aggiungi questa configurazione al tuo profilo di missione utilizzando il campo. `telemetrySinkConfigArn` Durante i contatti che utilizzano un profilo di missione abilitato alla telemetria, AWS Ground Station trasmette i dati di telemetria al tuo account. Il processo di consegna della telemetria funziona come segue: 1. Crei uno stream Kinesis Data Streams AWS nel tuo account per ricevere dati di telemetria. Lo stream deve essere creato nello stesso account e nella stessa regione da cui pianifichi i contatti. 1. Crei un ruolo IAM che concede AWS Ground Station l'autorizzazione a scrivere dati nel tuo stream. 1. Ne crei un TelemetrySinkConfig che fa riferimento al tuo stream e al tuo ruolo IAM. 1. Lo aggiungi TelemetrySinkConfig al tuo profilo di missione. 1. Elenchi e prenoti i contatti utilizzando il nuovo profilo di missione abilitato alla telemetria. 1. Durante i contatti che utilizzano questo profilo di missione, AWS Ground Station trasmette i dati di telemetria allo stream Kinesis Data Streams quasi in tempo reale. 1. Consumi ed elabori i dati di telemetria del tuo stream utilizzando servizi o le tue applicazioni. AWS ## Tipi di telemetria disponibili AWS Ground Station fornisce i seguenti tipi di telemetria durante i contatti: **Nota** AWS Ground Station sta lavorando all'espansione del numero di tipi di telemetria supportati Puntamento della telemetria Fornisce informazioni sulla direzione di puntamento dell'antenna durante i contatti satellitari. Questo tipo di telemetria viene sempre inviato durante un contatto e include gli angoli di azimut e di elevazione effettivi e comandati. Per ulteriori informazioni, consulta [Telemetria di puntamento](telemetry.understanding-data.md#telemetry.understanding-data.pointing). Telemetria di tracciamento Fornisce informazioni sullo stato di tracciamento dell'antenna e sugli errori di tracciamento. Questo tipo di telemetria viene inviato quando il tracciamento automatico è abilitato nella configurazione di tracciamento. Per ulteriori informazioni, consulta [Monitoraggio della telemetria](telemetry.understanding-data.md#telemetry.understanding-data.tracking). ## Disponibilità regionale La telemetria è disponibile in tutte le regioni in cui opera. AWS AWS Ground Station Durante l'esecuzione del contatto, la telemetria verrà trasmessa dall' AWS Ground Station antenna alla regione da cui è stato pianificato il contatto, fornendo supporto interregionale. Per un elenco completo delle AWS Ground Station regioni e delle sedi delle stazioni terrestri, consulta. [AWS Ground Station Sedi](aws-ground-station-antenna-locations.md) **Topics** + [Come funziona la telemetria](#telemetry.how-it-works) + [Tipi di telemetria disponibili](#telemetry.telemetry-types) + [Disponibilità regionale](#telemetry.regional-availability) + [Configurare la telemetria](telemetry.setup.md) + [Comprendi i dati di telemetria](telemetry.understanding-data.md) # 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 autorizzazioni e azioni sullo `kinesis:DescribeStream` stream. `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). # Comprendi i dati di telemetria I dati di telemetria vengono forniti come record JSON con codifica Base64 al flusso Kinesis Data Streams. Ogni record contiene informazioni raccolte durante il contatto satellitare, inclusi i metadati sul contatto e le misurazioni telemetriche campionate. ## Panoramica del formato dei dati Ogni record di telemetria contiene i seguenti componenti: Tipo e versione di telemetria Identifica il tipo specifico di dati di telemetria e la relativa versione dello schema. Ciò consente di analizzare i diversi tipi di telemetria in modo appropriato. Per ulteriori informazioni sul controllo delle versioni dello schema, vedere. [Versionamento ed evoluzione dello schema](#telemetry.understanding-data.schema-evolution) ID dell'ambito Un identificatore univoco per l'ambito della telemetria. Ciò consente di correlare i dati di telemetria con contatti specifici. Metadati Informazioni contestuali sulla telemetria. Dati Le misurazioni telemetriche campionate specifiche per il tipo di telemetria. **Chiave di partizione** I record di telemetria vengono inviati al flusso Kinesis Data Streams con una chiave di partizione nel formato: ``` SCOPE#scopeId#TELEMETRY_ID#telemetryId#TELEMETRY_VERSION#telemetryVersion ``` Questa chiave di partizione assicura che tutta la telemetria di un determinato tipo per un singolo contatto venga inviata allo stesso shard all'interno del flusso Kinesis Data Streams, permettendo di ordinare al meglio il flusso di telemetria di quel contatto. ## Telemetria di puntamento La telemetria di puntamento fornisce informazioni sulla direzione di puntamento dell'antenna durante i contatti satellitari. Questo tipo di telemetria viene sempre inviato durante un contatto. **Campi dati** Timestamp di esempio Ora in cui i dati di telemetria sono stati campionati, in formato ISO-8601 in UTC con precisione al millisecondo. azimut Angolo di azimut effettivo dell'antenna in gradi. elevazione Angolo di elevazione effettivo dell'antenna in gradi. Azimut comandato Angolo azimutale comandato in gradi. Questo è l'angolo azimutale target che l'antenna sta cercando di raggiungere. Elevazione comandata Angolo di elevazione comandato in gradi. Questo è l'angolo di elevazione target che l'antenna sta cercando di raggiungere. **Nota** La posizione effettiva dell'antenna può differire dalla posizione comandata a causa di limitazioni fisiche o ritardi meccanici durante il contatto. **Campi di metadati** Stazione terrestre Nome della stazione di terra (ad esempio, «Ohio 1"). ID satellitare Identificatore della risorsa satellitare in. AWS Ground Station contactId Identificatore del contatto. **Esempio 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 } } ``` ## Monitoraggio della telemetria La telemetria di tracciamento fornisce informazioni sullo stato di tracciamento dell'antenna e sugli errori di tracciamento. Questo tipo di telemetria viene inviato quando il tracciamento automatico è abilitato nella configurazione di tracciamento e quando l'antenna utilizza attivamente l'autotrack. **Nota** Se il `autotrack` parametro inserito TrackingConfig è impostato su, non verrà fornita alcuna telemetria di `REMOVED` tracciamento. Per ulteriori informazioni sul monitoraggio delle configurazioni, consulta. [Config di monitoraggio](how-it-works.config.md#how-it-works.config-tracking) **Campi dati** Timestamp di esempio Ora in cui i dati di telemetria sono stati campionati, in formato ISO-8601 in UTC con precisione al millisecondo. Stato del tracciamento Stato di tracciamento attuale dell'antenna. I valori possibili sono `TRACKING`, `ACQUIRING` e `MASKED`. trackingErrorAzimuth Errore di tracciamento nell'asse azimutale, misurato in gradi. trackingErrorElevation Errore di tracciamento nell'asse di elevazione, misurato in gradi. **Nota** I valori degli errori di tracciamento rappresentano le regolazioni della traccia del programma basata sulle effemeridi che AWS Ground Station si applica durante il tracciamento automatico per massimizzare la potenza del segnale. **Campi di metadati** La telemetria di tracciamento include gli stessi campi di metadati della telemetria di puntamento:,, e. `groundStation` `satelliteId` `contactId` **Esempio 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 } } ``` ## Lettura dei dati dal flusso Kinesis Data Streams I dati di telemetria vengono forniti al flusso Kinesis Data Streams e possono essere utilizzati utilizzando modelli di consumo standard dei flussi. Quando leggi i dati del tuo stream, tieni a mente le seguenti considerazioni. **Decodifica Base64** I dati nello stream Kinesis Data Streams sono codificati in Base64. È necessario decodificare i dati prima di analizzarli come JSON. Per ulteriori informazioni, consulta [Working with Amazon Kinesis Data Streams](https://docs.aws.amazon.com/streams/latest/dev/working-with-streams.html). **Utilizzo di Kinesis Data Viewer** Per un accesso rapido ai dati di telemetria, la console di streaming Kinesis Data Streams offre una funzionalità Data Viewer. Quando si utilizza questa funzionalità: + La consegna della telemetria può avvenire su qualsiasi shard all'interno dello stream. + La posizione iniziale predefinita viene letta dai record più recenti nello shard. + Potrebbe essere necessario regolare lo shard selezionato e utilizzare la posizione iniziale «Al timestamp» per visualizzare i record ricevuti. **Utilizzo della libreria Kinesis Client** La Kinesis Client Library (KCL) gestisce molte delle complessità associate al consumo di dati dal flusso Kinesis Data Streams, tra cui la gestione degli shard, il checkpoint e il bilanciamento del carico. Consigliamo di utilizzare KCL per le applicazioni di consumo telemetrico di produzione. Per ulteriori informazioni, consulta [Sviluppo dei consumatori utilizzando la libreria client Kinesis](https://docs.aws.amazon.com/streams/latest/dev/kcl.html). **Le migliori pratiche per il consumo** + **Minimizza la latenza**: utilizza Enhanced Fan-Out per leggere dal flusso Kinesis Data Streams con throughput dedicato e latenza inferiore rispetto al polling. [Per ulteriori informazioni, consulta Developing Enhanced Fan-Out Consumers.](https://docs.aws.amazon.com/streams/latest/dev/enhanced-consumers.html) + **Stream dedicato**: utilizza un flusso Kinesis Data Streams dedicato AWS Ground Station per l'integrazione della telemetria. La condivisione di uno stream con altre applicazioni può causare la saturazione della velocità di scrittura e errori nell'erogazione della telemetria. + **Capacità su richiesta**: implementa il tuo flusso Kinesis Data Streams in modalità di provisioning su richiesta per consentire il ridimensionamento automatico degli shard in base alla velocità effettiva. + **Monitora la velocità effettiva: monitora lo stream per verificare eventuali limitazioni utilizzando le metriche**. CloudWatch Per ulteriori informazioni, consulta [Monitoraggio di Amazon Kinesis Data Streams](https://docs.aws.amazon.com/streams/latest/dev/monitoring-with-cloudwatch.html). ## Versionamento ed evoluzione dello schema Le versioni degli schemi di telemetria sono adattate per supportare l'evoluzione nel tempo. Il `telemetryVersion` campo in ogni record indica la versione dello schema. **Gestione delle modifiche allo schema** + In futuro potrebbero essere introdotti nuovi tipi di telemetria. + I tipi di telemetria esistenti potrebbero ricevere nuove versioni con modifiche sostanziali. + Le applicazioni devono tollerare tipi e versioni di telemetria sconosciuti. + Analizza i `telemetryVersion` campi `telemetryTypeAndVersion``telemetryType`, e per determinare come elaborare ogni record. Consigliamo di implementare una serializzazione del payload sensibile alla versione in grado di gestire più versioni dello schema in modo corretto, permettendo alle applicazioni di continuare a funzionare quando vengono introdotte nuove versioni.