CloudWatch Exemples de surveillance réseau à l'aide de AWS CLI

Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants à l' AWS Command Line Interface aide de la surveillance du CloudWatch réseau.

Les actions sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Alors que les actions vous indiquent comment appeler des fonctions de service individuelles, vous pouvez les voir en contexte dans leurs scénarios associés.

Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la configuration et l’exécution du code en contexte.

Rubriques

Actions

Actions

L'exemple de code suivant montre comment utilisercreate-monitor.

AWS CLI

Exemple 1 : pour créer un moniteur réseau avec une période d’agrégation

L’exemple create-monitor suivant crée un moniteur nommé Example_NetworkMonitor avec une aggregationPeriod de 30 secondes. L’state initial du moniteur sera INACTIVE, car aucune sonde n’y est associée. L’état passe à ACTIVE uniquement lorsque des sondes sont ajoutées. Vous pouvez utiliser les commandes update-monitor ou create-probe pour ajouter des sondes à ce moniteur.


aws networkmonitor create-monitor \
     --monitor-name Example_NetworkMonitor \
     --aggregation-period 30

Sortie :


{
    "monitorArn": "arn:aws:networkmonitor:region:111122223333:monitor/Example_NetworkMonitor",
    "monitorName": "Example_NetworkMonitor",
    "state": "INACTIVE",
    "aggregationPeriod": 30,
    "tags": {}
}

Pour plus d'informations, consultez Comment fonctionne Amazon CloudWatch Network Monitor dans le guide de CloudWatch l'utilisateur Amazon.

Exemple 2 : pour créer un moniteur réseau avec une sonde utilisant le protocole TCP et incluant également des balises

L’exemple create-monitor suivant crée un moniteur nommé Example_NetworkMonitor. La commande crée également une sonde qui utilise le protocole ICMP et inclut des balises. Puisque aucune aggregationPeriod n’est transmise dans la demande, 60 secondes est la valeur par défaut. L’state du moniteur avec la sonde sera PENDING jusqu’à ce que le moniteur soit ACTIVE. Cela peut prendre plusieurs minutes. À ce moment-là, ils state deviendrontACTIVE, et vous pourrez commencer à consulter CloudWatch les statistiques.


aws networkmonitor create-monitor \
    --monitor-name Example_NetworkMonitor \
    --probes sourceArn=arn:aws:ec2:region:111122223333:subnet/subnet-id,destination=10.0.0.100,destinationPort=80,protocol=TCP,packetSize=56,probeTags={Name=Probe1} \
    --tags Monitor=Monitor1

Sortie :


{
    "monitorArn": "arn:aws:networkmonitor:region111122223333:monitor/Example_NetworkMonitor",
    "monitorName": "Example_NetworkMonitor",
    "state": "PENDING",
    "aggregationPeriod": 60,
    "tags": {
        "Monitor": "Monitor1"
    }
}

Pour plus d'informations, consultez Comment fonctionne Amazon CloudWatch Network Monitor dans le guide de CloudWatch l'utilisateur Amazon.

Exemple 3 : pour créer un moniteur réseau avec une sonde utilisant ICMP et incluant également des balises

L’exemple create-monitor suivant crée un moniteur nommé Example_NetworkMonitor avec une aggregationPeriod de 30 secondes. La commande crée également une sonde qui utilise le protocole ICMP et inclut des balises. Puisque aucune aggregationPeriod n’est transmise dans la demande, 60 secondes est la valeur par défaut. L’state du moniteur avec la sonde sera PENDING jusqu’à ce que le moniteur soit ACTIVE. Cela peut prendre plusieurs minutes. À ce moment-là, ils state deviendrontACTIVE, et vous pourrez commencer à consulter CloudWatch les statistiques.


aws networkmonitor create-monitor \
     --monitor-name Example_NetworkMonitor \
     --aggregation-period 30 \
     --probes sourceArn=arn:aws:ec2:region111122223333:subnet/subnet-id,destination=10.0.0.100,protocol=ICMP,packetSize=56,probeTags={Name=Probe1} \
     --tags Monitor=Monitor1

Sortie :


{
    "monitorArn": "arn:aws:networkmonitor:region:111122223333:monitor/Example_NetworkMonitor",
    "monitorName": "Example_NetworkMonitor",
    "state": "PENDING",
    "aggregationPeriod": 30,
    "tags": {
        "Monitor": "Monitor1"
    }
}

Pour plus d'informations, consultez Comment fonctionne Amazon CloudWatch Network Monitor dans le guide de CloudWatch l'utilisateur Amazon.

