

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 AWS Ground Station kontak Anda. Setelah menyelesaikan pengaturan ini, data telemetri akan dikirimkan ke aliran Kinesis Data Streams Anda selama kontak yang menggunakan profil misi yang mendukung telemetri. Untuk pemahaman mendalam tentang Kinesis Data Streams, silakan lihat Panduan Pengguna [ Kinesis Data Streams. ](https://docs.aws.amazon.com/streams/latest/dev/introduction.html) 

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

 Cup CloudFormation likan berikut menunjukkan cara membuat AWS sumber daya prasyarat untuk pengiriman telemetri. Cuplikan ini membuat aliran Kinesis Data Streams dan peran IAM yang memberikan AWS Ground Station izin untuk menulis data 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 Aliran Data Kinesis ** - Aliran menggunakan mode kapasitas sesuai permintaan, yang secara otomatis menskalakan berdasarkan throughput. Ini direkomendasikan untuk sebagian besar kasus penggunaan. Stream 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 prinsipal `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 pada streaming. Lihat [Konfigurasi Wastafel Telemetri](how-it-works.config.md#how-it-works.config-telemetry-sink) panduan tentang menyiapkan kebijakan kepercayaan dan kebijakan peran. 

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

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

 Untuk informasi selengkapnya tentang cara memperbarui atau melampirkan kebijakan peran, lihat M [ engelola kebijakan IAM ](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage.html) di Panduan Pengguna IAM. Untuk informasi selengkapnya `iam:PassRole` tentang izin, [ lihat Memberikan izin 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 aliran ARN dan peran ARN dari output CloudFormation stack pada 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 pada Langkah 2. 

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

 Jadwalkan kontak menggunakan profil misi Anda yang mendukung telemetri. 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 Aliran Data Kinesis Anda hampir secara real-time. 
+  **Durasi kontak ** - Data berlanjut di seluruh kontak. 
+  **Penghentian otomatis ** - Telemetri berhenti streaming saat kontak berakhir. 

 **Memantau pengiriman ** 

 Anda dapat memantau pengiriman telemetri menggunakan: 
+  **Metrik aliran Aliran Data Kinesis ** - Periksa catatan masuk CloudWatch. Untuk informasi selengkapnya, lihat Mem [ antau Aliran Data Amazon Kinesis. ](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 streaming 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 Mem [ bangun Konsumen untuk Amazon Kinesis Data Streams](https://docs.aws.amazon.com/streams/latest/dev/building-consumers.html). 
+  Buat dasbor dan peringatan menggunakan CloudWatch dan AWS layanan lainnya. 
+  Tinjau panduan pemecahan masalah jika Anda mengalami masalah. Lihat [Memecahkan masalah telemetri](troubleshooting-telemetry.md). 