

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Siapkan telemetri
<a name="telemetry.setup"></a>

 Ikuti langkah-langkah ini untuk mengonfigurasi telemetri untuk kontak Anda AWS Ground Station . Setelah menyelesaikan penyiapan ini, data telemetri akan dikirimkan ke aliran Kinesis Data Streams Anda selama kontak yang menggunakan profil misi berkemampuan telemetri. Untuk pemahaman mendalam tentang Kinesis Data Streams, silakan merujuk ke Panduan Pengguna Kinesis [Data Streams](https://docs.aws.amazon.com/streams/latest/dev/introduction.html). 

## Langkah 1: Buat sumber daya prasyarat AWS
<a name="telemetry.setup.step1"></a>

 CloudFormation Cuplikan berikut menunjukkan cara membuat sumber daya prasyarat AWS untuk pengiriman telemetri. Cuplikan ini membuat aliran Kinesis Data Streams dan peran IAM yang memberikan izin untuk menulis data AWS Ground Station telemetri ke aliran. 

```
TelemetryStream:
  Type: AWS::Kinesis::Stream
  Properties:
    Name: GroundStationTelemetryStream
    StreamModeDetails:
      StreamMode: ON_DEMAND
    RetentionPeriodHours: 24

TelemetryRole:
  Type: AWS::IAM::Role
  Properties:
    RoleName: GroundStationTelemetryRole
    AssumeRolePolicyDocument:
      Version: '2012-10-17'
      Statement:
        - Effect: Allow
          Principal:
            Service: groundstation.amazonaws.com
          Action: sts:AssumeRole
    Policies:
      - PolicyName: KinesisWritePolicy
        PolicyDocument:
          Version: '2012-10-17'
          Statement:
            - Effect: Allow
              Action:
                - kinesis:DescribeStream
                - kinesis:PutRecord
                - kinesis:PutRecords
              Resource: !GetAtt TelemetryStream.Arn
```

 Daftar di bawah ini menyebutkan pertimbangan pengaturan unik saat mengonfigurasi pengiriman telemetri untuk. AWS Ground Station

 Aliran **Data Streams Kinesis** - Aliran menggunakan mode kapasitas sesuai permintaan, yang secara otomatis menskalakan berdasarkan throughput. Ini direkomendasikan untuk sebagian besar kasus penggunaan. Aliran dikonfigurasi untuk menyimpan data selama 24 jam. Secara default, aliran menggunakan enkripsi AWS terkelola. Untuk menggunakan enkripsi yang dikelola pelanggan AWS Key Management Service, tambahkan `StreamEncryption` properti dan perbarui kebijakan peran IAM untuk menyertakan izin. `kms:GenerateDataKey` Untuk informasi selengkapnya, lihat [Perlindungan Data di Amazon Kinesis Data Streams](https://docs.aws.amazon.com/streams/latest/dev/server-side-encryption.html). 

 Peran **IAM - Peran** IAM memungkinkan kepala `groundstation.amazonaws.com` layanan untuk mengambil peran dan menulis data telemetri ke aliran Kinesis Data Streams Anda. Kebijakan peran memberikan izin untuk`kinesis:DescribeStream`,`kinesis:PutRecord`, dan `kinesis:PutRecords` tindakan di streaming. Lihat [Konfigurasi Wastafel Telemetri](how-it-works.config.md#how-it-works.config-telemetry-sink) panduan tentang pengaturan kebijakan kepercayaan dan kebijakan peran. 

 **Konfigurasi tambahan** - Tambahkan `iam:PassRole` izin ke pengguna IAM atau peran yang Anda gunakan untuk panggilan AWS Ground Station API. Ini memungkinkan Anda untuk meneruskan peran telemetri AWS Ground Station saat membuat file. TelemetrySinkConfig 

### Contoh PassRole Kebijakan
<a name="telemetry-passrole-policy-example"></a>

 Untuk informasi selengkapnya tentang cara memperbarui atau melampirkan kebijakan peran, lihat [Mengelola kebijakan IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage.html) di Panduan Pengguna IAM. Untuk informasi selengkapnya tentang `iam:PassRole` izin, lihat [Memberikan izin kepada pengguna untuk meneruskan peran ke layanan AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use_passrole.html) 

```
{
  "Version": "2012-10-17", 		 	 	 
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "iam:GetRole",
        "iam:PassRole"
      ],
      "Resource": "arn:aws:iam::999999999999:role/your-telemetry-delivery-role-name"
    }
  ]
}
```

## Langkah 2: Buat TelemetrySinkConfig
<a name="telemetry.setup.step2"></a>

 Buat *TelemetrySinkConfig*yang menentukan bagaimana AWS Ground Station akan mengirimkan data telemetri ke aliran Kinesis Data Streams Anda. Gunakan arus ARN dan peran ARN dari output CloudFormation tumpukan di Langkah 1. 

**catatan**  
 Saat Anda membuat *TelemetrySinkConfig*, AWS Ground Station akan memverifikasi akses ke aliran Kinesis Data Streams Anda dengan mengirimkan catatan pengujian kosong dengan kunci partisi. `test` 

 Untuk informasi selengkapnya tentang membuat *TelemetrySinkConfig*, lihat[Konfigurasi Wastafel Telemetri](how-it-works.config.md#how-it-works.config-telemetry-sink). 

## Langkah 3: Tambahkan telemetri ke profil misi Anda
<a name="telemetry.setup.step3"></a>

 Buat profil misi. Untuk informasi selengkapnya tentang membuat profil misi, lihat[Gunakan Profil AWS Ground Station Misi](how-it-works-mission-profile.md). Tambahkan `telemetrySinkConfigArn` ke profil misi Anda untuk mengaktifkan pengiriman telemetri selama kontak. Gunakan ARN yang *TelemetrySinkConfig*dibuat di Langkah 2. 

## Langkah 4: Jadwalkan kontak
<a name="telemetry.setup.step4"></a>

 Jadwalkan kontak menggunakan profil misi berkemampuan telemetri Anda. Selama kontak, AWS Ground Station akan mengalirkan data telemetri ke aliran Kinesis Data Streams Anda. 

 **Apa yang diharapkan selama kontak** 
+  **Telemetri mulai** - Data mulai streaming saat kontak dimulai. 
+  **Pengiriman mendekati waktu nyata** - Telemetri tiba di aliran Kinesis Data Streams Anda dalam waktu dekat. 
+  **Durasi kontak** - Data berlanjut di seluruh kontak. 
+  **Berhenti otomatis** - Telemetri berhenti streaming saat kontak berakhir. 

 **Memantau pengiriman** 

 Anda dapat memantau pengiriman telemetri menggunakan: 
+  Metrik aliran **Kinesis Data Streams** - Periksa catatan yang masuk. CloudWatch Untuk informasi selengkapnya, lihat [Memantau Amazon Kinesis Data Streams](https://docs.aws.amazon.com/streams/latest/dev/monitoring-with-cloudwatch.html). 
+  **Log aplikasi** - Verifikasi pemrosesan data dalam aplikasi Anda yang mengkonsumsi dari aliran. 
+  **Kinesis Data Viewer** - Gunakan konsol aliran Kinesis Data Streams untuk melihat rekaman sampel dari aliran Anda. 

## Langkah selanjutnya
<a name="telemetry.setup.next-steps"></a>

 Setelah menyelesaikan pengaturan, Anda dapat: 
+  Pelajari tentang format data telemetri dan jenis telemetri yang tersedia. Lihat [Memahami data telemetri](telemetry.understanding-data.md). 
+  Buat aplikasi untuk memproses data telemetri dari aliran Kinesis Data Streams Anda. Untuk informasi selengkapnya, lihat [Membangun Konsumen untuk Amazon Kinesis Data Streams](https://docs.aws.amazon.com/streams/latest/dev/building-consumers.html). 
+  Buat dasbor dan peringatan menggunakan CloudWatch dan layanan lainnya AWS . 
+  Tinjau panduan pemecahan masalah jika Anda mengalami masalah. Lihat [Memecahkan masalah telemetri](troubleshooting-telemetry.md). 