View a markdown version of this page

Memecahkan masalah telemetri - AWS Ground Station
Masalah penyiapan 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 penyiapan umum

Kesalahan izin IAM

Gejala

Saat memanggil 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 di 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.

  • Aliran Aliran Data Kinesis ARN di TelemetrySinkConfig dalam 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 apakah 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 mencakupkinesis:DescribeStream,kinesis:PutRecord, dan kinesis:PutRecords izin untuk streaming Anda.

  4. Verifikasi aliran Kinesis Data Streams ada dan ARN 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 meneruskan 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::123456789012:role/your-stream-name"
    }
  ]
}

Masalah konfigurasi aliran Aliran Data Kinesis

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

Solusi

  1. Periksa status streaming: 

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

  2. Pantau untuk 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 disediakan, meningkatkan jumlah pecahan.

Masalah pengiriman telemetri

Tidak ada data telemetri yang muncul

Gejala

Setelah menjadwalkan kontak dengan profil misi yang mendukung 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 diKesalahan 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
Kontak dijadwalkan di stasiun darat kembar digital

Stasiun darat kembar digital tidak mendukung pengiriman telemetri. Kontak yang dijadwalkan pada antena kembar digital tidak menghasilkan data telemetri. Pastikan stasiun darat yang digunakan untuk kontak Anda bukan kembar digital dengan memeriksa nama stasiun darat. Stasiun darat kembar digital memiliki awalan “Digital Twin” di namanya. Untuk informasi selengkapnya, lihat Gunakan AWS Ground Station fitur kembar digital.

Data telemetri intermiten

Gejala

Data telemetri disampaikan secara tidak konsisten dengan celah atau catatan yang hilang.

Kemungkinan penyebabnya

Solusi

  • Pantau metrik aliran Kinesis Data Streams CloudWatch untuk pelambatan atau kesalahan.

  • Pastikan streaming Anda menggunakan mode kapasitas sesuai permintaan atau memiliki kapasitas yang disediakan cukup.

  • Gunakan aliran khusus untuk AWS Ground Station telemetri untuk menghindari perselisihan 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 Aliran Data Kinesis adalah. Base64-encoded 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 TelemetrySinkConfig. Aplikasi Anda harus menangani catatan kosong atau cacat dengan anggun.

  • Menerapkan penguraian sadar versi - Parsis telemetryVersion bidangtelemetryTypeAndVersion,telemetryType, dan terlebih dahulu untuk menentukan skema yang sesuai untuk setiap catatan.

Jenis atau versi telemetri yang tidak diketahui

Gejala

Aplikasi Anda menemukan jenis atau versi telemetri yang tidak dikenali.

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

  • Terapkan penanganan anggun untuk skema yang tidak diketahui.

Untuk informasi selengkapnya tentang pembuatan versi skema, lihatVersi skema dan evolusi.

Mendapatkan bantuan

Jika Anda terus mengalami masalah setelah mengikuti langkah-langkah pemecahan masalah, hubungi AWS Dukungan.

Informasi untuk diberikan

Saat menghubungi dukungan, berikan informasi berikut:

  • ID Kontak mengalami masalah

  • ID profil misi digunakan

  • TelemetrySinkConfig ARN

  • Aliran Data Kinesis ARN

  • Peran IAM ARN dan kebijakan terlampir

  • Pesan kesalahan dari CloudWatch Log atau aplikasi Anda

  • Stempel waktu saat masalah terjadi

  • Langkah-langkah pemecahan masalah sudah diambil

Untuk AWS Ground Station dukungan umum, lihat Panduan AWS Ground Station Pengguna.