

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.

# Verstehen Sie die Überwachung mit AWS Ground Station
<a name="monitoring"></a>

Überwachung ist wichtig, um die Zuverlässigkeit, Verfügbarkeit und Performance von AWS Ground Station aufrechtzuerhalten. AWS bietet die folgenden Überwachungstools, um zu beobachten AWS Ground Station, zu melden, wenn etwas nicht stimmt, und gegebenenfalls automatische Maßnahmen zu ergreifen.
+  *Amazon EventBridge Events* bietet einen Stream von Systemereignissen, die Änderungen an AWS Ressourcen beschreiben, nahezu in Echtzeit. EventBridge Events ermöglicht automatisiertes ereignisgesteuertes Rechnen, da Sie Regeln schreiben können, die auf bestimmte Ereignisse achten und automatisierte Aktionen in anderen AWS Diensten auslösen können, wenn diese Ereignisse eintreten. Weitere Informationen zu EventBridge Veranstaltungen finden Sie im [Amazon EventBridge Events-Benutzerhandbuch](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html). 
+  *AWS CloudTrail*erfasst API-Aufrufe und zugehörige Ereignisse, die von oder im Namen Ihres AWS Kontos getätigt wurden, und übermittelt die Protokolldateien an einen von Ihnen angegebenen Amazon S3 S3-Bucket. Sie können feststellen, welche Benutzer und Konten angerufen wurden AWS, von welcher Quell-IP-Adresse aus die Anrufe getätigt wurden und wann die Aufrufe erfolgten. Weitere Informationen zu AWS CloudTrail finden Sie im [AWS CloudTrail Benutzerhandbuch](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/). 
+  *Amazon CloudWatch Metrics* erfasst bei der Nutzung Metriken für Ihre geplanten Kontakte AWS Ground Station. CloudWatch Mit Metrics können Sie Daten auf der Grundlage Ihres Kanals, Ihrer Polarisation und Ihrer Satelliten-ID analysieren, um die Signalstärke und Fehler bei Ihren Kontakten zu ermitteln. Weitere Informationen finden Sie unter [Verwenden von CloudWatch Amazon-Metriken](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/working_with_metrics.html). 
+  *[AWS Benutzerbenachrichtigungen](https://docs.aws.amazon.com/notifications/latest/userguide/what-is.html)* kann verwendet werden, um Lieferkanäle einzurichten, um über AWS Ground Station Ereignisse informiert zu werden. Sie erhalten eine Benachrichtigung, wenn ein Ereignis einer von Ihnen angegebenen Regel entspricht. Sie können Benachrichtigungen für Ereignisse über mehrere Kanäle erhalten, darunter E-Mail, [Amazon Q Developer in Chat-Anwendungen](https://docs.aws.amazon.com/chatbot/latest/adminguide/what-is.html), Chat-Benachrichtigungen oder [AWS Console Mobile Application](https://docs.aws.amazon.com/consolemobileapp/latest/userguide/what-is-consolemobileapp.html)Push-Benachrichtigungen. Sie können Benachrichtigungen auch im [Benachrichtigungscenter](https://console.aws.amazon.com/notifications/) der AWS Konsole sehen. Benutzerbenachrichtigungen unterstützt die Aggregation, wodurch die Anzahl der Benachrichtigungen, die Sie bei bestimmten Ereignissen erhalten, reduziert werden kann. 

Verwenden Sie die folgenden Themen zur Überwachung von AWS Ground Station. 

**Topics**
+ [Automatisieren Sie AWS Ground Station mit Ereignissen](monitoring.automating-events.md)
+ [AWS Ground Station API-Aufrufe protokollieren mit AWS CloudTrail](monitoring.cloudtrail.md)
+ [Metriken mit Amazon anzeigen CloudWatch](monitoring.metrics.md)

# Automatisieren Sie AWS Ground Station mit Ereignissen
<a name="monitoring.automating-events"></a>

**Anmerkung**  
 In diesem Dokument wird durchgängig der Begriff „Ereignis“ verwendet. CloudWatch Bei Ereignissen und EventBridge handelt es sich um denselben zugrunde liegenden Dienst und dieselbe API. Regeln für den Abgleich eingehender Ereignisse und deren Weiterleitung an Ziele zur Verarbeitung können mit beiden Diensten erstellt werden. 

 Ereignisse ermöglichen es Ihnen, Ihre AWS Dienste zu automatisieren und automatisch auf Systemereignisse wie Probleme mit der Anwendungsverfügbarkeit oder Ressourcenänderungen zu reagieren. Ereignisse aus AWS Diensten werden nahezu in Echtzeit übermittelt. Sie können einfache Regeln schreiben, um anzugeben, welche Ereignisse für Sie interessant sind und welche automatisierten Aktionen durchgeführt werden sollen, wenn sich für ein Ereignis eine Übereinstimmung mit einer Regel ergibt. Zu den Aktionen, die automatisch ausgelöst werden können, gehören die folgenden: 
+ Eine AWS Lambda Funktion aufrufen
+ Aufrufen eines Amazon EC2 Run Command
+ Weiterleiten des Ereignisses an Amazon Kinesis Data Streams
+ Aktivierung einer AWS Step Functions Zustandsmaschine
+ Benachrichtigen eines Amazon SNS-Themas oder einer Amazon SQS-Warteschlange

Einige Beispiele für die Verwendung von Ereignissen mit AWS Ground Station sind:
+ Aufrufen einer Lambda-Funktion, um das Starten und Stoppen von Amazon EC2 EC2-Instances basierend auf dem Ereignisstatus zu automatisieren. 
+ Veröffentlichung in einem Amazon SNS SNS-Thema, wenn sich der Status eines Kontakts ändert. Diese Themen können so eingerichtet werden, dass E-Mail-Benachrichtigungen am Anfang oder Ende von Kontakten gesendet werden. 

 Weitere Informationen finden Sie im [Amazon EventBridge Events-Benutzerhandbuch](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html). 

## AWS Ground Station Arten von Ereignissen
<a name="gs-csc-event-types"></a>

**Anmerkung**  
 Alle von AWS Ground Station generierten Ereignisse haben „aws.groundstation“ als Wert für „source“. 

AWS Ground Station gibt Ereignisse aus, die sich auf Statusänderungen beziehen, um Sie bei der Anpassung Ihrer Automatisierung zu unterstützen. AWS Ground Station Unterstützt derzeit Kontaktstatusänderungsereignisse, Datenfluss-Endpunktgruppen-Änderungsereignisse und kurzlebige Statusänderungsereignisse. Die folgenden Abschnitte enthalten detaillierte Informationen zu den einzelnen Typen. 

## Event-Zeitplan kontaktieren
<a name="monitoring.automating-events.contact-timeline"></a>

AWS Ground Station sendet Ereignisse aus, wenn Ihr Kontakt den Status ändert. Weitere Informationen darüber, was diese Statusänderungen sind und was die Staaten selbst bedeuten, finden Sie unter[Verstehen Sie den Lebenszyklus von Kontakten](contacts.lifecycle.md). Alle Datenfluss-Endpunktgruppen, die in Ihrem Kontakt verwendet werden, verfügen über einen unabhängigen Satz von Ereignissen, die ebenfalls ausgelöst werden. Im gleichen Zeitraum senden wir auch Ereignisse für Ihre Datenfluss-Endpunktgruppe aus. Die genaue Uhrzeit der Pre-Pass- und Post-Pass-Ereignisse können Sie bei der Einrichtung Ihres Missionsprofils und der Dataflow-Endpunktgruppe konfigurieren. 

 Das folgende Diagramm zeigt die Status und Ereignisse, die für einen nominellen Kontakt und die zugehörige Datenfluss-Endpunktgruppe ausgegeben wurden. 

 ![\[Diagram showing statuses and events for a nominal contact and its associated dataflow endpoint group.\]](http://docs.aws.amazon.com/de_de/ground-station/latest/ug/images/monitoring.automating-events.contact-timeline.png) 

 **Änderung des Ground Station-Kontaktzustands** 

 Wenn Sie eine bestimmte Aktion ausführen möchten, wenn sich der Status eines bevorstehenden Kontakts ändert, können Sie eine Regel einrichten, um diese Aktion zu automatisieren. Dies ist hilfreich, wenn Sie Benachrichtigungen über die Zustandsänderungen Ihres Kontakts erhalten möchten. Wenn Sie ändern möchten, wann Sie diese Ereignisse erhalten, können Sie die Einstellungen [ contactPrePassDurationSeconds](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_UpdateMissionProfile.html#groundstation-UpdateMissionProfile-request-contactPrePassDurationSeconds)und in Ihrem Missionsprofil ändern [ contactPostPassDurationSeconds](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_UpdateMissionProfile.html#groundstation-UpdateMissionProfile-request-contactPostPassDurationSeconds). Die Ereignisse werden in die Region gesendet, in der der Kontakt geplant wurde. 

 Ein Beispiel für ein Ereignis finden Sie unten. 

```
{
    "version": "0",
    "id": "01234567-0123-0123",
    "account": "123456789012",
    "time": "2019-05-30T17:40:30Z",
    "region": "us-west-2",
    "source": "aws.groundstation",
    "resources": [
        "arn:aws:groundstation:us-west-2:123456789012:contact/11111111-1111-1111-1111-111111111111"
    ],
    "detailType": "Ground Station Contact State Change",
    "detail": {
        "contactId": "11111111-1111-1111-1111-111111111111",
        "groundstationId": "Ground Station 1",
        "missionProfileArn": "arn:aws:groundstation:us-west-2:123456789012:mission-profile/11111111-1111-1111-1111-111111111111",
        "satelliteArn": "arn:aws:groundstation::123456789012:satellite/11111111-1111-1111-1111-111111111111",
        "contactStatus": "PASS"
    }
}
```

 Die möglichen Werte für `contactStatus` sind in definiert[AWS Ground Station Status der Kontakte](contacts.lifecycle.md#contact-statuses). 

 **Zustandsänderung der Ground Station-Datenfluss-Endpunktgruppen** 

 Wenn Sie eine Aktion ausführen möchten, sobald Ihre Datenflussendpunktgruppe zum Empfang von Daten verwendet wird, können Sie eine -Regel einrichten, um diese Aktion zu automatisieren. Auf diese Weise können Sie verschiedene Aktionen als Reaktion auf die Zustandsänderungen des Datenflussendpunktgruppen-Status ausführen. Wenn Sie ändern möchten, wann Sie diese Ereignisse empfangen, verwenden Sie eine Datenfluss-Endpunktgruppe mit einem anderen [contactPrePassDurationSeconds](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_CreateDataflowEndpointGroup.html#groundstation-CreateDataflowEndpointGroup-request-contactPrePassDurationSeconds)und. [contactPostPassDurationSeconds](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_CreateDataflowEndpointGroup.html#groundstation-CreateDataflowEndpointGroup-request-contactPostPassDurationSeconds) Dieses Ereignis wird in die Region der Datenfluss-Endpunktgruppe gesendet. 

 Nachstehend finden Sie ein Beispiel. 

```
{
    "version": "0",
    "id": "01234567-0123-0123",
    "account": "123456789012",
    "time": "2019-05-30T17:40:30Z",
    "region": "us-west-2",
    "source": "aws.groundstation",
    "resources": [
        "arn:aws:groundstation:us-west-2:123456789012:dataflow-endpoint-group/bad957a8-1d60-4c45-a92a-39febd98921d",
        "arn:aws:groundstation:us-west-2:123456789012:contact/98ddd10f-f2bc-479c-bf7d-55644737fb09",
        "arn:aws:groundstation:us-west-2:123456789012:mission-profile/c513c84c-eb40-4473-88a2-d482648c9234"
    ],
    "detailType": "Ground Station Dataflow Endpoint Group State Change",
    "detail": {
        "dataflowEndpointGroupId": "bad957a8-1d60-4c45-a92a-39febd98921d",
        "groundstationId": "Ground Station 1",
        "contactId": "98ddd10f-f2bc-479c-bf7d-55644737fb09",
        "dataflowEndpointGroupArn": "arn:aws:groundstation:us-west-2:680367718957:dataflow-endpoint-group/bad957a8-1d60-4c45-a92a-39febd98921d",
        "missionProfileArn": "arn:aws:groundstation:us-west-2:123456789012:mission-profile/c513c84c-eb40-4473-88a2-d482648c9234",
        "dataflowEndpointGroupState": "PREPASS"
    }
}
```

 Mögliche Zustände für `dataflowEndpointGroupState` umfassen `PREPASS`, `PASS`, `POSTPASS` und `COMPLETED`. 

## Ephemeriden-Ereignisse
<a name="monitoring.automating-events.ephemeris"></a>

 **Änderung des Zustands der Ground Station Ephemeris** 

 Wenn Sie eine Aktion ausführen möchten, wenn sich der Status einer Ephemeride ändert, können Sie eine Regel einrichten, um diese Aktion zu automatisieren. Auf diese Weise können Sie verschiedene Aktionen ausführen, wenn sich der Status einer Ephemeride ändert. Sie können beispielsweise eine Aktion ausführen, wenn die Validierung einer Ephemeride abgeschlossen ist, und das ist jetzt der Fall. `ENABLED` Die Benachrichtigung über dieses Ereignis wird an die Region gesendet, in die die Ephemeride hochgeladen wurde. 

 Nachstehend finden Sie ein Beispiel. 

```
{
    "id": "7bf73129-1428-4cd3-a780-95db273d1602",
    "detail-type": "Ground Station Ephemeris State Change",
    "source": "aws.groundstation",
    "account": "123456789012",
    "time": "2019-12-03T21:29:54Z",
    "region": "us-west-2",
    "resources": [
        "arn:aws:groundstation::123456789012:satellite/10313191-c9d9-4ecb-a5f2-bc55cab050ec",
        "arn:aws:groundstation::123456789012:ephemeris/111111-cccc-bbbb-a555-bcccca005000"
    ],
    "detail": {
        "ephemerisStatus": "ENABLED",
        "ephemerisId": "111111-cccc-bbbb-a555-bcccca005000",
        "satelliteId": "10313191-c9d9-4ecb-a5f2-bc55cab050ec"
    }
}
```

 Mögliche Zustände dafür `ephemerisStatus` sind`ENABLED`,,,`VALIDATING`,`INVALID`, `ERROR` `DISABLED` `EXPIRED` 

# AWS Ground Station API-Aufrufe protokollieren mit AWS CloudTrail
<a name="monitoring.cloudtrail"></a>

AWS Ground Station ist in einen Dienst integriert AWS CloudTrail, der eine Aufzeichnung der Aktionen bereitstellt, die von einem Benutzer, einer Rolle oder einem AWS Dienst in ausgeführt wurden AWS Ground Station. CloudTrail erfasst alle API-Aufrufe AWS Ground Station als Ereignisse. Zu den erfassten Aufrufen gehören Aufrufe von der AWS Ground Station Konsole und Codeaufrufen für die AWS Ground Station API-Operationen. Wenn Sie einen Trail erstellen, können Sie die kontinuierliche Bereitstellung von CloudTrail Ereignissen an einen Amazon S3 S3-Bucket aktivieren, einschließlich Ereignissen für AWS Ground Station. Wenn Sie keinen Trail konfigurieren, können Sie die neuesten Ereignisse trotzdem in der CloudTrail Konsole im **Ereignisverlauf** anzeigen. Anhand der von gesammelten Informationen können Sie die Anfrage ermitteln CloudTrail, an die die Anfrage gestellt wurde AWS Ground Station, die IP-Adresse, von der aus die Anfrage gestellt wurde, wer die Anfrage gestellt hat, wann sie gestellt wurde, und weitere Details. 

Weitere Informationen CloudTrail dazu finden Sie im [AWS CloudTrail Benutzerhandbuch](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/).

## AWS Ground Station Informationen in CloudTrail
<a name="monitoring.cloudtrail.service-name-info-in-cloudtrail"></a>

CloudTrail ist in Ihrem AWS Konto aktiviert, wenn Sie das Konto erstellen. Wenn eine Aktivität in stattfindet AWS Ground Station, wird diese Aktivität zusammen mit anderen CloudTrail AWS Serviceereignissen im **Ereignisverlauf in einem Ereignis** aufgezeichnet. Sie können aktuelle Ereignisse in Ihrem AWS Konto ansehen, suchen und herunterladen. Weitere Informationen finden Sie unter [Ereignisse mit CloudTrail Ereignisverlauf anzeigen](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html). 

Für eine fortlaufende Aufzeichnung der Ereignisse in Ihrem AWS Konto, einschließlich der Ereignisse für AWS Ground Station, erstellen Sie einen Trail. Ein *Trail* ermöglicht CloudTrail die Übermittlung von Protokolldateien an einen Amazon S3 S3-Bucket. Wenn Sie einen Pfad in der Konsole anlegen, gilt dieser für alle AWS-Regionen. Der Trail protokolliert Ereignisse aus allen Regionen der AWS Partition und übermittelt die Protokolldateien an den von Ihnen angegebenen Amazon S3 S3-Bucket. Darüber hinaus können Sie andere AWS Dienste konfigurieren, um die in den CloudTrail Protokollen gesammelten Ereignisdaten weiter zu analysieren und darauf zu reagieren. Weitere Informationen finden Sie hier: 
+ [Übersicht zum Erstellen eines Trails](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html)
+ [CloudTrail Unterstützte Dienste und Integrationen](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-aws-service-specific-topics.html#cloudtrail-aws-service-specific-topics-integrations)
+ [Konfiguration von Amazon SNS SNS-Benachrichtigungen für CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/getting_notifications_top_level.html)
+ [Empfangen von CloudTrail Protokolldateien aus mehreren Regionen](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/receive-cloudtrail-log-files-from-multiple-regions.html) und [Empfangen von CloudTrail Protokolldateien von mehreren Konten](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-receive-logs-from-multiple-accounts.html)

Alle AWS Ground Station Aktionen werden von der [AWS Ground Station API-Referenz](Welcome.html) protokolliert CloudTrail und sind in dieser dokumentiert. Beispielsweise generieren Aufrufe von `CancelContact` und `ListConfigs` Aktionen Einträge in den CloudTrail Protokolldateien. `ReserveContact` 

Jeder Ereignis- oder Protokolleintrag enthält Informationen zu dem Benutzer, der die Anforderung generiert hat. Die Identitätsinformationen unterstützen Sie bei der Ermittlung der folgenden Punkte: 
+ Ob die Anfrage mit Root- oder AWS Identity and Access Management (IAM-) Benutzeranmeldedaten gestellt wurde.
+ Gibt an, ob die Anforderung mit temporären Sicherheitsanmeldeinformationen für eine Rolle oder einen Verbundbenutzer gesendet wurde.
+ Ob die Anfrage von einem anderen AWS Dienst gestellt wurde.

Weitere Informationen finden Sie unter [CloudTrail userIdentity-Element](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html).

## Grundlegendes zu AWS Ground Station Protokolldateieinträgen
<a name="monitoring.cloudtrail.understanding-service-name-entries"></a>

Ein Trail ist eine Konfiguration, die die Übertragung von Ereignissen als Protokolldateien an einen von Ihnen angegebenen Amazon S3 S3-Bucket ermöglicht. CloudTrail Protokolldateien enthalten einen oder mehrere Protokolleinträge. Ein Ereignis stellt eine einzelne Anforderung aus einer beliebigen Quelle dar und enthält Informationen über die angeforderte Aktion, Datum und Uhrzeit der Aktion, Anforderungsparameter usw. CloudTrail Protokolldateien sind kein geordneter Stack-Trace der öffentlichen API-Aufrufe, sodass sie nicht in einer bestimmten Reihenfolge angezeigt werden. 

Das folgende Beispiel zeigt einen CloudTrail Protokolleintrag, der die `ReserveContact` Aktion demonstriert. 

**Beispiel: ReserveContact**

```
 
{
    "eventVersion": "1.05",
    "userIdentity": {
        "type": "IAMUser",
        "principalId": "EX_PRINCIPAL_ID",
        "arn": "arn:aws:sts::123456789012:user/Alice",
        "accountId": "123456789012",
        "accessKeyId": "EXAMPLE_KEY_ID",
        "sessionContext": {
            "attributes": {
                "mfaAuthenticated": "false",
                "creationDate": "2019-05-15T21:11:59Z"
            },
            "sessionIssuer": {
                "type": "Role",
                "principalId": "EX_PRINCIPAL_ID",
                "arn": "arn:aws:iam::123456789012:role/Alice",
                "accountId": "123456789012",
                "userName": "Alice"
            }
        }
    },
    "eventTime": "2019-05-15T21:14:37Z",
    "eventSource": "groundstation.amazonaws.com",
    "eventName": "ReserveContact",
    "awsRegion": "us-east-2",
    "sourceIPAddress": "127.0.0.1",
    "userAgent": "Mozilla/5.0 Gecko/20100101 Firefox/123.0",
    "requestParameters": {
        "satelliteArn": "arn:aws:groundstation::123456789012:satellite/11111111-2222-3333-4444-555555555555",
        "groundStation": "Ohio 1",
        "startTime": 1558356107,
        "missionProfileArn": "arn:aws:groundstation:us-east-2:123456789012:mission-profile/11111111-2222-3333-4444-555555555555",
        "endTime": 1558356886
    },
    "responseElements": {
        "contactId": "11111111-2222-3333-4444-555555555555"
    },
    "requestID": "11111111-2222-3333-4444-555555555555",
    "eventID": "11111111-2222-3333-4444-555555555555",
    "readOnly": false,
    "eventType": "AwsApiCall",
    "recipientAccountId": "11111111-2222-3333-4444-555555555555"
}
```

# Metriken mit Amazon anzeigen CloudWatch
<a name="monitoring.metrics"></a>

Erfasst während eines Kontakts AWS Ground Station automatisch Daten und sendet sie CloudWatch zur Analyse an. Ihre Daten können in der CloudWatch Amazon-Konsole eingesehen werden. Weitere Informationen zum Zugriff und zu CloudWatch Metriken finden Sie unter [Amazon CloudWatch Metrics verwenden](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/working_with_metrics.html). 

Die AWS Ground Station Telemetriefunktion kann auch verwendet werden, um bei Kontakten Metriken nahezu in Echtzeit zu erhalten. CloudWatch Metriken sind nicht nahezu in Echtzeit verfügbar und es kann zu Verzögerungen bei der Lieferung kommen. CloudWatch aggregiert außerdem Metriken über einen Zeitraum von einer Sekunde, wodurch die Datengranularität möglicherweise reduziert wird. Die Telemetriefunktion stellt die einzelnen Metriken bereit und übermittelt sie nahezu in Echtzeit direkt an Ihr Konto. AWS Weitere Informationen finden Sie unter [Arbeiten Sie mit Telemetrie](telemetry.md).

**Wichtig**  
 AWS Ground Station sendet CloudWatch Messwerte an die AWS Region, die mit dem Standort der Bodenstation des Kontakts verknüpft ist, und nicht an die AWS Region, von der aus der Kontakt geplant wurde. Um die Messwerte für einen Kontakt anzuzeigen, müssen Sie CloudWatch in der Region der Bodenstation darauf zugreifen. Informationen darüber, welche AWS Region mit den einzelnen Standorten der Bodenstation verknüpft ist, finden Sie unter[Finden Sie die AWS Region für einen Standort für eine Bodenstation](aws-ground-station-antenna-locations.md#aws-ground-station-antenna-locations.antenna-regions). Um Telemetriedaten in der Region zu empfangen, von der aus Sie Ihre Kontakte planen, können Sie die AWS Ground Station Telemetriefunktion verwenden. Weitere Details finden Sie unter [Arbeiten Sie mit Telemetrie](telemetry.md). 

## AWS Ground Station Metriken und Dimensionen
<a name="monitoring.metrics.metrics-and-dimensions"></a>

### Welche Metriken sind verfügbar?
<a name="monitoring.metrics.metrics-and-dimensions.available-metrics"></a>

 Die folgenden Metriken sind bei erhältlich AWS Ground Station. 

**Anmerkung**  
 Die spezifischen ausgegebenen Metriken hängen von den verwendeten AWS Ground Station Funktionen ab. Abhängig von Ihrer Konfiguration kann nur eine Teilmenge der folgenden Metriken ausgegeben werden. 


| Metrik | Metrikdimensionen | Description | 
| --- | --- | --- | 
|   `AzimuthAngle`   | SatelliteId |  Der Azimutwinkel der Antenne. Der wahre Norden ist 0 Grad und der Osten ist 90 Grad.  Einheiten: Grad  | 
|   `BitErrorRate`   | Kanal, Polarisation, SatelliteId |  Die Fehlerrate bei Bits bei einer bestimmten Anzahl von Bitübertragungen. Bitfehler werden durch Rauschen, Verzerrungen oder Störungen verursacht  Einheiten: Bitfehler pro Zeiteinheit  | 
|   `BlockErrorRate`   | Kanal, Polarisation, SatelliteId |  Die Fehlerquote von Blöcken in einer bestimmten Anzahl empfangener Blöcke. Blockfehler werden durch Störungen verursacht.  Einheiten: Fehlerhafte Blöcke/Gesamtzahl der Blöcke  | 
|   `CarrierFrequencyRecovery_Cn0`   | Kategorie, Config, SatelliteId |  Verhältnis zwischen Träger und Rauschdichte pro Bandbreiteneinheit. Einheiten: Dezibel-Hertz (dB-Hz)  | 
|   `CarrierFrequencyRecovery_Locked`   | Kategorie, Config, SatelliteId |  Wird auf 1 gesetzt, wenn die Trägerfrequenz-Wiederherstellungsschleife des Demodulators gesperrt ist, und auf 0, wenn sie entsperrt ist.  Einheiten: ohne Einheit  | 
|   `CarrierFrequencyRecovery_OffsetFrequency_Hz`   | Kategorie, Config, SatelliteId |  Der Offset zwischen dem geschätzten Signalzentrum und der idealen Mittenfrequenz. Dies wird durch die Dopplerverschiebung und den Offset des Lokaloszillators zwischen Raumfahrzeug und Antennensystem verursacht.  Einheiten: Hertz (Hz)  | 
|   `ElevationAngle`   | SatelliteId |  Der Höhenwinkel der Antenne. Der Horizont ist 0 Grad und der Zenit ist 90 Grad.  Einheiten: Grad  | 
|   `Es/N0`   | Kanal, Polarisation, SatelliteId |  Das Verhältnis von Energie pro Symbol zur spektralen Leistungsdichte des Rauschens. Einheiten: Dezibel (dB)  | 
|   `ReceivedPower`   | Polarisierung, SatelliteId |  Die gemessene Signalstärke im Demodulator/Decoder. Einheiten: Dezibel relativ zu Milliwatt (dBm)  | 
|   `SymbolTimingRecovery_ErrorVectorMagnitude`   | Kategorie, Config, SatelliteId |  Die Größe des Fehlervektors zwischen empfangenen Symbolen und idealen Konstellationspunkten.  Einheiten: Prozent  | 
|   `SymbolTimingRecovery_Locked`   | Kategorie, Config, SatelliteId |  Auf 1 setzen, wenn die Zeitwiederherstellungsschleife des Demodulatorsymbols gesperrt ist, und auf 0, wenn sie entsperrt ist  Einheiten: ohne Einheit  | 
|   `SymbolTimingRecovery_OffsetSymbolRate`   | Kategorie, Config, SatelliteId |  Der Offset zwischen der geschätzten Symbolrate und der idealen Signalsymbolrate. Dies wird durch die Dopplerverschiebung und den Offset des Lokaloszillators zwischen Raumfahrzeug und Antennensystem verursacht.  Einheiten: Symbole/Sekunde  | 

### Wofür werden Dimensionen verwendet? AWS Ground Station
<a name="monitoring.metrics.metrics-and-dimensions.metric-dimensions"></a>

 Sie können AWS Ground Station Daten anhand der folgenden Dimensionen filtern. 


| Dimension | Description | 
| --- | --- | 
|   `Category`   |  Demodulation oder Decodierung.  | 
|   `Channel`   |  Die Kanäle für jeden Kontakt umfassen One, Two, I (In-Phase) und Q (Quadrature).  | 
|   `Config`   |  Ein Antennen-Downlink-Demod-Decoder-Konfigurations-ARN.  | 
|   `Polarization`   |  Die Polarisierung für jeden Kontakt umfasst LHCP (Left Hand Circular Polarized) oder RHCP (Right Hand Circular Polarized).   | 
|   `SatelliteId`   |  Die Satelliten-ID enthält den ARN des Satelliten für Ihre Kontakte.  | 

## Anzeigen von -Metriken
<a name="monitoring.metrics.viewing-metrics"></a>

 Wenn Sie grafische Metriken anzeigen, ist es wichtig zu beachten, dass das Aggregationsfenster bestimmt, wie Ihre Metriken angezeigt werden. Jede Metrik in einem Kontakt kann 3 Stunden lang als Daten pro Sekunde angezeigt werden, nachdem die Daten empfangen wurden. Nach Ablauf dieses Zeitraums von 3 Stunden werden Ihre Daten von CloudWatch Metrics als Daten pro Minute zusammengefasst. Wenn Sie Ihre Messwerte anhand einer Messung von Daten pro Sekunde anzeigen möchten, wird empfohlen, Ihre Daten innerhalb von 3 Stunden nach dem Empfang der Daten anzuzeigen oder sie außerhalb von Metrics beizubehalten. CloudWatch Weitere Informationen zur CloudWatch Aufbewahrung finden Sie unter [ CloudWatch Amazon-Konzepte — Aufbewahrung metrischer](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html#metrics-retention) Daten. 

 Darüber hinaus enthalten alle innerhalb der ersten 60 Sekunden erfassten Daten nicht genügend Informationen, um aussagekräftige Metriken zu erzeugen, und werden wahrscheinlich nicht angezeigt. Um aussagekräftige Metriken anzuzeigen, empfiehlt es sich, Ihre Daten nach 60 Sekunden anzuzeigen. 

 ![\[Graph showing pass metrics with dBm and error rate lines over time during 11 minutes of a contact.\]](http://docs.aws.amazon.com/de_de/ground-station/latest/ug/images/viewing-metrics.png) 

 Weitere Informationen zur grafischen Darstellung von AWS Ground Station Metriken finden Sie unter [Metriken grafisch darstellen. CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/graph_metrics.html) 

### So zeigen Sie Metriken mithilfe der -Konsole an
<a name="monitoring.metrics.viewing-metrics.metrics-using-console"></a>

1.  Ermitteln Sie die AWS Region, die mit dem Standort Ihrer Bodenstation verknüpft ist. AWS Ground Station sendet CloudWatch Messwerte in der Region aus, die mit dem Standort der Bodenstation Ihres Kontakts verknüpft ist. Eine Liste der Standorte der Bodenstationen und der zugehörigen AWS Regionen finden Sie unter[Finden Sie die AWS Region für einen Standort für eine Bodenstation](aws-ground-station-antenna-locations.md#aws-ground-station-antenna-locations.antenna-regions). 

1.  Öffnen Sie die [ CloudWatch -Konsole](https://console.aws.amazon.com/cloudwatch). 

1.  Wählen Sie im Navigationsbereich **Metriken** aus.

1.  Wählen Sie den **GroundStation**-Namespace.

    ![\[Interface showing metrics categorized by AWS services used, including a tile for AWS Ground Station, which will appear after metrics have been emitted from the service.\]](http://docs.aws.amazon.com/de_de/ground-station/latest/ug/images/GroundStation-namespace.png) 

1.  Wählen Sie die gewünschten metrischen Abmessungen aus (z. B. **Kanal, Polarisation, SatelliteId**).

    ![\[Metrics interface showing "All metrics" tab with metrics grouped by dimensions, "Channel, Polarization, SatelliteId" and "Polarization, SatelliteId."\]](http://docs.aws.amazon.com/de_de/ground-station/latest/ug/images/metric-dimensions.png) 

1.  Die Registerkarte **All metrics** zeigt alle Metriken für diese Dimension im Namespace an. Sie haben die folgenden Möglichkeiten:

   1.  Um die Tabelle sortieren, verwenden Sie die Spaltenüberschrift. 

   1.  Um eine Metrik grafisch darzustellen, aktivieren Sie das der Metrik zugeordnete Kontrollkästchen. Um alle Metriken auszuwählen, aktivieren Sie das Kontrollkästchen in der Überschriftenzeile der Tabelle. 

   1.  Um nach Ressource zu filtern, müssen Sie zunächst die Ressourcen-ID und dann die Option **Zu Suche hinzufügen** auswählen. 

   1.  Um nach Metrik zu filtern, müssen Sie den Metriknamen und anschließend **Add to search (Zur Suche hinzufügen)** auswählen. 

### Um Metriken anzuzeigen, verwenden Sie AWS CLI
<a name="monitoring.metrics.viewing-metrics.metrics-using-cli"></a>

 AWS Ground Station sendet CloudWatch Metriken in der Region aus, die dem Standort der Bodenstation Ihres Kontakts zugeordnet ist. Für die Liste der Standorte der Bodenstationen und deren zugehörige AWS Regionen,[Finden Sie die AWS Region für einen Standort für eine Bodenstation](aws-ground-station-antenna-locations.md#aws-ground-station-antenna-locations.antenna-regions). * ground-station-region-code*Ersetzen Sie es durch den AWS Regionalcode für den Standort Ihrer Bodenstation (z. B. `us-west-2` für Oregon 1, Hawaii 1 oder Alaska 1). Alle nachfolgenden AWS CLI Befehle in diesem Verfahren müssen dieselbe Region verwenden. 

1.  Stellen Sie sicher, dass AWS CLI das installiert ist. Informationen zur Installation AWS CLI finden Sie unter [Installation der AWS-CLI Version 2.](https://docs.aws.amazon.com/cli/latest/userguide/install-cliv2.html) 

1.  Identifizieren Sie die AWS Region, die mit dem Standort Ihrer Bodenstation verknüpft ist.

1.  Verwenden Sie die [get-metric-data](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/get-metric-data.html)Methode der CloudWatch CLI, um eine Datei zu generieren, die geändert werden kann, um die Metriken anzugeben, an denen Sie interessiert sind, und die dann zur Abfrage dieser Metriken verwendet werden kann. 

    Führen Sie dazu den folgenden Befehl aus:`aws cloudwatch get-metric-data --region ground-station-region-code --generate-cli-skeleton`. Dadurch wird eine Ausgabe generiert, die der folgenden ähnelt: 

   ```
           {
              "MetricDataQueries": [
                 {
                    "Id": "",
                    "MetricStat": {
                       "Metric": {
                          "Namespace": "",
                          "MetricName": "",
                          "Dimensions": [
                             {
                                "Name": "",
                                "Value": ""
                             }
                          ]
                       },
                       "Period": 0,
                       "Stat": "",
                       "Unit": "Seconds"
                    },
                    "Expression": "",
                    "Label": "",
                    "ReturnData": true,
                    "Period": 0,
                    "AccountId": ""
                 } ],
              "StartTime": "1970-01-01T00:00:00",
              "EndTime": "1970-01-01T00:00:00",
              "NextToken": "",
              "ScanBy": "TimestampDescending",
              "MaxDatapoints": 0,
              "LabelOptions": {
                 "Timezone": ""
              }
           }
   ```

1. Listet die verfügbaren CloudWatch Metriken auf, indem Sie den Befehl ausführen`aws cloudwatch list-metrics --region ground-station-region-code`.

   Wenn Sie die Methode kürzlich verwendet haben AWS Ground Station, sollte sie eine Ausgabe zurückgeben, die Einträge wie die folgenden enthält: 

   ```
           ...
           {
              "Namespace": "AWS/GroundStation",
              "MetricName": "ReceivedPower",
              "Dimensions": [
                 {
                    "Name": "Polarization",
                    "Value": "LHCP"
                 },
                 {
                    "Name": "SatelliteId",
                    "Value": "arn:aws:groundstation::111111111111:satellite/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee"
                 }
              ]
          },
          ...
   ```
**Anmerkung**  
 Wenn seit Ihrer letzten Verwendung mehr als 2 Wochen vergangen sind AWS Ground Station, müssen Sie die [Tabelle der verfügbaren Metriken manuell überprüfen, um die Namen und Dimensionen der Metriken](#monitoring.metrics.metrics-and-dimensions.available-metrics) im Metrik-Namespace zu finden. ` AWS/GroundStation` Weitere Informationen zu CloudWatch Einschränkungen finden Sie unter: [Verfügbare Metriken anzeigen](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/viewing_metrics_with_cloudwatch.html) 

1.  Ändern Sie die JSON-Datei, die Sie in Schritt 2 erstellt haben, sodass sie mit den erforderlichen Werten aus Schritt 3 und `Polarization` Ihren Metriken übereinstimmt. `SatelliteId` Achten Sie außerdem darauf`StartTime`, die `EndTime` Werte und so zu aktualisieren, dass sie mit Ihrem Kontakt übereinstimmen. Beispiel:

   ```
            {
               "MetricDataQueries": [
                  {
                     "Id": "receivedPowerExample",
                     "MetricStat": {
                        "Metric": {
                           "Namespace": "AWS/GroundStation",
                           "MetricName": "ReceivedPower",
                           "Dimensions": [
                              {
                                 "Name": "SatelliteId",
                                 "Value": "arn:aws:groundstation::111111111111:satellite/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee"
                              },
                              {
                                 "Name": "Polarization",
                                 "Value": "RHCP"
                              }
                           ]
                        },
                        "Period": 300,
                        "Stat": "Maximum",
                        "Unit": "None"
                     },
                     "Label": "ReceivedPowerExample",
                     "ReturnData": true
                  }
               ],
               "StartTime": "2024-02-08T00:00:00",
               "EndTime": "2024-04-09T00:00:00"
            }
   ```
**Anmerkung**  
 AWS Ground Station veröffentlicht Metriken je nach Metrik alle 1 bis 60 Sekunden. Metriken werden nicht zurückgegeben, wenn das `Period` Feld einen Wert hat, der unter dem Veröffentlichungszeitraum für die Metrik liegt. 

1.  Führen Sie es `aws cloudwatch get-metric-data` mit der in den vorherigen Schritten erstellten Konfigurationsdatei aus. Nachstehend finden Sie ein Beispiel. 

   ```
   aws cloudwatch get-metric-data --region ground-station-region-code --cli-input-json file://<nameOfConfigurationFileCreatedInStep2>.json
   ```

 Metriken werden mit Zeitstempel von Ihrem Kontakt zur Verfügung gestellt. Ein Beispiel für die Ausgabe von AWS Ground Station -Metriken finden Sie unten.

```
{
   "MetricDataResults": [
      {
         "Id": "receivedPowerExample",
         "Label": "ReceivedPowerExample",
         "Timestamps": [
            "2024-04-08T18:35:00+00:00",
            "2024-04-08T18:30:00+00:00",
            "2024-04-08T18:25:00+00:00"
         ],
         "Values": [
            -33.30191555023193,
            -31.46100273132324,
            -32.13915576934814
         ],
         "StatusCode": "Complete"
      }
   ],
   "Messages": []
}
```