Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Comprenda los datos de telemetría
Los datos de telemetría se envían como registros Base64-encoded JSON a su transmisión de Kinesis Data Streams. Cada registro contiene la información recopilada durante el contacto con el satélite, incluidos los metadatos sobre el contacto y las mediciones telemétricas muestreadas.
Información general sobre el formato de datos
Cada registro de telemetría contiene los siguientes componentes:
- Tipo y versión de telemetría
-
Identifica el tipo específico de datos de telemetría y su versión de esquema. Esto le permite analizar los diferentes tipos de telemetría de forma adecuada. Para obtener más información sobre el control de versiones de esquemas, consulte. Control de versiones y evolución de esquemas
- ID de ámbito
-
Un identificador único para el ámbito de la telemetría. Esto le permite correlacionar los datos de telemetría con contactos específicos.
- Metadatos
-
Información contextual sobre la telemetría.
- Datos
-
Las medidas de telemetría muestreadas específicas del tipo de telemetría.
Clave de partición
Los registros de telemetría se envían a su transmisión de Kinesis Data Streams con una clave de partición con el siguiente formato:
SCOPE#scopeId#TELEMETRY_ID#telemetryId#TELEMETRY_VERSION#telemetryVersion
Esta clave de partición garantiza que toda la telemetría de un tipo determinado para un solo contacto se entregue al mismo fragmento de la transmisión de Kinesis Data Streams, lo que permite ordenar la transmisión de telemetría de ese contacto de la mejor manera posible.
Telemetría de señalamiento
La telemetría de puntería proporciona información sobre la dirección de orientación de la antena durante los contactos con el satélite. Este tipo de telemetría siempre se envía durante un contacto.
Campos de datos
- Ejemplo de marca de tiempo
-
Hora en la que se muestrearon los datos de telemetría, en ISO-8601 formato UTC con precisión de milisegundos.
- azimut
-
Ángulo acimutal real de la antena en grados.
- elevación
-
Ángulo de elevación real de la antena en grados.
- Azimut comandado
-
Ángulo acimutal ordenado en grados. Este es el ángulo acimutal objetivo que la antena intenta alcanzar.
- Elevación comandada
-
Ángulo de elevación ordenado en grados. Este es el ángulo de elevación objetivo que la antena intenta alcanzar.
nota
La posición real de la antena puede diferir de la posición ordenada debido a limitaciones físicas o retrasos mecánicos durante el contacto.
Campos de metadatos
- Estación terrestre
-
Nombre de la estación terrestre (por ejemplo, «Ohio 1").
- ID del satélite
-
Identificador del recurso satelital en. AWS Ground Station
- contactId
-
Identificador del contacto.
Ejemplo de 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 } }
Telemetría de seguimiento
La telemetría de seguimiento proporciona información sobre el estado del seguimiento de la antena y los errores de seguimiento. Este tipo de telemetría se envía cuando el seguimiento automático está activado en la configuración de seguimiento y cuando la antena utiliza el seguimiento automático de forma activa.
nota
Si el autotrack parámetro está establecido en, no TrackingConfig se entregará ninguna REMOVED telemetría de seguimiento. Para obtener más información sobre las configuraciones de seguimiento, consulte. Configuración de seguimiento
Campos de datos
- Ejemplo de marca de tiempo
-
Hora en la que se muestrearon los datos de telemetría, en ISO-8601 formato UTC con precisión de milisegundos.
- Estado de seguimiento
-
Estado de seguimiento actual de la antena. Los valores posibles son los que se indican a continuación.
-
TRACKING— La antena ha conseguido captar una señal que coincide con el perfil de la misión y la sigue activamente a través del cielo. Este es el estado operativo nominal durante un contacto. -
ACQUIRING— La antena está en proceso de localizar y bloquear la señal. El sistema utiliza actualmente un seguimiento programático, que apunta en función de los datos de efemérides. -
MASKED— La posición prevista del satélite es detrás de una máscara de seguimiento automático, lo que significa que la antena no puede utilizar el seguimiento automático de forma fiable en esa dirección específica de puntería. Esto suele ocurrir en áreas con altas interferencias de RF, como las elevaciones bajas.
-
- seguimiento ErrorAzimuth
-
Error de seguimiento en el eje acimutal, medido en grados.
- seguimiento ErrorElevation
-
Error de seguimiento en el eje de elevación, medido en grados.
nota
Los valores de error de seguimiento representan los ajustes del seguimiento del programa basado en efemérides que AWS Ground Station se aplica durante el seguimiento automático para maximizar la intensidad de la señal.
Campos de metadatos
La telemetría de seguimiento incluye los mismos campos de metadatos que la telemetría de señalamiento:groundStation,, y. satelliteId contactId
Ejemplo de 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 } }
Lectura de datos de una transmisión de Kinesis Data Streams
Los datos de telemetría se envían a su transmisión de Kinesis Data Streams y se pueden consumir según los patrones de consumo de transmisión estándar. Al leer los datos de su transmisión, tenga en cuenta las siguientes consideraciones.
Decodificación en Base64
Los datos de la transmisión de Kinesis Data Streams son. Base64-encoded Debe decodificar los datos antes de analizarlos como JSON. Para obtener más información, consulte Trabajar con Amazon Kinesis Data Streams.
Uso del visor de datos de Kinesis
Para acceder rápidamente a sus datos de telemetría, la consola de transmisión de Kinesis Data Streams ofrece una función de visor de datos. Al usar esta función:
-
La telemetría se puede enviar a cualquier fragmento de tu transmisión.
-
La posición inicial predeterminada se basa en los últimos registros del fragmento.
-
Es posible que tenga que ajustar el fragmento seleccionado y utilizar la posición inicial «Al marcar la fecha» para ver los registros recibidos.
Uso de la biblioteca cliente de Kinesis
La biblioteca cliente de Kinesis (KCL) administra muchas de las complejidades asociadas con el consumo de datos de Kinesis Data Streams Stream, como la administración de fragmentos, los puntos de control y el equilibrio de carga. Recomendamos usar KCL para aplicaciones de consumo y telemetría de producción.
Para obtener más información, consulte Cómo desarrollar a los consumidores mediante la biblioteca cliente de Kinesis.
Mejores prácticas de consumo
-
Minimice la latencia: utilice Enhanced Fan-Out para leer las transmisiones de Kinesis Data Streams con un rendimiento dedicado y una latencia más baja en comparación con las encuestas. Para obtener más información, consulte Desarrollar Fan-Out consumidores mejorados.
-
Transmisión dedicada: utilice una transmisión exclusiva de Kinesis Data Streams para la integración de AWS Ground Station telemetría. Compartir una transmisión con otras aplicaciones puede provocar una saturación del rendimiento de escritura y errores en la entrega de telemetría.
-
On-demand capacidad: implemente su transmisión de Kinesis Data Streams en modo de aprovisionamiento bajo demanda para permitir el escalado automático de las particiones en función del rendimiento.
-
Supervise el rendimiento: supervise su transmisión para ver si se limita mediante métricas. CloudWatch Para obtener más información, consulte Monitorización de las transmisiones de datos de Amazon Kinesis.
Control de versiones y evolución de esquemas
Los esquemas de telemetría están versionados para permitir la evolución a lo largo del tiempo. El telemetryVersion campo de cada registro indica la versión del esquema.
Gestionar los cambios de esquema
-
Es posible que en el futuro se introduzcan nuevos tipos de telemetría.
-
Es posible que los tipos de telemetría existentes reciban nuevas versiones con cambios importantes.
-
Sus aplicaciones deben tolerar los tipos y versiones de telemetría desconocidos.
-
Analice los
telemetryVersioncampostelemetryTypeAndVersiontelemetryType, y para determinar cómo procesar cada registro.
Recomendamos implementar una serialización de cargas con reconocimiento de versiones que pueda gestionar varias versiones del esquema sin problemas, lo que permitirá que las aplicaciones sigan funcionando cuando se introduzcan nuevas versiones.
