Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà. # Risolvere i problemi di telemetria Utilizza le seguenti informazioni per risolvere i problemi più comuni relativi alla telemetria. ## Problemi di configurazione comuni ### Errori di autorizzazione IAM **Sintomi** Quando si chiama `CreateConfig` per creare un TelemetrySinkConfig, viene visualizzato un errore: ``` Unable to write to Kinesis Data Streams stream. Ensure that Ground Station has kinesis:PutRecord permissions for the given stream ``` **Cause** + Il ruolo IAM specificato in TelemetrySinkConfig non dispone delle autorizzazioni necessarie per scrivere nel flusso Kinesis Data Streams. + La policy di fiducia sul ruolo IAM non consente di AWS Ground Station assumere il ruolo. + L' TelemetrySinkConfig ARN del flusso Kinesis Data Streams non è corretto o lo stream non esiste. **Soluzioni** 1. Verifica che il ruolo IAM esista e disponga delle autorizzazioni corrette. Rivedi [Fase 2: Creare un TelemetrySinkConfig](telemetry.setup.md#telemetry.setup.step2) e assicurati che tutti i passaggi siano stati seguiti. 1. Verifica che AWS Ground Station possa assumere il tuo ruolo di IAM: ``` aws iam get-role --role-name GroundStationTelemetryRole ``` Verifica che la politica di fiducia `groundstation.amazonaws.com` sia inclusa come responsabile del servizio affidabile. 1. Verifica che il ruolo IAM disponga delle autorizzazioni Kinesis richieste: ``` aws iam list-attached-role-policies --role-name GroundStationTelemetryRole ``` Assicurati che la policy `kinesis:DescribeStream` includa e `kinesis:PutRecords` autorizzazioni per il tuo stream. `kinesis:PutRecord` 1. Verifica che il flusso Kinesis Data Streams esista e che l'ARN sia corretto: ``` aws kinesis describe-stream \ --stream-name your-stream-name \ --region us-east-2 ``` 1. Se utilizzi la crittografia gestita dal cliente, verifica che il ruolo IAM `kms:GenerateDataKey` disponga dell'autorizzazione per la tua chiave. AWS KMS ### PassRole errori di autorizzazione **Sintomi** Quando si chiama`CreateConfig`, viene visualizzato un errore che indica che non si dispone dell'autorizzazione per passare il ruolo IAM. **Soluzione** Assicurati che il tuo utente o ruolo IAM disponga dell'`iam:PassRole`autorizzazione per il ruolo IAM di telemetria. Aggiungi la seguente policy al tuo utente o ruolo: ``` { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "iam:GetRole", "iam:PassRole" ], "Resource": "arn:aws:iam::99999999999:role/your-stream-name" } ] } ``` ### Problemi di configurazione del flusso Kinesis Data Streams **Sintomi** La consegna della telemetria non riesce o è intermittente. **Cause** + Lo stream Kinesis Data Streams ha una capacità insufficiente per il throughput di telemetria. + Lo stream viene utilizzato da altre applicazioni, con conseguente limitazione della scrittura. **Soluzioni** 1. Controlla lo stato dello stream: ``` aws kinesis describe-stream \ --stream-name your-stream-name \ --region us-east-2 ``` 1. Monitora la limitazione della scrittura utilizzando CloudWatch le metriche: ``` 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 viene rilevata una limitazione, considera: + Passaggio alla modalità di capacità su richiesta per la scalabilità automatica. + Utilizzo di uno stream dedicato per AWS Ground Station la telemetria. + Se si utilizza la modalità provisioned, aumentare il numero di shard. ## Problemi di consegna della telemetria ### Nessun dato di telemetria visualizzato **Sintomi** Dopo aver pianificato un contatto con un profilo di missione abilitato alla telemetria, nel flusso Kinesis Data Streams non viene visualizzato alcun dato di telemetria. **Possibili cause e soluzioni** Il profilo di missione non ha la telemetria abilitata Verifica che il profilo di missione utilizzato per il contatto includa: `telemetrySinkConfigArn` ``` aws groundstation get-mission-profile \ --mission-profile-id 12345678-1234-1234-1234-123456789012 \ --region us-east-2 ``` Controlla l'output del `telemetrySinkConfigArn` campo. Se non è presente, il profilo di missione non ha la telemetria abilitata. Problema con le autorizzazioni dei ruoli IAM Consulta la procedura per la risoluzione dei problemi di autorizzazione IAM riportata in[Errori di autorizzazione IAM](#troubleshooting-telemetry.iam-permissions). Lo stream Kinesis Data Streams non esiste o si trova nella regione sbagliata Verifica che lo stream esista nella regione corretta: ``` aws kinesis describe-stream \ --stream-name your-stream-name \ --region us-east-2 ``` Il contatto non è ancora iniziato La consegna della telemetria inizia all'ora di inizio del contatto. Verifica che il contatto sia iniziato controllando lo stato del contatto: ``` aws groundstation describe-contact \ --contact-id 12345678-1234-1234-1234-123456789012 \ --region us-east-2 ``` ### Dati di telemetria intermittenti **Sintomi** I dati di telemetria vengono forniti in modo incoerente rispetto alle lacune o ai record mancanti. **Possibili cause** + Problemi o limitazione della capacità dello streaming di Kinesis Data Streams. Per informazioni, consulta [Problemi di configurazione del flusso Kinesis Data Streams](#troubleshooting-telemetry.kinesis-config). + Problemi di connettività di rete tra AWS Ground Station e lo stream Kinesis Data Streams. **Soluzioni** + Monitora le CloudWatch metriche del flusso di Kinesis Data Streams per verificare la presenza di limitazioni o errori. + Assicurati che lo stream utilizzi la modalità di capacità su richiesta o disponga di una capacità fornita sufficiente. + Utilizza uno stream dedicato per la AWS Ground Station telemetria per evitare conflitti con altre applicazioni. ## Problemi relativi al formato dei dati ### Errori di analisi JSON **Sintomi** L'applicazione riscontra errori durante l'analisi dei record di telemetria come JSON. **Soluzioni** + **Verifica della decodifica Base64**: i dati nello stream Kinesis Data Streams sono codificati in Base64. Assicurati di decodificare i dati prima di analizzarli come JSON. Per ulteriori informazioni, consulta [Lettura dei dati dal flusso Kinesis Data Streams](telemetry.understanding-data.md#telemetry.understanding-data.reading). + **Verifica la presenza di record vuoti: AWS Ground Station può inviare record** di convalida vuoti durante la creazione di un. *TelemetrySinkConfig* La tua applicazione dovrebbe gestire con garbo i record vuoti o non corretti. + **Implementa l'analisi sensibile alla versione**: analizza prima i `telemetryVersion` campi `telemetryTypeAndVersion``telemetryType`, e per determinare lo schema appropriato per ogni record. ### Tipi o versioni di telemetria sconosciuti **Sintomi** L'applicazione presenta tipi o versioni di telemetria che non riconosce. **Soluzione** Questo è un comportamento previsto in quanto nel tempo potrebbero essere introdotti nuovi tipi di telemetria e nuove versioni dello schema. L'applicazione deve: + Registra tipi e versioni sconosciuti per il monitoraggio. + Continua a elaborare i tipi e le versioni noti. + Implementa una gestione corretta per schemi sconosciuti. Per ulteriori informazioni sul controllo delle versioni dello schema, vedere. [Versionamento ed evoluzione dello schema](telemetry.understanding-data.md#telemetry.understanding-data.schema-evolution) ## Utilizzo della guida Se continui a riscontrare problemi dopo aver seguito la procedura di risoluzione dei problemi, contatta l' AWS assistenza. **Informazioni da fornire** Quando contatti l'assistenza, fornisci le seguenti informazioni: + Contatta con IDs problemi + ID del profilo di missione utilizzato + TelemetrySinkConfig ARN + ARN per lo streaming di Kinesis Data Streams + Ruolo IAM, ARN e policy allegate + Messaggi di errore provenienti da CloudWatch Logs o dall'applicazione + Indicazioni temporali in cui si sono verificati i problemi + Procedure di risoluzione dei problemi già eseguite Per AWS Ground Station assistenza generale, consulta la [Guida AWS Ground Station per l'utente](https://docs.aws.amazon.com/ground-station/latest/ug/what-is.html).