View a markdown version of this page

Risoluzione dei problemi relativi alla telemetria - AWS Ground Station
Problemi di configurazione comuniProblemi di consegna della telemetriaProblemi relativi al formato dei datiUtilizzo della guida

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à.

Risoluzione dei problemi relativi alla telemetria

Utilizza le seguenti informazioni per risolvere i problemi più comuni relativi alla telemetria.

Problemi di configurazione comuni

Errori di autorizzazione IAM

Sintomi

Quando CreateConfig chiami per creare un TelemetrySinkConfig, ricevi 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 politica di fiducia sul ruolo IAM non consente di AWS Ground Station assumere il ruolo.

  • L'ARN dello stream di Kinesis Data Streams in TelemetrySinkConfig è errato o lo stream non esiste.

Soluzioni

  1. Verifica che il ruolo IAM esista e disponga delle autorizzazioni corrette. Rivedi Passaggio 2: creare un TelemetrySinkConfig e assicurati che tutti i passaggi siano stati seguiti.

  2. Verifica che AWS Ground Station possa assumere il tuo ruolo IAM: 

    aws iam get-role --role-name GroundStationTelemetryRole

    Verifica che la politica di fiducia groundstation.amazonaws.com includa come responsabile del servizio affidabile.

  3. 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

  4. Verifica che lo stream Kinesis Data Streams esista e che l'ARN sia corretto: 

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

  5. 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 chiamiCreateConfig, ricevi un messaggio di errore relativo alla mancata autorizzazione a passare il ruolo IAM.

Soluzione

Assicurati che il tuo utente o ruolo IAM disponga dell'iam:PassRoleautorizzazione 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::123456789012:role/your-stream-name"
    }
  ]
}

Problemi di configurazione dello stream di Kinesis Data Streams

Sintomi

L'invio della telemetria non riesce o è intermittente.

Cause

  • Lo stream di 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 streaming: 

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

  2. 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

  3. Se viene rilevata una limitazione, considera:

    • Passaggio alla modalità di capacità su richiesta per il ridimensionamento automatico.

    • Utilizzo di uno stream dedicato per AWS Ground Station la telemetria.

    • Se si utilizza la modalità provisioning, aumentare il numero di frammenti.

Problemi di consegna della telemetria

Nessun dato di telemetria visualizzato

Sintomi

Dopo aver pianificato un contatto con un profilo di missione abilitato alla telemetria, nello stream di 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 della 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 per il telemetrySinkConfigArn campo. Se non è presente, nel profilo della missione non è abilitata la telemetria.

Problema relativo alle autorizzazioni dei ruoli IAM

Consulta i passaggi per la risoluzione dei problemi relativi alle autorizzazioni IAM in. Errori di autorizzazione IAM

Lo stream di 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

L'invio 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
Contatto programmato su una stazione terrestre digitale gemellata

Le digital twin ground station non supportano la trasmissione della telemetria. I contatti pianificati su antenne digitali gemelle non producono dati di telemetria. Verifica che la stazione di terra utilizzata per il contatto non sia una gemella digitale controllando il nome della stazione di terra. Le stazioni terrestri Digital Twin hanno il prefisso «Digital Twin» nel nome. Per ulteriori informazioni, consulta Usa il AWS Ground Station funzionalità digital twin.

Dati di telemetria intermittenti

Sintomi

I dati di telemetria vengono forniti in modo incoerente con lacune o record mancanti.

Possibili cause

Soluzioni

  • Monitora le metriche dello streaming di Kinesis Data Streams CloudWatch per rilevare eventuali limitazioni o errori.

  • Assicurati che il tuo stream utilizzi la modalità di capacità su richiesta o disponga di una capacità predisposta sufficiente.

  • Usa 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 la decodifica Base64: i dati nello stream di Kinesis Data Streams sono. Base64-encoded Assicurati di decodificare i dati prima di analizzarli come JSON. Per ulteriori informazioni, consulta Lettura dei dati dal flusso Kinesis Data Streams.

  • 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 correttamente i record vuoti o non validi.

  • Implementa l'analisi in base alla versione: analizza prima i telemetryVersion campi telemetryTypeAndVersiontelemetryType, e per determinare lo schema appropriato per ogni record.

Tipi o versioni di telemetria sconosciuti

Sintomi

L'applicazione rileva tipi o versioni di telemetria che non riconosce.

Soluzione

Questo è un comportamento previsto poiché nel tempo potrebbero essere introdotti nuovi tipi di telemetria e versioni di schemi. L'applicazione deve:

  • Registra tipi e versioni sconosciuti per il monitoraggio.

  • Continua a elaborare tipi e versioni noti.

  • Implementa una gestione elegante degli schemi sconosciuti.

Per ulteriori informazioni sul controllo delle versioni dello schema, vedere. Versionamento ed evoluzione dello schema

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:

  • ID di contatto che presentano problemi

  • ID del profilo di missione utilizzato

  • TelemetrySinkConfig ARN

  • Kinesis Data Streams trasmette ARN

  • Ruolo IAM (ARN) e politiche allegate

  • Messaggi di errore provenienti dai CloudWatch log o dall'applicazione

  • Timestamp in cui si sono verificati i problemi

  • Misure di risoluzione dei problemi già intraprese

Per AWS Ground Station assistenza generale, consulta la Guida per l'AWS Ground Station utente.