View a markdown version of this page

Machen Sie sich mit Telemetriedaten vertraut - AWS Ground Station
Überblick über das DatenformatZeigetelemetrieTelemetrie verfolgenDaten aus dem Kinesis Data 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.

Machen Sie sich mit Telemetriedaten vertraut

Telemetriedaten werden als Base64-encoded JSON-Datensätze an Ihren Kinesis Data Streams-Stream übertragen. Jeder Datensatz enthält Informationen, die während Ihres Satellitenkontakts erfasst 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 Telemetrietypen entsprechend analysieren. Weitere Hinweise zur Schemaversionierung finden Sie unter. Versionierung und Weiterentwicklung von Schemas

Bereichs-ID

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

Metadaten

Kontextinformationen zur Telemetrie.

Daten

Die gesammelten 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-Stream übertragen: 

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-Stream übertragen wird. So können Sie den Telemetrie-Stream dieses Kontakts bestmöglich sortieren.

Zeigetelemetrie

Die Richttelemetrie liefert Informationen über die Ausrichtung der Antenne bei Satellitenkontakten. Dieser Telemetrietyp wird immer während eines Kontakts gesendet.

Datenfelder

SampleTimestamp

Uhrzeit, zu der die Telemetriedaten abgetastet wurden, im ISO-8601 UTC-Format mit einer Genauigkeit von Millisekunden.

Azimut

Tatsächlicher Azimutwinkel der Antenne in Grad.

Höhenlage

Tatsächlicher Höhenwinkel der Antenne in Grad.

Hat Azimuth befohlen

Vorgegebener Azimutwinkel in Grad. Dies ist der Zielazimutwinkel, den die Antenne zu erreichen versucht.

Befohlenes Anheben

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

Anmerkung

Die tatsächliche Antennenposition kann aufgrund physischer Einschränkungen oder mechanischer Verzögerungen während des Kontakts von der vorgeschriebenen Position abweichen.

Metadaten-Felder

Bodenstation

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

Satelliten-ID

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

SampleTimestamp

Uhrzeit, zu der die Telemetriedaten abgetastet wurden, im ISO-8601 UTC-Format mit einer Genauigkeit von Millisekunden.

Status verfolgen

Aktueller Tracking-Status der Antenne. Die möglichen Werte sind:

  • TRACKING— Die Antenne hat erfolgreich ein Signal empfangen, das dem Missionsprofil entspricht, und folgt ihm aktiv über den Himmel. Dies ist der nominale Betriebszustand während eines Kontakts.

  • ACQUIRING— Die Antenne ist dabei, das Signal zu lokalisieren und zu erfassen. Das System verwendet derzeit programmatisches Tracking und zeigt auf der Grundlage von Ephemeridendaten.

  • MASKED— Die vorhergesagte Position des Satelliten befindet sich hinter einer Autotrack-Maske, was bedeutet, dass die Antenne Autotrack in dieser bestimmten Ausrichtungsrichtung nicht zuverlässig nutzen kann. Dies tritt typischerweise in Bereichen mit hoher HF-Interferenz auf, z. B. in niedrigen Höhen.

Nachverfolgung ErrorAzimuth

Tracking-Fehler in der Azimutachse, gemessen in Grad.

Verfolgung ErrorElevation

Tracking-Fehler in der Höhenachse, gemessen in Grad.

Anmerkung

Bei den Tracking-Fehlerwerten handelt es sich um Anpassungen aus dem auf Ephemeriden basierenden Programmtrack, der während des Autotrackings vorgenommen AWS Ground Station wird, um die Signalstärke zu maximieren.

Metadaten-Felder

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

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

Daten aus dem Kinesis Data Streams-Stream lesen

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

Base64-Decodierung

Die Daten im Kinesis Data Streams-Stream sind. Base64-encoded Sie müssen die Daten dekodieren, bevor Sie sie als JSON analysieren. 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-Stream-Konsole eine Data Viewer-Funktion. Wenn Sie diese Funktion verwenden:

  • Die Telemetrieübertragung kann an jeden Shard in deinem 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 „At timestamp“ verwenden, um die empfangenen Datensätze anzuzeigen.

Verwenden der Kinesis-Client-Bibliothek

Die Kinesis Client Library (KCL) bewältigt viele der Komplexitäten, die mit der Nutzung von Daten aus dem Kinesis Data Streams-Stream verbunden sind, einschließlich Shard-Management, Checkpointing und Load Balancing. Wir empfehlen, KCL für Telemetrieanwendungen in der Produktion zu verwenden.

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

Bewährte Verfahren für den Konsum

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

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

  • On-demand Kapazität — Stellen Sie Ihren Kinesis Data Streams-Stream im On-Demand-Bereitstellungsmodus bereit, um eine automatische Skalierung der Shards auf der Grundlage des Durchsatzes zu ermöglichen.

  • Durchsatz überwachen — Überwachen Sie Ihren Stream mithilfe CloudWatch von Metriken auf Drosselung. Weitere Informationen finden Sie unter Überwachung von Amazon Kinesis-Datenströmen.

Versionierung und Weiterentwicklung von Schemas

Telemetrieschemas sind 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 Zukunft könnten neue Telemetrietypen eingeführt werden.

  • Bestehende Telemetrietypen erhalten möglicherweise neue Versionen mit wichtigen Änderungen.

  • Ihre Anwendungen sollten gegenüber unbekannten Telemetrietypen und Versionen tolerant sein.

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

Wir empfehlen die Implementierung einer versionssensitiven Payload-Serialisierung, die mehrere Schemaversionen problemlos verarbeiten kann, sodass Ihre Anwendungen auch nach der Einführung neuer Versionen weiter funktionieren.