View a markdown version of this page

Risolvere i problemi di 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à.

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 e assicurati che tutti i passaggi siano stati seguiti.

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

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

  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 si chiamaCreateConfig, 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: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::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

  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 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 inErrori di autorizzazione IAM.

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

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.

  • 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 telemetryTypeAndVersiontelemetryType, 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

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.