View a markdown version of this page

Memahami data telemetri - AWS Ground Station
Ikhtisar format dataTelemetri menunjukPelacakan telemetriMembaca data dari aliran Kinesis Data StreamsVersi skema dan evolusi

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 Base64-encoded JSON 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 spesifik data telemetri dan versi skemanya. Ini memungkinkan Anda untuk mengurai berbagai jenis telemetri dengan tepat. Untuk informasi selengkapnya tentang pembuatan versi skema, lihatVersi skema dan evolusi.

ID Lingkup

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

Metadata

Informasi kontekstual tentang telemetri.

Data

Pengukuran telemetri sampel khusus untuk jenis telemetri.

Kunci partisi

Catatan telemetri dikirimkan 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 Aliran Data Kinesis Anda, memberikan pemesanan upaya terbaik untuk aliran telemetri kontak tersebut.

Telemetri menunjuk

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

Bidang data

SampelTimestamp

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

azimut

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.

CommandedEvation

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

Stasiun Groundstation

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

ID Satelit

Pengidentifikasi sumber daya satelit di AWS Ground Station.

ID Kontak

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

Pelacakan telemetri

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

catatan

Jika autotrack parameter di Anda diset TrackingConfig el keREMOVED, telemetri pelacakan tidak akan dikirimkan. Untuk informasi selengkapnya tentang konfigurasi pelacakan, lihatMelacak Config.

Bidang data

SampelTimestamp

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

Status pelacakan

Status pelacakan antena saat ini. Kemungkinan nilainya adalah:

  • TRACKING— Antena telah berhasil mengunci sinyal yang cocok dengan profil misi dan secara aktif mengikutinya melintasi langit. Ini adalah keadaan operasional nominal selama kontak.

  • ACQUIRING- Antena sedang dalam proses menemukan dan mengunci sinyal. Sistem saat ini menggunakan pelacakan terprogram, menunjuk berdasarkan data ephemeris.

  • MASKED— Posisi satelit yang diprediksi berada di belakang topeng autotrack, yang berarti antena tidak dapat menggunakan autotrack dengan andal pada arah penunjuk tertentu. Ini biasanya terjadi di area interferensi RF tinggi seperti ketinggian rendah.

pelacakan ErrorAzimuth

Kesalahan pelacakan pada sumbu azimuth, diukur dalam derajat.

pelacakan ErrorElevation

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:groundStation,satelliteId, dan. 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 dikirim 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 adalah Base64-encoded. Anda harus memecahkan kode data sebelum menguraikannya sebagai JSON. Untuk informasi selengkapnya, lihat Bekerja dengan Amazon Kinesis Data Streams.

Menggunakan Kinesis Data Viewer

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 streaming Anda.

  • Posisi awal default dibaca dari catatan terbaru di shard.

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

Menggunakan Perpustakaan Klien Kinesis

Kinesis Client Library (KCL) mengelola banyak kompleksitas yang terkait dengan konsumsi data dari aliran Kinesis Data Streams, termasuk manajemen pecahan, checkpointing, dan penyeimbangan beban. Kami merekomendasikan penggunaan KCL untuk aplikasi konsumsi telemetri produksi.

Untuk informasi selengkapnya, lihat Meng embangkan 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 Mengem bangkan Konsumen yang Fan-Out Ditingkatkan.

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

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

  • Monitor throughput - Pantau aliran Anda untuk pelambatan menggunakan CloudWatch metrik. Untuk informasi selengkapnya, lihat Mem antau Aliran Data Amazon Kinesis.

Versi skema dan evolusi

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

Menangani perubahan skema

  • Jenis telemetri baru dapat diperkenalkan di masa depan.

  • Jenis telemetri yang ada dapat menerima versi baru dengan perubahan besar.

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

  • Parsi telemetryVersion bidangtelemetryTypeAndVersion,telemetryType, dan 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.