View a markdown version of this page

Memecahkan masalah telemetri - AWS Ground Station
Masalah pengaturan umumMasalah pengiriman telemetriMasalah format dataMendapatkan bantuan

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 dan pastikan semua langkah diikuti.

  2. 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.

  3. Verifikasi peran IAM memiliki izin Kinesis yang diperlukan: 

    aws iam list-attached-role-policies --role-name GroundStationTelemetryRole

    Pastikan kebijakan tersebut mencakupkinesis:DescribeStream,kinesis:PutRecord, dan kinesis:PutRecords izin untuk streaming Anda.

  4. Verifikasi aliran Kinesis Data Streams ada dan ARN sudah benar: 

    aws kinesis describe-stream \
    --stream-name your-stream-name \
    --region us-east-2

  5. Jika menggunakan enkripsi yang dikelola pelanggan, verifikasi peran IAM memiliki kms:GenerateDataKey izin untuk kunci Anda. AWS KMS

PassRole kesalahan izin

Gejala

Saat meneleponCreateConfig, 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

  2. 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

  3. 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 termasuktelemetrySinkConfigArn: 

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

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

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.

  • Periksa catatan kosong - AWS Ground Station dapat mengirim catatan validasi kosong saat membuat TelemetrySinkConfigfile. Aplikasi Anda harus menangani catatan kosong atau cacat dengan anggun.

  • Terapkan parsing sadar versi - Parse thetelemetryTypeAndVersion,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

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.