View a markdown version of this page

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

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

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 usw. generieren und CloudWatch Metrics Insights aktualisieren 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 für natürliche Sprache generiert eine Abfrage auf der Grundlage einer von Ihnen eingegebenen Eingabeaufforderung und erklärt Zeile für Zeile, wie die Abfrage funktioniert. 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 häufigsten Quell-IP-Adressen nach übertragenen Bytes?“ eingeben und „Finden Sie die 10 langsamsten Lambda-Funktionsanfragen.“

Anmerkung

Bei der Abfragefunktion in natürlicher Sprache handelt es sich um einen regionalen Dienst. In einigen Regionen führt die Funktion regionsübergreifende Aufrufe an Regionen in den USA aus, um die Abfrage-Prompts 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, CloudWatchLogsReadOnlyAccess AdministratorAccess ,- oder ReadOnlyAccess IAM-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-Abfrageeditor 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.

Prompt

Das Folgende ist ein Beispiel für eine Eingabeaufforderung, die die Funktion anweist, nach den 10 langsamsten Lambda-Funktionsaufrufen zu suchen.

Find the 10 slowest requests
Query

Die folgende Abfrage verwendet die CloudWatch Logs Insights-Abfragesprache, die von der Funktion für natürliche 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.

Prompt

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

Give me the number of errors and exceptions per hour
Query

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
Prompt

Um eine OpenSearch PPL-Abfrage zu generieren, wählen Sie die Registerkarte OpenSearch PPL aus und öffnen Sie dann das Eingabeaufforderungsfeld des Abfragegenerators, um Ihre Eingabeaufforderung in natürlicher Sprache einzugeben. Im Folgenden finden Sie ein Beispiel für eine Eingabeaufforderung, die die Funktion „Natürliche Sprache“ verwendet, um eine OpenSearch PPL-Abfrage zu generieren.

Give me all unique exception messages
Query

Im Folgenden finden Sie die von dieser Aufforderung generierte PPL-Abfrage, 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 Eingabeaufforderung, die nach den 10 langsamsten Lambda-Funktionsaufrufen sucht, leitet diese Aufforderung nun die Möglichkeit, nach den 20 langsamsten Lambda-Funktionsaufrufen zu suchen und eine weitere Spalte für zusätzliche Protokollereignisse einzuschließen.

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 unter Verwendung der Logs Insights-Abfragesprache. 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önnen 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 Generierung von Abfragen, 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 .