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à.
# Usa il linguaggio naturale per generare e aggiornare CloudWatch le query di Logs Insights
CloudWatch [Logs supporta una funzionalità di interrogazione in linguaggio naturale per aiutarti a generare e aggiornare le query per [CloudWatch Logs Insights](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CWL_QuerySyntax.html), [OpenSearch Service PPL, Service SQL](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CWL_AnalyzeLogData_PPL.html) e. OpenSearch [CloudWatch Metrics Insights](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/query_with_cloudwatch-metrics-insights.html)](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CWL_AnalyzeLogData_SQL.html)
Con questa funzionalità, puoi porre domande o descrivere i dati di CloudWatch Logs 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 dell'ambiente, è possibile inserire richieste come «Quali sono i primi 100 indirizzi IP di origine per byte trasferiti?» e «Trova le 10 richieste di funzioni Lambda più lente».
**Nota**
La funzionalità di interrogazione in linguaggio naturale è un servizio regionale. Per alcune Regioni, la funzionalità effettua chiamate tra Regioni verso le Regioni degli Stati Uniti d'America per elaborare i prompt di query. Per ulteriori informazioni, consulta [Amazon CloudWatch estende il supporto regionale per il riepilogo dei risultati delle query in linguaggio naturale e la generazione di query](https://aws.amazon.com/about-aws/whats-new/2025/08/amazon-cloudwatch-region-support-query-result-summarization-query-generation/).
**Per generare una query di CloudWatch Logs Insights con questa funzionalità, apri l'editor di query di CloudWatch Logs Insights, seleziona il gruppo di log su cui desideri interrogare e scegli Genera query.**
**Importante**
Per utilizzare la funzionalità di interrogazione in linguaggio naturale, devi aver effettuato l'accesso con le politiche [CloudWatchLogsFullAccess[CloudWatchLogsReadOnlyAccess](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/CloudWatchLogsReadOnlyAccess.html)](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/CloudWatchLogsFullAccess.html), [AdministratorAccess](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AdministratorAccess.html), o [ReadOnlyAccess](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/ReadOnlyAccess.html)IAM o disporre dell'`cloudwatch:GenerateQuery`autorizzazione.
## 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 Logs Insights, vedere Sintassi delle query di [CloudWatch Logs Insights.](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CWL_QuerySyntax.html)
### Esempi: generare una query in linguaggio naturale
Per generare un'interrogazione utilizzando il linguaggio naturale, inserisci un prompt e scegli **Genera nuova query**. Questo esempio mostra le interrogazioni che eseguono una ricerca di base.
**Prompt**
Di seguito è riportato un esempio di prompt che indirizza la capacità di cercare le 10 chiamate di funzione Lambda più lente.
```
Find the 10 slowest requests
```
**Query**
Di seguito è riportata la query che utilizza il linguaggio di query CloudWatch Logs Insights generata dalla funzionalità del 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.
```
# Find the 10 slowest requests
fields @timestamp, @message, @duration
| sort @duration desc
| limit 10
# This query retrieves the timestamp, message and duration fields from the logs and sorts them in descending order by duration to find the 10 slowest requests.
```
**Nota**
Per disattivare la visualizzazione del prompt e la spiegazione del funzionamento della query, utilizza l'icona a forma di ingranaggio nell'editor.
**Prompt**
Per generare una query OpenSearch SQL, seleziona la scheda OpenSearch SQL, quindi apri la casella di richiesta del generatore di query per inserire il prompt del linguaggio naturale. Di seguito è riportato un esempio di prompt che utilizza la funzionalità del linguaggio naturale per generare una OpenSearch query SQL.
```
Give me the number of errors and exceptions per hour
```
**Query**
Di seguito è riportata la query SQL generata da quel prompt che è possibile utilizzare per trovare il numero di errori ed eccezioni aggregati all'ora:
```
SELECT DATE_FORMAT(`@timestamp`, 'yyyy-MM-dd HH') AS hour,
COUNT(*) AS error_count
FROM `/aws/lambda/CloudWatchOdysseyQueryGen`
WHERE `@message` LIKE '%error%'
OR `@message` LIKE '%exception%'
GROUP BY DATE_FORMAT(`@timestamp`, 'yyyy-MM-dd HH')
ORDER BY hour
```
**Prompt**
Per generare una query OpenSearch PPL, seleziona la scheda OpenSearch PPL, quindi apri la casella di richiesta del generatore di query per inserire il prompt del linguaggio naturale. Di seguito è riportato un esempio di prompt che utilizza la funzionalità del linguaggio naturale per generare una query PPL. OpenSearch
```
Give me all unique exception messages
```
**Query**
Di seguito è riportata la query PPL generata da quel prompt che è possibile utilizzare per trovare i messaggi di eccezione univoci nei registri:
```
dedup @message
| fields @message
```
### 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 10 chiamate di funzione Lambda più lente, questo prompt ora indirizza la capacità di cercare le 20 chiamate di funzione Lambda più lente e include un'altra colonna per eventi di registro aggiuntivi.
```
Show top 20 slowest requests instead and display requestId as a column
```
**Query aggiornata**
Di seguito è riportato un esempio di query aggiornata che utilizza il linguaggio di query Logs Insights. CloudWatch 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.
```
# Show top 20 slowest requests instead and display requestId as a column
fields @timestamp, @message, @requestId, @duration
| sort @duration desc
| limit 20
# This query modifies the original query by replacing the @message field with the @requestId field and changing the limit from 10 to 20 to return the top 20 log events by duration instead of the top 10.
```
## 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 possono essere utilizzati per migliorare la qualità di CloudWatch Logs Insights. 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 Logs AI, inclusa la funzionalità di generazione di query, è necessario creare una politica di opt-out per Logs. 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 *.