Verstehen Sie Telemetriedaten - AWS Ground Station
Überblick über das DatenformatZeigetelemetrieTelemetrie verfolgenDaten aus dem Kinesis Data Streams Streams-Stream lesenVersionierung und Weiterentwicklung von Schemas

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Verstehen Sie Telemetriedaten

Telemetriedaten werden als Base64-kodierte JSON-Datensätze an Ihren Kinesis Data Streams Streams-Stream übermittelt. Jeder Datensatz enthält Informationen, die während Ihres Satellitenkontakts gesammelt wurden, einschließlich Metadaten über den Kontakt und die gesammelten Telemetriemessungen.

Überblick über das Datenformat

Jeder Telemetriedatensatz enthält die folgenden Komponenten:

Typ und Version der Telemetrie

Identifiziert den spezifischen Typ von Telemetriedaten und dessen Schemaversion. Auf diese Weise können Sie verschiedene Telemetriearten entsprechend analysieren. Weitere Informationen zur Schemaversionierung finden Sie unter. Versionierung und Weiterentwicklung von Schemas

Bereichs-ID

Eine eindeutige Kennung für den Umfang der Telemetrie. Auf diese Weise können Sie Telemetriedaten mit bestimmten Kontakten korrelieren.

Metadaten

Kontextinformationen zur Telemetrie.

Daten

Die ausgewählten Telemetriemessungen, die für den jeweiligen Telemetrietyp spezifisch sind.

Partitionsschlüssel

Telemetriedatensätze werden mit einem Partitionsschlüssel im folgenden Format an Ihren Kinesis Data Streams Streams-Stream übermittelt: 

SCOPE#scopeId#TELEMETRY_ID#telemetryId#TELEMETRY_VERSION#telemetryVersion

Dieser Partitionsschlüssel stellt sicher, dass die gesamte Telemetrie eines bestimmten Typs für einen einzelnen Kontakt an denselben Shard in Ihrem Kinesis Data Streams Streams-Stream übertragen wird, sodass Sie den Telemetriestream dieses Kontakts bestmöglich bestellen können.

Zeigetelemetrie

Die Zeigetelemetrie liefert Informationen über die Ausrichtung der Antenne bei Satellitenkontakten. Dieser Telemetrie-Typ wird immer während eines Kontakts gesendet.

Datenfelder

Beispiel für einen Zeitstempel

Zeitpunkt, zu dem die Telemetriedaten abgetastet wurden, im ISO-8601-Format in UTC mit Millisekundengenauigkeit.

Azimut

Tatsächlicher Azimutwinkel der Antenne in Grad.

Höhenlage

Tatsächlicher Höhenwinkel der Antenne in Grad.

Hat Azimuth befohlen

Befehlsmäßiger Azimutwinkel in Grad. Dies ist der Zielazimutwinkel, den die Antenne zu erreichen versucht.

Befehlte Höhe

Befohlener Höhenwinkel in Grad. Dies ist der Zielhöhenwinkel, den die Antenne zu erreichen versucht.

Anmerkung

Die tatsächliche Antennenposition kann aufgrund von physikalischen Einschränkungen oder mechanischen Verzögerungen während des Kontakts von der angegebenen Position abweichen.

Metadaten-Felder

Bodenstation

Name der Bodenstation (z. B. „Ohio 1").

Satelliten-ID

Kennung der Satellitenressource in. AWS Ground Station

contactId

Kennung des Kontakts.

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

Telemetrie verfolgen

Die Tracking-Telemetrie liefert Informationen zum Status der Antennenverfolgung und zu Tracking-Fehlern. Dieser Telemetrie-Typ wird gesendet, wenn Autotracking in Ihrer Tracking-Konfiguration aktiviert ist und wenn die Antenne Autotrack aktiv verwendet.

Anmerkung

Wenn der autotrack Parameter in Ihrem auf eingestellt TrackingConfig istREMOVED, wird keine Tracking-Telemetrie übermittelt. Weitere Informationen zu Tracking-Konfigurationen finden Sie unter. Nachverfolgungs-Config

Datenfelder

Beispiel für einen Zeitstempel

Zeitpunkt, zu dem die Telemetriedaten abgetastet wurden, im ISO-8601-Format in UTC mit Millisekundengenauigkeit.

Status der Nachverfolgung

Aktueller Tracking-Status der Antenne. Zu den möglichen Werten gehören TRACKING, ACQUIRING und MASKED.

trackingErrorAzimuth

Tracking-Fehler in der Azimutachse, gemessen in Grad.

trackingErrorElevation

Spurfehler auf der Höhenachse, gemessen in Grad.

Anmerkung

Bei den Tracking-Fehlerwerten handelt es sich um Anpassungen aus dem auf Ephemeriden basierenden Programmtrack, der beim Autotracking AWS Ground Station angewendet wird, um die Signalstärke zu maximieren.

Metadaten-Felder

Die Tracking-Telemetrie umfasst dieselben Metadatenfelder wie die Zeigetelemetrie: groundStationsatelliteId, und. contactId

JSON-Beispiel 

{
  "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
  }
}

