Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Memecahkan masalah telemetri
Gunakan informasi berikut untuk memecahkan masalah umum dengan telemetri.
## Masalah pengaturan umum
### Kesalahan izin IAM
**Gejala**
Saat menelepon `CreateConfig` untuk membuat TelemetrySinkConfig, Anda menerima kesalahan:
```
Unable to write to Kinesis Data Streams stream. Ensure that Ground Station has
kinesis:PutRecord permissions for the given stream
```
**Penyebab**
+ Peran IAM yang ditentukan dalam TelemetrySinkConfig tidak memiliki izin yang diperlukan untuk menulis ke aliran Kinesis Data Streams.
+ Kebijakan kepercayaan pada peran IAM tidak memungkinkan AWS Ground Station untuk mengambil peran tersebut.
+ TelemetrySinkConfig Arn aliran Data Kinesis Data Streams di salah atau aliran tidak ada.
**Solusi**
1. Verifikasi peran IAM ada dan memiliki izin yang benar. Tinjau [Langkah 2: Buat TelemetrySinkConfig](telemetry.setup.md#telemetry.setup.step2) dan pastikan semua langkah diikuti.
1. Periksa yang AWS Ground Station dapat mengambil peran IAM Anda:
```
aws iam get-role --role-name GroundStationTelemetryRole
```
Verifikasi kebijakan kepercayaan termasuk `groundstation.amazonaws.com` sebagai prinsipal layanan tepercaya.
1. Verifikasi peran IAM memiliki izin Kinesis yang diperlukan:
```
aws iam list-attached-role-policies --role-name GroundStationTelemetryRole
```
Pastikan kebijakan tersebut mencakup`kinesis:DescribeStream`,`kinesis:PutRecord`, dan `kinesis:PutRecords` izin untuk streaming Anda.
1. Verifikasi aliran Kinesis Data Streams ada dan ARN sudah benar:
```
aws kinesis describe-stream \
--stream-name your-stream-name \
--region us-east-2
```
1. Jika menggunakan enkripsi yang dikelola pelanggan, verifikasi peran IAM memiliki `kms:GenerateDataKey` izin untuk kunci Anda. AWS KMS
### PassRole kesalahan izin
**Gejala**
Saat menelepon`CreateConfig`, Anda menerima kesalahan tentang tidak memiliki izin untuk lulus peran IAM.
**Solusi**
Pastikan pengguna atau peran IAM Anda memiliki `iam:PassRole` izin untuk peran IAM telemetri. Tambahkan kebijakan berikut ke pengguna atau peran Anda:
```
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"iam:GetRole",
"iam:PassRole"
],
"Resource": "arn:aws:iam::99999999999:role/your-stream-name"
}
]
}
```
### Masalah konfigurasi aliran Kinesis Data Streams
**Gejala**
Pengiriman telemetri gagal atau terputus-putus.
**Penyebab**
+ Aliran Kinesis Data Streams memiliki kapasitas yang tidak mencukupi untuk throughput telemetri.
+ Aliran sedang digunakan oleh aplikasi lain, menyebabkan pelambatan penulisan.
**Solusi**
1. Periksa status streaming:
```
aws kinesis describe-stream \
--stream-name your-stream-name \
--region us-east-2
```
1. Pantau pelambatan tulis menggunakan CloudWatch metrik:
```
aws cloudwatch get-metric-statistics \
--namespace AWS/Kinesis \
--metric-name WriteProvisionedThroughputExceeded \
--dimensions Name=StreamName,Value=your-stream-name \
--start-time 2025-12-08T00:00:00Z \
--end-time 2025-12-08T23:59:59Z \
--period 60 \
--statistics Sum \
--region us-east-2
```
1. Jika pelambatan terdeteksi, pertimbangkan:
+ Beralih ke mode kapasitas sesuai permintaan untuk penskalaan otomatis.
+ Menggunakan aliran khusus untuk AWS Ground Station telemetri.
+ Jika menggunakan mode yang disediakan, tingkatkan jumlah pecahan.
## Masalah pengiriman telemetri
### Tidak ada data telemetri yang muncul
**Gejala**
Setelah menjadwalkan kontak dengan profil misi berkemampuan telemetri, tidak ada data telemetri yang muncul di aliran Kinesis Data Streams Anda.
**Kemungkinan penyebab dan solusi**
Profil misi tidak mengaktifkan telemetri
Verifikasi profil misi yang digunakan untuk kontak termasuk`telemetrySinkConfigArn`:
```
aws groundstation get-mission-profile \
--mission-profile-id 12345678-1234-1234-1234-123456789012 \
--region us-east-2
```
Periksa output untuk `telemetrySinkConfigArn` bidang tersebut. Jika tidak ada, profil misi tidak mengaktifkan telemetri.
Masalah izin peran IAM
Tinjau langkah-langkah pemecahan masalah izin IAM di. [Kesalahan izin IAM](#troubleshooting-telemetry.iam-permissions)
Aliran Kinesis Data Streams tidak ada atau berada di wilayah yang salah
Verifikasi aliran ada di wilayah yang benar:
```
aws kinesis describe-stream \
--stream-name your-stream-name \
--region us-east-2
```
Kontak belum dimulai
Pengiriman telemetri dimulai pada waktu mulai kontak. Verifikasi kontak telah dimulai dengan memeriksa status kontak:
```
aws groundstation describe-contact \
--contact-id 12345678-1234-1234-1234-123456789012 \
--region us-east-2
```
### Data telemetri intermiten
**Gejala**
Data telemetri disampaikan secara tidak konsisten dengan kesenjangan atau catatan yang hilang.
**Kemungkinan penyebabnya**
+ Kinesis Data Streams mengalirkan masalah kapasitas atau pelambatan. Lihat [Masalah konfigurasi aliran Kinesis Data Streams](#troubleshooting-telemetry.kinesis-config).
+ Masalah konektivitas jaringan antara AWS Ground Station dan aliran Kinesis Data Streams Anda.
**Solusi**
+ Pantau CloudWatch metrik aliran Data Streams Kinesis untuk pelambatan atau kesalahan.
+ Pastikan streaming Anda menggunakan mode kapasitas sesuai permintaan atau memiliki kapasitas yang cukup.
+ Gunakan aliran khusus untuk AWS Ground Station telemetri untuk menghindari pertengkaran dengan aplikasi lain.
## Masalah format data
### Kesalahan penguraian JSON
**Gejala**
Aplikasi Anda mengalami kesalahan saat mengurai catatan telemetri sebagai JSON.
**Solusi**
+ **Verifikasi decoding Base64** - Data dalam aliran Kinesis Data Streams dikodekan Base64. Pastikan Anda memecahkan kode data sebelum menguraikannya sebagai JSON. Untuk informasi selengkapnya, lihat [Membaca data dari aliran Kinesis Data Streams](telemetry.understanding-data.md#telemetry.understanding-data.reading).
+ **Periksa catatan kosong** - AWS Ground Station dapat mengirim catatan validasi kosong saat membuat *TelemetrySinkConfig*file. Aplikasi Anda harus menangani catatan kosong atau cacat dengan anggun.
+ **Terapkan parsing sadar versi - Parse** the`telemetryTypeAndVersion`,`telemetryType`, and `telemetryVersion` fields terlebih dahulu untuk menentukan skema yang sesuai untuk setiap record.
### Jenis atau versi telemetri yang tidak diketahui
**Gejala**
Aplikasi Anda menemukan jenis atau versi telemetri yang tidak dikenalinya.
**Solusi**
Ini adalah perilaku yang diharapkan karena jenis telemetri baru dan versi skema dapat diperkenalkan dari waktu ke waktu. Aplikasi Anda harus:
+ Log jenis dan versi yang tidak dikenal untuk pemantauan.
+ Lanjutkan memproses jenis dan versi yang dikenal.
+ Menerapkan penanganan yang anggun untuk skema yang tidak diketahui.
Untuk informasi selengkapnya tentang pembuatan versi skema, lihat. [Pembuatan versi dan evolusi skema](telemetry.understanding-data.md#telemetry.understanding-data.schema-evolution)
## Mendapatkan bantuan
Jika Anda terus mengalami masalah setelah mengikuti langkah-langkah pemecahan masalah, hubungi Support AWS .
**Informasi untuk diberikan**
Saat menghubungi dukungan, berikan informasi berikut:
+ Kontak IDs mengalami masalah
+ ID profil misi digunakan
+ TelemetrySinkConfig ARN
+ Aliran Data Streams Kinesis ARN
+ IAM berperan ARN dan kebijakan terlampir
+ Pesan galat dari CloudWatch Log atau aplikasi Anda
+ Stempel waktu saat masalah terjadi
+ Langkah pemecahan masalah sudah diambil
Untuk AWS Ground Station dukungan umum, lihat [Panduan AWS Ground Station Pengguna](https://docs.aws.amazon.com/ground-station/latest/ug/what-is.html).