CloudWatch Beispiele für Netzwerküberwachung mit AWS CLI

Beispiel 1: Um einen Netzwerkmonitor mit einem Aggregationszeitraum zu erstellen

Im folgenden create-monitor Beispiel wird ein Monitor Example_NetworkMonitor mit einem auf 30 Sekunden aggregationPeriod festgelegten Namen erstellt. Der state Anfangsbuchstabe des Monitors ist darauf INACTIVE zurückzuführen, dass ihm keine Sonden zugeordnet sind. Der Status ändert sich ACTIVE nur, wenn Sonden hinzugefügt werden. Sie können die Befehle update-monitor oder create-probe verwenden, um diesem Monitor Sonden hinzuzufügen.

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

Ausgabe:

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

Weitere Informationen finden Sie unter So funktioniert Amazon CloudWatch Network Monitor im CloudWatch Amazon-Benutzerhandbuch.

Beispiel 2: So erstellen Sie einen Netzwerkmonitor mit einer Sonde, die TCP verwendet und auch Tags enthält

Im folgenden create-monitor Beispiel wird ein Monitor mit dem Namen erstelltExample_NetworkMonitor. Der Befehl erstellt außerdem einen Prüfpunkt, der das ICMP Protokoll verwendet und Tags enthält. Da in der Anfrage „no“ übergeben aggregationPeriod wird, ist die Standardeinstellung 60 Sekunden. Der state des Monitors mit der Sonde wird PENDING solange sein, bis der Monitor es istACTIVE. Dies kann mehrere Minuten dauern. Ab diesem Zeitpunkt wechseln state Sie zuACTIVE, und Sie können mit der Anzeige der CloudWatch Messwerte beginnen.

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

Ausgabe:

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

Weitere Informationen finden Sie unter So funktioniert Amazon CloudWatch Network Monitor im CloudWatch Amazon-Benutzerhandbuch.

Beispiel 3: So erstellen Sie mithilfe von ICMP einen Netzwerkmonitor mit einer Sonde, der auch Tags enthält

Im folgenden create-monitor Beispiel wird ein Monitor erstellt, der Example_NetworkMonitor mit einer Zahl aggregationPeriod von 30 Sekunden benannt ist. Der Befehl erstellt außerdem einen Prüfpunkt, der das ICMP Protokoll verwendet und Tags enthält. Da in der Anfrage „no“ übergeben aggregationPeriod wird, ist die Standardeinstellung 60 Sekunden. Der state des Monitors mit der Sonde wird PENDING solange sein, bis der Monitor es istACTIVE. Dies kann mehrere Minuten dauern. Ab diesem Zeitpunkt wechseln state Sie zuACTIVE, und Sie können mit der Anzeige der CloudWatch Messwerte beginnen.

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

Ausgabe:

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

Weitere Informationen finden Sie unter So funktioniert Amazon CloudWatch Network Monitor im CloudWatch Amazon-Benutzerhandbuch.

Beispiel 1: Um eine Probe zu erstellen, die TCP verwendet, und sie einem Netzwerkmonitor hinzuzufügen

Im folgenden create-probe Beispiel wird ein Test erstellt, der den verwendet, TCP protocol und der Test wird einem Monitor mit dem Namen hinzugefügtExample_NetworkMonitor. Nach der Erstellung bleibt der state des Monitors mit der Sonde bestehen, PENDING bis der Monitor es istACTIVE. Dies kann mehrere Minuten dauern. Zu diesem Zeitpunkt wird der Status geändertACTIVE, und Sie können mit der Anzeige der CloudWatch Messwerte beginnen.

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}

Ausgabe:

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

Beispiel 2: Um eine Sonde zu erstellen, die Probe mithilfe von ICMP verwendet, und sie einem Netzwerkmonitor hinzuzufügen

Im folgenden create-probe Beispiel wird ein Prüfpunkt erstellt, der den verwendet, ICMP protocol und der Test wird einem Monitor mit dem Namen Example_NetworkMonitor hinzugefügt. Nach der Erstellung bleibt der state des Monitors mit der Sonde bestehen, PENDING bis der Monitor es istACTIVE. Dies kann mehrere Minuten dauern. Zu diesem Zeitpunkt wird der Status geändertACTIVE, und Sie können mit der Anzeige der CloudWatch Messwerte beginnen.

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}

Ausgabe:

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

Weitere Informationen finden Sie unter So funktioniert Amazon CloudWatch Network Monitor im CloudWatch Amazon-Benutzerhandbuch.

