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à.
Comprendi i dati di telemetria
I dati di telemetria vengono inviati come record Base64-encoded JSON allo stream Kinesis Data Streams. Ogni record contiene le informazioni raccolte durante il contatto con il satellite, 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
- 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 allo stream 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 frammento all'interno dello stream Kinesis Data Streams, semplificando al massimo l'ordinamento del 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
- Esempio di timestamp
-
Ora in cui i dati di telemetria sono stati campionati, in formato UTC con precisione al millisecondo. ISO-8601
- azimut
-
Angolo di azimut effettivo dell'antenna in gradi.
- elevazione
-
Angolo di elevazione effettivo dell'antenna in gradi.
- Azimut comandato
-
Angolo di azimut comandato in gradi. Questo è l'angolo di azimut 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 di terra
-
Nome della stazione di terra (ad esempio, «Ohio 1").
- ID del satellite
-
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 } }
Tracciamento della telemetria
La telemetria di tracciamento fornisce informazioni sullo stato del 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 nel tuo TrackingConfig è impostato su, non verrà fornita alcuna telemetria di REMOVED tracciamento. Per ulteriori informazioni sulle configurazioni di tracciamento, consulta. Config di monitoraggio
Campi dati
- Esempio di timestamp
-
Ora in cui i dati di telemetria sono stati campionati, in formato UTC con precisione al millisecondo. ISO-8601
- Stato del tracciamento
-
Stato di tracciamento attuale dell'antenna. I valori possibili sono:
-
TRACKING— L'antenna si è bloccata con successo su un segnale che corrisponde al profilo della missione e lo segue attivamente attraverso il cielo. Questo è lo stato operativo nominale durante un contatto. -
ACQUIRING— L'antenna è in fase di localizzazione e bloccaggio del segnale. Il sistema sta attualmente utilizzando il tracciamento programmatico, il puntamento basato sui dati delle effemeridi. -
MASKED— La posizione prevista del satellite è nascosta da una maschera di tracciamento automatico, il che significa che l'antenna non può utilizzare in modo affidabile l'autotrack in quella specifica direzione di puntamento. Ciò si verifica in genere in aree ad alta interferenza RF, ad esempio a basse altitudini.
-
- tracciamento ErrorAzimuth
-
errore di tracciamento sull'asse azimutale, misurato in gradi.
- tracciamento ErrorElevation
-
errore di tracciamento sull'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 inviati allo stream Kinesis Data Streams e possono essere consumati utilizzando modelli di consumo standard. Quando leggi i dati dal tuo stream, tieni a mente le seguenti considerazioni.
Decodifica Base64
I dati nello stream di Kinesis Data Streams sono. Base64-encoded È necessario decodificare i dati prima di analizzarli come JSON. Per ulteriori informazioni, consulta Lavorare con Amazon Kinesis Data Streams.
Utilizzo di Kinesis Data Viewer
Per un rapido accesso ai dati di telemetria, la console di streaming Kinesis Data Streams offre una funzionalità Data Viewer. Quando si utilizza questa funzionalità:
-
L'invio della telemetria può avvenire a qualsiasi frammento all'interno del tuo stream.
-
La posizione iniziale predefinita si basa sui record più recenti dello shard.
-
Potrebbe essere necessario modificare lo shard selezionato e utilizzare la posizione iniziale «Al timestamp» per visualizzare i record ricevuti.
Utilizzo della Kinesis Client Library
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 telemetria di produzione relative al consumo.
Per ulteriori informazioni, consulta Developing Consumers Using the Kinesis Client Library.
Le migliori pratiche per il consumo
-
Riduci al minimo la latenza: utilizza Enhanced Fan-Out per leggere dallo stream di Kinesis Data Streams con throughput dedicato e latenza inferiore rispetto al polling. Per ulteriori informazioni, consulta Developing Enhanced Consumers. Fan-Out
-
Stream dedicato: utilizzate uno stream Kinesis Data Streams dedicato per l'integrazione della AWS Ground Station telemetria. La condivisione di uno stream con altre applicazioni può causare la saturazione del throughput di scrittura e il mancato recapito della telemetria.
-
On-demand capacità - Implementa il tuo stream Kinesis Data Streams in modalità di provisioning su richiesta per consentire il ridimensionamento automatico degli shard in base al throughput.
-
Monitora il throughput: monitora il tuo stream per individuare eventuali limitazioni utilizzando le metriche. CloudWatch Per ulteriori informazioni, consulta Monitoraggio di Amazon Kinesis Data Streams.
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
telemetryVersioncampitelemetryTypeAndVersiontelemetryType, e per determinare come elaborare ogni record.
Consigliamo di implementare la serializzazione del payload in base alla versione in grado di gestire più versioni dello schema con facilità, consentendo alle applicazioni di continuare a funzionare quando vengono introdotte nuove versioni.
