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à.
Un'opzione per comprendere meglio il traffico Internet AWS dell'applicazione consiste nell'utilizzare l'interfaccia di interrogazione di Internet Monitor. Per utilizzare l'interfaccia di interrogazione, crei una query con filtri di dati a tua scelta, quindi esegui la query per restituire un sottoinsieme dei dati di Monitor Internet. L'esplorazione dei dati restituiti dalla query può fornire informazioni sulle prestazioni dell'applicazione su Internet.
È possibile interrogare ed esplorare tutti i parametri acquisiti da Monitor Internet con il monitor, tra cui i punteggi di disponibilità e prestazioni, i byte trasferiti, i tempi di andata e ritorno e il time to first byte (TTFB).
Monitor Internet utilizza l'interfaccia di interrogazione per fornire i dati che è possibile esplorare nel pannello di controllo della console di Monitor Internet. Utilizzando le opzioni di ricerca nella dashboard, nella pagina Analizza o nella pagina Ottimizza, puoi interrogare e filtrare i dati Internet per la tua applicazione.
Se desideri una maggiore flessibilità per esplorare e filtrare i tuoi dati rispetto a quella fornita dalla dashboard, puoi utilizzare tu stesso l'interfaccia di interrogazione, utilizzando le operazioni dell'API Internet Monitor con o con un SDK. AWS Command Line Interface AWS Questa sezione presenta i tipi di query che puoi utilizzare con l'interfaccia di interrogazione e i filtri che puoi specificare per creare un sottoinsieme di dati al fine di ottenere approfondimenti sul traffico Internet per la tua applicazione.
Argomenti
Come utilizzare l'interfaccia di interrogazione
Per creare una query con l'interfaccia di interrogazione, è possibile scegliere un tipo di query e quindi specificare i valori di filtro per restituire uno specifico sottoinsieme desiderato dei dati del file di log. È quindi possibile lavorare con il sottoinsieme di dati, filtrarlo e ordinarlo ulteriormente, creare report e così via.
Il processo di query avviene in questo modo:
Quando si esegue una query, Monitor Internet restituisce un
query ID
univoco per la query. Questa sezione descrive i tipi di query disponibili e le opzioni per filtrare i dati nelle query. Per capire come funziona, puoi anche consultare la sezione sugli esempi di query.Specificate l'ID della query con il nome del monitor con l'operazione GetQueryResultsAPI per restituire i risultati dei dati per la query. Ogni tipo di query restituisce un set diverso di campi di dati. Per ulteriori informazioni, consulta la sezione Ottenimento dei risultati della query.
L'interfaccia di interrogazione fornisce i seguenti tipi di query. Ogni tipo di query restituisce un diverso set di informazioni sul traffico proveniente dai file di log, come illustrato.
Misurazioni: fornisce il punteggio di disponibilità, il punteggio delle prestazioni, il traffico totale e i tempi di andata e ritorno, a intervalli di 5 minuti.
Posizioni principali: fornisce il punteggio di disponibilità, il punteggio delle prestazioni, il traffico totale e le informazioni sul time-to-first byte (TTFB), per le principali combinazioni di località e ASN che stai monitorando, in base al volume di traffico.
Dettagli sulle sedi principali: fornisce TTFB per Amazon CloudFront, la tua configurazione attuale e la EC2 configurazione Amazon con le migliori prestazioni, a intervalli di 1 ora.
Suggerimenti generali sul traffico: fornisce TTFB, utilizzando una media ponderata di 30 giorni, per tutto il traffico in ogni località monitorata. AWS
Dettagli complessivi sui suggerimenti sul traffico: fornisce TTFB, utilizzando una media ponderata di 30 giorni, per ogni località principale, per una località proposta. AWS
Suggerimenti di routing: fornisce il tempo medio di andata e ritorno (RTT) previsto da un prefisso IP verso una posizione per un resolver DNS. AWS L'RTT viene calcolato a intervalli di un'ora, su un periodo di un'ora.
Puoi filtrare ulteriormente i dati utilizzando criteri specifici. Con la maggior parte dei tipi di query, ad eccezione dei suggerimenti di routing, è possibile filtrare specificando uno o più dei seguenti criteri:
AWS posizione: per AWS posizione, è possibile specificare CloudFront o Regione AWS, ad esempio.
us-east-2
ASN: Specificare il numero di sistema autonomo (ASN) di un resolver DNS (in genere un ISP), ad esempio 4225.
Posizione del client: per l'ubicazione, specifica una città, un'area metropolitana, una regione o un paese.
AWS Ubicazione proposta: specificare una Regione AWS, ad esempio, o una zona locale.
us-east-2
AWS Puoi utilizzare questo filtro con il tipo di query relativo ai dettagli generali sui suggerimenti sul traffico.Geo: specifica
geo
per alcune query. È necessario per le query che utilizzano il tipo di queryTop locations
, ma non è consentito per altri tipi di query. Per capire quando specificaregeo
per i parametri del filtro, consulta la sezione sugli esempi di query.
Per il tipo di query sui suggerimenti di routing, puoi filtrare maggiormente i dati specificando uno o più dei seguenti criteri:
AWS Posizione corrente: specificare un Regione AWS, ad esempio.
us-east-2
AWS Ubicazione proposta: specificare una Regione AWS, ad esempio
us-east-2
, o una zona AWS locale.IPv4 prefisso: Specificare un IPv4 prefisso nel formato standard, simile a.
192.0.2.0/24
ARN di monitoraggio: Specificare l'ARN per un monitor specifico.
IP del resolver DNS: specifica l'indirizzo IP di un resolver DNS.
Risolver DNS ISP: Specificare il nome di un resolver DNS (in genere un ISP), ad esempio.
Cloudflare
ASN del resolver DNS: specificare il numero di sistema autonomo (ASN) di un resolver DNS, ad esempio 4225.
Gli operatori che è possibile utilizzare per filtrare i dati sono EQUALS
e NOT_EQUALS
. Per i dettagli sui parametri di filtraggio, consulta il funzionamento dell'API. FilterParameter
Per visualizzare i dettagli sulle operazioni dell'interfaccia di interrogazione, consulta le seguenti operazioni API nella Guida di riferimento dell'API di Internet Monitor:
Per creare ed eseguire una query, consulta il funzionamento dell'StartQueryAPI.
Per interrompere una query, consulta l'operazione StopQueryAPI.
Per restituire i dati per una query che hai creato, consulta l'operazione GetQueryResultsAPI.
Per recuperare lo stato di una query, consulta l'operazione GetQueryStatusAPI.
Esempi di query
Per creare una query da utilizzare per recuperare un set di dati filtrato dal file di registro del monitor, si utilizza l'StartQueryoperazione API. È possibile specificare un tipo di query e i parametri di filtro per la query. Quindi, quando si utilizza l'operazione API dell'interfaccia di interrogazione di Monitor Internet per ottenere i risultati delle query utilizzando la query, verrà recuperato il sottoinsieme di dati con cui si desidera lavorare.
Per comprendere come funzionano i tipi di query e i parametri di filtro, vediamo alcuni esempi.
Esempio 1
Supponiamo che tu voglia recuperare tutti i dati del file di log del monitor per un paese specifico, ad eccezione di una città. L'esempio seguente mostra i parametri di filtro per una query che è possibile creare con l'operazione StartQuery
per questo scenario.
{
MonitorName: "TestMonitor"
StartTime: "2023-07-12T20:00:00Z"
EndTime: "2023-07-12T21:00:00Z"
QueryType: "MEASUREMENTS"
FilterParameters: [
{
Field: "country",
Operator: "EQUALS",
Values: ["Germany"]
},
{
Field: "city",
Operator: "NOT_EQUALS",
Values: ["Berlin"]
},
]
}
Esempio 2
Come altro esempio, supponiamo che tu voglia visualizzare le posizioni principali per area metropolitana. È possibile utilizzare la seguente query di esempio per questo scenario.
{
MonitorName: "TestMonitor"
StartTime: "2023-07-12T20:00:00Z"
EndTime: "2023-07-12T21:00:00Z"
QueryType: "TOP_LOCATIONS"
FilterParameters: [
{
Field: "geo",
Operator: "EQUALS",
Values: ["metro"]
},
]
}
Esempio 3
Supponiamo ora che tu voglia vedere le migliori combinazioni di rete urbana nell'area metropolitana di Los Angeles. Per fare ciò, specifica geo=city
e quindi imposta metro
su Los Angeles. Ora, la query restituisce le principali reti urbane dell'area metropolitana di Los Angeles anziché le principali reti metropolitane in generale.
Ecco la query di esempio che puoi usare:
{
MonitorName: "TestMonitor"
StartTime: "2023-07-12T20:00:00Z"
EndTime: "2023-07-12T21:00:00Z"
QueryType: "TOP_LOCATIONS"
FilterParameters: [
{
Field: "geo",
Operator: "EQUALS",
Values: ["city"]
},
{
Field: "metro",
Operator: "EQUALS",
Values: ["Los Angeles"]
}
]
}
Esempio 4
Supponiamo quindi che tu voglia recuperare i dati TTFB per una suddivisione specifica (ad esempio, uno stato degli Stati Uniti).
Di seguito è riportato un esempio di query per questo scenario:
{
MonitorName: "TestMonitor"
StartTime: "2023-07-12T20:00:00Z"
EndTime: "2023-07-12T21:00:00Z"
QueryType: "TOP_LOCATION_DETAILS"
FilterParameters: [
{
Field: "subdivision",
Operator: "EQUALS",
Values: ["California"]
},
]
}
Esempio 5
Supponiamo ora che tu voglia recuperare i dati TTFB per ogni posizione in cui l'applicazione ha traffico client.
Di seguito è riportato un esempio di query per questo scenario:
{
MonitorName: "TestMonitor"
StartTime: "2023-07-12T20:00:00Z"
EndTime: "2023-07-12T21:00:00Z"
QueryType: "OVERALL_TRAFFIC_SUGGESTIONS"
FilterParameters: []
}
Results:
[us-east-1, 40, us-west-2, 30],
[us-east-1, 40, us-west-1, 35],
[us-east-1, 40, us-east-1, 44],
[us-east-1, 40, CloudFront, 22],
...
[us-east-2, 44, us-west-2, 30],
[us-east-2, 44, us-west-1, 35],
...
Esempio 6
Supponiamo che tu voglia recuperare i dati TTFB per un nuovo prodotto specifico. Regione AWS
Di seguito è riportato un esempio di query per questo scenario:
{
MonitorName: "TestMonitor"
StartTime: "2023-07-12T20:00:00Z"
EndTime: "2023-07-12T21:00:00Z"
QueryType: "OVERALL_TRAFFIC_SUGGESTIONS_DETAILS"
FilterParameters: [
{
Field: "proposed_aws_location",
Operator: "EQUALS",
Values: ["us-west-2"]
},
]
}
Results:
[San Jose, San Jose-Santa Clara, California, United States, 7922, us-east-1, 40, 350, 350, us-west-2, 45]
[San Jose, San Jose-Santa Clara, California, United States, 7922, us-west-1, 35, 450, 450, us-west-2, 45]
Esempio 7
Un ultimo esempio consiste nel recuperare i dati per resolver DNS specifici.
Di seguito è riportato un esempio di query per questo scenario:
{
MonitorName: "TestMonitor"
StartTime: "2023-07-12T20:00:00Z"
EndTime: "2023-07-12T21:00:00Z"
QueryType: "ROUTING_SUGGESTIONS"
FilterParameters: [
{
Field: "proposed_aws_location",
Operator: "EQUALS",
Values: ["us-east-1"]
},
]
}
Results:
[162.158.180.245, 13335, Cloudflare, [5.4.0.0/14], us-east-2, 200.0, us-east-1, 160.0]
[162.158.180.243, 13313, Cloudflare, [5.4.0.0/10], us-east-2, 150.0, us-east-1, 125.0]
Ottenimento dei risultati della query
Dopo aver definito una query, è possibile restituire una serie di risultati con la query eseguendo un'altra operazione dell'API Internet Monitor,. GetQueryResults Quando esegui GetQueryResults
, specifichi l'ID della query per la query che hai definito, insieme al nome del monitor. GetQueryResults
recupera i dati per la query specificata in un set di risultati.
Quando esegui una query, assicurati che l'esecuzione sia terminata prima di utilizzare GetQueryResults
per rivedere i risultati. È possibile determinare se la query è stata completata utilizzando l'operazione GetQueryStatusAPI. Quando il valore Status
della query è SUCCEEDED
, puoi procedere con la revisione dei risultati.
Una volta completata la query, è possibile utilizzare le informazioni seguenti per facilitare la revisione dei risultati. Ogni tipo di query utilizzato per creare una query include un set univoco di campi di dati dei file di log, come descritto nell'elenco seguente:
- Misurazioni
Il tipo di query
measurements
restituisce i seguenti dati:timestamp, availability, performance, bytes_in, bytes_out, rtt_p50, rtt_p90, rtt_p95
- Posizioni migliori
Il tipo di query
top locations
raggruppa i dati per posizione e fornisce la media dei dati nel periodo di tempo. I dati restituiti includono quanto segue:aws_location, city, metro, subdivision, country, asn, availability, performance, bytes_in, bytes_out, current_fbl, best_ec2, best_ec2_region, best_cf_fbl
Tieni presente che
city
,metro
esubdivision
vengono restituiti solo se scegli quel tipo di posizione per il campogeo
. Vengono restituiti i seguenti campi di posizione, a seconda del tipo di posizione specificato pergeo
:city = city, metro, subdivision, country metro = metro, subdivision, country subdivision = subdivision, country country = country
- Dettagli sulle posizioni migliori
Il tipo di query
top locations details
restituisce i dati raggruppati ora per ora. La query restituisce i seguenti dati:timestamp, current_service, current_fbl, best_ec2_fbl, best_ec2_region, best_cf_fbl
- Suggerimenti generali sul traffico
Il tipo di query
overall traffic suggestions
restituisce i dati raggruppati ora per ora. La query restituisce i seguenti dati:current_aws_location, proposed_aws_location, average_fbl, traffic, optimized_traffic_excluding_cf, optimized_traffic_including_cf
- Dettagli generali sui suggerimenti sul traffico
Il tipo di query
overall traffic suggestions details
restituisce i dati raggruppati ora per ora. La query restituisce i seguenti dati:aws_location, city, metro, subdivision, country, asn, traffic, current_aws_location, fbl_data
- Suggerimenti di routing
Il tipo di query
routing suggestions
restituisce i dati raggruppati ora per ora. La query restituisce i seguenti dati:dns_resolver_ip, dns_resolver_asn, dns_resolver_isp, ipv4_prefixes, current_aws_location, current_latency, proposed_aws_location, proposed_latency
Quando si esegue l'operazione API GetQueryResults
, Monitor Internet restituisce quanto segue nella risposta:
Un array di stringhe di dati che contiene i risultati restituiti dalla query. Le informazioni vengono restituite in array allineati con il campo
Fields
, anch'essi restituiti dalla chiamata API. Utilizzando il campoFields
, è possibile analizzare le informazioni dal repositoryData
e quindi filtrarle o ordinarle ulteriormente per i propri scopi.Un array di campi che elenca i campi per i quali la query ha restituito i dati (nella risposta del campo
Data
). Ogni elemento dell'array è una coppia nome-tipo di dati, ad esempioavailability_score
-float
.
Risoluzione dei problemi
Se vengono restituiti errori quando utilizzi le operazioni API dell'interfaccia di interrogazione, verifica di disporre delle autorizzazioni necessarie per utilizzare Internet Monitor. In particolare, accertati di disporre delle seguenti autorizzazioni:
internetmonitor:StartQuery internetmonitor:GetQueryStatus internetmonitor:GetQueryResults internetmonitor:StopQuery
Queste autorizzazioni sono incluse nella AWS Identity and Access Management politica consigliata per l'utilizzo della dashboard di Internet Monitor nella console. Per ulteriori informazioni, consulta AWS politiche gestite per Internet Monitor.