Esempi di utilizzo della CLI con Monitor Internet
Questa sezione include esempi di utilizzo della AWS Command Line Interface con le operazioni di Monitor Internet.
Prima di iniziare, assicurati di effettuare l'accesso per utilizzare la AWS CLI con lo stesso account AWS contenente i VPC Amazon, i Network Load Balancer, le distribuzioni Amazon CloudFront o le directory Amazon WorkSpaces da monitorare. Monitor Internet non supporta l'accesso alle risorse tra account. Per ulteriori informazioni sull'utilizzo di AWS CLI, consulta la Guida di riferimento ai comandi della AWS CLI. Per ulteriori informazioni sull'utilizzo delle operazioni API con Monitor Internet, consulta la documentazione di riferimento alle API di Monitor Internet.
Argomenti
Creazione di un monitoraggio
Durante la creazione di un monitoraggio in Monitor Internet, indica un nome e associa le risorse al monitoraggio per mostrare dove si trova il traffico Internet dell'applicazione. Specifica una percentuale di traffico che definisce la quantità di traffico dell'applicazione monitorata. Ciò determina anche il numero di reti urbane, ovvero le posizioni dei client e gli ASN, in genere provider di servizi Internet o ISP, che vengono monitorati. Per tenere sotto controllo la fattura, puoi anche impostare un limite per il numero massimo di reti urbane da monitorare per le risorse dell'applicazione. Per ulteriori informazioni, consulta Scelta di un limite massimo per le reti urbane.
Infine, puoi decidere se pubblicare tutte le misurazioni Internet per la tua applicazione su Amazon S3. Le misurazioni Internet per le prime 500 reti urbane (per volume di traffico) vengono pubblicate automaticamente su File di log CloudWatch da Monitor Internet, ma puoi decidere di pubblicare tutte le misurazioni anche su S3.
Per creare un monitor con la AWS CLI, utilizza il comando create-monitor. Il comando seguente crea un monitor che monitora il 100% del traffico ma imposta un limite massimo di 10.000 reti urbane, aggiunge una risorsa VPC e sceglie di pubblicare misurazioni Internet su Amazon S3.
Nota
Monitor Internet pubblica le misurazioni di Internet di File di log CloudWatch ogni cinque minuti per le 500 principali reti urbane (posizioni dei client e ASN, in genere provider di servizi Internet o ISP) che inviano traffico a ciascun monitor. Facoltativamente, puoi decidere di pubblicare misurazioni ed eventi Internet per tutte le reti urbane monitorate (fino al limite di servizio di 500.000 reti urbane) in un bucket Amazon S3. Per ulteriori informazioni, consulta Pubblicazione delle misurazioni Internet su Amazon S3 in Monitor Internet.
aws internetmonitor create-monitor --monitor-name "TestMonitor" \ --traffic-percentage-to-monitor 100 \ --max-city-networks-to-monitor 10000 \ --resources "arn:aws:ec2:us-east-1:111122223333:vpc/vpc-11223344556677889" \ --internet-measurements-log-delivery S3Config="{BucketName=amzn-s3-demo-bucket,LogDeliveryStatus=ENABLED}"
{ "Arn": "arn:aws:internetmonitor:us-east-1:111122223333:monitor/TestMonitor", "Status": "ACTIVE" }
Nota
Non puoi modificare il nome di un monitor.
Visualizzare i dettagli del monitoraggio
Per visualizzare le informazioni relative a un monitor con AWS CLI, utilizza il comando get-monitor.
aws internetmonitor get-monitor --monitor-name "TestMonitor"
{ "ClientLocationType": "city", "CreatedAt": "2022-09-22T19:27:47Z", "ModifiedAt": "2022-09-22T19:28:30Z", "MonitorArn": "arn:aws:internetmonitor:us-east-1:111122223333:monitor/TestMonitor", "MonitorName": "TestMonitor", "ProcessingStatus": "OK", "ProcessingStatusInfo": "The monitor is actively processing data", "Resources": [ "arn:aws:ec2:us-east-1:111122223333:vpc/vpc-11223344556677889" ], "MaxCityNetworksToMonitor": 10000, "Status": "ACTIVE" }
Elenco degli eventi di stato
Quando le prestazioni del traffico Internet dell'applicazione peggiorano, Monitor Internet crea eventi di stato all'interno del monitoraggio. Per visualizzare un elenco degli eventi di integrità attuali con AWS CLI, utilizza il comando list-health-events.
aws internetmonitor list-health-events --monitor-name "TestMonitor"
{ "HealthEvents": [ { "EventId": "2022-06-20T01-05-05Z/latency", "Status": "RESOLVED", "EndedAt": "2022-06-20T01:15:14Z", "ServiceLocations": [ { "Name": "us-east-1" } ], "PercentOfTotalTrafficImpacted": 1.21, "ClientLocations": [ { "City": "Lockport", "PercentOfClientLocationImpacted": 60.370000000000005, "PercentOfTotalTraffic": 2.01, "Country": "United States", "Longitude": -78.6913, "AutonomousSystemNumber": 26101, "Latitude": 43.1721, "Subdivision": "New York", "NetworkName": "YAHOO-BF1" } ], "StartedAt": "2022-06-20T01:05:05Z", "ImpactType": "PERFORMANCE", "EventArn": "arn:aws:internetmonitor:us-east-1:111122223333:monitor/TestMonitor/health-event/2022-06-20T01-05-05Z/latency" }, { "EventId": "2022-06-20T01-17-56Z/latency", "Status": "RESOLVED", "EndedAt": "2022-06-20T01:30:23Z", "ServiceLocations": [ { "Name": "us-east-1" } ], "PercentOfTotalTrafficImpacted": 1.29, "ClientLocations": [ { "City": "Toronto", "PercentOfClientLocationImpacted": 75.32, "PercentOfTotalTraffic": 1.05, "Country": "Canada", "Longitude": -79.3623, "AutonomousSystemNumber": 14061, "Latitude": 43.6547, "Subdivision": "Ontario", "CausedBy": { "Status": "ACTIVE", "Networks": [ { "AutonomousSystemNumber": 16509, "NetworkName": "Amazon.com" } ], "NetworkEventType": "AWS" }, "NetworkName": "DIGITALOCEAN-ASN" }, { "City": "Lockport", "PercentOfClientLocationImpacted": 22.91, "PercentOfTotalTraffic": 2.01, "Country": "United States", "Longitude": -78.6913, "AutonomousSystemNumber": 26101, "Latitude": 43.1721, "Subdivision": "New York", "NetworkName": "YAHOO-BF1" }, { "City": "Hangzhou", "PercentOfClientLocationImpacted": 2.88, "PercentOfTotalTraffic": 0.7799999999999999, "Country": "China", "Longitude": 120.1612, "AutonomousSystemNumber": 37963, "Latitude": 30.2994, "Subdivision": "Zhejiang", "NetworkName": "Hangzhou Alibaba Advertising Co.,Ltd." } ], "StartedAt": "2022-06-20T01:17:56Z", "ImpactType": "PERFORMANCE", "EventArn": "arn:aws:internetmonitor:us-east-1:111122223333:monitor/TestMonitor/health-event/2022-06-20T01-17-56Z/latency" }, { "EventId": "2022-06-20T01-34-20Z/latency", "Status": "RESOLVED", "EndedAt": "2022-06-20T01:35:04Z", "ServiceLocations": [ { "Name": "us-east-1" } ], "PercentOfTotalTrafficImpacted": 1.15, "ClientLocations": [ { "City": "Lockport", "PercentOfClientLocationImpacted": 39.45, "PercentOfTotalTraffic": 2.01, "Country": "United States", "Longitude": -78.6913, "AutonomousSystemNumber": 26101, "Latitude": 43.1721, "Subdivision": "New York", "NetworkName": "YAHOO-BF1" }, { "City": "Toronto", "PercentOfClientLocationImpacted": 29.770000000000003, "PercentOfTotalTraffic": 1.05, "Country": "Canada", "Longitude": -79.3623, "AutonomousSystemNumber": 14061, "Latitude": 43.6547, "Subdivision": "Ontario", "CausedBy": { "Status": "ACTIVE", "Networks": [ { "AutonomousSystemNumber": 16509, "NetworkName": "Amazon.com" } ], "NetworkEventType": "AWS" }, "NetworkName": "DIGITALOCEAN-ASN" }, { "City": "Hangzhou", "PercentOfClientLocationImpacted": 2.88, "PercentOfTotalTraffic": 0.7799999999999999, "Country": "China", "Longitude": 120.1612, "AutonomousSystemNumber": 37963, "Latitude": 30.2994, "Subdivision": "Zhejiang", "NetworkName": "Hangzhou Alibaba Advertising Co.,Ltd." } ], "StartedAt": "2022-06-20T01:34:20Z", "ImpactType": "PERFORMANCE", "EventArn": "arn:aws:internetmonitor:us-east-1:111122223333:monitor/TestMonitor/health-event/2022-06-20T01-34-20Z/latency" } ] }
Visualizzazione di un evento di stato specifico
Per visualizzare informazioni più dettagliate su uno specifico evento di stato con la CLI, esegui il comando get-health-event con il nome del monitoraggio e l'ID dell'evento di stato.
aws internetmonitor get-monitor --monitor-name "TestMonitor" --event-id "health-event/TestMonitor/2021-06-03T01:02:03Z/latency"
{ "EventId": "2022-06-20T01-34-20Z/latency", "Status": "RESOLVED", "EndedAt": "2022-06-20T01:35:04Z", "ServiceLocations": [ { "Name": "us-east-1" } ], "EventArn": "arn:aws:internetmonitor:us-east-1:111122223333:monitor/TestMonitor/health-event/2022-06-20T01-34-20Z/latency", "LastUpdatedAt": "2022-06-20T01:35:04Z", "ClientLocations": [ { "City": "Lockport", "PercentOfClientLocationImpacted": 39.45, "PercentOfTotalTraffic": 2.01, "Country": "United States", "Longitude": -78.6913, "AutonomousSystemNumber": 26101, "Latitude": 43.1721, "Subdivision": "New York", "NetworkName": "YAHOO-BF1" }, { "City": "Toronto", "PercentOfClientLocationImpacted": 29.770000000000003, "PercentOfTotalTraffic": 1.05, "Country": "Canada", "Longitude": -79.3623, "AutonomousSystemNumber": 14061, "Latitude": 43.6547, "Subdivision": "Ontario", "CausedBy": { "Status": "ACTIVE", "Networks": [ { "AutonomousSystemNumber": 16509, "NetworkName": "Amazon.com" } ], "NetworkEventType": "AWS" }, "NetworkName": "DIGITALOCEAN-ASN" }, { "City": "Shenzhen", "PercentOfClientLocationImpacted": 4.07, "PercentOfTotalTraffic": 0.61, "Country": "China", "Longitude": 114.0683, "AutonomousSystemNumber": 37963, "Latitude": 22.5455, "Subdivision": "Guangdong", "NetworkName": "Hangzhou Alibaba Advertising Co.,Ltd." }, { "City": "Hangzhou", "PercentOfClientLocationImpacted": 2.88, "PercentOfTotalTraffic": 0.7799999999999999, "Country": "China", "Longitude": 120.1612, "AutonomousSystemNumber": 37963, "Latitude": 30.2994, "Subdivision": "Zhejiang", "NetworkName": "Hangzhou Alibaba Advertising Co.,Ltd." } ], "StartedAt": "2022-06-20T01:34:20Z", "ImpactType": "PERFORMANCE", "PercentOfTotalTrafficImpacted": 1.15 }
Visualizzazione dell'elenco dei monitoraggi
Per visualizzare un elenco di tutti i monitoraggi del tuo account con la CLI, esegui il comando list-monitors.
aws internetmonitor list-monitors
{ "Monitors": [ { "MonitorName": "TestMonitor", "ProcessingStatus": "OK", "Status": "ACTIVE" } ], "NextToken": " zase12" }
Modifica del monitoraggio
Per aggiornare le informazioni relative al monitoraggio utilizzando la CLI, usa il comando update-monitor e specifica il nome del monitoraggio da aggiornare. Ad esempio, puoi aggiornare la percentuale di traffico da monitorare, il limite del numero massimo di reti urbane da monitorare, aggiungere o rimuovere le risorse che Monitor Internet utilizza per monitorare il traffico e modificare lo stato del monitor da ACTIVE a INACTIVE o viceversa. Tieni presente che non puoi modificare il nome del monitoraggio.
La risposta a una chiamata update-monitor restituisce solo il MonitorArn e il Status.
L'esempio seguente mostra come utilizzare il comando update-monitor per modificare il numero massimo di reti urbane per monitorare in 50000:
aws internetmonitor update-monitor --monitor-name "TestMonitor" --max-city-networks-to-monitor 50000
{ "MonitorArn": "arn:aws:internetmonitor:us-east-1:111122223333:monitor/TestMonitor", "Status": " ACTIVE " }
L'esempio seguente mostra come aggiungere e rimuovere risorse:
aws internetmonitor update-monitor --monitor-name "TestMonitor" \ --resources-to-add "arn:aws:ec2:us-east-1:111122223333:vpc/vpc-11223344556677889" \ --resources-to-remove "arn:aws:ec2:us-east-1:111122223333:vpc/vpc-2222444455556666"
{ "MonitorArn": "arn:aws:internetmonitor:us-east-1:111122223333:monitor/TestMonitor", "Status": "ACTIVE" }
L'esempio seguente mostra come utilizzare il comando update-monitor per modificare lo stato del monitoraggio in INACTIVE:
aws internetmonitor update-monitor --monitor-name "TestMonitor" --status "INACTIVE"
{ "MonitorArn": "arn:aws:internetmonitor:us-east-1:111122223333:monitor/TestMonitor", "Status": "INACTIVE" }
Eliminazione del monitoraggio
Puoi eliminare un monitoraggio con la CLI tramite il comando delete-monitor. Innanzitutto, imposta il monitoraggio come inattivo. Per eseguire questa operazione, usa il comando update-monitor per modificare lo stato in INACTIVE. Verifica che il monitoraggio sia inattivo controllandone lo stato tramite il comando get-monitor.
Quando lo stato del monitoraggio è INACTIVE, puoi utilizzare la CLI per eseguire il comando delete-monitor ed eliminare così il monitoraggio. La risposta per una chiamata delete-monitor riuscita è vuota.
aws internetmonitor delete-monitor --monitor-name "TestMonitor"
{}
