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à.
# Utilizza il linguaggio naturale per generare e aggiornare le query di CloudWatch Metrics Insights
CloudWatch [supporta una funzionalità di interrogazione in linguaggio naturale per aiutarti a generare e aggiornare le query per [CloudWatchMetrics Insights e Logs Insights](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/query_with_cloudwatch-metrics-insights.html). CloudWatch ](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData.html)
Con questa funzionalità, puoi porre domande o descrivere i CloudWatch dati che stai cercando in un inglese semplice. La funzionalità del linguaggio naturale genera un'interrogazione in base a un prompt immesso e fornisce una line-by-line spiegazione del funzionamento della query. Puoi anche aggiornare la tua query per analizzare ulteriormente i dati.
A seconda del tuo ambiente, puoi inserire istruzioni come “Quale istanza di Amazon Elastic Compute Cloud ha la rete in uscita più alta?” e “Mostrami le 10 migliori tabelle Amazon DynamoDB per numero di letture consumate”.
**Nota**
La funzionalità di query in linguaggio naturale è disponibile a livello generale in 10 Regioni. Per alcune Regioni, la funzionalità effettua chiamate tra Regioni verso le Regioni degli Stati Uniti d'America per elaborare i prompt di query. La tabella seguente elenca le Regioni supportate e mostra dove ciascuna Regione elabora i prompt.
| Regione supportata | Regione in cui viene elaborato il prompt |
| --- | --- |
| Stati Uniti orientali (Virginia settentrionale) | Stati Uniti orientali (Virginia settentrionale) |
| Stati Uniti orientali (Ohio) | Stati Uniti orientali (Virginia settentrionale) |
| Stati Uniti occidentali (Oregon) | Stati Uniti occidentali (Oregon) |
| Asia Pacifico (Hong Kong) | Stati Uniti occidentali (Oregon) |
| Asia Pacifico (Singapore) | Stati Uniti occidentali (Oregon) |
| Asia Pacifico (Sydney) | Stati Uniti occidentali (Oregon) |
| Asia Pacifico (Tokyo) | Asia Pacifico (Tokyo) |
| Europa (Francoforte) | Europa (Francoforte) |
| Europa (Irlanda) | Stati Uniti orientali (Virginia settentrionale) |
| Europa (Stoccolma) | Stati Uniti orientali (Virginia settentrionale) |
**Per generare una query di CloudWatch Metrics Insights con questa funzionalità, apri l'editor di query di CloudWatch Metrics Insights nella vista del *generatore* o dell'*editor* e scegli Genera query.**
**Importante**
Per utilizzare la funzionalità di interrogazione in linguaggio naturale, è necessario utilizzare la policy [CloudWatchFullAccess](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/CloudWatchFullAccess.html),, [CloudWatchReadOnlyAccess](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/CloudWatchReadOnlyAccess.html), [CloudWatchFullAccessV2](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/CloudWatchFullAccessV2.html) o. [AdministratorAccess[ReadOnlyAccess](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/ReadOnlyAccess.html)](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AdministratorAccess.html)
È inoltre possibile includere l'operazione `cloudwatch:GenerateQuery` in una policy inline o gestita dal cliente nuova o esistente.
## Query di esempio
Gli esempi in questa sezione descrivono come generare e aggiornare le query utilizzando la funzionalità di linguaggio naturale.
**Nota**
Per ulteriori informazioni sull'editor di query e sulla sintassi di CloudWatch Metrics Insights, consulta Componenti e sintassi delle [query di CloudWatch Metrics Insights](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch-metrics-insights-querylanguage.html).
### Esempio: generazione di una query in linguaggio naturale
Per generare un'interrogazione utilizzando il linguaggio naturale, inserisci un prompt e scegli **Genera nuova query**. Questo esempio mostra una query che esegue una ricerca di base.
**Prompt**
Di seguito è riportato un esempio di prompt che esegue la funzionalità per cercare le prime 10 tabelle DynamoDB che consumano maggiormente la capacità di lettura.
```
Show top 10 DynamoDB Tables by consumed reads
```
**Query**
Di seguito è riportato un esempio di query generata dalla funzionalità di linguaggio naturale in base al prompt. Nota come il prompt appare in un commento prima della query. Dopo l'esecuzione della query, puoi leggere una spiegazione del funzionamento della query.
```
# Show top 10 DynamoDB Tables by consumed reads
SELECT SUM("ConsumedReadCapacityUnits")
FROM "AWS/DynamoDB"
GROUP BY TableName
ORDER BY SUM() DESC
LIMIT 10
# This query selects the sum of consumed read capacity units for each DynamoDB table, groups the results by table name, orders the results from highest to lowest read capacity consumption, and limits the results to the top 10 tables.
```
**Nota**
Per disattivare la visualizzazione del prompt e la spiegazione del funzionamento della query, utilizza l'icona a forma di ingranaggio nell'editor.
### Esempio: aggiornamento di una query in linguaggio naturale
È possibile aggiornare una query modificando il prompt iniziale e scegliendo **Aggiorna query**.
**Richiesta aggiornata**
L'esempio seguente mostra una versione aggiornata del prompt precedente. Invece di un prompt che cerca le prime 10 tabelle DynamoDB che consumano maggiormente capacità di lettura, questo prompt ora esegue la funzionalità per ordinare i risultati in base al numero di byte restituiti.
```
Sort by bytes returned instead
```
**Query aggiornata**
Di seguito è riportato un esempio della query aggiornata. Nota come il prompt aggiornato appare in un commento prima della query aggiornata. Dopo l'esecuzione della query, puoi leggere una spiegazione di come la query originale è stata aggiornata.
```
# Sort by bytes returned instead
SELECT SUM("ReturnedBytes")
FROM "AWS/DynamoDB"
GROUP BY TableName
ORDER BY SUM() DESC
LIMIT 10
# This query modifies the original query to select the sum of returned bytes instead of consumed read capacity units, and orders the results from highest to lowest sum of returned bytes, limiting the results to the top 10 tables.
```
## Rifiuto esplicito all'utilizzo dei dati volto al miglioramento del servizio
I dati prompt in linguaggio naturale forniti per addestrare il modello di intelligenza artificiale e generare query pertinenti vengono utilizzati esclusivamente per fornire e gestire il servizio. Questi dati potrebbero essere utilizzati per migliorare la qualità di Metrics Insights. CloudWatch La tua fiducia, la tua privacy e la sicurezza dei tuoi contenuti sono le nostre maggiori priorità. Per ulteriori informazioni, consulta i [Termini del servizio AWS](https://aws.amazon.com/service-terms/) e la [Policy sull'IA responsabile di AWS](https://aws.amazon.com/machine-learning/responsible-ai/policy/).
Puoi scegliere di non utilizzare i tuoi contenuti per sviluppare o migliorare la qualità delle query in linguaggio naturale creando una policy di rifiuto dei servizi di intelligenza artificiale. Per disattivare la raccolta dei dati per tutte le funzionalità di CloudWatch intelligenza artificiale, inclusa la funzionalità di generazione di query, devi creare una politica di opt-out per. CloudWatch Per ulteriori informazioni, consulta le [Policy di rifiuto dei servizi di IA](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_ai-opt-out.html) nella *Guida per l'utente di AWS Organizations *.