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](#telemetry.understanding-data.schema-evolution)
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 ke`REMOVED`, tidak ada telemetri pelacakan yang akan dikirimkan. Untuk informasi selengkapnya tentang melacak konfigurasi, lihat[Melacak Config](how-it-works.config.md#how-it-works.config-tracking).
**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 termasuk`TRACKING`,`ACQUIRING`, dan`MASKED`.
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](https://docs.aws.amazon.com/streams/latest/dev/working-with-streams.html).
**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](https://docs.aws.amazon.com/streams/latest/dev/kcl.html).
**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.](https://docs.aws.amazon.com/streams/latest/dev/enhanced-consumers.html)
+ **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](https://docs.aws.amazon.com/streams/latest/dev/monitoring-with-cloudwatch.html).
## Pembuatan versi dan evolusi skema
Skema telemetri diberi versi untuk mendukung evolusi dari waktu ke waktu. `telemetryVersion`Bidang 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.
+ Mengurai`telemetryTypeAndVersion`,`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.