CloudWatch Esempi di monitoraggio della rete utilizzando AWS CLI - AWS Esempi di codice SDK
Azioni

Sono disponibili altri esempi AWS SDK nel repository AWS Doc SDK Examples. GitHub

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

CloudWatch Esempi di monitoraggio della rete utilizzando AWS CLI

I seguenti esempi di codice mostrano come eseguire azioni e implementare scenari comuni utilizzando AWS Command Line Interface with CloudWatch Network Monitoring.

Le operazioni sono estratti di codice da programmi più grandi e devono essere eseguite nel contesto. Sebbene le operazioni mostrino come richiamare le singole funzioni del servizio, è possibile visualizzarle contestualizzate negli scenari correlati.

Ogni esempio include un collegamento al codice sorgente completo, in cui è possibile trovare istruzioni su come configurare ed eseguire il codice nel contesto.

Argomenti

Azioni

Il seguente esempio di codice mostra come utilizzarecreate-monitor.

AWS CLI

Esempio 1: creare un monitor di rete con un periodo di aggregazione

L'create-monitoresempio seguente crea un monitor denominato Example_NetworkMonitor con un valore aggregationPeriod impostato su 30 secondi. L'iniziale state del monitor sarà INACTIVE perché non vi sono sonde associate. Lo stato cambia ACTIVE solo quando vengono aggiunte le sonde. È possibile utilizzare i comandi update-monitor o create-probe per aggiungere sonde a questo monitor.

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

Output:

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

Per ulteriori informazioni, consulta Come funziona Amazon CloudWatch Network Monitor nella Amazon CloudWatch User Guide.

Esempio 2: creare un monitor di rete con una sonda utilizzando TCP e includendo anche i tag

L'create-monitoresempio seguente crea un monitor denominato. Example_NetworkMonitor Il comando crea anche una sonda che utilizza il ICMP protocollo e include tag. Poiché nella richiesta aggregationPeriod viene passato no, i 60 secondi sono impostati come valore predefinito. Il state monitor con la sonda rimarrà attivo PENDING finché il monitor non lo sarà. ACTIVE Questa operazione potrebbe richiedere alcuni minuti, dopodiché state cambierà e potrai iniziare a ACTIVE visualizzare le CloudWatch metriche.

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

Output:

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

Per ulteriori informazioni, consulta Come funziona Amazon CloudWatch Network Monitor nella Amazon CloudWatch User Guide.

Esempio 3: creare un monitor di rete con una sonda utilizzando ICMP e includendo anche i tag

L'create-monitoresempio seguente crea un monitor denominato Example_NetworkMonitor con un aggregationPeriod di 30 secondi. Il comando crea anche una sonda che utilizza il ICMP protocollo e include tag. Poiché nella richiesta aggregationPeriod viene passato no, i 60 secondi sono impostati come valore predefinito. Il state monitor con la sonda rimarrà attivo PENDING finché il monitor non lo sarà. ACTIVE Questa operazione potrebbe richiedere alcuni minuti, dopodiché state cambierà e potrai iniziare a ACTIVE visualizzare le CloudWatch metriche.

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

Output:

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

Per ulteriori informazioni, consulta Come funziona Amazon CloudWatch Network Monitor nella Amazon CloudWatch User Guide.

Il seguente esempio di codice mostra come utilizzarecreate-probe.

AWS CLI

Esempio 1: creare una sonda che utilizza TCP e aggiungerla a un monitor di rete

L'create-probeesempio seguente crea una sonda che utilizza TCP protocol e aggiunge la sonda a un monitor denominato. Example_NetworkMonitor Una volta creato, il state monitor con la sonda rimarrà in funzione PENDING finché il monitor non lo sarà. ACTIVE Questa operazione potrebbe richiedere alcuni minuti, dopodiché lo stato cambierà e potrai iniziare a ACTIVE visualizzare le CloudWatch metriche.

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}

Output:

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

Esempio 2: creare una sonda che utilizza una sonda utilizzando ICMP e aggiungerla a un monitor di rete

L'create-probeesempio seguente crea una sonda che utilizza ICMP protocol e aggiunge la sonda a un monitor denominato. Example_NetworkMonitor Una volta creato, il state monitor con la sonda rimarrà in funzione PENDING finché il monitor non lo sarà. ACTIVE Questa operazione potrebbe richiedere alcuni minuti, dopodiché lo stato cambierà e potrai iniziare a ACTIVE visualizzare le CloudWatch metriche.

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}

Output:

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

Per ulteriori informazioni, consulta Come funziona Amazon CloudWatch Network Monitor nella Amazon CloudWatch User Guide.

