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 façon de configurer et d'exécuter le 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'create-monitorexemple suivant crée un moniteur dont le nom Example_NetworkMonitor est aggregationPeriod défini sur 30 secondes. L'initiale state du moniteur sera due au INACTIVE fait qu'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'create-monitorexemple suivant crée un moniteur nomméExample_NetworkMonitor. La commande crée également une sonde qui utilise le ICMP protocole et inclut des balises. Puisque aucun n'aggregationPeriodest transmis dans la demande, les 60 secondes sont définies par défaut. Le moniteur avec state la sonde durera PENDING jusqu'à ce que le moniteur soitACTIVE. 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 le protocole ICMP et incluant également des balises

L'create-monitorexemple suivant crée un moniteur nommé Example_NetworkMonitor avec un nombre aggregationPeriod de 30 secondes. La commande crée également une sonde qui utilise le ICMP protocole et inclut des balises. Puisque aucun n'aggregationPeriodest transmis dans la demande, les 60 secondes sont définies par défaut. Le moniteur avec state la sonde durera PENDING jusqu'à ce que le moniteur soit en placeACTIVE. 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'create-probeexemple suivant crée une sonde qui utilise TCP protocol et ajoute la sonde à un moniteur nomméExample_NetworkMonitor. Une fois créé, state le moniteur avec la sonde durera PENDING jusqu'à ce que le moniteur soitACTIVE. Cela peut prendre plusieurs minutes, puis 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 une sonde à l'aide de l'ICMP et pour l'ajouter à un moniteur réseau

L'create-probeexemple suivant crée une sonde qui utilise ICMP protocol et ajoute la sonde à un moniteur nomméExample_NetworkMonitor. Une fois créé, state le moniteur avec la sonde durera PENDING jusqu'à ce que le moniteur soitACTIVE. Cela peut prendre plusieurs minutes, puis 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'delete-monitorexemple suivant supprime un moniteur nomméExample_NetworkMonitor.


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

Cette commande ne produit aucun résultat.

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'delete-probeexemple 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 aucun résultat.

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 des informations sur le moniteur

L'get-monitorexemple suivant permet d'obtenir 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 les détails de la sonde

L'get-probeexemple suivant renvoie les détails d'une sonde associée à un moniteur nomméExample_NetworkMonitor. probeID probe-12345


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'list-monitorsexemple suivant renvoie une liste d'un seul moniteur. Le moniteur l'stateest ACTIVE et il a aggregationPeriod 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'list-monitorsexemple 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 utilisent une durée 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'list-tags-for-resourceexemple suivant renvoie la 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 étiqueter une ressource

L'tag-resourceexemple suivant balise un moniteur nommé Example_NetworkMonitor avec Environment=Dev et Application=PetStore tags.


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

Cette commande ne produit aucun résultat.

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 annuler le balisage d'une ressource

L'untag-resourceexemple suivant supprime un tag-keys paramètre avec la paire clé-valeur de 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 aucun résultat.

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'update-monitorexemple suivant fait passer la valeur d'un moniteur aggregationPeriod de 60 quelques secondes à 30 quelques 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'update-probeexemple suivant met à jour l'adresse destination IP d'origine d'une sonde et met également packetSize à 60 jour le


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é