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. # Logs entdecken Die Seite Discover Logs bietet eine spezielle Oberfläche für die Untersuchung und Analyse von Protokolldaten in Ihrem OpenSearch Service-Observability-Workspace. Sie können PPL-Abfragen schreiben, um Protokolldaten zu filtern und zu aggregieren, Visualisierungen direkt aus Abfrageergebnissen erstellen und diese Visualisierungen zu Dashboards hinzufügen. Die Seite bietet auch Unterstützung bei Abfragen in natürlicher Sprache, die vom KI-Assistenten unterstützt wird. OpenSearch ## So greifen Sie auf die Logs-Seite zu Erweitern Sie in Ihrem Observability-Workspace in der linken Navigationsleiste die Option **Discover** und wählen Sie **Logs** aus. ## Erkundung von Protokolldaten Die Discover Logs-Oberfläche bietet die folgenden Komponenten für die Untersuchung Ihrer Protokolldaten. ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/opensearch-service/latest/developerguide/images/discover-logs/discover-logs-interface.png) + **Datensatzauswahl** — Wählen Sie den Protokolldatensatz aus, den Sie abfragen möchten. Jeder Datensatz ist einem oder mehreren Indizes in Ihrer OpenSearch Service-Domain zugeordnet. + **Abfrage-Editor** — Schreiben Sie PPL-Abfragen, um Ihre Protokolldaten zu filtern, zu aggregieren und zu transformieren. Der Editor bietet Vorschläge zur automatischen Vervollständigung und Syntaxhervorhebung. + **Zeitfilter** — Geben Sie den Zeitraum für Ihre Abfrageergebnisse an. Sie können einen relativen Bereich wählen oder absolute Start- und Endzeiten angeben. + **Ergebnisbereich** — Zeigt die Abfrageergebnisse als Tabelle mit Protokollereignissen an. Sie können einzelne Ereignisse erweitern, um alle Felder zu sehen. + **Histogramm** — Sehen Sie sich die Verteilung der Protokollereignisse im Laufe der Zeit an. Das Histogramm wird basierend auf Ihrer Abfrage und Ihrem Zeitfilter automatisch aktualisiert. + **Bereich „Felder“** — Durchsuchen Sie die verfügbaren Felder in Ihrem Datensatz und fügen Sie sie als Spalten zur Ergebnistabelle hinzu. ## Logs mit PPL abfragen Die Piped Processing Language (PPL) ist eine Abfragesprache, die eine pipebasierte (`|`) -Syntax für die Verkettung von Befehlen verwendet. Sie können PPL verwenden, um Ihre Protokolldaten zu filtern, zu aggregieren und zu transformieren. ### Grundlegende Abfragen Verwenden Sie den `source` folgenden Befehl, um alle Protokollereignisse aus einem Datensatz abzurufen: ``` source = my-logs-dataset ``` Verwenden Sie den `head` folgenden Befehl, um die Anzahl der Ergebnisse zu begrenzen: ``` source = my-logs-dataset | head 20 ``` ### Filterung mit WHERE Verwenden Sie die `where` Klausel, um Protokollereignisse auf der Grundlage von Feldwerten zu filtern: ``` source = my-logs-dataset | where severity_text = 'ERROR' ``` Sie können mehrere Bedingungen kombinieren: ``` source = my-logs-dataset | where severity_text = 'ERROR' and service_name = 'payment-service' ``` ### Abfragen verwalten Sie können häufig verwendete Abfragen zur Wiederverwendung speichern. Um eine Abfrage zu speichern, wählen Sie in der Werkzeugleiste des Abfrage-Editors **Speichern** und geben Sie einen Namen für die Abfrage ein. Um eine gespeicherte Abfrage zu laden, wählen Sie **Öffnen** und wählen Sie die Abfrage aus der Liste aus. Eine vollständige Liste der PPL-Befehle und -Funktionen finden Sie in der [Piped Processing Language-Referenz](https://observability.opensearch.org/docs/ppl/). ## Visualisierungen aus Protokollen erstellen Sie können Visualisierungen direkt aus Ihren PPL-Abfrageergebnissen erstellen. Verwenden Sie den `stats` Befehl, um Daten für die Visualisierung zu aggregieren: ``` source = my-logs-dataset | stats count() as error_count by service_name, span(timestamp, 1h) ``` Nachdem Sie eine `stats` Abfrage ausgeführt haben, wählen Sie die Registerkarte **Visualisierung**, um die Ergebnisse als Diagramm anzuzeigen. ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/opensearch-service/latest/developerguide/images/discover-logs/discover-logs-visualization.png) ### Visualisierungstypen In der folgenden Tabelle werden die Visualisierungstypen beschrieben, die Sie verwenden können. | Typ | Description | | --- | --- | | Linien | Zeigt Datenpunkte an, die durch Linien miteinander verbunden sind. Dies ist nützlich, um Trends im Zeitverlauf darzustellen. | | Flächen | Ähnlich wie bei einem Liniendiagramm, bei dem der Bereich unter der Linie ausgefüllt ist. Dies ist nützlich, um das Volumen im Zeitverlauf darzustellen. | | Säulen | Zeigt Daten als vertikale oder horizontale Balken an, was für den Vergleich von Werten zwischen Kategorien nützlich ist. | | Metrik | Zeigt einen einzelnen numerischen Wert an, der für die Darstellung wichtiger Leistungsindikatoren nützlich ist. | | Zeitleiste des Bundesstaates | Zeigt Statusänderungen im Laufe der Zeit als farbige Bänder an, was für die Überwachung von Statusübergängen nützlich ist. | | Heatmap | Zeigt Daten als Matrix aus farbigen Zellen an, was für die Darstellung von Dichte und Mustern nützlich ist. | | Balkenmaß | Zeigt einen einzelnen Wert als gefüllten Balken innerhalb eines Bereichs an. Dies ist nützlich, um den Fortschritt bei Erreichen eines Schwellenwerts anzuzeigen. | | Kreis | Zeigt Daten als proportionale Teile eines Kreises an, was für die Darstellung der Zusammensetzung nützlich ist. | ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/opensearch-service/latest/developerguide/images/discover-logs/discover-logs-viz-types.png) ### Einstellungen für die Visualisierung Wenn die Registerkarte **Visualisierung** aktiv ist, wird auf der rechten Seite des Bildschirms ein Einstellungsfenster angezeigt. Verwenden Sie diesen Bereich, um den Diagrammtyp zu konfigurieren, Felder Achsen zuzuordnen und visuelle Stile wie Farben und Legenden anzupassen. Verwenden Sie die Achsenkonfiguration im Einstellungsfenster, um zwischen den Achsen einer Visualisierung zu wechseln. ![\[alt text not found\]](http://docs.aws.amazon.com/de_de/opensearch-service/latest/developerguide/images/discover-logs/discover-logs-switch-axes.png) ## Hinzufügen von Visualisierungen zu Dashboards Nachdem Sie eine Visualisierung erstellt haben, können Sie sie zu einem Dashboard hinzufügen, um sie fortlaufend zu überwachen. Wählen Sie in der Visualisierungssymbolleiste Im **Dashboard speichern** und wählen Sie dann ein vorhandenes Dashboard aus oder erstellen Sie ein neues. Die Visualisierung wird mit der zugrunde liegenden PPL-Abfrage gespeichert, sodass sie automatisch aktualisiert wird, wenn Sie das Dashboard öffnen.