Comprendi i dati di telemetria - AWS Ground Station
Panoramica del formato dei datiTelemetria di puntamentoMonitoraggio della telemetriaLettura dei dati dal flusso Kinesis Data StreamsVersionamento ed evoluzione dello schema

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

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

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.

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.

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.

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

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 telemetryTypeAndVersiontelemetryType, 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.