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, lihat[Versi skema dan evolusi](#telemetry.understanding-data.schema-evolution).
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 ke`REMOVED`, telemetri pelacakan tidak akan dikirimkan. Untuk informasi selengkapnya tentang konfigurasi pelacakan, lihat[Melacak Config](how-it-works.config.md#how-it-works.config-tracking).
**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](https://docs.aws.amazon.com/streams/latest/dev/working-with-streams.html).
**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 ](https://docs.aws.amazon.com/streams/latest/dev/kcl.html) 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](https://docs.aws.amazon.com/streams/latest/dev/enhanced-consumers.html).
+ **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. ](https://docs.aws.amazon.com/streams/latest/dev/monitoring-with-cloudwatch.html)
## 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` bidang`telemetryTypeAndVersion`,`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.