Memahami data telemetri - AWS Ground Station
Ikhtisar format dataMenunjuk telemetriMelacak telemetriMembaca data dari aliran Kinesis Data StreamsPembuatan versi dan evolusi skema

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Memahami data telemetri

Data telemetri dikirimkan sebagai catatan JSON yang dikodekan Base64 ke aliran Kinesis Data Streams Anda. Setiap catatan berisi informasi yang dikumpulkan selama kontak satelit Anda, termasuk metadata tentang kontak dan pengukuran telemetri sampel.

Ikhtisar format data

Setiap catatan telemetri berisi komponen-komponen berikut:

Jenis dan versi telemetri

Mengidentifikasi jenis data telemetri tertentu dan versi skemanya. Ini memungkinkan Anda untuk mengurai jenis telemetri yang berbeda dengan tepat. Untuk informasi selengkapnya tentang pembuatan versi skema, lihat. Pembuatan versi dan evolusi skema

ID Lingkup

Pengidentifikasi unik untuk ruang lingkup telemetri. Ini memungkinkan Anda untuk mengkorelasikan data telemetri dengan kontak tertentu.

Metadata

Informasi kontekstual tentang telemetri.

Data

Pengukuran telemetri sampel khusus untuk jenis telemetri.

Kunci partisi

Rekaman telemetri dikirim ke aliran Kinesis Data Streams Anda dengan kunci partisi dalam format: 

SCOPE#scopeId#TELEMETRY_ID#telemetryId#TELEMETRY_VERSION#telemetryVersion

Kunci partisi ini memastikan bahwa semua telemetri dari jenis tertentu untuk satu kontak dikirim ke pecahan yang sama dalam aliran Kinesis Data Streams Anda, memberikan upaya terbaik untuk pemesanan aliran telemetri kontak tersebut.

Menunjuk telemetri

Telemetri penunjuk memberikan informasi tentang arah penunjuk antena selama kontak satelit. Jenis telemetri ini selalu dikirim selama kontak.

Bidang data

SampleTimeStamp

Waktu ketika data telemetri diambil sampelnya, dalam format ISO-8601 dalam UTC dengan presisi milidetik.

azimuth

Sudut azimuth aktual antena dalam derajat.

elevasi

Sudut elevasi aktual antena dalam derajat.

CommandeDazimuth

Sudut azimuth yang diperintahkan dalam derajat. Ini adalah sudut azimuth target yang coba dicapai antena.

CommandeDelevation

Sudut elevasi yang diperintahkan dalam derajat. Ini adalah sudut elevasi target yang coba dicapai antena.

catatan

Posisi antena sebenarnya mungkin berbeda dari posisi yang diperintahkan karena keterbatasan fisik atau penundaan mekanis selama kontak.

Bidang metadata

GroundStation

