Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Comprenez la surveillance avec AWS Ground Station
La surveillance est un enjeu important pour assurer la fiabilité, la disponibilité et les performances de AWS Ground Station. AWS fournit les outils de surveillance suivants pour surveiller AWS Ground Station, signaler tout problème et prendre des mesures automatiques le cas échéant.
+ *Amazon EventBridge Events* fournit un flux en temps quasi réel d'événements système décrivant les modifications apportées aux AWS ressources. EventBridge Les événements permettent une informatique automatisée axée sur les événements, car vous pouvez rédiger des règles qui surveillent certains événements et déclenchent des actions automatisées dans d'autres AWS services lorsque ces événements se produisent. Pour plus d'informations sur les EventBridge événements, consultez le [guide de l'utilisateur Amazon EventBridge Events](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html).
+ *AWS CloudTrail*capture les appels d'API et les événements associés effectués par ou pour le compte de votre AWS compte et envoie les fichiers journaux dans un compartiment Amazon S3 que vous spécifiez. Vous pouvez identifier les utilisateurs et les comptes appelés AWS, l'adresse IP source à partir de laquelle les appels ont été effectués et la date des appels. Pour plus d'informations AWS CloudTrail, consultez le [guide de AWS CloudTrail l'utilisateur](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/).
+ *Amazon CloudWatch Metrics* capture les statistiques de vos contacts planifiés lors de l'utilisation AWS Ground Station. CloudWatch Les métriques vous permettent d'analyser les données en fonction de votre canal, de votre polarisation et de l'identifiant du satellite afin d'identifier l'intensité du signal et les erreurs chez vos contacts. Pour plus d'informations, consultez la section [Utilisation CloudWatch des métriques Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/working_with_metrics.html).
+ *[AWS Notifications des utilisateurs](https://docs.aws.amazon.com/notifications/latest/userguide/what-is.html)* peut être utilisé pour configurer des canaux de diffusion afin d'être informé AWS Ground Station des événements. Vous recevez une notification lorsqu'un événement correspond à une règle que vous avez spécifiée. Vous pouvez recevoir des notifications d'événements via plusieurs canaux, notamment par e-mail, [Amazon Q Developer dans les applications de chat](https://docs.aws.amazon.com/chatbot/latest/adminguide/what-is.html), les notifications par chat ou les notifications [AWS Console Mobile Application](https://docs.aws.amazon.com/consolemobileapp/latest/userguide/what-is-consolemobileapp.html)push. Vous pouvez également consulter les notifications dans le [centre de notifications de](https://console.aws.amazon.com/notifications/) la AWS console. Notifications des utilisateurs prendre en charge l'agrégation, qui peut réduire le nombre de notifications que vous recevez lors d'événements spécifiques.
Utilisez les rubriques suivantes pour surveiller AWS Ground Station.
**Topics**
+ [Automatisez AWS Ground Station avec des événements](monitoring.automating-events.md)
+ [Enregistrez les appels AWS Ground Station d'API avec AWS CloudTrail](monitoring.cloudtrail.md)
+ [Afficher les statistiques avec Amazon CloudWatch](monitoring.metrics.md)
# Automatisez AWS Ground Station avec des événements
**Note**
Le terme « événement » est utilisé partout dans le présent document. CloudWatch Les événements et EventBridge les deux sont le même service sous-jacent et la même API. Les règles permettant de faire correspondre les événements entrants et de les acheminer vers des cibles à des fins de traitement peuvent être établies à l'aide de l'un ou l'autre service.
Les événements vous permettent d'automatiser vos AWS services et de répondre automatiquement aux événements du système tels que les problèmes de disponibilité des applications ou les modifications des ressources. Les événements liés AWS aux services sont diffusés en temps quasi réel. Vous pouvez écrire des règles simples pour indiquer quels événements vous intéressent et les actions automatisées à effectuer quand un événement correspond à une règle. Certaines des actions qui peuvent être déclenchées automatiquement sont les suivantes :
+ Invoquer une fonction AWS Lambda
+ Appel de la fonctionnalité Exécuter la commande d’Amazon EC2
+ Relais de l’événement à Amazon Kinesis Data Streams
+ Activation d'une machine à AWS Step Functions états
+ Notification d’une rubrique Amazon SNS ou d’une file d’attente Amazon SQS
Voici quelques exemples d'utilisation d'événements avec AWS Ground Station :
+ Invocation d'une fonction Lambda pour automatiser le démarrage et l'arrêt des instances Amazon EC2 en fonction de l'état de l'événement.
+ Publication sur une rubrique Amazon SNS chaque fois qu'un contact change d'état. Ces rubriques peuvent être configurées pour envoyer des notifications par e-mail au début ou à la fin des contacts.
Pour plus d'informations, consultez le [guide de l'utilisateur Amazon EventBridge Events](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html).
## AWS Ground Station Types d'événements
**Note**
La valeur « source » de tous les événements générés par AWS Ground Station est « aws.groundstation ».
AWS Ground Station émet des événements liés aux changements d'état pour vous permettre de personnaliser votre automatisation. Actuellement, AWS Ground Station prend en charge les événements de changement d'état des contacts, les événements de modification du groupe de points de terminaison du flux de données et les événements de changement d'état des éphémérides. Les sections suivantes fournissent des informations détaillées sur chaque type.
## Chronologie des événements de contact
AWS Ground Station émet des événements lorsque votre contact change d'état. Pour plus d'informations sur la nature de ces changements d'État et sur la signification des États eux-mêmes, voir[Comprendre le cycle de vie des contacts](contacts.lifecycle.md). Tous les groupes de points de terminaison de flux de données utilisés dans votre contact sont associés à un ensemble indépendant d'événements qui sont également émis. Au cours de cette même période, nous émettons également des événements pour votre groupe de points de terminaison de flux de données. Vous pouvez configurer l'heure précise des événements avant et après le passage lorsque vous configurez votre profil de mission et votre groupe de points de terminaison de flux de données.
Le schéma suivant montre les statuts et les événements émis pour un contact nominal et son groupe de points de terminaison de flux de données associé.
![\[Diagram showing statuses and events for a nominal contact and its associated dataflow endpoint group.\]](http://docs.aws.amazon.com/fr_fr/ground-station/latest/ug/images/monitoring.automating-events.contact-timeline.png)
**Modification de l’état d’un contact Ground Station**
Si vous souhaitez effectuer une action spécifique lorsqu'un prochain contact change d'état, vous pouvez définir une règle pour automatiser cette action. Ceci est utile lorsque vous souhaitez recevoir des notifications sur les changements d'état de votre contact. Si vous souhaitez modifier le moment où vous recevez ces événements, vous pouvez modifier le profil de votre mission [ contactPrePassDurationSeconds](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_UpdateMissionProfile.html#groundstation-UpdateMissionProfile-request-contactPrePassDurationSeconds)et [ contactPostPassDurationSeconds](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_UpdateMissionProfile.html#groundstation-UpdateMissionProfile-request-contactPostPassDurationSeconds). Les événements sont envoyés à la région à partir de laquelle le contact a été planifié.
Un exemple d'événement est fourni ci-dessous.
```
{
"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"
}
}
```
Les valeurs possibles pour `contactStatus` sont définies dans[AWS Ground Station statuts des contacts](contacts.lifecycle.md#contact-statuses).
**Modification de l'état du groupe de points de terminaison du flux de données Ground Station**
Si vous souhaitez effectuer une action lorsque votre groupe de points de terminaison de flux de données est utilisé pour recevoir des données, vous pouvez configurer une règle pour automatiser cette action. Cela vous permettra d'effectuer différentes actions en réponse aux états changeants du groupe de points de terminaison de flux de données. Si vous souhaitez modifier le moment où vous recevez ces événements, utilisez un groupe de points de terminaison de flux de données avec un et différent [contactPrePassDurationSeconds](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_CreateDataflowEndpointGroup.html#groundstation-CreateDataflowEndpointGroup-request-contactPrePassDurationSeconds). [contactPostPassDurationSeconds](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_CreateDataflowEndpointGroup.html#groundstation-CreateDataflowEndpointGroup-request-contactPostPassDurationSeconds) Cet événement sera envoyé à la région du groupe de points de terminaison de flux de données.
Vous trouverez un exemple ci-dessous.
```
{
"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"
}
}
```
Les états possibles pour `dataflowEndpointGroupState` sont : `PREPASS`, `PASS`, `POSTPASS` et `COMPLETED`.
## Événements Ephemeris
**Changement d'état des éphémérides de la station au sol**
Si vous souhaitez effectuer une action lorsqu'une éphéméride change d'état, vous pouvez définir une règle pour automatiser cette action. Cela vous permet d'effectuer différentes actions en réponse au changement d'état d'une éphéméride. Par exemple, vous pouvez effectuer une action lorsque la validation d'une éphéméride est terminée, et c'est maintenant le cas. `ENABLED` La notification de cet événement sera envoyée à la région où les éphémérides ont été téléchargées.
Vous trouverez un exemple ci-dessous.
```
{
"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"
}
}
```
Les états possibles pour les `ephemerisStatus` incluent `ENABLED``VALIDATING`,`INVALID`,`ERROR`,`DISABLED`, `EXPIRED`
# Enregistrez les appels AWS Ground Station d'API avec AWS CloudTrail
AWS Ground Station est intégré à AWS CloudTrail un service qui fournit un enregistrement des actions entreprises par un utilisateur, un rôle ou un AWS service dans AWS Ground Station. CloudTrail capture tous les appels d'API AWS Ground Station sous forme d'événements. Les appels capturés incluent des appels provenant de la AWS Ground Station console et des appels de code vers les opérations de l' AWS Ground Station API. Si vous créez un suivi, vous pouvez activer la diffusion continue d' CloudTrail événements vers un compartiment Amazon S3, y compris les événements pour AWS Ground Station. Si vous ne configurez pas de suivi, vous pouvez toujours consulter les événements les plus récents dans la CloudTrail console dans **Historique des événements**. À l'aide des informations collectées par CloudTrail, vous pouvez déterminer la demande qui a été faite AWS Ground Station, l'adresse IP à partir de laquelle la demande a été faite, qui a fait la demande, quand elle a été faite et des détails supplémentaires.
Pour en savoir plus CloudTrail, consultez le [guide de AWS CloudTrail l'utilisateur](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/).
## AWS Ground Station Informations dans CloudTrail
CloudTrail est activé sur votre AWS compte lorsque vous le créez. Lorsqu'une activité se produit dans AWS Ground Station, cette activité est enregistrée dans un CloudTrail événement avec d'autres événements de AWS service dans **l'historique des événements**. Vous pouvez consulter, rechercher et télécharger les événements récents dans votre AWS compte. Pour plus d'informations, consultez la section [Affichage des événements à l'aide de l'historique des CloudTrail événements](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html).
Pour un enregistrement continu des événements de votre AWS compte, y compris des événements pour AWS Ground Station, créez un parcours. Un *suivi* permet CloudTrail de fournir des fichiers journaux à un compartiment Amazon S3. Par défaut, lorsque vous créez un journal d'activité dans la console, il s’applique à toutes les régions AWS. Le journal enregistre les événements de toutes les régions de la AWS partition et transmet les fichiers journaux au compartiment Amazon S3 que vous spécifiez. En outre, vous pouvez configurer d'autres AWS services pour analyser plus en détail les données d'événements collectées dans les CloudTrail journaux et agir en conséquence. Pour plus d’informations, consultez les ressources suivantes :
+ [Vue d’ensemble de la création d’un journal d’activité](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html)
+ [CloudTrail Services et intégrations pris en charge](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-aws-service-specific-topics.html#cloudtrail-aws-service-specific-topics-integrations)
+ [Configuration des notifications Amazon SNS pour CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/getting_notifications_top_level.html)
+ [Réception de fichiers CloudTrail journaux de plusieurs régions](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/receive-cloudtrail-log-files-from-multiple-regions.html) et [réception de fichiers CloudTrail journaux de plusieurs comptes](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-receive-logs-from-multiple-accounts.html)
Toutes les AWS Ground Station actions sont enregistrées CloudTrail et documentées dans la [référence de l'AWS Ground Station API](Welcome.html). Par exemple, les appels au`ReserveContact`, `CancelContact` et les `ListConfigs` actions génèrent des entrées dans les fichiers CloudTrail journaux.
Chaque événement ou entrée de journal contient des informations sur la personne ayant initié la demande. Les informations relatives à l’identité permettent de déterminer les éléments suivants :
+ Si la demande a été faite avec les informations d'identification de l'utilisateur root ou Gestion des identités et des accès AWS (IAM).
+ Si la demande a été effectuée avec les informations d’identification de sécurité temporaires d’un rôle ou d’un utilisateur fédéré.
+ Si la demande a été faite par un autre AWS service.
Pour plus d’informations, consultez la section [Élément userIdentity CloudTrail ](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html).
## Comprendre les entrées du fichier AWS Ground Station journal
Un suivi est une configuration qui permet de transmettre des événements sous forme de fichiers journaux à un compartiment Amazon S3 que vous spécifiez. CloudTrail les fichiers journaux contiennent une ou plusieurs entrées de journal. Un événement représente une demande unique provenant de n'importe quelle source et inclut des informations sur l'action demandée, la date et l'heure de l'action, les paramètres de la demande, etc. CloudTrail les fichiers journaux ne constituent pas une trace ordonnée des appels d'API publics, ils n'apparaissent donc pas dans un ordre spécifique.
L'exemple suivant montre une entrée de CloudTrail journal illustrant l'`ReserveContact`action.
**Exemple : 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"
}
```
# Afficher les statistiques avec Amazon CloudWatch
Lors d'un contact, capture et envoie AWS Ground Station automatiquement les données à des CloudWatch fins d'analyse. Vos données peuvent être consultées dans la CloudWatch console Amazon. Pour plus d'informations sur l'accès et CloudWatch les métriques, consultez [Using Amazon CloudWatch Metrics](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/working_with_metrics.html).
La fonction de AWS Ground Station télémétrie peut également être utilisée pour recevoir des métriques en temps quasi réel lors des contacts. CloudWatch les statistiques ne sont pas disponibles en temps quasi réel et peuvent entraîner des retards de livraison. CloudWatch agrège également les métriques sur une période d'une seconde, ce qui peut réduire la granularité des données. La fonction de télémétrie fournit les statistiques individuelles et les transmet en temps quasi réel directement sur votre AWS compte. Pour de plus amples informations, veuillez consulter [Travailler avec la télémétrie](telemetry.md).
**Important**
AWS Ground Station émet CloudWatch des métriques vers la AWS région associée à l'emplacement de la station au sol du contact, et non vers la AWS région à partir de laquelle le contact a été planifié. Pour consulter les statistiques d'un contact, vous devez accéder CloudWatch à la région de la station au sol. Pour plus d'informations sur AWS la région associée à l'emplacement de chaque station au sol, consultez[Trouver la AWS région pour l'emplacement d'une station au sol](aws-ground-station-antenna-locations.md#aws-ground-station-antenna-locations.antenna-regions). Pour recevoir des données de télémétrie dans la région à partir de laquelle vous planifiez vos contacts, vous pouvez utiliser la fonction de AWS Ground Station télémétrie. Pour plus d’informations, consultez [Travailler avec la télémétrie](telemetry.md).
## AWS Ground Station Métriques et dimensions
### Quelles métriques sont disponibles ?
Les statistiques suivantes sont disponibles auprès de AWS Ground Station.
**Note**
Les métriques spécifiques émises dépendent des AWS Ground Station capacités utilisées. Selon votre configuration, seul un sous-ensemble des métriques ci-dessous peut être émis.
| Métrique | Dimensions métriques | Description |
| --- | --- | --- |
| `AzimuthAngle` | SatelliteId | Angle d'azimut de l'antenne. Le nord réel est à 0 degré et l'est à 90 degrés. Unités : degrés |
| `BitErrorRate` | Canal, Polarisation, SatelliteId | Le taux d'erreur sur les bits dans un nombre donné de transmissions binaires. Les erreurs de bits sont causées par le bruit, la distorsion ou les interférences Unités : erreurs de bits par unité de temps |
| `BlockErrorRate` | Canal, Polarisation, SatelliteId | Taux d'erreur de blocs dans un nombre donné de blocs reçus. Les erreurs de blocs sont causées par des interférences. Unités : blocs erronés/Nombre total de blocs |
| `CarrierFrequencyRecovery_Cn0` | Catégorie, Config, SatelliteId | Rapport entre le support et la densité du bruit par unité de bande passante. Unités : décibel-Hertz (dB-Hz) |
| `CarrierFrequencyRecovery_Locked` | Catégorie, Config, SatelliteId | Réglé sur 1 lorsque la boucle de récupération de fréquence porteuse du démodulateur est verrouillée et sur 0 lorsqu'elle est déverrouillée. Unités : sans unité |
| `CarrierFrequencyRecovery_OffsetFrequency_Hz` | Catégorie, Config, SatelliteId | Le décalage entre le centre du signal estimé et la fréquence centrale idéale. Cela est dû au décalage Doppler et au décalage de l'oscillateur local entre le vaisseau spatial et le système d'antenne. Unités : hertz (Hz) |
| `ElevationAngle` | SatelliteId | Angle d'élévation de l'antenne. L'horizon est de 0 degré et le zénith de 90 degrés. Unités : degrés |
| `Es/N0` | Canal, Polarisation, SatelliteId | Rapport entre l'énergie par symbole et la densité spectrale de puissance du bruit. Unités : décibels (dB) |
| `ReceivedPower` | Polarisation, SatelliteId | La puissance du signal mesurée dans le démodulateur/décodeur. Unités : décibels par rapport aux milliwatts (dBm) |
| `SymbolTimingRecovery_ErrorVectorMagnitude` | Catégorie, Config, SatelliteId | L'amplitude du vecteur d'erreur entre les symboles reçus et les points de constellation idéaux. Unités : pourcentage |
| `SymbolTimingRecovery_Locked` | Catégorie, Config, SatelliteId | Réglé sur 1 lorsque le symbole du démodulateur (chronométrage, boucle de restauration) est verrouillé et sur 0 lorsqu'il est déverrouillé Unités : sans unité |
| `SymbolTimingRecovery_OffsetSymbolRate` | Catégorie, Config, SatelliteId | Le décalage entre le débit de symboles estimé et le taux de symboles de signal idéal. Cela est dû au décalage Doppler et au décalage de l'oscillateur local entre le vaisseau spatial et le système d'antenne. Unités : symboles/seconde |
### Quelles sont les dimensions utilisées AWS Ground Station ?
Vous pouvez filtrer AWS Ground Station les données à l'aide des dimensions suivantes.
| Dimension | Description |
| --- | --- |
| `Category` | Démodulation ou décodage. |
| `Channel` | Les canaux de chaque contact incluent Un, Deux, I (en phase) et Q (quadrature). |
| `Config` | Une démo d'antenne en liaison descendante décode la configuration arn. |
| `Polarization` | La polarisation pour chaque contact comprend la LHCP (polarisation circulaire tournant à gauche) ou la RHCP (polarisation circulaire tournant à droite). |
| `SatelliteId` | L'ID satellite contient l'ARN du satellite pour vos contacts. |
## Affichage des métriques
Lors de l'affichage des métriques dans un graphique, il est important de noter que la fenêtre d'agrégation détermine la façon dont vos métriques seront affichées. Chaque métrique d'un contact peut être affichée sous forme de données par seconde pendant 3 heures après la réception des données. Vos données seront agrégées par CloudWatch Metrics sous forme de données par minute après la fin de cette période de 3 heures. Si vous devez consulter vos statistiques sur une mesure de données par seconde, il est recommandé de consulter vos données dans les 3 heures suivant leur réception ou de les conserver en dehors des CloudWatch métriques. Pour plus d'informations sur la CloudWatch rétention, consultez [Amazon CloudWatch Concepts - Concepts - Conservation métrique](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html#metrics-retention).
De plus, toutes les données capturées au cours des 60 premières secondes ne contiendront pas suffisamment d'informations pour produire des métriques significatives et ne seront probablement pas affichées. Pour afficher des métriques significatives, il est recommandé d'afficher vos données après 60 secondes.
![\[Graph showing pass metrics with dBm and error rate lines over time during 11 minutes of a contact.\]](http://docs.aws.amazon.com/fr_fr/ground-station/latest/ug/images/viewing-metrics.png)
Pour plus d'informations sur la représentation graphique des AWS Ground Station métriques CloudWatch, consultez la section Représentation [graphique des métriques.](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/graph_metrics.html)
### Pour afficher des métriques à l'aide de la console
1. Déterminez la AWS région associée à l'emplacement de votre station au sol. AWS Ground Station émet CloudWatch des métriques dans la région associée à l'emplacement de la station au sol de votre contact. Pour obtenir la liste des emplacements des stations au sol et AWS des régions associées, voir[Trouver la AWS région pour l'emplacement d'une station au sol](aws-ground-station-antenna-locations.md#aws-ground-station-antenna-locations.antenna-regions).
1. Ouvrez la [ CloudWatch console](https://console.aws.amazon.com/cloudwatch).
1. Dans le panneau de navigation, sélectionnez **Métriques**.
1. Sélectionnez l'espace de noms **GroundStation**.
![\[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/fr_fr/ground-station/latest/ug/images/GroundStation-namespace.png)
1. Sélectionnez les dimensions métriques souhaitées (par exemple, **canal, polarisation, SatelliteId**).
![\[Metrics interface showing "All metrics" tab with metrics grouped by dimensions, "Channel, Polarization, SatelliteId" and "Polarization, SatelliteId."\]](http://docs.aws.amazon.com/fr_fr/ground-station/latest/ug/images/metric-dimensions.png)
1. L'onglet **All metrics (Toutes les métriques)** affiche toutes les métriques pour cette dimension dans l'espace de noms. Vous pouvez effectuer les opérations suivantes :
1. Pour trier le tableau, utilisez l’en-tête de colonne.
1. Pour représenter graphiquement une métrique, cochez la case associée à la métrique. Pour sélectionner toutes les mesures, cochez la case dans la ligne d'en-tête du tableau.
1. Pour filtrer par ressource, sélectionnez l’ID de ressource, puis **Add to search**.
1. Pour filtrer par métrique, choisissez le nom de la métrique, puis **Add to search (Ajouter à la recherche)**.
### Pour consulter les métriques à l'aide de AWS CLI
AWS Ground Station émet CloudWatch des métriques dans la région associée à l'emplacement de la station au sol de votre contact. Pour la liste des emplacements des stations au sol, leurs AWS régions associées,[Trouver la AWS région pour l'emplacement d'une station au sol](aws-ground-station-antenna-locations.md#aws-ground-station-antenna-locations.antenna-regions). * ground-station-region-code*Remplacez-le par le code de AWS région correspondant à l'emplacement de votre station au sol (par exemple, `us-west-2` pour Oregon 1, Hawaï 1 ou Alaska 1). Toutes les AWS CLI commandes suivantes de cette procédure doivent utiliser la même région.
1. Assurez-vous qu'il AWS CLI est installé. Pour plus d'informations sur l'installation AWS CLI, consultez [Installation de la version 2 de l'interface de ligne de commande AWS](https://docs.aws.amazon.com/cli/latest/userguide/install-cliv2.html).
1. Identifiez la AWS région associée à l'emplacement de votre station au sol.
1. Utilisez la [get-metric-data](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/get-metric-data.html)méthode de la CloudWatch CLI pour générer un fichier qui peut être modifié pour spécifier les métriques qui vous intéressent, puis être utilisé pour interroger ces métriques.
Pour ce faire, exécutez ce qui suit :`aws cloudwatch get-metric-data --region ground-station-region-code --generate-cli-skeleton`. Cela générera un résultat similaire à :
```
{
"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. Répertoriez CloudWatch les métriques disponibles en exécutant`aws cloudwatch list-metrics --region ground-station-region-code`.
Si vous l'avez récemment utilisée AWS Ground Station, la méthode doit renvoyer une sortie contenant des entrées telles que :
```
...
{
"Namespace": "AWS/GroundStation",
"MetricName": "ReceivedPower",
"Dimensions": [
{
"Name": "Polarization",
"Value": "LHCP"
},
{
"Name": "SatelliteId",
"Value": "arn:aws:groundstation::111111111111:satellite/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee"
}
]
},
...
```
**Note**
Si cela fait plus de 2 semaines que vous les avez utilisées pour la dernière fois AWS Ground Station, vous devrez inspecter manuellement le [tableau des métriques disponibles](#monitoring.metrics.metrics-and-dimensions.available-metrics) pour trouver les noms et les dimensions des métriques dans l'espace de noms des ` AWS/GroundStation` métriques. Pour plus d'informations sur CloudWatch les limitations, voir : [Afficher les métriques disponibles](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/viewing_metrics_with_cloudwatch.html)
1. Modifiez le fichier JSON que vous avez créé à l'étape 2 pour qu'il corresponde aux valeurs requises à l'étape 3, par exemple`SatelliteId`, et `Polarization` à partir de vos métriques. Veillez également à mettre à jour les `StartTime` `EndTime` valeurs et pour qu'elles correspondent à celles de votre contact. Par exemple :
```
{
"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"
}
```
**Note**
AWS Ground Station publie des métriques toutes les 1 à 60 secondes, selon la métrique. Les métriques ne seront pas renvoyées si le `Period` champ a une valeur inférieure à la période de publication de la métrique.
1. Exécutez `aws cloudwatch get-metric-data` avec le fichier de configuration créé lors des étapes précédentes. Vous trouverez un exemple ci-dessous.
```
aws cloudwatch get-metric-data --region ground-station-region-code --cli-input-json file://.json
```
Les métriques seront fournies avec des horodatages de votre contact. Un exemple de sortie de métrique AWS Ground Station est fourni ci-dessous.
```
{
"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": []
}
```