CloudWatch Beispiele für Netzwerküberwachung mit AWS CLI - AWS Command Line Interface
Aktionen

Diese Dokumentation bezieht sich AWS CLI nur auf Version 1 von. Dokumentation zu Version 2 von finden Sie im Benutzerhandbuch für Version 2. AWS CLI

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

CloudWatch Beispiele für Netzwerküberwachung mit AWS CLI

Die folgenden Codebeispiele zeigen Ihnen, wie Sie AWS Command Line Interface mit CloudWatch Network Monitoring Aktionen ausführen und allgemeine Szenarien implementieren.

Aktionen sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Aktionen zeigen Ihnen zwar, wie Sie einzelne Servicefunktionen aufrufen, aber Sie können Aktionen im Kontext der zugehörigen Szenarien sehen.

Jedes Beispiel enthält einen Link zum vollständigen Quellcode, in dem Sie Anweisungen zum Einrichten und Ausführen des Codes im Kontext finden.

Themen

Aktionen

Das folgende Codebeispiel zeigt die Verwendungcreate-monitor.

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 Tags verwendet TCP und diese auch 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 einen Netzwerkmonitor mit einer Sonde, die Tags verwendet ICMP und diese auch 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.

  • APIEinzelheiten finden Sie CreateMonitorin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungcreate-probe.

AWS CLI

Beispiel 1: So erstellen Sie einen Test, der ihn verwendet, TCP und fügen ihn einem Netzwerkmonitor hinzu

Im folgenden create-probe Beispiel wird ein Prüfpunkt 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: So erstellen Sie einen Test, der Probe using verwendet, ICMP und fügen ihn einem Netzwerkmonitor hinzu

Im folgenden create-probe Beispiel wird ein Test erstellt, der den verwendet, ICMP 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: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.

  • APIEinzelheiten finden Sie CreateProbein der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdelete-monitor.

AWS CLI

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.

  • APIEinzelheiten finden Sie DeleteMonitorin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdelete-probe.

AWS CLI

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.

  • APIEinzelheiten finden Sie DeleteProbein der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungget-monitor.

AWS CLI

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.

  • APIEinzelheiten finden Sie GetMonitorin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungget-probe.

AWS CLI

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.

  • APIEinzelheiten finden Sie GetProbein der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendunglist-monitors.

AWS CLI

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.

  • APIEinzelheiten finden Sie ListMonitorsin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendunglist-tags-for-resource.

AWS CLI

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.

Das folgende Codebeispiel zeigt die Verwendungtag-resource.

AWS CLI

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.

  • APIEinzelheiten finden Sie TagResourcein der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendunguntag-resource.

AWS CLI

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.

  • APIEinzelheiten finden Sie UntagResourcein der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungupdate-monitor.

AWS CLI

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.

  • APIEinzelheiten finden Sie UpdateMonitorin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungupdate-probe.

AWS CLI

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.

  • APIEinzelheiten finden Sie UpdateProbein der AWS CLI Befehlsreferenz.