Pour plus de détails sur l'API, reportez-vous CreateMonitorà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utilisercreate-probe.

AWS CLI

Exemple 1 : pour créer une sonde utilisant le protocole TCP et l’ajouter à un moniteur réseau

L’exemple create-probe suivant crée une sonde qui utilise le protocol TCP et ajoute la sonde à un moniteur nommé Example_NetworkMonitor. Une fois créé, l’state du moniteur avec la sonde sera PENDING jusqu’à ce que le moniteur soit ACTIVE. Cela peut prendre plusieurs minutes. À ce moment-là, l'état passera à l'étatACTIVE, et vous pourrez commencer à consulter CloudWatch les statistiques.


aws networkmonitor create-probe \
    --monitor-name Example_NetworkMonitor \
    --probe sourceArn=arn:aws:ec2:region:111122223333:subnet/subnet-id,destination=10.0.0.100,destinationPort=80,protocol=TCP,packetSize=56,tags={Name=Probe1}

Sortie :


{
    "probeId": "probe-12345",
    "probeArn": "arn:aws:networkmonitor:region:111122223333:probe/probe-12345",
    "destination": "10.0.0.100",
    "destinationPort": 80,
    "packetSize": 56,
    "addressFamily": "IPV4",
    "vpcId": "vpc-12345",
    "state": "PENDING",
    "createdAt": "2024-03-29T12:41:57.314000-04:00",
    "modifiedAt": "2024-03-29T12:41:57.314000-04:00",
    "tags": {
        "Name": "Probe1"
    }
}

Exemple 2 : pour créer une sonde utilisant ICMP et l’ajouter à un moniteur réseau

L’exemple create-probe suivant crée une sonde qui utilise le protocol ICMP et ajoute la sonde à un moniteur nommé Example_NetworkMonitor. Une fois créé, l’state du moniteur avec la sonde sera PENDING jusqu’à ce que le moniteur soit ACTIVE. Cela peut prendre plusieurs minutes. À ce moment-là, l'état passera à l'étatACTIVE, et vous pourrez commencer à consulter CloudWatch les statistiques.


aws networkmonitor create-probe \
    --monitor-name Example_NetworkMonitor \
    --probe sourceArn=arn:aws:ec2:region:012345678910:subnet/subnet-id,destination=10.0.0.100,protocol=ICMP,packetSize=56,tags={Name=Probe1}

Sortie :


{
    "probeId": "probe-12345",
    "probeArn": "arn:aws:networkmonitor:region:111122223333:probe/probe-12345",
    "destination": "10.0.0.100",
    "packetSize": 56,
    "addressFamily": "IPV4",
    "vpcId": "vpc-12345",
    "state": "PENDING",
    "createdAt": "2024-03-29T12:44:02.452000-04:00",
    "modifiedAt": "2024-03-29T12:44:02.452000-04:00",
    "tags": {
        "Name": "Probe1"
    }
}

Pour plus d'informations, consultez Comment fonctionne Amazon CloudWatch Network Monitor dans le guide de CloudWatch l'utilisateur Amazon.

Pour plus de détails sur l'API, reportez-vous CreateProbeà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdelete-monitor.

AWS CLI

Pour supprimer un moniteur

L’exemple delete-monitor suivant supprime un moniteur nommé Example_NetworkMonitor.


aws networkmonitor delete-monitor \
    --monitor-name Example_NetworkMonitor

Cette commande ne produit aucune sortie.

Pour plus d'informations, consultez Comment fonctionne Amazon CloudWatch Network Monitor dans le guide de CloudWatch l'utilisateur Amazon.

Pour plus de détails sur l'API, reportez-vous DeleteMonitorà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdelete-probe.

AWS CLI

Pour supprimer une sonde

L’exemple delete-probe suivant supprime une sonde portant l’ID probe-12345 d’un moniteur réseau nommé Example_NetworkMonitor.


aws networkmonitor delete-probe \
    --monitor-name Example_NetworkMonitor \
    --probe-id probe-12345

Cette commande ne produit aucune sortie.

Pour plus d'informations, consultez Comment fonctionne Amazon CloudWatch Network Monitor dans le guide de CloudWatch l'utilisateur Amazon.

Pour plus de détails sur l'API, reportez-vous DeleteProbeà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserget-monitor.

AWS CLI

Pour obtenir les informations sur le moniteur

L’exemple get-monitor suivant obtient des informations sur un moniteur nommé Example_NetworkMonitor.