Daten aus dem Kinesis Data Streams Streams-Stream lesen

Telemetriedaten werden an Ihren Kinesis Data Streams Streams-Stream übermittelt und können mithilfe von Standard-Stream-Verbrauchsmustern genutzt werden. Beachten Sie beim Lesen von Daten aus Ihrem Stream die folgenden Überlegungen.

Base64-Decodierung

Daten im Kinesis Data Streams Streams-Stream sind Base64-codiert. Sie müssen die Daten dekodieren, bevor Sie sie als JSON analysieren können. Weitere Informationen finden Sie unter Arbeiten mit Amazon Kinesis Data Streams.

Verwenden des Kinesis Data Viewers

Für den schnellen Zugriff auf Ihre Telemetriedaten bietet die Kinesis Data Streams Streams-Stream-Konsole eine Data Viewer-Funktion. Wenn Sie diese Funktion verwenden:

  • Die Telemetrieübertragung kann an jeden Shard in Ihrem Stream erfolgen.

  • Die Standard-Startposition liest aus den neuesten Datensätzen im Shard.

  • Möglicherweise müssen Sie den ausgewählten Shard anpassen und die Startposition „Am Zeitstempel“ verwenden, um die empfangenen Datensätze anzuzeigen.

Verwenden der Kinesis Client Library

Die Kinesis Client Library (KCL) bewältigt viele der komplexen Aufgaben, die mit der Nutzung von Daten aus dem Kinesis Data Streams Streams-Stream verbunden sind, einschließlich Shard-Management, Checkpointing und Load Balancing. Wir empfehlen die Verwendung von KCL für Anwendungen zur Nutzung von Telemetrie in der Produktion.

Weitere Informationen finden Sie unter Developing Consumer Using the Kinesis Client Library.

Bewährte Methoden für den Konsum

  • Latenz minimieren — Verwenden Sie Enhanced Fan-Out, um aus dem Kinesis Data Streams Streams-Stream mit dediziertem Durchsatz und geringerer Latenz im Vergleich zu Polling zu lesen. Weitere Informationen finden Sie unter Entwickeln erweiterter Fan-Out-Nutzer.

  • Dedizierter Stream — Verwenden Sie einen dedizierten Kinesis Data Streams Streams-Stream für Ihre AWS Ground Station Telemetrieintegration. Die gemeinsame Nutzung eines Streams mit anderen Anwendungen kann zu einer Überlastung des Schreibdurchsatzes und zu Fehlern bei der Telemetrieübertragung führen.

  • Kapazität auf Abruf — Stellen Sie Ihren Kinesis Data Streams Streams-Stream im On-Demand-Bereitstellungsmodus bereit, um eine automatische Skalierung von Shards basierend auf dem Durchsatz zu ermöglichen.

  • Durchsatz überwachen — Überwachen Sie Ihren Stream anhand von Metriken auf Drosselung. CloudWatch Weitere Informationen finden Sie unter Amazon Kinesis Data Streams überwachen.

Versionierung und Weiterentwicklung von Schemas

Telemetrieschemas werden versioniert, um die Entwicklung im Laufe der Zeit zu unterstützen. Das telemetryVersion Feld in jedem Datensatz gibt die Schemaversion an.

Umgang mit Schemaänderungen

  • In future könnten neue Telemetriearten eingeführt werden.

  • Bestehende Telemetriearten erhalten möglicherweise neue Versionen mit grundlegenden Änderungen.

  • Ihre Anwendungen sollten gegenüber unbekannten Telemetriearten und -versionen tolerant sein.

  • Analysieren Sie die telemetryVersion FeldertelemetryTypeAndVersion, undtelemetryType, um zu bestimmen, wie die einzelnen Datensätze verarbeitet werden sollen.

Wir empfehlen die Implementierung einer versionsabhängigen Payload-Serialisierung, die mehrere Schemaversionen problemlos verarbeiten kann, sodass Ihre Anwendungen auch bei der Einführung neuer Versionen weiter funktionieren können.