Problemas comuns de configuração Problemas de entrega de telemetria Problemas de formato de dados Como obter ajuda

Solucionar problemas de telemetria

Use as informações a seguir para solucionar problemas comuns com 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 em 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 ARN do stream do Kinesis Data Streams no TelemetrySinkConfig está incorreto ou o stream não existe.

Soluções

Verifique se a função do IAM existe e tem as permissões corretas. Analise Etapa 2: criar um TelemetrySinkConfig e garanta que todas as etapas foram seguidas.
Verifique se AWS Ground Station você pode assumir sua função do IAM:
```
aws iam get-role --role-name GroundStationTelemetryRole
```
Verifique se a política de confiança inclui groundstation.amazonaws.com um diretor de serviço confiável.
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.

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

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 passar 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 de telemetria do IAM. Adicione a política a seguir ao seu usuário ou função:


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

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

Sintomas

A entrega da telemetria falha ou é intermitente.

Causas

O stream do Kinesis Data Streams não tem capacidade suficiente para a taxa de transferência de telemetria.
O stream está sendo usado por outros aplicativos, causando limitação de gravação.

Soluções

Verifique o status da transmissão:


aws kinesis describe-stream \
    --stream-name your-stream-name \
    --region us-east-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

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ões 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 começou

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

Contato agendado em uma estação terrestre digital dupla

As estações terrestres duplas digitais não oferecem suporte à entrega de telemetria. Os contatos agendados em antenas duplas digitais não produzem dados de telemetria. Verifique se a estação terrestre usada para seu contato não é uma gêmea digital verificando o nome da estação terrestre. As estações terrestres digitais gêmeas têm o prefixo “Digital Twin” em seu nome. Para obter mais informações, consulte Use o comando AWS Ground Station recurso de gêmeos digitais.

Dados de telemetria intermitentes

Sintomas

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

Causas possíveis

Problemas de capacidade de streaming ou limitação do Kinesis Data Streams. Consulte Problemas de configuração de stream do Kinesis Data Streams.
Problemas de conectividade de rede entre AWS Ground Station e seu stream do Kinesis Data Streams.

Soluções

Monitore as métricas de streaming do Kinesis Data Streams em CloudWatch 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 fluxo dedicado para AWS Ground Station telemetria para evitar contenção 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 Base64 - Os dados no stream do Kinesis Data Streams são. Base64-encoded 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 ele não reconhece.

Solução

Esse comportamento é esperado, pois novos tipos de telemetria e versões de esquema podem ser introduzidos com o 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 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 Suporte.

Informações a serem fornecidas

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

IDs de contato com problemas
ID do perfil da missão usada
TelemetrySinkConfig ARN
O Kinesis Data Streams transmite ARN
Função do IAM, ARN e políticas anexas
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.

Atenção O Javascript está desativado ou não está disponível no seu navegador.

Para usar a documentação da AWS, o Javascript deve estar ativado. Consulte as páginas de Ajuda do navegador para obter instruções.

Convenções do documento

Solucionar problemas de contatos que não receberam dados

Cotas e limites