aws networkmonitor get-monitor \
    --monitor-name Example_NetworkMonitor

Sortie :


{
    "monitorArn": "arn:aws:networkmonitor:region:012345678910:monitor/Example_NetworkMonitor",
    "monitorName": "Example_NetworkMonitor",
    "state": "ACTIVE",
    "aggregationPeriod": 60,
    "tags": {},
    "probes": [],
    "createdAt": "2024-04-01T17:58:07.211000-04:00",
    "modifiedAt": "2024-04-01T17:58:07.211000-04:00"
}

Pour plus d'informations, consultez Comment fonctionne Amazon CloudWatch Network Monitor dans le guide de CloudWatch l'utilisateur Amazon.

Pour plus de détails sur l'API, reportez-vous GetMonitorà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserget-probe.

AWS CLI

Pour afficher des informations sur la sonde

L’exemple get-probe suivant renvoie des informations sur une sonde avec l’probeID probe-12345 associée à un moniteur nommé Example_NetworkMonitor.


aws networkmonitor get-probe \
    --monitor-name Example_NetworkMonitor \
    --probe-id probe-12345

Sortie :


{
    "probeId": "probe-12345",
    "probeArn": "arn:aws:networkmonitor:region:012345678910:probe/probe-12345",
    "sourceArn": "arn:aws:ec2:region:012345678910:subnet/subnet-12345",
    "destination": "10.0.0.100",
    "destinationPort": 80,
    "protocol": "TCP",
    "packetSize": 56,
    "addressFamily": "IPV4",
    "vpcId": "vpc-12345",
    "state": "ACTIVE",
    "createdAt": "2024-03-29T12:41:57.314000-04:00",
    "modifiedAt": "2024-03-29T12:42:28.610000-04:00",
    "tags": {
        "Name": "Probe1"
    }
}

Pour plus d'informations, consultez Comment fonctionne Amazon CloudWatch Network Monitor dans le guide de CloudWatch l'utilisateur Amazon.

Pour plus de détails sur l'API, reportez-vous GetProbeà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserlist-monitors.

AWS CLI

Exemple 1 : pour répertorier tous les moniteurs (moniteur unique)

L’exemple list-monitors suivant renvoie une liste d’un seul moniteur. L’state du moniteur est ACTIVE avec une aggregationPeriod de 60 secondes.


aws networkmonitor list-monitors

Sortie :


{
    "monitors": [{
            "monitorArn": "arn:aws:networkmonitor:region:012345678910:monitor/Example_NetworkMonitor",
            "monitorName": "Example_NetworkMonitor",
            "state": "ACTIVE",
            "aggregationPeriod": 60,
            "tags": {
                "Monitor": "Monitor1"
            }
        }
    ]
}

Pour plus d'informations, consultez Comment fonctionne Amazon CloudWatch Network Monitor dans le guide de CloudWatch l'utilisateur Amazon.

Exemple 2 : pour répertorier tous les moniteurs (plusieurs moniteurs)

L’exemple list-monitors suivant renvoie une liste de trois moniteurs. Le state d'un moniteur est ACTIVE et génère des CloudWatch métriques. Les états des deux autres moniteurs ne INACTIVE génèrent pas de CloudWatch métriques. Les trois moniteurs ont une aggregationPeriod de 60 secondes.


aws networkmonitor list-monitors

Sortie :


{
    "monitors": [
        {
            "monitorArn": "arn:aws:networkmonitor:us-east-1:111122223333:monitor/Example_NetworkMonitor",
            "monitorName": "Example_NetworkMonitor",
            "state": "INACTIVE",
            "aggregationPeriod": 60,
            "tags": {}
        },
        {
            "monitorArn": "arn:aws:networkmonitor:us-east-1:111122223333:monitor/Example_NetworkMonitor2",
            "monitorName": "Example_NetworkMonitor2",
            "state": "ACTIVE",
            "aggregationPeriod": 60,
            "tags": {
                "Monitor": "Monitor1"
            }
        },
        {
            "monitorArn": "arn:aws:networkmonitor:us-east-1:111122223333:monitor/TestNetworkMonitor_CLI",
            "monitorName": "TestNetworkMonitor_CLI",
            "state": "INACTIVE",
            "aggregationPeriod": 60,
            "tags": {}
        }
    ]
}

Pour plus d'informations, consultez Comment fonctionne Amazon CloudWatch Network Monitor dans le guide de CloudWatch l'utilisateur Amazon.

