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'opzione di interrogazione metrica per interrogare i dati di CloudWatch Metrics Insights **Nota** Amazon CloudWatch Metrics Insights è disponibile in anteprima. CloudWatch Le funzionalità di Metrics Insights sono aperte a tutti. Account AWS Le funzionalità potrebbero essere soggette a modifiche. Puoi interrogare i dati di CloudWatch Metrics Insights scegliendo la `metric query` modalità nell'editor di **query Metric**. CloudWatch Metrics Insights è un potente motore di query SQL ad alte prestazioni che puoi utilizzare per interrogare le tue metriche su larga scala. È un motore di query veloce e flessibile basato su SQL che puoi utilizzare per identificare tendenze e modelli all'interno di tutte le tue CloudWatch metriche in tempo reale. Utilizza un dialetto di SQL. Per ulteriori informazioni sulla sintassi delle query di Metrics Insights, vedere. [Sintassi e parole chiave delle query](#metrics-insights-syntax-keywords) ## Sintassi e parole chiave delle query CloudWatch Metrics Insights utilizza un dialetto di SQL. L'esempio seguente mostra la sintassi della query. ``` SELECT FUNCTION(metricName) FROM namespace | [ SCHEMA(namespace[, labelKey [, ...] ]) ] [ WHERE labelKey OPERATOR labelValue [AND|OR|([...])*] [, ...] ] [ GROUP BY labelKey [, ...]] [ ORDER BY FUNCTION() [DESC | ASC] ] [ LIMIT number] ``` Le parole chiave non fanno distinzione tra maiuscole e minuscole, ma gli identificatori fanno distinzione tra maiuscole e minuscole. Gli identificatori includono i nomi di metriche, namespace e dimensioni. La tabella seguente fornisce le parole chiave della query e le relative descrizioni. | Parola chiave | Description | | --- | --- | | FUNCTION | Obbligatorio. Specifica la funzione di aggregazione da utilizzare e specifica anche il nome della metrica da interrogare. I valori validi sono AVG, COUNT, MAX, MIN e SUM. | | MetricName | Obbligatorio. Ad esempio, CPUUtilization. | | FROM | Obbligatorio. Specifica la fonte del parametro. È possibile specificare lo spazio dei nomi delle metriche che contiene la metrica da interrogare o una funzione di tabella SCHEMA. Alcuni esempi di namespace sono and. AWS/EC2 AWS/Lambda | | SCHEMA | (Facoltativo) Filtra i risultati della query per mostrare solo le metriche che corrispondono esattamente o le metriche che non corrispondono. | | WHERE | (Facoltativo) Filtra i risultati per mostrare solo le metriche che corrispondono all'espressione specificata. Ad esempio, WHERE InstanceType \$1= 'c3.4xlarge'. | | GROUP BY | (Facoltativo) Raggruppa i risultati della query in più serie temporali. Ad esempio, GROUP BY ServiceName. | | ORDER BY | (Facoltativo) Specificate l'ordine delle serie temporali da restituire. Le opzioni sono ASC e. DESC | | LIMIT | (Facoltativo) Limita il numero di serie temporali da restituire. | Di seguito vengono mostrati alcuni esempi: + ``` SELECT AVG(CPUUtilization) FROM "AWS/EC2" ``` Corrisponde a tutte le `CPUUtilization` metriche nel `AWS/EC2` namespace, ignorandone le dimensioni, e restituisce una singola serie temporale aggregata. + ``` SELECT AVG(CPUUtilization) FROM SCHEMA("AWS/EC2") ``` Corrisponde solo alle `CPUUtilization` metriche nello `AWS/EC2` spazio dei nomi per le quali non è stata definita alcuna dimensione. + ``` SELECT AVG(CPUUtilization) FROM SCHEMA("AWS/EC2", InstanceId) ``` Corrisponde solo alle `CPUUtilization` metriche a cui sono state riportate esattamente una CloudWatch dimensione,. `InstanceId` + ``` SELECT SUM(RequestCount) FROM SCHEMA("AWS/ApplicationELB", LoadBalancer, AvailabilityZone) ``` Corrisponde solo alle `RequestCount` metriche che sono state riportate a CloudWatch Form `AWS/ApplicationELB` con esattamente due dimensioni, e. `LoadBalancer` `AvailabilityZone` I valori delle etichette devono essere racchiusi tra virgolette singole. ### Caratteri escape In una query, i valori delle etichette devono sempre essere racchiusi tra virgolette singole.   Ad esempio, `SELECT MAX(CPUUtilization) FROM "AWS/EC2" WHERE AutoScalingGroupName = 'my-production-fleet'`. Gli spazi dei nomi delle metriche, i nomi delle metriche e le chiavi di etichetta che contengono caratteri diversi da lettere, numeri e caratteri di sottolineatura (`_`) devono essere racchiusi tra virgolette doppie. Ad esempio, `SELECT MAX("My.Metric")`. Se uno di questi contiene a sua volta delle virgolette doppie (ad esempio`Bytes"Input"`), è necessario evitare tale virgoletta con delle barre rovesciate, ad esempio. `SELECT AVG("Bytes\"Input\"")` Se uno spazio dei nomi del parametro, un nome del parametro o una chiave etichetta contiene una parola che è una parola chiave riservata in Metrics Insights, queste devono anche essere racchiuse tra virgolette doppie. Ad esempio, se si dispone di un parametro denominato `LIMIT`, si utilizza `SELECT AVG("LIMIT")`. È inoltre valido racchiudere qualsiasi spazio dei nomi, nome del parametro o etichetta tra virgolette doppie anche se non include una parola chiave riservata. ## Modalità Builder e modalità codice È possibile creare un'interrogazione in `Builder` modalità o `Code` modalità. **Per creare un'interrogazione in `Builder` modalità** 1. Sfoglia e seleziona le opzioni relative allo spazio dei nomi, al nome della metrica, al filtro, al gruppo e all'ordine utilizzando le informazioni della tabella precedente. 1. Per ognuna di queste opzioni, scegli dall'elenco delle opzioni possibili. **Per creare un'interrogazione in `Code` modalità** 1. Scrivi la tua query nell'editor di codice. 1. Per eseguire la query, scegli **Esegui query** nell'editor di codice. Per creare un'interrogazione in questa `builder` modalità: + Sfoglia e seleziona lo spazio dei nomi delle metriche, il nome della metrica, il filtro, il gruppo e le opzioni di ordine utilizzando le informazioni della tabella precedente. + Per ognuna di queste opzioni, scegli dall'elenco delle opzioni possibili. Grafana costruisce automaticamente una query SQL in base alle tue selezioni. Per creare una query in questa modalità: `code` + Scrivi la tua query nell'editor di codice. + Per eseguire la query, scegli **Esegui query** nell'editor di codice. L'editor di codice ha una funzionalità di completamento automatico integrata che fornisce suggerimenti per parole chiave, aggregazioni, namespace, metriche, etichette e valori delle etichette. I suggerimenti vengono visualizzati quando si inserisce uno spazio, una virgola o il simbolo del dollaro. Puoi anche usare la combinazione di tasti`CTRL+Space`. L'editor di codice può completare automaticamente la query. Tuttavia, l'uso di variabili modello nell'editor di codice potrebbe interferire con il completamento automatico. ## CloudWatch Esempi di Metrics Insights **Nota** CloudWatch Metrics Insights è in anteprima aperta. L'anteprima è aperta a tutti gli AWS account e non è necessario richiedere l'accesso. Le funzionalità potrebbero essere aggiunte o modificate prima di annunciare la disponibilità generale. Questa sezione contiene esempi di utili query di CloudWatch Metrics Insights che puoi copiare e utilizzare direttamente o copiare e modificare nell'editor di query. Alcuni di questi esempi sono già disponibili nella console ed è possibile accedervi scegliendo **Aggiungi query** nella visualizzazione **Parametri**. ### Esempi EC2 Visualizza i parametri relativi all'utilizzo della CPU per istanza ``` SELECT AVG(CPUUtilization) FROM "AWS/EC2" GROUP BY InstanceId ``` Visualizza l'utilizzo medio della CPU nell'intero parco macchine ``` SELECT AVG(CPUUtilization) FROM SCHEMA("AWS/EC2", InstanceId) ``` Visualizza le 10 istanze con il più alto utilizzo medio della CPU ``` SELECT MAX(CPUUtilization) FROM "AWS/EC2" GROUP BY InstanceId LIMIT 10 ``` Visualizza le 10 istanze con il maggior utilizzo della CPU, ordinate per numero massimo, in ordine decrescente ``` SELECT AVG(CPUUtilization) FROM "AWS/EC2" GROUP BY InstanceId ORDER BY MAX() DESC LIMIT 10 ``` In questo caso, l' CloudWatch agente sta raccogliendo una CPUUtilization metrica per applicazione. Questa query filtra la media di questo parametro per un nome specifico dell'applicazione. ``` SELECT AVG(CPUUtilization) FROM "AWS/CWAgent" WHERE ApplicationName = 'eCommerce' SELECT AVG(ConcurrentExecutions) FROM "AWS/Lambda" ``` Visualizza il tempo medio di esecuzione per le prime 10 funzioni Lambda, ordinate per numero massimo, in ordine decrescente ``` SELECT AVG(Duration) FROM "AWS/Lambda" GROUP BY FunctionName ORDER BY MAX() DESC LIMIT 10 ``` Visualizza i tempi di esecuzione Lambda massimi, medi e minimi ``` SELECT MAX(Duration) FROM "AWS/Lambda" ``` ### Esempi di Application Load Balancer Visualizza le metriche che hanno le dimensioni e **LoadBalancer**AvailabilityZone**** ``` SELECT SUM(RequestCount) FROM SCHEMA("AWS/ApplicationELB", LoadBalancer, AvailabilityZone) ``` Visualizza le metriche con il numero di connessioni TCP simultanee attive ``` SELECT AVG(ActiveConnectionCount) FROM "AWS/ApplicationELB" ``` ### Esempi di Amazon EBS Visualizza i primi 10 byte di scrittura medi per volume in ordine decrescente ``` SELECT AVG(VolumeWriteBytes) FROM "AWS/EBS" GROUP BY VolumeId ORDER BY MAX() DESC LIMIT 10 ``` Visualizza il tempo medio di scrittura del volume Amazon EBS ``` SELECT AVG(VolumeTotalWriteTime) FROM "AWS/EBS" ``` Visualizza il tempo medio di inattività del volume Amazon EBS ``` SELECT AVG(VolumeIdleTime) FROM "AWS/EBS" View average burst balance per volume SELECT AVG(BurstBalance) FROM "AWS/EBS" GROUP BY VolumeId View average read bytes across Amazon EBS volumes SELECT AVG(VolumeReadBytes) FROM "AWS/EBS" ``` Visualizza i byte di scrittura medi nei volumi Amazon EBS ``` SELECT AVG(VolumeWriteBytes) FROM "AWS/EBS" ``` ### Esempi di codice di Amazon Simple Storage Service Visualizza il gruppo di latenza media per nome del bucket ``` SELECT AVG(TotalRequestLatency) FROM "AWS/S3" GROUP BY BucketName ``` Visualizza il numero medio di oggetti per bucket in tutti i bucket Amazon S3 ``` SELECT AVG(NumberOfObjects) FROM "AWS/S3" GROUP BY BucketName ``` ### Esempi di Amazon Simple Notification Service mazon-simple-notificaation-serviceA -esempi ``` SELECT AVG(NumberOfMessagesPublished) FROM "AWS/SNS" ``` Visualizzazione del numero medio di messaggi non riusciti per ogni nome di argomento ``` SELECT AVG(NumberOfNotificationsFailed) FROM "AWS/SNS" GROUP BY TopicName ``` ### AWS Esempi di utilizzo delle API Visualizza le prime 20 chiamate nel tuo account in AWS APIs base al numero di chiamate ``` SELECT COUNT(CallCount) FROM "AWS/Usage" WHERE "Type" = 'API' GROUP BY "Service", "Resource" ORDER BY SUM() DESC LIMIT 20 ``` ## CloudWatch Limiti di Metrics Insights CloudWatch Metrics Insights ha attualmente i seguenti limiti: + Puoi interrogare solo i dati delle tre ore più recenti. + Una singola query può elaborare non più di 10.000 parametri. Ciò significa che se le `WHERE` clausole `SELECT``FROM`, e corrispondono a più di 10.000 metriche, solo le prime 10.000 di queste metriche trovate verranno elaborate dalla query. + Una singola query può restituire non più di 500 serie temporali. Ciò significa che se la query elabora più di 500 metriche, non tutte le metriche verranno restituite nei risultati della query. Se si utilizza una `ORDER BY` clausola, tutte le metriche in fase di elaborazione verranno ordinate e verranno restituite le 500 con i valori più alti o più bassi in base alla `ORDER BY` clausola. Se non includi una `ORDER BY` clausola, non puoi controllare quali 500 metriche corrispondenti vengono restituite. + Ogni `GetMetricData` operazione può avere una sola query, ma puoi avere più widget in una dashboard, ognuno dei quali include una query.