Solucionar problemas de telemetría - AWS Ground Station
Problemas comunes de configuraciónProblemas con la 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 relacionados con la telemetría.

Problemas comunes de configuración

Errores de permisos de IAM

Síntomas

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

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

Causas

  • El rol de IAM especificado en el 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 que aparece en TelemetrySinkConfig es incorrecto o la transmisión no existe.

Soluciones

  1. Compruebe que el rol de IAM existe y tiene los permisos correctos. Revise Paso 2: Crear un TelemetrySinkConfig y asegúrese de que se hayan seguido todos los pasos.

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

    aws iam get-role --role-name GroundStationTelemetryRole

    Compruebe que la política de confianza groundstation.amazonaws.com se incluye como principio de servicio de confianza.

  3. Compruebe que el rol 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 los kinesis:PutRecords permisos para su transmisión.

  4. Compruebe que la transmisión de Kinesis Data Streams existe y que el ARN es correcto: 

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

  5. Si utiliza un 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 mensaje de 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. Añada 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::99999999999:role/your-stream-name"
    }
  ]
}

Problemas de configuración de transmisiones de Kinesis Data Streams

Síntomas

El suministro de telemetría falla o es intermitente.

Causas

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

  • Otras aplicaciones utilizan la transmisión, lo que provoca una ralentización de la escritura.

Soluciones

  1. Compruebe el estado de la transmisión: 

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

  2. Supervisa la limitación de la 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 AWS Ground Station telemetría.

    • Si utiliza el modo aprovisionado, aumentar la cantidad de fragmentos.

Problemas con la entrega de telemetría

No aparecen datos de telemetría

Síntomas

Tras programar un contacto con un perfil de misión habilitado para 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

Comprueba 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 de los roles de IAM

Consulte los pasos de solución de problemas de permisos de IAM que se indican en. Errores de permisos de IAM

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

Compruebe que la transmisión existe en la región correcta: 

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

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

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 CloudWatch de transmisión de Kinesis Data Streams para detectar limitaciones o errores.

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

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

Problemas de formato de datos

Errores de análisis de JSON

Síntomas

La 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 Kinesis Data Streams están codificados en Base64. Asegúrese de decodificar los datos antes de analizarlos como JSON. Para obtener más información, consulte Lectura de datos de la 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 un análisis que tenga en cuenta las versiones: analice primero los telemetryVersion campos y telemetryTypeAndVersiontelemetryType, 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 con el tiempo se introduzcan nuevos tipos de telemetría y versiones de esquemas. Su solicitud debería:

  • Registre los tipos y versiones desconocidos para su supervisión.

  • Continúe procesando los tipos y versiones conocidos.

  • Implemente un manejo correcto de los esquemas desconocidos.

Para obtener más información sobre el control de versiones de esquemas, consulte. Evolución y control de versiones del esquema

Obtener ayuda

Si sigue teniendo problemas después de seguir los pasos de solución de problemas, póngase en contacto con AWS Support.

Información que debe proporcionar

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

  • El contacto IDs tiene problemas

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

  • TelemetrySinkConfig ARN

  • ARN de transmisión de Kinesis Data Streams

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

  • Mensajes de error de los CloudWatch registros o de su aplicación

  • Marcas de tiempo en las que se produjeron los problemas

  • Ya se han tomado medidas de solución de problemas

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