Pour plus de détails sur l'API, reportez-vous ListMonitorsà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserlist-tags-for-resource.

AWS CLI

Pour répertorier les balises d’une ressource

L’exemple list-tags-for-resource suivant renvoie une liste des balises d’un moniteur nommé Example_NetworkMonitor.


aws networkmonitor list-tags-for-resource \
    --resource-arn arn:aws:networkmonitor:region:012345678910:monitor/Example_NetworkMonitor

Sortie :


{
    "tags": {
        "Environment": "Dev",
        "Application": "PetStore"
    }
}

Pour plus d'informations, consultez Comment fonctionne Amazon CloudWatch Network Monitor dans le guide de CloudWatch l'utilisateur Amazon.

Pour plus de détails sur l'API, reportez-vous ListTagsForResourceà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utilisertag-resource.

AWS CLI

Pour baliser une ressource

L’exemple tag-resource suivant ajoute des balises Environment=Dev et Application=PetStore à un moniteur nommé Example_NetworkMonitor.


aws networkmonitor tag-resource \
    --resource-arn arn:aws:networkmonitor:region:012345678910:monitor/Example_NetworkMonitor \
    --tags Environment=Dev,Application=PetStore

Cette commande ne produit aucune sortie.

Pour plus d'informations, consultez Comment fonctionne Amazon CloudWatch Network Monitor dans le guide de CloudWatch l'utilisateur Amazon.

Pour plus de détails sur l'API, reportez-vous TagResourceà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliseruntag-resource.

AWS CLI

Pour supprimer les balises d’une ressource

L’exemple untag-resource suivant supprime un paramètre tag-keys avec la paire clé-valeur de l’Environment Application de son association avec un moniteur nommé Example_NetworkMonitor.


aws networkmonitor untag-resource \
    --resource-arn arn:aws:networkmonitor:region:012345678910:monitor/Example_NetworkMonitor \
    --tag-keys Environment Application

Cette commande ne produit aucune sortie.

Pour plus d'informations, consultez Comment fonctionne Amazon CloudWatch Network Monitor dans le guide de CloudWatch l'utilisateur Amazon.

Pour plus de détails sur l'API, reportez-vous UntagResourceà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserupdate-monitor.

AWS CLI

Pour mettre à jour un moniteur

L’exemple update-monitor suivant fait passer la aggregationPeriod d’un moniteur de 60 secondes à 30 secondes.


aws networkmonitor update-monitor \
    --monitor-name Example_NetworkMonitor \
    --aggregation-period 30

Sortie :


{
    "monitorArn": "arn:aws:networkmonitor:region:012345678910:monitor/Example_NetworkMonitor",
    "monitorName": "Example_NetworkMonitor",
    "state": "PENDING",
    "aggregationPeriod": 30,
    "tags": {
        "Monitor": "Monitor1"
    }
}

Pour plus d'informations, consultez Comment fonctionne Amazon CloudWatch Network Monitor dans le guide de CloudWatch l'utilisateur Amazon.

Pour plus de détails sur l'API, reportez-vous UpdateMonitorà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserupdate-probe.

AWS CLI

Pour mettre à jour une sonde

L’exemple update-probe suivant met à jour l’adresse IP destination d’origine d’une sonde et met également à jour la packetSize sur 60.


aws networkmonitor update-probe \
    --monitor-name Example_NetworkMonitor \
    --probe-id probe-12345 \
    --destination 10.0.0.150 \
    --packet-size 60

Sortie :


{
    "probeId": "probe-12345",
    "probeArn": "arn:aws:networkmonitor:region:012345678910:probe/probe-12345",
    "sourceArn": "arn:aws:ec2:region:012345678910:subnet/subnet-12345",
    "destination": "10.0.0.150",
    "destinationPort": 80,
    "protocol": "TCP",
    "packetSize": 60,
    "addressFamily": "IPV4",
    "vpcId": "vpc-12345",
    "state": "PENDING",
    "createdAt": "2024-03-29T12:41:57.314000-04:00",
    "modifiedAt": "2024-03-29T13:52:23.115000-04:00",
    "tags": {
        "Name": "Probe1"
    }
}

Pour plus d'informations, consultez Comment fonctionne Amazon CloudWatch Network Monitor dans le guide de CloudWatch l'utilisateur Amazon.

Pour plus de détails sur l'API, reportez-vous UpdateProbeà la section Référence des AWS CLI commandes.

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

CloudWatch Journaux

CloudWatch Moniteur d'accès à l'observabilité