Verwenden Sie natürliche Sprache, um CloudWatch Logs Insights-Abfragen zu generieren und zu aktualisieren

CloudWatch Logs unterstützt eine Abfragefunktion in natürlicher Sprache, mit der Sie Abfragen für CloudWatch Logs Insights, OpenSearch Service PPL, OpenSearch Service SQL und generieren und CloudWatch Metrics Insightsaktualisieren können.

Mit dieser Funktion können Sie Fragen zu den CloudWatch Logs-Daten, nach denen Sie suchen, stellen oder diese in einfachem Englisch beschreiben. Die Funktion in natürlicher Sprache generiert eine Abfrage auf der Grundlage einer von Ihnen eingegebenen Eingabeaufforderung und bietet eine line-by-line Erläuterung der Funktionsweise der Abfrage. Sie können Ihre Abfrage auch aktualisieren, um Ihre Daten weiter zu untersuchen.

Abhängig von Ihrer Umgebung können Sie Eingabeaufforderungen wie „Was sind die 100 wichtigsten Quell-IP-Adressen nach übertragenen Byte?“ eingeben. und „Finde die 10 langsamsten Lambda-Funktionsanfragen.“

Anmerkung

Bei der Funktion für Abfragen in natürlicher Sprache handelt es sich um einen regionalen Dienst. Für einige Regionen ruft die Funktion regionsübergreifende Aufrufe an Regionen in den Vereinigte Staaten ab, um die Abfrageaufforderungen zu verarbeiten. Weitere Informationen finden Sie unter Amazon CloudWatch erweitert die regionale Unterstützung für die Zusammenfassung und Generierung von Abfragen in natürlicher Sprache.

Um eine CloudWatch Logs Insights-Abfrage mit dieser Funktion zu generieren, öffnen Sie den CloudWatch Logs Insights-Abfrage-Editor, wählen Sie die Protokollgruppe aus, die Sie abfragen möchten, und wählen Sie Abfrage generieren.

Wichtig

Um die Abfragefunktion in natürlicher Sprache verwenden zu können, müssen Sie mit den CloudWatchLogsFullAccess, CloudWatchLogsReadOnlyAccessAdministratorAccess, oder ReadOnlyAccessIAM-Richtlinien angemeldet sein oder über die cloudwatch:GenerateQuery entsprechende Berechtigung verfügen.

Beispielabfragen

In den Beispielen in diesem Abschnitt wird beschrieben, wie Abfragen mithilfe der natürlichen Sprachfunktion generiert und aktualisiert werden.

Anmerkung

Weitere Informationen zum CloudWatch Logs Insights-Abfrage-Editor und zur Syntax finden Sie unter CloudWatch Logs Insights-Abfragesyntax.

Beispiele: Generieren Sie eine Abfrage in natürlicher Sprache

Um eine Abfrage in natürlicher Sprache zu generieren, geben Sie eine Aufforderung ein und wählen Sie Neue Abfrage generieren. Dieses Beispiel zeigt Abfragen, die eine einfache Suche durchführen.

Telefonansage

Im Folgenden finden Sie ein Beispiel für eine Eingabeaufforderung, die die Fähigkeit anweist, nach den 10 langsamsten Lambda-Funktionsaufrufen zu suchen.

Find the 10 slowest requests

Abfrage

Die folgende Abfrage verwendet die CloudWatch Logs Insights-Abfragesprache, die von der Funktion in natürlicher Sprache auf der Grundlage der Aufforderung generiert wurde. Beachten Sie, wie die Aufforderung in einem Kommentar vor der Abfrage erscheint. Nach der Abfrage können Sie eine Erklärung lesen, in der beschrieben wird, wie die Abfrage funktioniert.

# 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.

Anmerkung

Verwenden Sie das Zahnradsymbol in Ihrem Editor, um das Erscheinungsbild Ihrer Aufforderung und die Erläuterung der Funktionsweise der Abfrage zu deaktivieren.

Telefonansage