Um einen Monitor zu löschen

Im folgenden delete-monitor Beispiel wird ein Monitor mit dem Namen Example_NetworkMonitor gelöscht.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter So funktioniert Amazon CloudWatch Network Monitor im CloudWatch Amazon-Benutzerhandbuch.

Um eine Sonde zu löschen

Im folgenden delete-probe Beispiel wird ein Prüfpunkt mit der ID probe-12345 aus einem Netzwerkmonitor mit dem Namen Example_NetworkMonitor gelöscht.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter So funktioniert Amazon CloudWatch Network Monitor im CloudWatch Amazon-Benutzerhandbuch.

Um Monitorinformationen abzurufen

Im folgenden get-monitor Beispiel werden Informationen über einen Monitor mit dem Namen abgerufenExample_NetworkMonitor.

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

Ausgabe:

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

Weitere Informationen finden Sie unter So funktioniert Amazon CloudWatch Network Monitor im CloudWatch Amazon-Benutzerhandbuch.

Um die Details der Sonde anzuzeigen

Im folgenden get-probe Beispiel werden Details zu einem Prüfpunkt zurückgegeben probeIDprobe-12345, der einem Monitor mit dem Namen zugeordnet istExample_NetworkMonitor.

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

Ausgabe:

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

Weitere Informationen finden Sie unter So funktioniert Amazon CloudWatch Network Monitor im CloudWatch Amazon-Benutzerhandbuch.

Beispiel 1: Um alle Monitore aufzulisten (einzelner Monitor)

Das folgende list-monitors Beispiel gibt eine Liste mit nur einem einzigen Monitor zurück. Der Monitor state ist ACTIVE und er hat eine aggregationPeriod von 60 Sekunden.

aws networkmonitor list-monitors

Ausgabe:

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

Weitere Informationen finden Sie unter So funktioniert Amazon CloudWatch Network Monitor im CloudWatch Amazon-Benutzerhandbuch.

Beispiel 2: Um alle Monitore aufzulisten (mehrere Monitore)

Das folgende list-monitors Beispiel gibt eine Liste mit drei Monitoren zurück. Der state eines Monitors ist ACTIVE und generiert CloudWatch Metriken. Die Status der anderen beiden Monitore sind INACTIVE und generieren keine CloudWatch Metriken. Alle drei Monitore verwenden einen aggregationPeriod Wert von 60 Sekunden.

aws networkmonitor list-monitors

Ausgabe:

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

Weitere Informationen finden Sie unter So funktioniert Amazon CloudWatch Network Monitor im CloudWatch Amazon-Benutzerhandbuch.

Um Tags für eine Ressource aufzulisten

Das folgende list-tags-for-resource Beispiel gibt eine Liste der Tags für einen Monitor mit dem Namen zurückExample_NetworkMonitor.

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

Ausgabe:

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

Weitere Informationen finden Sie unter So funktioniert Amazon CloudWatch Network Monitor im CloudWatch Amazon-Benutzerhandbuch.

Um eine Ressource zu taggen

Im folgenden tag-resource Beispiel wird ein Monitor mit Tags versehen, der Example_NetworkMonitor mit Environment=Dev und Application=PetStore tags benannt ist.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter So funktioniert Amazon CloudWatch Network Monitor im CloudWatch Amazon-Benutzerhandbuch.

Um die Markierung einer Ressource aufzuheben

Im folgenden untag-resource Beispiel wird ein tag-keys Parameter mit dem Schlüssel-Wert-Paar von Environment Application aus seiner Zuordnung zu einem Monitor mit dem Namen entfernt. Example_NetworkMonitor

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter So funktioniert Amazon CloudWatch Network Monitor im CloudWatch Amazon-Benutzerhandbuch.

Um einen Monitor zu aktualisieren

Das folgende update-monitor Beispiel ändert die Werte eines Monitors aggregationPeriod von 60 Sekunden auf 30 Sekunden.

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

Ausgabe:

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

Weitere Informationen finden Sie unter So funktioniert Amazon CloudWatch Network Monitor im CloudWatch Amazon-Benutzerhandbuch.

Um eine Sonde zu aktualisieren

Im folgenden update-probe Beispiel wird die ursprüngliche destination IP-Adresse einer Probe aktualisiert und auch die Adresse packetSize to aktualisiert60.

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

Ausgabe:

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

Weitere Informationen finden Sie unter So funktioniert Amazon CloudWatch Network Monitor im CloudWatch Amazon-Benutzerhandbuch.