

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Configure la telemetría
<a name="telemetry.setup"></a>

 Sigue estos pasos para configurar la telemetría de tus contactos. AWS Ground Station Tras completar esta configuración, los datos de telemetría se enviarán a la transmisión de Kinesis Data Streams durante los contactos que utilicen un perfil de misión con telemetría habilitada. Para obtener información detallada sobre Kinesis Data Streams, consulte la Guía [del usuario de Kinesis Data Streams](https://docs.aws.amazon.com/streams/latest/dev/introduction.html). 

## Paso 1: Cree los recursos necesarios AWS
<a name="telemetry.setup.step1"></a>

 En el siguiente CloudFormation fragmento se muestra cómo crear los AWS recursos necesarios para la entrega de telemetría. Este fragmento crea una transmisión de Kinesis Data Streams y una función de IAM que concede AWS Ground Station permiso para escribir datos de telemetría en la transmisión. 

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

 En la siguiente lista se indican algunas consideraciones de configuración específicas a la hora de configurar la entrega de telemetría para. AWS Ground Station

 Transmisión de **Kinesis Data Streams**: la transmisión utiliza el modo de capacidad bajo demanda, que se escala automáticamente en función del rendimiento. Esto se recomienda para la mayoría de los casos de uso. La transmisión está configurada para conservar los datos durante 24 horas. De forma predeterminada, la transmisión utiliza un cifrado AWS gestionado. Para utilizar el cifrado administrado por el cliente AWS Key Management Service, añada la `StreamEncryption` propiedad y actualice la política de funciones de IAM para incluir los permisos. `kms:GenerateDataKey` Para obtener más información, consulte [Protección de datos en Amazon Kinesis Data Streams](https://docs.aws.amazon.com/streams/latest/dev/server-side-encryption.html). 

 Función de **IAM: la función** de IAM permite al director del `groundstation.amazonaws.com` servicio asumir la función y escribir datos de telemetría en la transmisión de Kinesis Data Streams. La política de roles otorga permisos y `kinesis:PutRecords` acciones `kinesis:DescribeStream` en la `kinesis:PutRecord` transmisión. Consulte [Config del disipador de telemetría](how-it-works.config.md#how-it-works.config-telemetry-sink) para obtener orientación sobre cómo configurar la política de confianza y la política de roles. 

 **Configuración adicional**: añade `iam:PassRole` permisos al usuario o rol de IAM que utilizas para las llamadas a la AWS Ground Station API. Esto le permite transferir la función de telemetría AWS Ground Station al crear un. TelemetrySinkConfig 

### Ejemplo de política PassRole
<a name="telemetry-passrole-policy-example"></a>

 Para obtener más información sobre cómo actualizar o adjuntar una política de funciones, consulte [Gestión de las políticas de IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage.html) en la Guía del usuario de IAM. Para obtener más información sobre el `iam:PassRole` permiso, consulte [Otorgar permisos a un usuario para transferir un rol a un servicio de 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}}"
    }
  ]
}
```

## Paso 2: Crear un TelemetrySinkConfig
<a name="telemetry.setup.step2"></a>

 Cree una *TelemetrySinkConfig*que defina cómo AWS Ground Station se entregarán los datos de telemetría a su transmisión de Kinesis Data Streams. Utilice el ARN de flujo y el ARN de rol de las salidas de la CloudFormation pila en el paso 1. 

**nota**  
 Cuando cree una *TelemetrySinkConfig*, AWS Ground Station verificará el acceso a su transmisión de Kinesis Data Streams entregando un registro de prueba vacío con una clave `test` de partición de. 

 Para obtener más información sobre la creación de una *TelemetrySinkConfig*, consulte[Config del disipador de telemetría](how-it-works.config.md#how-it-works.config-telemetry-sink). 

## Paso 3: Añade la telemetría al perfil de tu misión
<a name="telemetry.setup.step3"></a>

 Crea un perfil de misión. Para obtener más información sobre la creación de perfiles de misión, consulte[Usa perfiles AWS Ground Station de misión](how-it-works-mission-profile.md). `telemetrySinkConfigArn`Añádalo al perfil de su misión para activar la telemetría durante los contactos. Utilice el ARN del *TelemetrySinkConfig*creado en el paso 2. 

## Paso 4: programar un contacto
<a name="telemetry.setup.step4"></a>

 Programa un contacto utilizando tu perfil de misión con telemetría. Durante el contacto, AWS Ground Station transmitirá los datos de telemetría a su transmisión de Kinesis Data Streams. 

 **¿Qué esperar durante los contactos** 
+  Inicio por **telemetría: los datos comienzan a** transmitirse a medida que se inicia el contacto. 
+  **Entrega casi en tiempo real**: la telemetría llega a su transmisión de Kinesis Data Streams prácticamente en tiempo real. 
+  **Duración del contacto**: los datos se conservan durante todo el contacto. 
+  **Parada automática**: la telemetría detiene la transmisión cuando finaliza el contacto. 

 **Supervisión de la entrega** 

 Puede monitorear la entrega de telemetría mediante: 
+  Métricas de transmisión de **Kinesis Data Streams**: compruebe los registros CloudWatch entrantes. Para obtener más información, consulte [Supervisión de Amazon Kinesis Data Streams](https://docs.aws.amazon.com/streams/latest/dev/monitoring-with-cloudwatch.html). 
+  **Registros de aplicaciones**: compruebe el procesamiento de los datos en las aplicaciones que consumen contenido de la transmisión. 
+  **Visor de datos de Kinesis**: utilice la consola de transmisiones de Kinesis Data Streams para ver los registros de muestra de su transmisión. 

## Siguientes pasos
<a name="telemetry.setup.next-steps"></a>

 Tras completar la configuración, puede: 
+  Obtenga información sobre el formato de datos de telemetría y los tipos de telemetría disponibles. Consulte [Comprenda los datos de telemetría](telemetry.understanding-data.md). 
+  Cree aplicaciones para procesar los datos de telemetría de su transmisión de Kinesis Data Streams. Para obtener más información, consulte [Creación de consumidores para Amazon Kinesis Data Streams](https://docs.aws.amazon.com/streams/latest/dev/building-consumers.html). 
+  Cree paneles y alertas mediante CloudWatch y otros AWS servicios. 
+  Consulte la guía de solución de problemas si encuentra algún problema. Consulte [Solucionar problemas de telemetría](troubleshooting-telemetry.md). 