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à.
Esempi di utilizzo della CLI con Internet Monitor
Questa sezione include esempi per l'utilizzo delle operazioni AWS Command Line Interface con Internet Monitor.
Prima di iniziare, assicurati di accedere per utilizzarlo AWS CLI con lo stesso AWS account su cui sono presenti Amazon Virtual Private Clouds (VPCs), Network Load Balancers, CloudFront le distribuzioni Amazon o le WorkSpaces directory Amazon che desideri monitorare. Monitor Internet non supporta l'accesso alle risorse tra account. Per ulteriori informazioni sull'utilizzo di AWS CLI, consulta il Command Reference.AWS CLI Per ulteriori informazioni sull'utilizzo delle azioni API con Internet Monitor, consulta la Guida di riferimento dell'API di Internet Monitor.
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 ubicazioni dei clienti e, in genere ASNs, i provider di servizi Internet o ISPs, 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 Scegliete un limite massimo per le reti cittadine.
Infine, puoi decidere se pubblicare tutte le misurazioni Internet per la tua applicazione su Amazon S3. Le misurazioni Internet per le 500 principali reti urbane (per volume di traffico) vengono pubblicate automaticamente in CloudWatch Logs by Internet Monitor, ma puoi scegliere di pubblicare tutte le misurazioni anche su S3.
Per creare un monitor con AWS CLI, si usa 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
Internet Monitor pubblica su CloudWatch Logs le misurazioni Internet ogni cinque minuti per le 500 principali reti cittadine (sedi dei clienti e ASNs, in genere, provider di servizi Internet o ISPs) 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 Pubblica misurazioni Internet su Amazon S3 in Internet Monitor.
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 su un monitor con AWS CLI, si usa 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 sanitari in corso con AWS CLI, utilizzare il list-health-events comando
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, è possibile aggiornare la percentuale di traffico da monitorare, il limite del numero massimo di reti urbane da monitorare, aggiungere o rimuovere le risorse utilizzate da Internet Monitor per monitorare il traffico e modificare lo stato del monitoraggio 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"
{}
