Esempi per CloudWatch Network Monitoring con AWS CLI

Gli esempi di codice seguenti mostrano come eseguire operazioni e implementare scenari comuni utilizzando AWS Command Line Interface con CloudWatch Network Monitoring.

Le azioni 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 link al codice sorgente completo, in cui vengono fornite le istruzioni su come configurare ed eseguire il codice nel contesto.

Argomenti

Azioni

Azioni

L’esempio di codice seguente mostra come utilizzare create-monitor.

AWS CLI

Esempio 1: come creare un monitoraggio di rete con un periodo di aggregazione

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


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 Funzionamento di Amazon CloudWatch Network Monitor nella Guida per l’utente di Amazon CloudWatch.

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

L’esempio create-monitor seguente crea un monitor denominato Example_NetworkMonitor. Il comando crea inoltre una sonda che utilizza il protocollo ICMP e include dei tag. Poiché nella richiesta non viene passato nessun valore aggregationPeriod, come valore predefinito sono impostati 60 secondi. Il valore state del monitoraggio con la sonda rimarrà PENDING finché il monitoraggio rimane ACTIVE. L’operazione potrebbe richiedere alcuni minuti, a quel punto state diventerà ACTIVE e potrai iniziare a visualizzare le metriche di CloudWatch.


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 Funzionamento di Amazon CloudWatch Network Monitor nella Guida per l’utente di Amazon CloudWatch.

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

L’esempio create-monitor seguente crea un monitor denominato Example_NetworkMonitor con aggregationPeriod impostato su 30 secondi. Il comando crea inoltre una sonda che utilizza il protocollo ICMP e include dei tag. Poiché nella richiesta non viene passato nessun valore aggregationPeriod, come valore predefinito sono impostati 60 secondi. Il valore state del monitoraggio con la sonda rimarrà PENDING finché il monitoraggio rimane ACTIVE. L’operazione potrebbe richiedere alcuni minuti, a quel punto state diventerà ACTIVE e potrai iniziare a visualizzare le metriche di CloudWatch.


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 Funzionamento di Amazon CloudWatch Network Monitor nella Guida per l’utente di Amazon CloudWatch.

Per informazioni dettagliate sull’API, consulta CreateMonitor nella documentazione di riferimento dei comandi della AWS CLI.

L’esempio di codice seguente mostra come utilizzare create-probe.

AWS CLI

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

L’esempio create-probe seguente crea una sonda con protocol impostato su TCP e aggiunge la sonda a un monitor denominato Example_NetworkMonitor. Una volta creato, il valore state del monitoraggio con la sonda rimarrà PENDING finché il monitoraggio rimane ACTIVE. L’operazione potrebbe richiedere alcuni minuti, a quel punto il valore state diventerà ACTIVE e potrai iniziare a visualizzare le metriche di CloudWatch.


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: come creare una sonda che utilizza ICMP e aggiungerla a un monitoraggio di rete

L’esempio create-probe seguente crea una sonda con protocol impostato su ICMP e aggiunge la sonda a un monitor denominato Example_NetworkMonitor. Una volta creato, il valore state del monitoraggio con la sonda rimarrà PENDING finché il monitoraggio rimane ACTIVE. L’operazione potrebbe richiedere alcuni minuti, a quel punto il valore state diventerà ACTIVE e potrai iniziare a visualizzare le metriche di CloudWatch.


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 Funzionamento di Amazon CloudWatch Network Monitor nella Guida per l’utente di Amazon CloudWatch.

Per informazioni dettagliate sull’API, consulta CreateProbe in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare delete-monitor.

AWS CLI

Come eliminare un monitoraggio

L’esempio delete-monitor seguente elimina un monitor denominato Example_NetworkMonitor.


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

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Funzionamento di Amazon CloudWatch Network Monitor nella Guida per l’utente di Amazon CloudWatch.

Per informazioni dettagliate sull’API, consulta DeleteMonitor nella documentazione di riferimento dei comandi della AWS CLI.

L’esempio di codice seguente mostra come utilizzare delete-probe.

AWS CLI

Come eliminare una sonda

L’esempio delete-probe 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 Funzionamento di Amazon CloudWatch Network Monitor nella Guida per l’utente di Amazon CloudWatch.

Per informazioni dettagliate sull’API, consulta DeleteProbe in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare get-monitor.

AWS CLI

Come ottenere informazioni sul monitoraggio

