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

Utilizzo dell'interfaccia di interrogazione Amazon CloudWatch Internet Monitor

Un'opzione per comprendere meglio il traffico Internet per la tua AWS applicazione consiste nell'utilizzare l'interfaccia di interrogazione di Amazon CloudWatch 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 nel pannello di controllo, nella scheda Esploratore storico o nella scheda Informazioni sul traffico, puoi interrogare e filtrare i dati Internet per l'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 AWS Command Line Interface o con un AWS SDK. 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:

L'interfaccia di interrogazione fornisce i seguenti tre tipi di query. Ogni tipo di query restituisce un diverso set di informazioni sul traffico proveniente dai file di log, come illustrato.

Con ognuno di questi tipi di query è possibile filtrare ulteriormente i dati specificando uno o più dei seguenti criteri:

Gli operatori che è possibile utilizzare per filtrare i dati sono EQUALS e NOT_EQUALS. Per informazioni dettagliate sui parametri di filtraggio, consulta il funzionamento dell'FilterParameterAPI.

Per visualizzare i dettagli sulle operazioni dell'interfaccia di interrogazione, consulta le seguenti operazioni API nella Guida di riferimento dell'API di Amazon CloudWatch Internet Monitor:

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

Infine, supponiamo che tu voglia recuperare i dati TTFB per una regione 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"]
      },
    ]
}

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:

Quando si esegue l'operazione API GetQueryResults, Monitor Internet restituisce quanto segue nella risposta:

Risoluzione dei problemi

Se vengono restituiti errori quando utilizzi le operazioni API dell'interfaccia di interrogazione, verifica di disporre delle autorizzazioni necessarie per utilizzare Amazon CloudWatch 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'uso della dashboard di Internet Monitor nella console. Per ulteriori informazioni, consulta Autorizzazioni IAM per Amazon CloudWatch Internet Monitor.