View a markdown version of this page

Solucionar problemas de telemetria - AWS Ground Station
Problemas comuns de configuraçãoProblemas de entrega de telemetriaProblemas de formato de dadosComo obter ajuda

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Solucionar problemas de telemetria

Use as informações a seguir para solucionar problemas comuns com a telemetria.

Problemas comuns de configuração

Erros de permissão do IAM

Sintomas

Ao ligar CreateConfig para criar um TelemetrySinkConfig, você recebe um erro: 

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

Causas

  • A função do IAM especificada no TelemetrySinkConfig não tem as permissões necessárias para gravar no stream do Kinesis Data Streams.

  • A política de confiança na função do IAM não AWS Ground Station permite assumir a função.

  • O TelemetrySinkConfig ARN do stream do Kinesis Data Streams em está incorreto ou o stream não existe.

Soluções

  1. Verifique se a função do IAM existe e tem as permissões corretas. Revise Etapa 2: criar um TelemetrySinkConfig e garanta que todas as etapas foram seguidas.

  2. Verifique se AWS Ground Station pode assumir sua função do IAM: 

    aws iam get-role --role-name GroundStationTelemetryRole

    Verifique se a política de confiança está incluída groundstation.amazonaws.com como principal de serviço confiável.

  3. Verifique se a função do IAM tem as permissões necessárias do Kinesis: 

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

    Certifique-se de que a política inclua kinesis:DescribeStreamkinesis:PutRecord, e kinesis:PutRecords permissões para sua transmissão.

  4. Verifique se o stream do Kinesis Data Streams existe e se o ARN está correto: 

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

  5. Se estiver usando criptografia gerenciada pelo cliente, verifique se a função do IAM tem kms:GenerateDataKey permissão para sua AWS KMS chave.

PassRole erros de permissão

Sintomas

Ao ligarCreateConfig, você recebe um erro sobre não ter permissão para transmitir a função do IAM.

Solução

Certifique-se de que seu usuário ou função do IAM tenha iam:PassRole permissão para a função do IAM de telemetria. Adicione a seguinte política ao seu usuário ou função: 

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

Problemas de configuração do stream do Kinesis Data Streams

Sintomas

A entrega da telemetria falha ou é intermitente.

Causas

  • O stream do Kinesis Data Streams tem capacidade insuficiente para a taxa de transferência de telemetria.

  • O stream está sendo usado por outros aplicativos, causando limitação de gravação.

Soluções

  1. Verifique o status da transmissão: 

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

  2. Monitore a limitação de gravação usando 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. Se a limitação for detectada, considere:

    • Mudar para o modo de capacidade sob demanda para escalabilidade automática.

    • Usando um stream dedicado para AWS Ground Station telemetria.

    • Se estiver usando o modo provisionado, aumente o número de fragmentos.

Problemas de entrega de telemetria

Nenhum dado de telemetria aparecendo

Sintomas

Depois de agendar um contato com um perfil de missão habilitado para telemetria, nenhum dado de telemetria aparece em seu stream do Kinesis Data Streams.

Possíveis causas e soluções

O perfil da missão não tem a telemetria ativada

Verifique se o perfil da missão usado para o contato incluitelemetrySinkConfigArn: 

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

Verifique a saída do telemetrySinkConfigArn campo. Se não estiver presente, o perfil da missão não tem a telemetria ativada.

Problema de permissões de função do IAM

Analise as etapas de solução de problemas de permissão do IAM emErros de permissão do IAM.

O stream do Kinesis Data Streams não existe ou está na região errada

Verifique se o fluxo existe na região correta: 

aws kinesis describe-stream \
    --stream-name your-stream-name \
    --region us-east-2
O contato ainda não foi iniciado

A entrega da telemetria começa no horário de início do contato. Verifique se o contato foi iniciado verificando o status do contato: 

aws groundstation describe-contact \
    --contact-id 12345678-1234-1234-1234-123456789012 \
    --region us-east-2

Dados de telemetria intermitentes

Sintomas

Os dados de telemetria são fornecidos de forma inconsistente com lacunas ou registros ausentes.

Causas possíveis

Soluções

  • Monitore as CloudWatch métricas de stream do Kinesis Data Streams em busca de limitações ou erros.

  • Certifique-se de que seu stream esteja usando o modo de capacidade sob demanda ou tenha capacidade provisionada suficiente.

  • Use um stream dedicado para AWS Ground Station telemetria para evitar contenções com outros aplicativos.

Problemas de formato de dados

Erros de análise de JSON

Sintomas

Seu aplicativo encontra erros ao analisar registros de telemetria como JSON.

Soluções

  • Verifique a decodificação em Base64 - Os dados no stream do Kinesis Data Streams são codificados em Base64. Certifique-se de decodificar os dados antes de analisá-los como JSON. Para obter mais informações, consulte Lendo dados do stream do Kinesis Data Streams.

  • Verifique se há registros vazios - AWS Ground Station pode enviar registros de validação vazios ao criar um TelemetrySinkConfig. Seu aplicativo deve lidar com registros vazios ou malformados normalmente.

  • Implemente a análise com reconhecimento de versão - analise primeiro os telemetryVersion campos telemetryTypeAndVersiontelemetryType, e para determinar o esquema apropriado para cada registro.

Tipos ou versões de telemetria desconhecidos

Sintomas

Seu aplicativo encontra tipos ou versões de telemetria que não reconhece.

Solução

Esse é o comportamento esperado, pois novos tipos de telemetria e versões de esquema podem ser introduzidos ao longo do tempo. Sua inscrição deve:

  • Registre tipos e versões desconhecidos para monitoramento.

  • Continue processando tipos e versões conhecidos.

  • Implemente um tratamento elegante para esquemas desconhecidos.

Para obter mais informações sobre o controle de versão do esquema, consulte. Controle de versão e evolução do esquema

Como obter ajuda

Se você continuar enfrentando problemas depois de seguir as etapas de solução de problemas, entre em contato com o AWS Support.

Informações a serem fornecidas

Ao entrar em contato com o suporte, forneça as seguintes informações:

  • Contato IDs com problemas

  • ID do perfil de missão usado

  • TelemetrySinkConfig ARN

  • ARN do stream do Kinesis Data Streams

  • ARN da função do IAM e políticas anexadas

  • Mensagens de erro do CloudWatch Logs ou do seu aplicativo

  • Registros de data e hora em que os problemas ocorreram

  • Etapas de solução de problemas já realizadas

Para obter AWS Ground Station suporte geral, consulte o Guia AWS Ground Station do usuário.