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 azioni sono estratti di codice da programmi più grandi e devono essere eseguite nel contesto. Sebbene le azioni 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

Il seguente esempio di codice mostra come utilizzarecreate-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 How CloudWatch Network Monitor Works nella Amazon CloudWatch User Guide.

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. 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 How CloudWatch Network Monitor Works nella Amazon CloudWatch User Guide.

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. 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 How CloudWatch Network Monitor Works nella Amazon CloudWatch User Guide.

Per i dettagli sull'API, consulta CreateMonitor AWS CLICommand Reference.

Il seguente esempio di codice mostra come utilizzarecreate-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. 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: 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. 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 How CloudWatch Network Monitor Works nella Amazon CloudWatch User Guide.

Per i dettagli sull'API, consulta CreateProbe AWS CLICommand Reference.

Il seguente esempio di codice mostra come utilizzaredelete-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 How CloudWatch Network Monitor Works nella Amazon CloudWatch User Guide.

Per i dettagli sull'API, consulta DeleteMonitor AWS CLICommand Reference.

Il seguente esempio di codice mostra come utilizzaredelete-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 How CloudWatch Network Monitor Works nella Amazon CloudWatch User Guide.

Per i dettagli sull'API, consulta DeleteProbe AWS CLICommand Reference.

Il seguente esempio di codice mostra come utilizzareget-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 How CloudWatch Network Monitor Works nella Amazon CloudWatch User Guide.

Per i dettagli sull'API, consulta GetMonitor AWS CLICommand Reference.

Il seguente esempio di codice mostra come utilizzareget-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 How CloudWatch Network Monitor Works nella Amazon CloudWatch User Guide.

Per i dettagli sull'API, consulta GetProbe AWS CLICommand Reference.

Il seguente esempio di codice mostra come utilizzarelist-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 How CloudWatch Network Monitor Works nella Amazon CloudWatch User Guide.

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

L’esempio list-monitors seguente restituisce un elenco di tre monitor. Il risultato state di un unico monitor è ACTIVE la generazione di CloudWatch metriche. Gli stati degli altri due monitor sono INACTIVE e non CloudWatch generano metriche. 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 How CloudWatch Network Monitor Works nella Amazon CloudWatch User Guide.

Per i dettagli sull'API, consulta ListMonitors AWS CLICommand Reference.

Il seguente esempio di codice mostra come utilizzarelist-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 How CloudWatch Network Monitor Works nella Amazon CloudWatch User Guide.

Per i dettagli sull'API, consulta ListTagsForResource AWS CLICommand Reference.

Il seguente esempio di codice mostra come utilizzaretag-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 How CloudWatch Network Monitor Works nella Amazon CloudWatch User Guide.

Per i dettagli sull'API, consulta TagResource AWS CLICommand Reference.

Il seguente esempio di codice mostra come utilizzareuntag-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 How CloudWatch Network Monitor Works nella Amazon CloudWatch User Guide.

Per i dettagli sull'API, consulta UntagResource AWS CLICommand Reference.

Il seguente esempio di codice mostra come utilizzareupdate-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 How CloudWatch Network Monitor Works nella Amazon CloudWatch User Guide.

Per i dettagli sull'API, consulta UpdateMonitor AWS CLICommand Reference.

Il seguente esempio di codice mostra come utilizzareupdate-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 How CloudWatch Network Monitor Works nella Amazon CloudWatch User Guide.

Per i dettagli sull'API, consulta UpdateProbe AWS CLICommand 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

CloudWatch Registri

CloudWatch Observability Access Monitor