Il seguente esempio di codice mostra come utilizzaredelete-monitor.

AWS CLI

Per eliminare un monitor

L'delete-monitoresempio seguente elimina un monitor denominatoExample_NetworkMonitor.

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

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Come funziona Amazon CloudWatch Network Monitor nella Amazon CloudWatch User Guide.

Il seguente esempio di codice mostra come utilizzaredelete-probe.

AWS CLI

Per eliminare una sonda

L'delete-probeesempio seguente elimina una sonda con l'ID probe-12345 da un monitor di rete denominato. Example_NetworkMonitor

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

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Come funziona Amazon CloudWatch Network Monitor nella Amazon CloudWatch User Guide.

Il seguente esempio di codice mostra come utilizzareget-monitor.

AWS CLI

Per ottenere informazioni sul monitor

L'get-monitoresempio seguente ottiene informazioni su un monitor denominatoExample_NetworkMonitor.

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

Output:

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

Per ulteriori informazioni, consulta Come funziona Amazon CloudWatch Network Monitor nella Amazon CloudWatch User Guide.

Il seguente esempio di codice mostra come utilizzareget-probe.

AWS CLI

Per visualizzare i dettagli della sonda

L'get-probeesempio seguente restituisce i dettagli su una sonda con probeID probe-12345 il nome associato a un monitor. Example_NetworkMonitor

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

Output:

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

Per ulteriori informazioni, consulta Come funziona Amazon CloudWatch Network Monitor nella Amazon CloudWatch User Guide.

Il seguente esempio di codice mostra come utilizzarelist-monitors.

AWS CLI

Esempio 1: Per elencare tutti i monitor (monitor singolo)

L'list-monitorsesempio seguente restituisce un elenco di un solo monitor. Il monitor state è ACTIVE e ha una durata aggregationPeriod di 60 secondi.

aws networkmonitor list-monitors

Output:

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

Per ulteriori informazioni, consulta Come funziona Amazon CloudWatch Network Monitor nella Amazon CloudWatch User Guide.

Esempio 2: per elencare tutti i monitor (più monitor)

L'list-monitorsesempio seguente restituisce un elenco di tre monitor. La funzione state di un monitor è ACTIVE e la generazione di CloudWatch metriche. Gli stati degli altri due monitor sono INACTIVE e non CloudWatch generano metriche. Tutti e tre i monitor utilizzano 60 secondiaggregationPeriod.

aws networkmonitor list-monitors

Output:

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

Per ulteriori informazioni, consulta Come funziona Amazon CloudWatch Network Monitor nella Amazon CloudWatch User Guide.

Il seguente esempio di codice mostra come utilizzarelist-tags-for-resource.

AWS CLI

Per elencare i tag di una risorsa

L'list-tags-for-resourceesempio seguente restituisce un elenco dei tag per un monitor denominatoExample_NetworkMonitor.

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

Output:

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

Per ulteriori informazioni, consulta Come funziona Amazon CloudWatch Network Monitor nella Amazon CloudWatch User Guide.

Il seguente esempio di codice mostra come utilizzaretag-resource.

AWS CLI

Per etichettare una risorsa

L'tag-resourceesempio seguente etichetta un monitor denominato Example_NetworkMonitor con Application=PetStore tag Environment=Dev e.

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

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Come funziona Amazon CloudWatch Network Monitor nella Amazon CloudWatch User Guide.

Il seguente esempio di codice mostra come utilizzareuntag-resource.

AWS CLI

Per rimuovere i tag da una risorsa

L'untag-resourceesempio seguente rimuove un tag-keys parametro con la coppia chiave-valore di Environment Application dalla sua associazione a un monitor denominato. Example_NetworkMonitor

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

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Come funziona Amazon CloudWatch Network Monitor nella Amazon CloudWatch User Guide.

Il seguente esempio di codice mostra come utilizzareupdate-monitor.

AWS CLI

Per aggiornare un monitor

L'update-monitoresempio seguente modifica il valore di un monitor aggregationPeriod da 60 secondi a 30 secondi.

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

Output:

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

Per ulteriori informazioni, consulta Come funziona Amazon CloudWatch Network Monitor nella Amazon CloudWatch User Guide.

Il seguente esempio di codice mostra come utilizzareupdate-probe.

AWS CLI

Per aggiornare una sonda

L'update-probeesempio seguente aggiorna l'indirizzo destination IP originale di una sonda e aggiorna anche ilpacketSize. 60

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

Output:

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

Per ulteriori informazioni, consulta Come funziona Amazon CloudWatch Network Monitor nella Amazon CloudWatch User Guide.