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 *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.
**Topics**
+ [Azioni](#actions)
## Azioni
### `create-monitor`
Il seguente esempio di codice 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](https://docs.aws.amazon.com/cli/latest/reference/networkmonitor/update-monitor.html) o [create-probe](https://docs.aws.amazon.com/cli/latest/reference/networkmonitor/create-probe.html) 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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/nw-monitor-how-it-works.html) 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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/nw-monitor-how-it-works.html) 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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/nw-monitor-how-it-works.html) nella *Amazon CloudWatch User Guide*.
+ Per i dettagli sull'API, consulta [CreateMonitor AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmonitor/create-monitor.html)*Command Reference*.
### `create-probe`
Il seguente esempio di codice 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`. 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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/nw-monitor-how-it-works.html) nella *Amazon CloudWatch User Guide*.
+ Per i dettagli sull'API, consulta [CreateProbe AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmonitor/create-probe.html)*Command Reference*.
### `delete-monitor`
Il seguente esempio di codice 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 [How CloudWatch Network Monitor Works](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/nw-monitor-how-it-works.html) nella *Amazon CloudWatch User Guide*.
+ Per i dettagli sull'API, consulta [DeleteMonitor AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmonitor/delete-monitor.html)*Command Reference*.
### `delete-probe`
Il seguente esempio di codice 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 [How CloudWatch Network Monitor Works](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/nw-monitor-how-it-works.html) nella *Amazon CloudWatch User Guide*.
+ Per i dettagli sull'API, consulta [DeleteProbe AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmonitor/delete-probe.html)*Command Reference*.
### `get-monitor`
Il seguente esempio di codice 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 [How CloudWatch Network Monitor Works](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/nw-monitor-how-it-works.html) nella *Amazon CloudWatch User Guide*.
+ Per i dettagli sull'API, consulta [GetMonitor AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmonitor/get-monitor.html)*Command Reference*.
### `get-probe`
Il seguente esempio di codice 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 [How CloudWatch Network Monitor Works](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/nw-monitor-how-it-works.html) nella *Amazon CloudWatch User Guide*.
+ Per i dettagli sull'API, consulta [GetProbe AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmonitor/get-probe.html)*Command Reference*.
### `list-monitors`
Il seguente esempio di codice 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 [How CloudWatch Network Monitor Works](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/nw-monitor-how-it-works.html) 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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/nw-monitor-how-it-works.html) nella *Amazon CloudWatch User Guide*.
+ Per i dettagli sull'API, consulta [ListMonitors AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmonitor/list-monitors.html)*Command Reference*.
### `list-tags-for-resource`
Il seguente esempio di codice 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 [How CloudWatch Network Monitor Works](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/nw-monitor-how-it-works.html) nella *Amazon CloudWatch User Guide*.
+ Per i dettagli sull'API, consulta [ListTagsForResource AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmonitor/list-tags-for-resource.html)*Command Reference*.
### `tag-resource`
Il seguente esempio di codice 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 [How CloudWatch Network Monitor Works](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/nw-monitor-how-it-works.html) nella *Amazon CloudWatch User Guide*.
+ Per i dettagli sull'API, consulta [TagResource AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmonitor/tag-resource.html)*Command Reference*.
### `untag-resource`
Il seguente esempio di codice 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 [How CloudWatch Network Monitor Works](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/nw-monitor-how-it-works.html) nella *Amazon CloudWatch User Guide*.
+ Per i dettagli sull'API, consulta [UntagResource AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmonitor/untag-resource.html)*Command Reference*.
### `update-monitor`
Il seguente esempio di codice 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 [How CloudWatch Network Monitor Works](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/nw-monitor-how-it-works.html) nella *Amazon CloudWatch User Guide*.
+ Per i dettagli sull'API, consulta [UpdateMonitor AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmonitor/update-monitor.html)*Command Reference*.
### `update-probe`
Il seguente esempio di codice 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 [How CloudWatch Network Monitor Works](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/nw-monitor-how-it-works.html) nella *Amazon CloudWatch User Guide*.
+ Per i dettagli sull'API, consulta [UpdateProbe AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/networkmonitor/update-probe.html)*Command Reference*.