L’esempio get-monitor seguente ottiene informazioni su un monitor denominato Example_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 Funzionamento di Amazon CloudWatch Network Monitor nella Guida per l’utente di Amazon CloudWatch.

Per informazioni dettagliate sull’API, consulta GetMonitor nella documentazione di riferimento dei comandi della AWS CLI.

L’esempio di codice seguente mostra come utilizzare get-probe.

AWS CLI

Come visualizzare i dettagli della sonda

L’esempio get-probe seguente restituisce i dettagli su una sonda con probeID probe-12345 associata 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 Funzionamento di Amazon CloudWatch Network Monitor nella Guida per l’utente di Amazon CloudWatch.

Per informazioni dettagliate sull’API, consulta GetProbe in AWS CLI Command Reference.

L’esempio di codice seguente mostra come utilizzare list-monitors.

AWS CLI

Esempio 1: come elencare tutti i monitoraggi (monitoraggio singolo)

L’esempio list-monitors seguente restituisce un elenco contenente un solo monitor. Il valore state del monitoraggio è ACTIVE, con aggregationPeriod impostato su 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 Funzionamento di Amazon CloudWatch Network Monitor nella Guida per l’utente di Amazon CloudWatch.

Esempio 2: come elencare tutti i monitoraggi (monitoraggi multipli)

L’esempio list-monitors seguente restituisce un elenco di tre monitor. Il valore state di un monitoraggio è ACTIVE e genera metriche di CloudWatch. Gli stati degli altri due monitoraggi sono INACTIVE e non generano metriche di CloudWatch. Tutti e tre i monitoraggi utilizzano un valore aggregationPeriod di 60 secondi.


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 Funzionamento di Amazon CloudWatch Network Monitor nella Guida per l’utente di Amazon CloudWatch.

Per informazioni dettagliate sull’API, consulta ListMonitors nella documentazione di riferimento dei comandi della AWS CLI.

L’esempio di codice seguente mostra come utilizzare list-tags-for-resource.

AWS CLI

Come elencare i tag per una risorsa

L’esempio list-tags-for-resource seguente restituisce un elenco di tag per un monitor denominato Example_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 Funzionamento di Amazon CloudWatch Network Monitor nella Guida per l’utente di Amazon CloudWatch.

Per informazioni dettagliate sull’API, consulta ListTagsForResource nella documentazione di riferimento dei comandi della AWS CLI.

L’esempio di codice seguente mostra come utilizzare tag-resource.

AWS CLI

Come taggare a una risorsa

L’esempio tag-resource seguente tagga un monitor denominato Example_NetworkMonitor con i tag Environment=Dev e Application=PetStore.


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 Funzionamento di Amazon CloudWatch Network Monitor nella Guida per l’utente di Amazon CloudWatch.

Per informazioni dettagliate sull’API, consulta TagResource nella documentazione di riferimento dei comandi della AWS CLI.

L’esempio di codice seguente mostra come utilizzare untag-resource.

AWS CLI

Come rimuovere un tag da una risorsa

L’esempio untag-resource seguente rimuove un parametro tag-keys con la coppia chiave-valore Environment Application dalla relativa 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 Funzionamento di Amazon CloudWatch Network Monitor nella Guida per l’utente di Amazon CloudWatch.

Per informazioni dettagliate sull’API, consulta UntagResource nella documentazione di riferimento dei comandi della AWS CLI.

L’esempio di codice seguente mostra come utilizzare update-monitor.

AWS CLI

Come creare un monitoraggio

L’esempio update-monitor seguente modifica il valore aggregationPeriod da 60 secondi a 30 secondi per un monitor.


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 Funzionamento di Amazon CloudWatch Network Monitor nella Guida per l’utente di Amazon CloudWatch.

Per informazioni dettagliate sull’API, consulta UpdateMonitor nella documentazione di riferimento dei comandi della AWS CLI.

L’esempio di codice seguente mostra come utilizzare update-probe.

AWS CLI

Come aggiornare una sonda

L’esempio update-probe seguente aggiorna l’indirizzo IP destination originale di una sonda e aggiorna anche il valore packetSize impostandolo su 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 Funzionamento di Amazon CloudWatch Network Monitor nella Guida per l’utente di Amazon CloudWatch.

Per informazioni dettagliate sull’API, consulta UpdateProbe in AWS CLI Command Reference.

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

File di log CloudWatch

CloudWatch Observability Access Monitor