Utilizza l'interfaccia di interrogazione di Internet Monitor

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.

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:

1. 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.

2. 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 query Top locations, ma non è consentito per altri tipi di query. Per capire quando specificare geo 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 esempious-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 e subdivision vengono restituiti solo se scegli quel tipo di posizione per il campo geo. Vengono restituiti i seguenti campi di posizione, a seconda del tipo di posizione specificato per geo:

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 campo Fields, è possibile analizzare le informazioni dal repository Data 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 esempio availability_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.