Usa il linguaggio naturale per generare e aggiornare CloudWatch le query di Logs Insights - CloudWatch Registri Amazon

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, OpenSearch Service PPL, Service SQL e. OpenSearch CloudWatch Metrics Insights

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 è generalmente disponibile in 10 regioni. Per alcune regioni, la funzionalità effettua chiamate interregionali verso le regioni degli Stati Uniti d'America per elaborare le richieste di interrogazione.

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 eseguire la query e scegli Genera query.

Importante

Per utilizzare la funzionalità di interrogazione in linguaggio naturale, devi aver effettuato l'accesso con le politiche CloudWatchLogsFullAccessCloudWatchLogsReadOnlyAccess, AdministratorAccess, o ReadOnlyAccessIAM o disporre dell'cloudwatch:GenerateQueryautorizzazione.

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.

Esempi: 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 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 e la Policy sull'IA responsabile di AWS.

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 nella Guida per l'utente di AWS Organizations .