View a markdown version of this page

Fehlerbehebung bei Telemetrie - AWS Ground Station
Häufig auftretende Probleme bei der EinrichtungProbleme bei der TelemetrieübertragungProbleme mit dem DatenformatHilfe erhalten

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Fehlerbehebung bei Telemetrie

Verwenden Sie die folgenden Informationen, um häufig auftretende Probleme mit Telemetrie zu beheben.

Häufig auftretende Probleme bei der Einrichtung

IAM-Berechtigungsfehler

Symptome

Wenn Sie aufrufenCreateConfig, um eine zu erstellen TelemetrySinkConfig, erhalten Sie eine Fehlermeldung: 

Unable to write to Kinesis Data Streams stream. Ensure that Ground Station has 
kinesis:PutRecord permissions for the given stream

Ursachen

  • Die in der angegebene IAM-Rolle TelemetrySinkConfig verfügt nicht über die erforderlichen Berechtigungen, um in den Kinesis Data Streams Streams-Stream zu schreiben.

  • Die Vertrauensrichtlinie für die IAM-Rolle erlaubt es nicht, die Rolle AWS Ground Station zu übernehmen.

  • Der Kinesis Data Streams Streams-Stream-ARN in der TelemetrySinkConfig ist falsch oder der Stream ist nicht vorhanden.

Lösungen

  1. Stellen Sie sicher, dass die IAM-Rolle existiert und über die richtigen Berechtigungen verfügt. Überprüfen Sie Schritt 2: Erstellen Sie ein TelemetrySinkConfig und stellen Sie sicher, dass alle Schritte befolgt wurden.

  2. Prüfen Sie, ob das Ihre IAM-Rolle übernehmen AWS Ground Station kann: 

    aws iam get-role --role-name GroundStationTelemetryRole

    Vergewissern Sie sich, dass die Vertrauensrichtlinie einen vertrauenswürdigen Dienstprinzipal beinhaltetgroundstation.amazonaws.com.

  3. Stellen Sie sicher, dass die IAM-Rolle über die erforderlichen Kinesis-Berechtigungen verfügt: 

    aws iam list-attached-role-policies --role-name GroundStationTelemetryRole

    Stellen Sie sicher, dass die Richtliniekinesis:DescribeStream,kinesis:PutRecord, und kinesis:PutRecords Berechtigungen für Ihren Stream beinhaltet.

  4. Stellen Sie sicher, dass der Kinesis Data Streams Streams-Stream vorhanden ist und der ARN korrekt ist: 

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

  5. Wenn Sie eine vom Kunden verwaltete Verschlüsselung verwenden, stellen Sie sicher, dass die IAM-Rolle über die kms:GenerateDataKey Berechtigung für Ihren Schlüssel verfügt. AWS KMS

PassRole Berechtigungsfehler

Symptome

Wenn Sie anrufenCreateConfig, erhalten Sie die Fehlermeldung, dass Sie nicht berechtigt sind, die IAM-Rolle weiterzugeben.

Lösung

Stellen Sie sicher, dass Ihr IAM-Benutzer oder Ihre IAM-Rolle über die iam:PassRole Berechtigung für die Telemetrie-IAM-Rolle verfügt. Fügen Sie Ihrem Benutzer oder Ihrer Rolle die folgende Richtlinie hinzu: 

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

Probleme mit der Kinesis Data Streams Streams-Stream-Konfiguration

Symptome

Die Telemetrieübertragung schlägt fehl oder ist unterbrochen.

Ursachen

  • Der Kinesis Data Streams Streams-Stream hat nicht genügend Kapazität für den Telemetriedurchsatz.

  • Der Stream wird von anderen Anwendungen verwendet, was zu einer Schreibdrosselung führt.

Lösungen

  1. Überprüfen Sie den Stream-Status: 

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

  2. Überwachen Sie mithilfe CloudWatch von Metriken die Schreibdrosselung: 

    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. Wenn eine Drosselung erkannt wird, sollten Sie Folgendes berücksichtigen:

    • Umschalten in den On-Demand-Kapazitätsmodus für die automatische Skalierung.

    • Verwendung eines dedizierten Streams für die AWS Ground Station Telemetrie.

    • Wenn Sie den Bereitstellungsmodus verwenden, erhöhen Sie die Anzahl der Shards.

Probleme bei der Telemetrieübertragung

Es werden keine Telemetriedaten angezeigt

Symptome

Nachdem Sie einen Kontakt mit einem telemetriefähigen Missionsprofil geplant haben, werden keine Telemetriedaten in Ihrem Kinesis Data Streams Streams-Stream angezeigt.

Mögliche Ursachen und Lösungen

Für das Missionsprofil ist Telemetrie nicht aktiviert

