View a markdown version of this page

Solucionar problemas de telemetría - AWS Ground Station
Problemas de configuración comunesProblemas de entrega de telemetríaProblemas de formato de datosObtener ayuda

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.

Solucionar problemas de telemetría

Utilice la siguiente información para solucionar problemas comunes de telemetría.

Problemas de configuración comunes

Errores de permisos de IAM

¿Síntomas

Cuando llamas CreateConfig para crear un TelemetrySinkConfig, recibes un error: 

Unable to write to Kinesis Data Streams stream. Ensure that Ground Station has 
kinesis:PutRecord permissions for the given stream

Causas

  • La función de IAM especificada en TelemetrySinkConfig no tiene los permisos necesarios para escribir en la transmisión de Kinesis Data Streams.

  • La política de confianza del rol de IAM no permite AWS Ground Station asumir el rol.

  • El ARN de la transmisión de Kinesis Data Streams TelemetrySinkConfig es incorrecto o la transmisión no existe.

Soluciones

  1. Compruebe que la función de IAM existe y tiene los permisos correctos. Revise Paso 2: Crear un TelemetrySinkConfig y asegúrese de que se han seguido todos los pasos.

  2. Compruebe que AWS Ground Station puede asumir su función de IAM: 

    aws iam get-role --role-name GroundStationTelemetryRole

    Verifique que la política de confianza incluya groundstation.amazonaws.com a un director de servicio confiable.

  3. Compruebe que la función de IAM tenga los permisos de Kinesis necesarios: 

    aws iam list-attached-role-policies --role-name GroundStationTelemetryRole

    Asegúrese de que la política incluya kinesis:DescribeStream y kinesis:PutRecord otorgue kinesis:PutRecords permisos para su transmisión.

  4. Verifique que la transmisión de Kinesis Data Streams exista y que el ARN sea correcto: 

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

  5. Si utiliza el cifrado administrado por el cliente, compruebe que el rol de IAM tenga kms:GenerateDataKey permiso para su clave. AWS KMS

PassRole errores de permisos

Síntomas

Cuando llamasCreateConfig, recibes un error que indica que no tienes permiso para pasar a la función de IAM.

Solución

Asegúrese de que su usuario o rol de IAM tenga iam:PassRole permiso para el rol de IAM de telemetría. Agregue la siguiente política a su usuario o rol: 

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

Problemas de configuración de transmisiones de Kinesis Data Streams

Síntomas

La entrega de telemetría falla o es intermitente.

Causas

  • La transmisión de Kinesis Data Streams no tiene capacidad suficiente para el rendimiento de la telemetría.

  • La transmisión está siendo utilizada por otras aplicaciones, lo que provoca una limitación de escritura.

Soluciones

  1. Comprueba el estado de la transmisión: 

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

  2. Controle la limitación de escritura mediante CloudWatch métricas: 

    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. Si se detecta una limitación, tenga en cuenta lo siguiente:

    • Cambiar al modo de capacidad bajo demanda para el escalado automático.

    • Uso de una transmisión dedicada para la AWS Ground Station telemetría.

    • Si usa el modo aprovisionado, aumente la cantidad de fragmentos.

Problemas de entrega de telemetría

No aparecen datos de telemetría

¿Síntomas

Después de programar un contacto con un perfil de misión habilitado para la telemetría, no aparece ningún dato de telemetría en la transmisión de Kinesis Data Streams.

Posibles causas y soluciones

El perfil de la misión no tiene habilitada la telemetría

Verifique que el perfil de misión utilizado para el contacto incluya: telemetrySinkConfigArn 

aws groundstation get-mission-profile \
    --mission-profile-id 12345678-1234-1234-1234-123456789012 \
    --region us-east-2

Compruebe el resultado del telemetrySinkConfigArn campo. Si no está presente, el perfil de la misión no tiene habilitada la telemetría.

Problema con los permisos del rol de IAM

