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](#telemetry.understanding-data.schema-evolution)
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 ist`REMOVED`, wird keine Tracking-Telemetrie übermittelt. Weitere Informationen zu Tracking-Konfigurationen finden Sie unter. [Nachverfolgungs-Config](how-it-works.config.md#how-it-works.config-tracking)
**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: `groundStation``satelliteId`, 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](https://docs.aws.amazon.com/streams/latest/dev/working-with-streams.html).
**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](https://docs.aws.amazon.com/streams/latest/dev/kcl.html).
**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](https://docs.aws.amazon.com/streams/latest/dev/enhanced-consumers.html) 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](https://docs.aws.amazon.com/streams/latest/dev/monitoring-with-cloudwatch.html).
## 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` Felder`telemetryTypeAndVersion`, und`telemetryType`, 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.