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.
# Exemples d’utilisation de la CLI avec le Moniteur Internet
Cette section contient des exemples d'utilisation des opérations AWS Command Line Interface avec Internet Monitor.
Avant de commencer, assurez-vous de vous connecter pour utiliser le AWS CLI même AWS compte qui possède les WorkSpaces annuaires Amazon VPC VPCs, Network Load Balancers, Amazon CloudFront distributions ou Amazon que vous souhaitez surveiller. Le Moniteur Internet ne prend pas en charge l'accès aux ressources entre comptes. Pour plus d'informations sur l'utilisation du AWS CLI, consultez la [référence des AWS CLI commandes](https://docs.aws.amazon.com/cli/latest/index.html). Pour plus d’informations sur l’utilisation des actions d’API avec le Moniteur Internet, consultez le [Guide de référence de l’API du Moniteur Internet](https://docs.aws.amazon.com/internet-monitor/latest/api/Welcome.html).
**Topics**
+ [Création d'une surveillance](#CloudWatch-IM-get-started-CLI-create-mon)
+ [Afficher les détails du moniteur](#CloudWatch-IM-get-started-CLI-mon-details)
+ [Lister les événements de l'état](#CloudWatch-IM-get-started-CLI-list-events)
+ [Afficher un événement de l'état spécifique](#CloudWatch-IM-get-started-CLI-view-event-specific)
+ [Afficher la liste des moniteurs](#CloudWatch-IM-get-started-CLI-monitor-list)
+ [Modifier le moniteur](#CloudWatch-IM-get-started-CLI-edit-monitor)
+ [Supprimer un moniteur](#CloudWatch-IM-get-started-CLI-delete-monitor)
## Création d'une surveillance
Lorsque vous créez un moniteur dans Moniteur Internet, vous fournissez un nom et associez des ressources au moniteur pour indiquer où se trouve le trafic Internet de votre application. Vous spécifiez un pourcentage de trafic qui définit la part du trafic de votre application qui est surveillée. Cela détermine également le nombre de réseaux urbains, c'est-à-dire les sites des clients et ASNs, généralement, les fournisseurs de services Internet ou ISPs surveillés. Vous pouvez également définir un nombre maximum de réseaux urbains à surveiller pour vos ressources d'application afin de mieux contrôler votre facture. Pour de plus amples informations, veuillez consulter [Choisir une limite maximale de réseaux urbains](IMCityNetworksMaximum.md).
Enfin, vous pouvez choisir de publier toutes les mesures Internet de votre application sur Amazon S3. Les mesures Internet pour les 500 principaux réseaux urbains (par volume de trafic) sont automatiquement publiées dans CloudWatch Logs by Internet Monitor, mais vous pouvez également choisir de publier toutes les mesures sur S3.
Pour créer un moniteur avec le AWS CLI, vous devez utiliser la `create-monitor` commande. La commande suivante crée un moniteur qui surveille 100 % du trafic, mais fixe une limite maximale de 10 000 réseaux urbains, ajoute une ressource VPC et choisit de publier les mesures Internet sur Amazon S3.
**Note**
Internet Monitor publie dans CloudWatch Logs les mesures Internet toutes les cinq minutes pour les 500 principaux réseaux urbains (sites clients et ASNs, généralement, fournisseurs de services Internet ou ISPs) qui envoient du trafic vers chaque moniteur. Vous pouvez choisir de publier les mesures Internet pour tous les réseaux urbains surveillés (jusqu'à la limite de service de 500 000 réseaux urbains) dans un compartiment Amazon S3. Pour de plus amples informations, veuillez consulter [Publier des mesures Internet vers Amazon S3 dans le Moniteur Internet](CloudWatch-IM-get-started.Publish-to-S3.md).
```
aws internetmonitor create-monitor --monitor-name "TestMonitor" \
--traffic-percentage-to-monitor 100 \
--max-city-networks-to-monitor 10000 \
--resources "arn:aws:ec2:us-east-1:111122223333:vpc/vpc-11223344556677889" \
--internet-measurements-log-delivery S3Config="{BucketName=amzn-s3-demo-bucket,LogDeliveryStatus=ENABLED}"
```
```
{
"Arn": "arn:aws:internetmonitor:us-east-1:111122223333:monitor/TestMonitor",
"Status": "ACTIVE"
}
```
**Note**
Vous ne pouvez pas modifier le nom d'un moniteur.
## Afficher les détails du moniteur
Pour afficher les informations relatives à un moniteur doté du AWS CLI, vous devez utiliser la `get-monitor` commande.
```
aws internetmonitor get-monitor --monitor-name "TestMonitor"
```
```
{
"ClientLocationType": "city",
"CreatedAt": "2022-09-22T19:27:47Z",
"ModifiedAt": "2022-09-22T19:28:30Z",
"MonitorArn": "arn:aws:internetmonitor:us-east-1:111122223333:monitor/TestMonitor",
"MonitorName": "TestMonitor",
"ProcessingStatus": "OK",
"ProcessingStatusInfo": "The monitor is actively processing data",
"Resources": [
"arn:aws:ec2:us-east-1:111122223333:vpc/vpc-11223344556677889"
],
"MaxCityNetworksToMonitor": 10000,
"Status": "ACTIVE"
}
```
## Lister les événements de l'état
Lorsque les performances se dégradent pour le trafic Internet de votre application, Moniteur Internet crée des événements de l'état dans votre moniteur. Pour voir la liste des problèmes de santé actuels associés au AWS CLI, utilisez la `list-health-events` commande.
```
aws internetmonitor list-health-events --monitor-name "TestMonitor"
```
```
{
"HealthEvents": [
{
"EventId": "2022-06-20T01-05-05Z/latency",
"Status": "RESOLVED",
"EndedAt": "2022-06-20T01:15:14Z",
"ServiceLocations": [
{
"Name": "us-east-1"
}
],
"PercentOfTotalTrafficImpacted": 1.21,
"ClientLocations": [
{
"City": "Lockport",
"PercentOfClientLocationImpacted": 60.370000000000005,
"PercentOfTotalTraffic": 2.01,
"Country": "United States",
"Longitude": -78.6913,
"AutonomousSystemNumber": 26101,
"Latitude": 43.1721,
"Subdivision": "New York",
"NetworkName": "YAHOO-BF1"
}
],
"StartedAt": "2022-06-20T01:05:05Z",
"ImpactType": "PERFORMANCE",
"EventArn": "arn:aws:internetmonitor:us-east-1:111122223333:monitor/TestMonitor/health-event/2022-06-20T01-05-05Z/latency"
},
{
"EventId": "2022-06-20T01-17-56Z/latency",
"Status": "RESOLVED",
"EndedAt": "2022-06-20T01:30:23Z",
"ServiceLocations": [
{
"Name": "us-east-1"
}
],
"PercentOfTotalTrafficImpacted": 1.29,
"ClientLocations": [
{
"City": "Toronto",
"PercentOfClientLocationImpacted": 75.32,
"PercentOfTotalTraffic": 1.05,
"Country": "Canada",
"Longitude": -79.3623,
"AutonomousSystemNumber": 14061,
"Latitude": 43.6547,
"Subdivision": "Ontario",
"CausedBy": {
"Status": "ACTIVE",
"Networks": [
{
"AutonomousSystemNumber": 16509,
"NetworkName": "Amazon.com"
}
],
"NetworkEventType": "AWS"
},
"NetworkName": "DIGITALOCEAN-ASN"
},
{
"City": "Lockport",
"PercentOfClientLocationImpacted": 22.91,
"PercentOfTotalTraffic": 2.01,
"Country": "United States",
"Longitude": -78.6913,
"AutonomousSystemNumber": 26101,
"Latitude": 43.1721,
"Subdivision": "New York",
"NetworkName": "YAHOO-BF1"
},
{
"City": "Hangzhou",
"PercentOfClientLocationImpacted": 2.88,
"PercentOfTotalTraffic": 0.7799999999999999,
"Country": "China",
"Longitude": 120.1612,
"AutonomousSystemNumber": 37963,
"Latitude": 30.2994,
"Subdivision": "Zhejiang",
"NetworkName": "Hangzhou Alibaba Advertising Co.,Ltd."
}
],
"StartedAt": "2022-06-20T01:17:56Z",
"ImpactType": "PERFORMANCE",
"EventArn": "arn:aws:internetmonitor:us-east-1:111122223333:monitor/TestMonitor/health-event/2022-06-20T01-17-56Z/latency"
},
{
"EventId": "2022-06-20T01-34-20Z/latency",
"Status": "RESOLVED",
"EndedAt": "2022-06-20T01:35:04Z",
"ServiceLocations": [
{
"Name": "us-east-1"
}
],
"PercentOfTotalTrafficImpacted": 1.15,
"ClientLocations": [
{
"City": "Lockport",
"PercentOfClientLocationImpacted": 39.45,
"PercentOfTotalTraffic": 2.01,
"Country": "United States",
"Longitude": -78.6913,
"AutonomousSystemNumber": 26101,
"Latitude": 43.1721,
"Subdivision": "New York",
"NetworkName": "YAHOO-BF1"
},
{
"City": "Toronto",
"PercentOfClientLocationImpacted": 29.770000000000003,
"PercentOfTotalTraffic": 1.05,
"Country": "Canada",
"Longitude": -79.3623,
"AutonomousSystemNumber": 14061,
"Latitude": 43.6547,
"Subdivision": "Ontario",
"CausedBy": {
"Status": "ACTIVE",
"Networks": [
{
"AutonomousSystemNumber": 16509,
"NetworkName": "Amazon.com"
}
],
"NetworkEventType": "AWS"
},
"NetworkName": "DIGITALOCEAN-ASN"
},
{
"City": "Hangzhou",
"PercentOfClientLocationImpacted": 2.88,
"PercentOfTotalTraffic": 0.7799999999999999,
"Country": "China",
"Longitude": 120.1612,
"AutonomousSystemNumber": 37963,
"Latitude": 30.2994,
"Subdivision": "Zhejiang",
"NetworkName": "Hangzhou Alibaba Advertising Co.,Ltd."
}
],
"StartedAt": "2022-06-20T01:34:20Z",
"ImpactType": "PERFORMANCE",
"EventArn": "arn:aws:internetmonitor:us-east-1:111122223333:monitor/TestMonitor/health-event/2022-06-20T01-34-20Z/latency"
}
]
}
```
## Afficher un événement de l'état spécifique
Pour obtenir des informations plus détaillées sur un événement de l'état spécifique avec la CLI, exécutez la commande `get-health-event` avec le nom de votre moniteur et un ID d'événement de l'état.
```
aws internetmonitor get-monitor --monitor-name "TestMonitor" --event-id "health-event/TestMonitor/2021-06-03T01:02:03Z/latency"
```
```
{
"EventId": "2022-06-20T01-34-20Z/latency",
"Status": "RESOLVED",
"EndedAt": "2022-06-20T01:35:04Z",
"ServiceLocations": [
{
"Name": "us-east-1"
}
],
"EventArn": "arn:aws:internetmonitor:us-east-1:111122223333:monitor/TestMonitor/health-event/2022-06-20T01-34-20Z/latency",
"LastUpdatedAt": "2022-06-20T01:35:04Z",
"ClientLocations": [
{
"City": "Lockport",
"PercentOfClientLocationImpacted": 39.45,
"PercentOfTotalTraffic": 2.01,
"Country": "United States",
"Longitude": -78.6913,
"AutonomousSystemNumber": 26101,
"Latitude": 43.1721,
"Subdivision": "New York",
"NetworkName": "YAHOO-BF1"
},
{
"City": "Toronto",
"PercentOfClientLocationImpacted": 29.770000000000003,
"PercentOfTotalTraffic": 1.05,
"Country": "Canada",
"Longitude": -79.3623,
"AutonomousSystemNumber": 14061,
"Latitude": 43.6547,
"Subdivision": "Ontario",
"CausedBy": {
"Status": "ACTIVE",
"Networks": [
{
"AutonomousSystemNumber": 16509,
"NetworkName": "Amazon.com"
}
],
"NetworkEventType": "AWS"
},
"NetworkName": "DIGITALOCEAN-ASN"
},
{
"City": "Shenzhen",
"PercentOfClientLocationImpacted": 4.07,
"PercentOfTotalTraffic": 0.61,
"Country": "China",
"Longitude": 114.0683,
"AutonomousSystemNumber": 37963,
"Latitude": 22.5455,
"Subdivision": "Guangdong",
"NetworkName": "Hangzhou Alibaba Advertising Co.,Ltd."
},
{
"City": "Hangzhou",
"PercentOfClientLocationImpacted": 2.88,
"PercentOfTotalTraffic": 0.7799999999999999,
"Country": "China",
"Longitude": 120.1612,
"AutonomousSystemNumber": 37963,
"Latitude": 30.2994,
"Subdivision": "Zhejiang",
"NetworkName": "Hangzhou Alibaba Advertising Co.,Ltd."
}
],
"StartedAt": "2022-06-20T01:34:20Z",
"ImpactType": "PERFORMANCE",
"PercentOfTotalTrafficImpacted": 1.15
}
```
## Afficher la liste des moniteurs
Pour voir une liste de tous les moniteurs de votre compte avec la CLI, exécutez la commande `list-monitors`.
```
aws internetmonitor list-monitors
```
```
{
"Monitors": [
{
"MonitorName": "TestMonitor",
"ProcessingStatus": "OK",
"Status": "ACTIVE"
}
],
"NextToken": " zase12"
}
```
## Modifier le moniteur
Pour mettre à jour les informations sur votre moniteur à l'aide de la CLI, utilisez la commande `update-monitor` et spécifiez le nom du moniteur à mettre à jour. Par exemple, vous pouvez mettre à jour le pourcentage de trafic à surveiller, la limite du nombre maximal de réseaux urbains à surveiller, ajouter ou supprimer les ressources que le Moniteur Internet utilise pour surveiller le trafic, et modifier l’état de la surveillance de `ACTIVE` à `INACTIVE`, ou vice versa. Notez que vous ne pouvez pas modifier le nom du moniteur.
La réponse à un appel `update-monitor` renvoie uniquement les valeurs `MonitorArn` et `Status`.
L'exemple suivant montre comment utiliser la commande `update-monitor` pour définir le nombre maximal de réseaux urbains à surveiller sur `50000` :
```
aws internetmonitor update-monitor --monitor-name "TestMonitor" --max-city-networks-to-monitor 50000
```
```
{
"MonitorArn": "arn:aws:internetmonitor:us-east-1:111122223333:monitor/TestMonitor",
"Status": " ACTIVE "
}
```
L'exemple suivant montre comment ajouter et supprimer des ressources :
```
aws internetmonitor update-monitor --monitor-name "TestMonitor" \
--resources-to-add "arn:aws:ec2:us-east-1:111122223333:vpc/vpc-11223344556677889" \
--resources-to-remove "arn:aws:ec2:us-east-1:111122223333:vpc/vpc-2222444455556666"
```
```
{
"MonitorArn": "arn:aws:internetmonitor:us-east-1:111122223333:monitor/TestMonitor",
"Status": "ACTIVE"
}
```
L'exemple suivant montre comment utiliser la commande `update-monitor` pour changer le statut du moniteur en `INACTIVE` :
```
aws internetmonitor update-monitor --monitor-name "TestMonitor" --status "INACTIVE"
```
```
{
"MonitorArn": "arn:aws:internetmonitor:us-east-1:111122223333:monitor/TestMonitor",
"Status": "INACTIVE"
}
```
## Supprimer un moniteur
Vous pouvez supprimer un moniteur avec la CLI en utilisant la commande `delete-monitor`. Tout d'abord, vous devez configurer le moniteur pour qu'il soit inactif. Pour ce faire, utilisez la commande `update-monitor` pour changer le statut en `INACTIVE`. Confirmez que le moniteur est inactif en utilisant la commande `get-monitor` et en vérifiant le statut.
Lorsque le statut du moniteur est `INACTIVE`, vous pouvez alors utiliser la CLI pour exécuter la commande `delete-monitor` afin de supprimer le moniteur. La réponse à un appel `delete-monitor` réussi est vide.
```
aws internetmonitor delete-monitor --monitor-name "TestMonitor"
```
```
{}
```