Nama stasiun bumi (misalnya, “Ohio 1").

SatelliteID

Pengidentifikasi sumber daya satelit di AWS Ground Station.

contactId

Pengidentifikasi kontak.

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

Melacak telemetri

Telemetri pelacakan memberikan informasi tentang status pelacakan antena dan kesalahan pelacakan. Jenis telemetri ini dikirim saat pelacakan otomatis diaktifkan di konfigurasi pelacakan Anda dan saat antena secara aktif menggunakan autotrack.

catatan

Jika autotrack parameter dalam Anda TrackingConfig disetel keREMOVED, tidak ada telemetri pelacakan yang akan dikirimkan. Untuk informasi selengkapnya tentang melacak konfigurasi, lihatMelacak Config.

Bidang data

SampleTimeStamp

Waktu ketika data telemetri diambil sampelnya, dalam format ISO-8601 dalam UTC dengan presisi milidetik.

Status Pelacakan

Status pelacakan antena saat ini. Nilai yang mungkin termasukTRACKING,ACQUIRING, danMASKED.

trackingErrorAzimuth

Kesalahan pelacakan pada sumbu azimuth, diukur dalam derajat.

trackingErrorElevation

Kesalahan pelacakan pada sumbu elevasi, diukur dalam derajat.

catatan

Nilai kesalahan pelacakan mewakili penyesuaian dari trek program berbasis ephemeris yang AWS Ground Station berlaku selama pelacakan otomatis untuk memaksimalkan kekuatan sinyal.

Bidang metadata

Telemetri pelacakan mencakup bidang metadata yang sama dengan telemetri penunjuk:,, dan. groundStation satelliteId contactId

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

Membaca data dari aliran Kinesis Data Streams

Data telemetri dikirimkan ke aliran Kinesis Data Streams Anda dan dapat dikonsumsi menggunakan pola konsumsi aliran standar. Saat membaca data dari streaming Anda, ingatlah pertimbangan berikut.

Penguraian kode Base64

Data dalam aliran Kinesis Data Streams dikodekan Base64. Anda harus memecahkan kode data sebelum menguraikannya sebagai JSON. Untuk informasi selengkapnya, lihat Bekerja dengan Amazon Kinesis Data Streams.

Menggunakan Penampil Data Kinesis

Untuk akses cepat ke data telemetri Anda, konsol aliran Kinesis Data Streams menawarkan fitur Penampil Data. Saat menggunakan fitur ini:

  • Pengiriman telemetri dapat terjadi pada pecahan apa pun dalam aliran Anda.

  • Posisi awal default dibaca dari catatan terbaru di pecahan.

  • Anda mungkin perlu menyesuaikan pecahan yang dipilih dan menggunakan posisi awal “Pada stempel waktu” untuk melihat catatan yang diterima.

Menggunakan Perpustakaan Klien Kinesis

Perpustakaan Klien Kinesis (KCL) mengelola banyak kompleksitas yang terkait dengan konsumsi data dari aliran Kinesis Data Streams, termasuk manajemen shard, checkpointing, dan load balancing. Kami merekomendasikan penggunaan KCL untuk aplikasi konsumsi telemetri produksi.

Untuk informasi selengkapnya, lihat Mengembangkan Konsumen Menggunakan Perpustakaan Klien Kinesis.

Praktik terbaik untuk konsumsi

  • Minimalkan latensi - Gunakan Enhanced Fan-Out untuk membaca dari aliran Kinesis Data Streams dengan throughput khusus dan latensi yang lebih rendah dibandingkan dengan polling. Untuk informasi selengkapnya, lihat Mengembangkan Konsumen Penggemar yang Ditingkatkan.

  • Aliran khusus - Gunakan aliran Kinesis Data Streams khusus AWS Ground Station untuk integrasi telemetri Anda. Berbagi aliran dengan aplikasi lain dapat menyebabkan saturasi throughput tulis dan kegagalan pengiriman telemetri.

  • Kapasitas sesuai permintaan - Terapkan aliran Kinesis Data Streams Anda dalam mode penyediaan sesuai permintaan untuk memungkinkan penskalaan pecahan otomatis berdasarkan throughput.

  • Monitor throughput - Pantau streaming Anda untuk pembatasan menggunakan metrik. CloudWatch Untuk informasi selengkapnya, lihat Memantau Amazon Kinesis Data Streams.

Pembuatan versi dan evolusi skema

Skema telemetri diberi versi untuk mendukung evolusi dari waktu ke waktu. telemetryVersionBidang di setiap catatan menunjukkan versi skema.

Menangani perubahan skema

  • Jenis telemetri baru dapat diperkenalkan di masa depan.

  • Jenis telemetri yang ada mungkin menerima versi baru dengan perubahan yang melanggar.

  • Aplikasi Anda harus toleran terhadap jenis dan versi telemetri yang tidak diketahui.

  • MenguraitelemetryTypeAndVersion,telemetryType, dan telemetryVersion bidang untuk menentukan cara memproses setiap catatan.

Sebaiknya terapkan serialisasi payload sadar versi yang dapat menangani beberapa versi skema dengan anggun, memungkinkan aplikasi Anda terus berfungsi saat versi baru diperkenalkan.