View a markdown version of this page

Problembehandlung bei Telemetrie - AWS Ground Station
Häufige 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.

Problembehandlung bei Telemetrie

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

Häufige 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-Stream zu schreiben.

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

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

Lösungen

  1. Stellen Sie sicher, dass die IAM-Rolle vorhanden ist und über die richtigen Berechtigungen verfügt. Überprüfen Sie, Schritt 2: Erstellen Sie eine 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 die Angabe groundstation.amazonaws.com „Als vertrauenswürdiger Dienstprinzipal“ enthält.

  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 kinesis:DescribeStreamkinesis:PutRecord, dass die Richtlinie die kinesis:PutRecords Berechtigungen für Ihren Stream enthält.

  4. Stellen Sie sicher, dass der Kinesis Data Streams-Stream existiert 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 die kms:GenerateDataKey Berechtigung für Ihren Schlüssel hat. AWS KMS

PassRole Fehler bei der Genehmigung

Symptome

Beim Anruf erhalten Sie eine FehlermeldungCreateConfig, dass Sie nicht berechtigt sind, die IAM-Rolle zu übergeben.

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::123456789012:role/your-stream-name"
    }
  ]
}

Probleme mit der Kinesis Data Streams-Stream-Konfiguration

Symptome

Die Telemetrieübertragung schlägt fehl oder erfolgt nur sporadisch.

Ursachen

  • Der Kinesis Data Streams-Stream hat keine ausreichende Kapazität für den Telemetriedurchsatz.

  • Der Stream wird von anderen Anwendungen verwendet, was zu einer Drosselung der Schreibvorgänge führt.

Lösungen

  1. Überprüfe den Stream-Status: 

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

  2. Überwachen Sie anhand CloudWatch von Metriken, ob das Schreiben gedrosselt ist: 

    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 in Ihrem Kinesis Data Streams-Stream keine Telemetriedaten angezeigt.

Mögliche Ursachen und Lösungen

Für das Missionsprofil ist die Telemetrie nicht aktiviert

Vergewissern Sie sich, 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 sie nicht vorhanden ist, ist die Telemetrie im Missionsprofil nicht aktiviert.

Problem mit den Berechtigungen für IAM-Rollen

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

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

Stellen Sie sicher, dass der Stream in der richtigen Region existiert: 

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

Die Telemetriezustellung beginnt bei Kontaktbeginn. Stellen Sie sicher, dass der Kontakt begonnen hat, indem Sie den Kontaktstatus überprüfen: 

aws groundstation describe-contact \
    --contact-id 12345678-1234-1234-1234-123456789012 \
    --region us-east-2
Der Kontakt ist auf einer digitalen Zwillingsbodenstation geplant

Bodenstationen mit digitalen Zwillingen unterstützen keine Telemetrieübertragung. Kontakte, die auf digitalen Doppelantennen geplant sind, erzeugen keine Telemetriedaten. Stellen Sie sicher, dass es sich bei der für Ihren Kontakt verwendeten Bodenstation nicht um einen digitalen Zwilling handelt, indem Sie den Namen der Bodenstation überprüfen. Digitale Zwillingsbodenstationen haben das Präfix „Digitaler Zwilling“ in ihrem Namen. Weitere Informationen finden Sie unter Benutze die AWS Ground Station Funktion für digitale Zwillinge.

Intermittierende Telemetriedaten

Symptome

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

Mögliche Ursachen

Lösungen

  • Überwachen Sie die in Kinesis Data Streams eingespielten Metriken CloudWatch auf Drosselungen 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 beim JSON-Parsen

Symptome

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

Lösungen

  • Überprüfen Sie die Base64-Dekodierung — Die Daten im Kinesis Data Streams-Stream sind. Base64-encoded 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-Stream lesen.

  • Suchen Sie nach leeren Datensätzen - beim Erstellen eines AWS Ground Station werden möglicherweise leere Validierungsdatensätze gesendet. TelemetrySinkConfig Ihre Anwendung sollte mit leeren oder falsch formatierten Datensätzen ordnungsgemäß umgehen.

  • Implementieren Sie eine versionssensitive Analyse — Analysieren Sie zuerst die telemetryVersion FeldertelemetryTypeAndVersion, undtelemetryType, 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

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

  • Unbekannte Typen und Versionen zur Überwachung protokollieren.

  • Setzen Sie die Verarbeitung bekannter Typen und Versionen fort.

  • Implementieren Sie einen reibungslosen Umgang mit unbekannten Schemas.

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

Hilfe erhalten

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

Zur Verfügung zu stellende Informationen

Wenn Sie den Support kontaktieren, geben Sie bitte die folgenden Informationen an:

  • Bei Kontakt-IDs treten Probleme auf

  • Verwendete Missionsprofil-ID

  • TelemetrySinkConfig ARN

  • Kinesis Data Streams streamen ARN

  • ARN der IAM-Rolle und zugehörige Richtlinien

  • Fehlermeldungen aus CloudWatch Logs oder Ihrer Anwendung

  • Zeitstempel, wann Probleme aufgetreten sind

  • Bereits unternommene Schritte zur Fehlerbehebung

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