View a markdown version of this page

Usa il linguaggio naturale per generare e aggiornare CloudWatch Domande su Logs Insights - Amazon CloudWatch Registri

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 Domande su 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 Servizio PPL, OpenSearch Servizio SQLe CloudWatch Metrics Insights.

Con questa funzionalità, puoi porre domande o descrivere CloudWatch Registra i dati che stai cercando in un inglese semplice. La funzionalità di linguaggio naturale genera una query basata su una richiesta inserita da te e fornisce una spiegazione riga per riga del funzionamento della query. Puoi anche aggiornare la tua query per analizzare ulteriormente i dati.

A seconda dell'ambiente, puoi inserire prompt 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, vedere Amazon CloudWatch estende il supporto regionale per il riepilogo dei risultati delle query in linguaggio naturale e la generazione di query .

Per generare un CloudWatch Query Logs Insights con questa funzionalità, apri il CloudWatch Editor di query Logs Insights, seleziona il gruppo di log da interrogare e scegli Genera una query.

Importante

Per utilizzare la funzionalità di interrogazione in linguaggio naturale, è necessario accedere con CloudWatchLogsFullAccess, CloudWatchLogsReadOnlyAccess, AdministratorAccess, o ReadOnlyAccess politiche IAM, oppure hanno 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 su CloudWatch Editor e sintassi delle query di Logs Insights, vedi CloudWatch Sintassi delle query di Logs Insights.

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 query che eseguono una ricerca di base.

Prompt

Di seguito è riportato un esempio di prompt che indirizza la capacità di cercare le 10 chiamate di funzioni Lambda più lente.

Find the 10 slowest requests
Query

Di seguito è riportata la query che utilizza CloudWatch Linguaggio di interrogazione Logs Insights generato 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.

# 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 un OpenSearch Query SQL, selezionare OpenSearch scheda SQL, quindi apri la casella di richiesta del generatore di query per inserire il prompt in linguaggio naturale. Di seguito è riportato un esempio di prompt che utilizza la funzionalità del linguaggio naturale per generare un OpenSearch Interrogazione SQL.

Give me the number of errors and exceptions per hour
Query

Di seguito è riportata la query SQL generata da quel prompt che puoi 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 un OpenSearch Interrogazione PPL, selezionare OpenSearch scheda PPL, quindi apri la casella di richiesta del generatore di query per inserire il prompt in linguaggio naturale. Di seguito è riportato un esempio di prompt che utilizza la funzionalità del linguaggio naturale per generare un OpenSearch Interrogazione PPL.

Give me all unique exception messages
Query

Di seguito è riportata la query PPL generata da quel prompt che puoi utilizzare per trovare i messaggi di eccezione univoci nei tuoi log:

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 funzioni Lambda più lente, questo prompt ora indirizza la capacità di cercare le 20 chiamate di funzioni Lambda più lente e include un'altra colonna per gli eventi di registro aggiuntivi.

Show top 20 slowest requests instead and display requestId as a column
Query aggiornata

Di seguito è riportato un esempio della query aggiornata che utilizza CloudWatch Linguaggio di interrogazione Logs Insights. 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 potrebbero essere utilizzati per migliorare la qualità di CloudWatch Registri e approfondimenti. 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 tutti CloudWatch Registra le funzionalità di intelligenza artificiale, inclusa la capacità di generazione di query, per le quali è necessario creare una politica di opt-out CloudWatch Log. Per ulteriori informazioni, consulta le Policy di rifiuto dei servizi di IA nella Guida per l'utente di AWS Organizations .