Esempi per il Monitoraggio di rete CloudWatch con AWS CLI

Negli esempi di codice seguenti viene mostrato come eseguire operazioni e implementare scenari comuni utilizzando AWS Command Line Interface con il Monitoraggio di rete CloudWatch.

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 link al codice sorgente completo, dove è possibile trovare le istruzioni su come configurare ed eseguire il codice nel contesto.

Argomenti

Operazioni

Operazioni

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

AWS CLI

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

Nell’esempio seguente create-monitor crea un monitoraggio denominato Example_NetworkMonitor con aggregationPeriod impostato su 30 secondi. Lo 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 How Amazon CloudWatch Network Monitor Works nella Guida per l’utente di Amazon CloudWatch.

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

Nell’esempio seguente create-monitor crea un monitoraggio 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 aggregationPeriod, i 60 secondi sono impostati come valore predefinito. Lo 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 How Amazon CloudWatch Network Monitor Works nella Guida per l’utente di Amazon CloudWatch.

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

Nell’esempio seguente create-monitor crea un monitoraggio 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 aggregationPeriod, i 60 secondi sono impostati come valore predefinito. Lo 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 How Amazon CloudWatch Network Monitor Works nella Guida per l’utente di Amazon CloudWatch.

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

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

AWS CLI

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

Nell’esempio seguente create-probe crea una sonda con protocol impostato su TCP e aggiunge la sonda a un monitoraggio denominato Example_NetworkMonitor. Una volta creato, lo 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-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 ICMP e aggiungerla a un monitoraggio di rete

Nell’esempio seguente create-probe crea una sonda con protocol impostato su ICMP e aggiunge la sonda a un monitoraggio denominato Example_NetworkMonitor. Una volta creato, lo 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-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 How Amazon CloudWatch Network Monitor Works 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 monitor

Nell’esempio seguente delete-monitor elimina un monitoraggio denominato Example_NetworkMonitor.


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

Questo comando non produce alcun output.

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

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

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

AWS CLI

Come eliminare una sonda

Nell’esempio seguente delete-probe elimina una sonda con l’ID probe-12345 da un monitoraggio 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 How Amazon CloudWatch Network Monitor Works 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

Nell’esempio seguente get-monitor ottiene informazioni su un monitoraggio 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 How Amazon CloudWatch Network Monitor Works nella Guida per l’utente di Amazon CloudWatch.

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

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

AWS CLI

Come visualizzare i dettagli della sonda

Nell’esempio seguente get-probe restituisce i dettagli su una sonda con probeID probe-12345 associata a un monitoraggio 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 How Amazon CloudWatch Network Monitor Works 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: elencare tutti i monitoraggi (monitoraggio singolo)

Nell’esempio seguente list-monitors restituisce un elenco di un solo monitoraggio. Lo state del monitoraggio è ACTIVE e ha un 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 How Amazon CloudWatch Network Monitor Works nella Guida per l’utente di Amazon CloudWatch.

Esempio 2: elencare tutti i monitoraggi (monitoraggi multipli)

Nell’esempio seguente list-monitors restituisce un elenco di tre monitoraggi. Lo 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 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 How Amazon CloudWatch Network Monitor Works nella Guida per l’utente di Amazon CloudWatch.

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

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

AWS CLI

Come elencare i tag per una risorsa

Nell’esempio seguente list-tags-for-resource restituisce un elenco di tag per un monitoraggio 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 How Amazon CloudWatch Network Monitor Works 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 aggiungere un tag a una risorsa

Nell’esempio seguente tag-resource tagga un monitoraggio 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 How Amazon CloudWatch Network Monitor Works nella Guida per l’utente di Amazon CloudWatch.

Per informazioni dettagliate sulle API, consulta TagResource nel Riferimento ai comandi AWS CLI.

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

AWS CLI

Come rimuovere un tag da una risorsa

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

Per i dettagli dell'API, consulta UntagResource in Riferimento ai comandi della AWS CLI.

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

AWS CLI

Come creare un monitoraggio

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


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

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

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

AWS CLI

Come aggiornare una sonda

Nell’esempio seguente update-probe 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 How Amazon CloudWatch Network Monitor Works nella Guida per l’utente di Amazon CloudWatch.

Per ulteriori informazioni 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