翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# テレメトリの設定
<a name="telemetry.setup"></a>

 AWS Ground Station 連絡先のテレメトリを設定するには、次の手順に従います。この設定が完了すると、テレメトリ対応ミッションプロファイルを使用するコンタクト中に、テレメトリデータが Kinesis Data Streams ストリームに配信されます。Kinesis Data Streams の詳細については、[Kinesis Data Streams ユーザーガイド](https://docs.aws.amazon.com/streams/latest/dev/introduction.html)を参照してください。

## ステップ 1: 前提条件 AWS となるリソースを作成する
<a name="telemetry.setup.step1"></a>

 次の CloudFormation スニペットは、テレメトリ配信の前提条件 AWS となるリソースを作成する方法を示しています。このスニペットは、Kinesis Data Streams ストリームと、ストリームにテレメトリデータを書き込む AWS Ground Station アクセス許可を付与する IAM ロールを作成します。

```
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
```

 以下のリストでは、テレメトリ配信を設定する際の一意の設定に関する考慮事項を示します AWS Ground Station。

 **Kinesis Data Streams ストリーム** - ストリームはオンデマンドキャパシティモードを使用し、スループットに基づいて自動的にスケーリングされます。これは、ほとんどのユースケースで推奨されます。ストリームは、データを 24 時間保持するように設定されています。デフォルトでは、ストリームは AWS マネージド暗号化を使用します。でカスタマーマネージド暗号化を使用するには AWS Key Management Service、 `StreamEncryption`プロパティを追加し、IAM ロールポリシーを更新して アクセス`kms:GenerateDataKey`許可を含めます。詳細については、[Amazon Kinesis Data Streams でのデータ保護](https://docs.aws.amazon.com/streams/latest/dev/server-side-encryption.html)」を参照してください。

 **IAM ロール** - IAM ロールは、`groundstation.amazonaws.com`サービスプリンシパルがロールを引き受け、テレメトリデータを Kinesis Data Streams ストリームに書き込むことを許可します。ロールポリシーは`kinesis:DescribeStream`、ストリーム上の 、`kinesis:PutRecord`、および `kinesis:PutRecords`アクションのアクセス許可を付与します。信頼ポリシーとロールポリシーの設定に関するガイダンス[テレメトリシンク設定](how-it-works.config.md#how-it-works.config-telemetry-sink)については、「」を参照してください。

 **追加設定** - AWS Ground Station API コールに使用する IAM ユーザーまたはロールにアクセス`iam:PassRole`許可を追加します。これにより、TelemetrySinkConfig の作成 AWS Ground Station 時にテレメトリロールを に渡すことができます。

### PassRole ポリシーの例
<a name="telemetry-passrole-policy-example"></a>

 ロールポリシーを更新またはアタッチする方法の詳細については、IAM ユーザーガイドの[「IAM ポリシーの管理](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage.html)」を参照してください。アクセス`iam:PassRole`許可の詳細については、[「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"
    }
  ]
}
```

## ステップ 2: TelemetrySinkConfig を作成する
<a name="telemetry.setup.step2"></a>

 AWS Ground Station がテレメトリデータを Kinesis Data Streams ストリームに配信する方法を定義する *TelemetrySinkConfig* を作成します。ステップ 1 の CloudFormation スタック出力からストリーム ARN とロール ARN を使用します。

**注記**  
 *TelemetrySinkConfig* を作成すると、 AWS Ground Station はパーティションキーが の空のテストレコードを配信することで、Kinesis Data Streams ストリームへのアクセスを検証します`test`。

 *TelemetrySinkConfig* の作成の詳細については、「」を参照してください[テレメトリシンク設定](how-it-works.config.md#how-it-works.config-telemetry-sink)。

## ステップ 3: ミッションプロファイルにテレメトリを追加する
<a name="telemetry.setup.step3"></a>

 ミッションプロファイルを作成します。ミッションプロファイルの作成の詳細については、「」を参照してください[AWS Ground Station ミッションプロファイルを使用する](how-it-works-mission-profile.md)。をミッションプロファイルに追加`telemetrySinkConfigArn`して、コンタクト中のテレメトリ配信を有効にします。ステップ 2 で作成した *TelemetrySinkConfig* の ARN を使用します。

## ステップ 4: コンタクトをスケジュールする
<a name="telemetry.setup.step4"></a>

 テレメトリが有効なミッションプロファイルを使用してコンタクトをスケジュールします。問い合わせ中、 AWS Ground Station はテレメトリデータを Kinesis Data Streams ストリームにストリーミングします。

 **問い合わせ中に予想されること** 
+  **テレメトリ開始** - 問い合わせが開始されると、データがストリーミングを開始します。
+  **ほぼリアルタイムの配信** - テレメトリはほぼリアルタイムで Kinesis Data Streams ストリームに到着します。
+  **問い合わせ期間** - データは問い合わせ全体を通じて継続されます。
+  **自動停止** - コンタクトが終了すると、テレメトリはストリーミングを停止します。

 **配信のモニタリング** 

 テレメトリ配信は、以下を使用してモニタリングできます。
+  **Kinesis Data Streams ストリームメトリクス** - CloudWatch で受信レコードを確認します。詳細については、[Amazon Kinesis Data Streams のモニタリング](https://docs.aws.amazon.com/streams/latest/dev/monitoring-with-cloudwatch.html)」を参照してください。
+  **アプリケーションログ** - ストリームから消費するアプリケーションのデータ処理を検証します。
+  **Kinesis Data Viewer** - Kinesis Data Streams ストリームコンソールを使用して、ストリームのサンプルレコードを表示します。

## 次の手順
<a name="telemetry.setup.next-steps"></a>

 セットアップが完了したら、次のことができます。
+  テレメトリデータ形式と使用可能なテレメトリタイプについて説明します。「[テレメトリデータを理解する](telemetry.understanding-data.md)」を参照してください。
+  Kinesis Data Streams ストリームからテレメトリデータを処理するためのアプリケーションを構築します。詳細については、[Amazon Kinesis Data Streams のコンシューマーの構築](https://docs.aws.amazon.com/streams/latest/dev/building-consumers.html)」を参照してください。
+  CloudWatch およびその他の AWS サービスを使用してダッシュボードとアラートを作成します。
+  問題が発生した場合は、トラブルシューティングガイダンスを確認してください。「[テレメトリのトラブルシューティング](troubleshooting-telemetry.md)」を参照してください。