Um eine OpenSearch SQL-Abfrage zu generieren, wählen Sie die Registerkarte OpenSearch SQL aus und öffnen Sie dann das Eingabeaufforderungsfeld für den Abfragegenerator, um Ihre Eingabeaufforderung in natürlicher Sprache einzugeben. Im Folgenden finden Sie ein Beispiel für eine Eingabeaufforderung, bei der die Funktion natürlicher Sprache verwendet wird, um eine OpenSearch SQL-Abfrage zu generieren.

Give me the number of errors and exceptions per hour

Abfrage

Im Folgenden finden Sie die von dieser Aufforderung generierte SQL-Abfrage, mit der Sie die Anzahl der pro Stunde aggregierten Fehler und Ausnahmen ermitteln können:

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

Telefonansage

Um eine OpenSearch PPL-Abfrage zu generieren, wählen Sie die Registerkarte PPL aus und öffnen Sie dann das OpenSearch Eingabeaufforderungsfeld für den Abfragegenerator, um Ihre Eingabeaufforderung in natürlicher Sprache einzugeben. Im Folgenden finden Sie ein Beispiel für eine Aufforderung, bei der die Funktion natürlicher Sprache verwendet wird, um eine OpenSearch PPL-Abfrage zu generieren.

Give me all unique exception messages

Abfrage

Im Folgenden finden Sie die PPL-Abfrage, die durch diese Aufforderung generiert wurde und die Sie verwenden können, um die eindeutigen Ausnahmemeldungen in Ihren Protokollen zu finden:

dedup @message 
| fields @message
                       

Beispiel: Eine Abfrage in natürlicher Sprache aktualisieren

Sie können eine Abfrage aktualisieren, indem Sie die erste Eingabeaufforderung bearbeiten und dann Abfrage aktualisieren wählen.

Aktualisierte Eingabeaufforderung

Das folgende Beispiel zeigt eine aktualisierte Version der vorherigen Eingabeaufforderung. Anstatt einer Aufforderung, die nach den 10 langsamsten Lambda-Funktionsaufrufen sucht, leitet diese Aufforderung nun die Fähigkeit an, nach den 20 langsamsten Lambda-Funktionsaufrufen zu suchen und eine weitere Spalte für zusätzliche Protokollereignisse einzufügen.

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

Aktualisierte Abfrage

Im Folgenden finden Sie ein Beispiel für die aktualisierte Abfrage, die die Logs Insights-Abfragesprache verwendet. CloudWatch Beachten Sie, wie die Eingabeaufforderung in einem Kommentar vor der Abfrage erscheint. Nach der Abfrage können Sie eine Erklärung lesen, in der beschrieben wird, wie die ursprüngliche Abfrage aktualisiert wurde.

# 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.
                

Abmeldung von der Verwendung Ihrer Daten zur Serviceverbesserung

Die Eingabeaufforderungs-Daten in natürlicher Sprache, die Sie bereitstellen, um das KI-Modell zu trainieren und relevante Abfragen zu generieren, werden ausschließlich zur Bereitstellung und Wartung Ihres Services verwendet. Diese Daten könnten verwendet werden, um die Qualität von CloudWatch Logs Insights zu verbessern. Ihr Vertrauen, Ihre Privatsphäre sowie die Sicherheit Ihrer Inhalte sind unsere obersten Prioritäten. Weitere Informationen finden Sie unter AWS -Service-Bedingungen und AWS verantwortliche KI-Richtlinie.

Sie können die Verwendung Ihrer Inhalte zur Entwicklung oder Verbesserung der Qualität von Abfragen in natürlicher Sprache deaktivieren, indem Sie eine Opt-Out-Richtlinie für KI-Services erstellen. Um die Datenerfassung für alle CloudWatch Logs AI-Funktionen, einschließlich der Funktion zur Abfragegenerierung, abzulehnen, müssen Sie eine Opt-Out-Richtlinie für CloudWatch Logs erstellen. Weitere Informationen finden Sie unter Opt-Out-Richtlinien für KI-Services im Benutzerhandbuch für AWS Organizations .