Exemples d’utilisation de la CLI avec le Moniteur Internet - Amazon CloudWatch
Création d'une surveillanceAfficher les détails du contrôleLister les événements de l'étatAfficher un événement de l'état spécifiqueAfficher la liste des moniteursModifier le moniteurSupprimer un moniteur

Exemples d’utilisation de la CLI avec le Moniteur Internet

Cette section comprend des exemples d’utilisation de l’AWS Command Line Interface avec les opérations du Moniteur Internet.

Avant de commencer, assurez-vous que vous vous connectez pour utiliser l’AWS CLI avec le même compte AWS qui possède les VPC Amazon VPC, les Network Load Balancer, les distributions Amazon CloudFront ou les répertoires Amazon WorkSpaces que vous voulez surveiller. Le Moniteur Internet ne prend pas en charge l'accès aux ressources entre comptes. Pour plus d'informations sur l'utilisation de l'AWS CLI, consultez Référence des commandes AWS CLI. 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.

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 emplacements et les ASN (généralement des fournisseurs de services Internet, ou FSI) client qui sont 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, consultez Choisir une limite maximale de réseaux urbains.

Enfin, vous pouvez choisir de publier toutes les mesures Internet de votre application sur Amazon S3. Les mesures Internet des 500 premiers réseaux urbains (en termes de volume de trafic) sont automatiquement publiées sur CloudWatch Logs par Moniteur Internet, mais vous pouvez choisir de publier toutes les mesures sur S3 également.

Pour créer un moniteur à l'aide de l'AWS CLI, utilisez la commande create-monitor. 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

Moniteur Internet publie les mesures Internet dans CloudWatch Logs toutes les cinq minutes pour les 500 principaux réseaux urbains (emplacements clients et ASN, généralement des fournisseurs de services Internet, ou FSI) de votre compte. 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, consultez Publier des mesures Internet vers Amazon S3 dans le Moniteur Internet.

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 sur un moniteur avec l'AWS CLI, utilisez la commande get-monitor.

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 une liste d’événements de l’état actuel avec l’AWS CLI, utilisez la commande list-health-events.

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"
{}