Stellen Sie sicher, dass das für den Kontakt verwendete Missionsprofil Folgendes enthält: telemetrySinkConfigArn 

aws groundstation get-mission-profile \
    --mission-profile-id 12345678-1234-1234-1234-123456789012 \
    --region us-east-2

Überprüfen Sie die Ausgabe für das telemetrySinkConfigArn Feld. Wenn es nicht vorhanden ist, ist Telemetrie im Missionsprofil nicht aktiviert.

Problem mit den IAM-Rollenberechtigungen

Lesen Sie die Schritte zur Fehlerbehebung bei IAM-Berechtigungen unter. IAM-Berechtigungsfehler

Der Kinesis Data Streams Streams-Stream ist nicht vorhanden oder befindet sich in der falschen Region

Stellen Sie sicher, dass der Stream in der richtigen Region vorhanden ist: 

aws kinesis describe-stream \
    --stream-name your-stream-name \
    --region us-east-2
Der Kontakt hat noch nicht begonnen

Die Telemetrieübertragung beginnt mit der Startzeit des Kontakts. Überprüfen Sie, ob der Kontakt gestartet wurde, indem Sie den Kontaktstatus überprüfen: 

aws groundstation describe-contact \
    --contact-id 12345678-1234-1234-1234-123456789012 \
    --region us-east-2

Intermittierende Telemetriedaten

Symptome

Telemetriedaten werden uneinheitlich mit Lücken oder fehlenden Datensätzen geliefert.

Mögliche Ursachen

Lösungen

  • Überwachen Sie die Stream-Metriken von Kinesis Data Streams auf CloudWatch Drosselung oder Fehler.

  • Stellen Sie sicher, dass Ihr Stream den On-Demand-Kapazitätsmodus verwendet oder über ausreichend bereitgestellte Kapazität verfügt.

  • Verwenden Sie einen dedizierten Stream für die AWS Ground Station Telemetrie, um Konflikte mit anderen Anwendungen zu vermeiden.

Probleme mit dem Datenformat

Fehler bei der JSON-Analyse

Symptome

In Ihrer Anwendung treten Fehler auf, wenn Telemetriedatensätze als JSON analysiert werden.

Lösungen

  • Überprüfen Sie die Base64-Dekodierung — Daten im Kinesis Data Streams Streams-Stream sind Base64-codiert. Stellen Sie sicher, dass Sie die Daten dekodieren, bevor Sie sie als JSON analysieren. Weitere Informationen finden Sie unter Daten aus dem Kinesis Data Streams Streams-Stream lesen.

  • Auf leere Datensätze prüfen — beim Erstellen eines AWS Ground Station werden möglicherweise leere Validierungsdatensätze gesendet. TelemetrySinkConfig Ihre Anwendung sollte leere oder falsch formatierte Datensätze ordnungsgemäß behandeln.

  • Implementieren Sie versionsbewusstes Parsing — Analysieren Sie zuerst die telemetryVersion Felder, und telemetryTypeAndVersiontelemetryType, um das passende Schema für jeden Datensatz zu ermitteln.

Unbekannte Telemetrietypen oder Versionen

Symptome

Ihre Anwendung stößt auf Telemetrietypen oder Versionen, die sie nicht erkennt.

Lösung

Dieses Verhalten ist zu erwarten, da im Laufe der Zeit möglicherweise neue Telemetrietypen und Schemaversionen eingeführt werden. Ihre Bewerbung sollte:

  • Protokollieren Sie unbekannte Typen und Versionen zur Überwachung.

  • Setzen Sie die Verarbeitung bekannter Typen und Versionen fort.

  • Implementieren Sie eine elegante Behandlung für unbekannte Schemas.

Weitere Hinweise zur Schemaversionierung finden Sie unter. Versionierung und Weiterentwicklung von Schemas

Hilfe erhalten

Wenn Sie nach dem Ausführen der Schritte zur Fehlerbehebung weiterhin Probleme haben, wenden Sie sich an den AWS Support.

Informationen, die Sie bereitstellen müssen

Wenn Sie sich an den Support wenden, geben Sie die folgenden Informationen an:

  • Kontakt, bei dem IDs Probleme aufgetreten sind

  • Verwendete Missionsprofil-ID

  • TelemetrySinkConfig ARN

  • Kinesis Data Streams Streams-Stream-ARN

  • ARN der IAM-Rolle und angehängte Richtlinien

  • Fehlermeldungen aus CloudWatch Logs oder Ihrer Anwendung

  • Zeitstempel, wann Probleme aufgetreten sind

  • Schritte zur Fehlerbehebung wurden bereits unternommen

Allgemeine AWS Ground Station Unterstützung finden Sie im AWS Ground Station Benutzerhandbuch.