Revisa los pasos para solucionar el problema de los permisos de IAM en. Errores de permisos de IAM

La transmisión de Kinesis Data Streams no existe o se encuentra en una región incorrecta

Verifique que la transmisión exista en la región correcta: 

aws kinesis describe-stream \
    --stream-name your-stream-name \
    --region us-east-2
El contacto aún no ha comenzado

La entrega de telemetría comienza a la hora de inicio del contacto. Verifique que el contacto se haya iniciado comprobando el estado del contacto: 

aws groundstation describe-contact \
    --contact-id 12345678-1234-1234-1234-123456789012 \
    --region us-east-2
Contacto programado en una estación terrestre doble digital

Las estaciones terrestres gemelas digitales no admiten la entrega de telemetría. Los contactos programados en las antenas gemelas digitales no producen datos de telemetría. Verifique que la estación terrestre utilizada para su contacto no sea una gemela digital comprobando el nombre de la estación terrestre. Las estaciones terrestres gemelas digitales tienen el prefijo «gemela digital» en su nombre. Para obtener más información, consulte Use la AWS Ground Station función de gemelo digital.

Datos de telemetría intermitente

Síntomas

Los datos de telemetría se entregan de forma incoherente, con lagunas o registros faltantes.

Posibles causas

Soluciones

  • Supervise las métricas de transmisión de Kinesis Data Streams CloudWatch para detectar limitaciones o errores.

  • Asegúrese de que su transmisión utilice el modo de capacidad bajo demanda o de que tenga suficiente capacidad aprovisionada.

  • Usa una transmisión dedicada para la AWS Ground Station telemetría a fin de evitar problemas con otras aplicaciones.

Problemas de formato de datos

Errores de análisis de JSON

¿Síntomas

Su aplicación detecta errores al analizar los registros de telemetría como JSON.

Soluciones

  • Verifique la decodificación en Base64: los datos de la transmisión de datos de Kinesis Data Streams son. Base64-encoded Asegúrese de decodificar los datos antes de analizarlos como JSON. Para obtener más información, consulte Lectura de datos de una transmisión de Kinesis Data Streams.

  • Compruebe si hay registros vacíos: es AWS Ground Station posible que se envíen registros de validación vacíos al crear un. TelemetrySinkConfig Su aplicación debe gestionar correctamente los registros vacíos o con formato incorrecto.

  • Implemente el análisis con reconocimiento de versiones: analice primero los telemetryVersion campos telemetryTypeAndVersiontelemetryType, y para determinar el esquema apropiado para cada registro.

Tipos o versiones de telemetría desconocidos

¿Síntomas

La aplicación encuentra tipos o versiones de telemetría que no reconoce.

Solución

Este es el comportamiento esperado, ya que es posible que se introduzcan nuevos tipos de telemetría y versiones de esquemas con el tiempo. Su aplicación debería:

  • Registra los tipos y versiones desconocidos para supervisarlos.

  • Continúe procesando los tipos y versiones conocidos.

  • Implemente un manejo eficiente de los esquemas desconocidos.

Para obtener más información sobre el control de versiones de esquemas, consulte. Control de versiones y evolución de esquemas

Obtener ayuda

Si sigues teniendo problemas después de seguir los pasos de solución de problemas, ponte en contacto con el equipo de AWS soporte.

Información que debe proporcionarse

Cuando te pongas en contacto con el servicio de asistencia, proporciona la siguiente información:

  • Los identificadores de contacto tienen problemas

  • Se utilizó el identificador del perfil de la misión

  • TelemetrySinkConfig ARN

  • Kinesis Data Streams transmite ARN

  • Rol de IAM (ARN) y políticas adjuntas

  • Mensajes de error de CloudWatch Logs o de tu aplicación

  • Marcas de tiempo en las que se produjeron los problemas

  • Ya se han tomado medidas para solucionar el problema

Para obtener AWS Ground Station asistencia general, consulte la Guía AWS Ground Station del usuario.