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](telemetry.setup.md#telemetry.setup.step2) e garanta que todas as etapas foram seguidas. 1. 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. 1. 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:DescribeStream``kinesis:PutRecord`, e `kinesis:PutRecords` permissões para sua transmissão. 1. 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 ``` 1. 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 ligar`CreateConfig`, 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 ``` 1. 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 ``` 1. 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 inclui`telemetrySinkConfigArn`: ``` 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 em[Erros de permissão do IAM](#troubleshooting-telemetry.iam-permissions). 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** + Problemas de capacidade ou limitação de streaming do Kinesis Data Streams. Consulte [Problemas de configuração do stream do Kinesis Data Streams](#troubleshooting-telemetry.kinesis-config). + Problemas de conectividade de rede entre AWS Ground Station e seu stream do Kinesis Data Streams. **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](telemetry.understanding-data.md#telemetry.understanding-data.reading). + **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 `telemetryTypeAndVersion``telemetryType`, 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](telemetry.understanding-data.md#telemetry.understanding-data.schema-evolution) ## 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](https://docs.aws.amazon.com/ground-station/latest/ug/what-is.html).