Exemples d'utilisation CLI avec Amazon CloudWatch Internet Monitor

Cette section contient des exemples d'utilisation des opérations AWS Command Line Interface avec Amazon CloudWatch Internet Monitor.

Avant de commencer, assurez-vous de vous connecter pour utiliser le AWS CLI même AWS compte qui possède les Amazon Virtual Private Clouds (VPCs), les Network Load Balancers, les CloudFront distributions Amazon ou les WorkSpaces annuaires 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 API des actions avec Amazon CloudWatch Internet Monitor, consultez le guide de API référence Amazon CloudWatch Internet 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 etASNs, 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.

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 VPC ressource 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 etASNs, généralement, fournisseurs de services Internet ouISPs) 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 Publication de mesures Internet sur Amazon S3 dans Amazon CloudWatch 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=MyS3Bucket,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 consulter 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 médical spécifique associé auCLI, exécutez la get-health-event commande avec le nom de votre moniteur et un identifiant d'événement médical.

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 la liste de tous les moniteurs de votre compte dotés duCLI, exécutez la list-monitors commande.

aws internetmonitor list-monitors

{
    "Monitors": [
        {
            "MonitorName": "TestMonitor",
            "ProcessingStatus": "OK",
            "Status": "ACTIVE"
        }
    ],
    "NextToken": " zase12"
}

Modifier le moniteur

Pour mettre à jour les informations relatives à votre moniteur à l'aide deCLI, utilisez la update-monitor commande et spécifiez le nom du moniteur à mettre à jour. Vous pouvez mettre à jour le pourcentage de trafic à surveiller, la limite maximale de réseaux urbains à surveiller, ajouter ou supprimer les ressources utilisées par Moniteur Internet pour surveiller le trafic et modifier le statut 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 à l'CLIaide de la delete-monitor commande. 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 l'état du moniteur est définiINACTIVE, vous pouvez utiliser le CLI pour exécuter la delete-monitor commande de suppression du moniteur. La réponse à un appel delete-monitor réussi est vide.

aws internetmonitor delete-monitor --monitor-name "TestMonitor"

{}