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 Internet Monitor
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 contient 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. Pour plus d'informations sur l'utilisation des actions d'API avec Internet Monitor, consultez le Guide de référence de l'API Internet Monitor.
Rubriques
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 Choisissez une limite maximale pour les réseaux urbains.
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 (en termes de 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 sur Amazon S3 dans Internet Monitor.
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 contrôle
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 maximum de réseaux urbains à surveiller, ajouter ou supprimer les ressources utilisées par Internet Monitor pour surveiller le trafic et modifier l'état du moniteur 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"
{}
