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.

# Arbeiten mit CloudWatch Protokollen in Visual Studio
<a name="cloudwatch-log-overview"></a>

Die Amazon CloudWatch Logs-Integration ermöglicht es Ihnen, CloudWatch Logs aus dem AWS Toolkit for Visual Studio mit Amazon Q zu überwachen, zu speichern und darauf zuzugreifen. Der Zugriff auf CloudWatch Logs-Funktionen — ohne Ihre IDE verlassen zu müssen — verbessert die Effizienz, indem der CloudWatch Logs-Entwicklungsprozess vereinfacht und Unterbrechungen in Ihrem Arbeitsablauf reduziert werden. In den folgenden Themen wird beschrieben, wie Sie mit den grundlegenden Merkmalen und Funktionen der Logs-Integration arbeiten. CloudWatch 

**Topics**
+ [CloudWatch Protokollgruppen](#cloudwatch-log-overview-groups)
+ [CloudWatch Streams protokollieren](#cloudwatch-log-overview-logstream)
+ [CloudWatch Ereignisse protokollieren](#cloudwatch-log-overview-logevents)
+ [Zusätzlicher Zugriff auf CloudWatch Protokolle](#cloudwatch-log-overview-additional)

## CloudWatch Protokollgruppen
<a name="cloudwatch-log-overview-groups"></a>

A `log group` ist eine Gruppe von Gruppen`log streams`, die dieselben Einstellungen für Aufbewahrung, Überwachung und Zugriffskontrolle verwenden. Es gibt keine Begrenzung dazu, wie viele Protokollstreams zu einer Protokollgruppe gehören können.

### Protokollgruppen anzeigen
<a name="cloudwatch-log-overview-groups-view"></a>

Die `View Log Groups` Funktion zeigt eine Liste von Protokollgruppen im CloudWatch Protokollgruppen-Explorer an.

Gehen Sie wie folgt vor, um auf die Funktion „ CloudWatch Protokollgruppen anzeigen“ zuzugreifen und den Protokollgruppen-Explorer zu öffnen.

1. Erweitern Sie **Amazon** im AWS Explorer CloudWatch.

1. Doppelklicken Sie auf **Protokollgruppen** oder öffnen Sie das Kontextmenü (Rechtsklick) und wählen Sie **Ansicht**, um den **CloudWatch Protokollgruppen-Explorer** zu öffnen.
**Anmerkung**  
Der CloudWatch Log Groups Explorer wird an derselben Fensterposition wie der Solutions Explorer geöffnet.

### Protokollgruppen filtern
<a name="cloudwatch-log-overview-groups-filter"></a>

Ihr individuelles Konto kann Tausende verschiedener Protokollgruppen enthalten. Verwenden Sie die unten beschriebene `filtering` Funktion, um Ihre Suche nach bestimmten Gruppen zu vereinfachen. 

1. Platzieren **CloudWatch Sie im Log Groups Explorer** den Cursor in der Suchleiste oben im Fenster.

1. Geben Sie zunächst ein Präfix ein, das sich auf die Log-Gruppen bezieht, nach denen Sie suchen.

1. CloudWatch Der **Log Groups Explorer** wird automatisch aktualisiert und zeigt Ergebnisse an, die den Suchbegriffen entsprechen, die Sie im vorherigen Schritt angegeben haben.

### Protokollgruppen löschen
<a name="cloudwatch-log-overview-groups-delete"></a>

Gehen Sie wie folgt vor, um eine bestimmte Protokollgruppe zu löschen.

1. Klicken **CloudWatch Sie im Protokollgruppen-Explorer** mit der rechten Maustaste auf die Protokollgruppe, die Sie löschen möchten.

1. Wenn Sie dazu aufgefordert werden, bestätigen Sie, dass Sie die aktuell ausgewählte Protokollgruppe löschen möchten.

1. Wenn Sie auf **Ja** klicken, wird die ausgewählte Protokollgruppe gelöscht und anschließend der **CloudWatch Protokollgruppen-Explorer** aktualisiert.

### Protokollgruppen aktualisieren
<a name="cloudwatch-log-overview-groups-refresh"></a>

Um die aktuelle Liste der im **Protokollgruppen-Explorer** angezeigten Protokollgruppen zu aktualisieren, klicken Sie in der CloudWatch Werkzeugleiste auf die **Symbolschaltfläche „Aktualisieren****“**.

### Protokollgruppen-ARN kopieren
<a name="cloudwatch-log-overview-groups-copyarn"></a>

Um den ARN einer bestimmten Protokollgruppe zu kopieren, führen Sie die unten beschriebenen Schritte aus.

1. Klicken **CloudWatch Sie im Log Groups Explorer** mit der rechten Maustaste auf die Protokollgruppe, aus der Sie einen ARN kopieren möchten.

1. Wählen Sie im Menü die Option **ARN kopieren**.

1. Der ARN wird jetzt in Ihre lokale Zwischenablage kopiert und kann eingefügt werden.

## CloudWatch Streams protokollieren
<a name="cloudwatch-log-overview-logstream"></a>

Ein Protokollstream ist eine Abfolge von Protokollereignissen, die dieselbe Quelle nutzen.

**Anmerkung**  
Beachten Sie beim Anzeigen von Log-Streams die folgenden Eigenschaften:  
Standardmäßig sind die Protokollstreams nach dem Zeitstempel des letzten Ereignisses sortiert.
Mit einem Log-Stream verknüpfte Spalten können entweder in aufsteigender oder absteigender Reihenfolge sortiert werden, indem das Einfügezeichen in den Spaltenüberschriften umgeschaltet wird**.**
**Gefilterte Einträge können nur nach dem Namen des Protokolldatenstroms sortiert werden.**

### Log-Streams anzeigen
<a name="cloudwatch-log-overview-logstream-view"></a>

1. Doppelklicken Sie im **CloudWatch Protokollgruppen-Explorer** auf eine Protokollgruppe, oder klicken Sie mit der rechten Maustaste auf eine Protokollgruppe und wählen Sie im Kontextmenü die Option **Protokollstream anzeigen** aus.

1. Im **Dokumentfenster** wird eine neue Registerkarte geöffnet, die eine Liste der Logstreams enthält, die Ihrer Protokollgruppe zugeordnet sind.

### Log-Streams filtern
<a name="cloudwatch-log-overview-logstream-filter"></a>

1. Platzieren Sie auf der Registerkarte „**Log-Streams**“ im **Dokumentfenster** den Cursor in der Suchleiste.

1. Beginnen Sie mit der Eingabe eines Präfixes, das sich auf den Log-Stream bezieht, nach dem Sie suchen.

1. Während der Eingabe wird die aktuelle Anzeige automatisch aktualisiert, um Ihre Log-Streams nach Ihren Eingaben zu filtern.

### Log-Streams aktualisieren
<a name="cloudwatch-log-overview-logstream-refresh"></a>

Um die aktuelle Liste der im **Dokumentfenster** angezeigten Protokollstreams zu **aktualisieren, klicken Sie in der Werkzeugleiste neben der **Suchleiste** auf die **Symbolschaltfläche**** „Aktualisieren“.

### ARN für Protokollstreams kopieren
<a name="cloudwatch-log-overview-logstream-copyarn"></a>

Um den ARN eines bestimmten Log-Streams zu kopieren, führen Sie die unten beschriebenen Schritte aus.

1. Klicken Sie auf der Registerkarte **Log Streams** im **Dokumentfenster** mit der rechten Maustaste auf den Logstream, aus dem Sie einen ARN kopieren möchten.

1. Wählen Sie im Menü die Option **ARN kopieren**.

1. Der ARN wird jetzt in Ihre lokale Zwischenablage kopiert und kann eingefügt werden.

### Laden Sie Log-Streams herunter
<a name="cloudwatch-log-overview-logstream-delete"></a>

Mit der Funktion **Protokollstream exportieren** wird der ausgewählte Protokollstream heruntergeladen und lokal gespeichert, sodass benutzerdefinierte Tools und Software zur weiteren Verarbeitung darauf zugreifen können.

1. Klicken Sie im **Dokumentfenster** auf der Registerkarte **Protokolldatenströme** mit der rechten Maustaste auf den Protokollstream, den Sie herunterladen möchten.

1. Wählen Sie **Protokollstream exportieren**, um das Dialogfeld In **eine Textdatei exportieren zu** öffnen.

1. Wählen Sie den Speicherort, an dem Sie die Datei lokal speichern möchten, und geben Sie einen Namen in das dafür vorgesehene Textfeld ein.

1. Bestätigen Sie den Download, indem Sie **OK** wählen. Der Status des Downloads wird im **Visual Studio Task Status Center** angezeigt

## CloudWatch Ereignisse protokollieren
<a name="cloudwatch-log-overview-logevents"></a>

Protokollereignisse sind Aufzeichnungen von Aktivitäten, die von der Anwendung oder Ressource aufgezeichnet wurden, von der bzw. die überwacht wird CloudWatch.

### Aktionen von Ereignissen protokollieren
<a name="cloudwatch-log-overview-logevents-actions"></a>

Protokollereignisse werden als Tabelle angezeigt. Standardmäßig werden die Ereignisse vom ältesten bis zum neuesten Ereignis sortiert.

Die folgenden Aktionen sind mit Protokollereignissen in Visual Studio verknüpft:
+ Modus für umbrochenen Text: Sie können den umbrochenen Text umschalten, indem Sie auf ein Ereignis klicken.
+ Schaltfläche für Textumbruch: Diese Schaltfläche befindet sich in der und schaltet den Zeilenumbruch für `document window toolbar` alle Einträge ein und aus.
+ Nachrichten in die Zwischenablage kopieren: Wählen Sie die Nachrichten aus, die Sie kopieren möchten, klicken Sie dann mit der rechten Maustaste auf die Auswahl und wählen Sie **Kopieren** (Tastenkombination). `Ctrl + C`

### Protokollereignisse anzeigen
<a name="cloudwatch-log-overview-logevents-view"></a>

1. Wählen Sie im **Dokumentfenster** eine Registerkarte aus, die eine Liste von Protokolldatenströmen enthält. 

1. Doppelklicken Sie auf einen Log-Stream oder klicken Sie mit der rechten Maustaste auf einen Log-Stream und wählen Sie im Menü **Log-Stream anzeigen** aus.

1. Im **Dokumentfenster** wird eine neue Registerkarte mit **Protokollereignissen** geöffnet, die eine Tabelle mit Protokollereignissen enthält, die mit dem ausgewählten Protokollstream verknüpft sind.

### Filterung von Protokollereignissen
<a name="cloudwatch-log-overview-logevents-filter"></a>

Es gibt drei Möglichkeiten, Protokollereignisse zu filtern: nach Inhalt, Zeitraum oder beidem. Um Ihre Protokollereignisse sowohl nach Inhalt als auch nach Zeitraum zu filtern, filtern Sie Ihre Nachrichten zunächst nach Inhalt oder Zeitraum und filtern Sie diese Ergebnisse dann mit der anderen Methode.

So filtern Sie Ihre Protokollereignisse nach Inhalt:

1. Platzieren Sie auf der Registerkarte „**Protokollereignisse**“ im **Dokumentfenster** den Cursor in der Suchleiste, die sich oben im Fenster befindet.

1. Beginnen Sie mit der Eingabe eines Begriffs oder einer Wortgruppe, die sich auf die Protokollereignisse bezieht, nach denen Sie suchen.

1. Während der Eingabe beginnt die aktuelle Anzeige automatisch, Ihre Protokollereignisse zu filtern.
**Anmerkung**  
Filtermuster beachten die Groß-/Kleinschreibung. Sie können die Suchergebnisse verbessern, indem Sie exakte Begriffe und Wortgruppen mit nicht-alphanumerischen Zeichen in doppelte Anführungszeichen (\*""\*) setzen. Ausführlichere Informationen zu Filtermustern finden Sie unter dem Thema [Filter- und Mustersyntax](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/FilterAndPatternSyntax.html) im CloudWatch Amazon-Leitfaden.

So zeigen Sie Protokollereignisse an, die in einem bestimmten Zeitraum generiert wurden:

1. Wählen Sie auf der Registerkarte „**Ereignisse protokollieren**“ im **Dokumentfenster** die **Symbolschaltfläche „Kalender**“ in der **Werkzeugleiste** aus. 

1. Geben Sie mithilfe der bereitgestellten Felder den Zeitraum an, in dem Sie suchen möchten.

1. Die gefilterten Ergebnisse werden automatisch aktualisiert, wenn Sie die Datums- und Uhrzeitbeschränkungen angeben.
**Anmerkung**  
Die Option **Filter löschen** löscht alle Ihre aktuellen date-and-time Filterauswahlen.

### Protokollereignisse aktualisieren
<a name="cloudwatch-log-overview-logevents-refresh"></a>

Um die aktuelle Liste der Protokollereignisse, die auf der Registerkarte „**Protokollereignisse**“ angezeigt wird, zu **aktualisieren, wählen Sie in der Werkzeugleiste die Symbolschaltfläche** **„Aktualisieren“**.

## Zusätzlicher Zugriff auf CloudWatch Protokolle
<a name="cloudwatch-log-overview-additional"></a>

Sie können direkt über das AWS Toolkit in Visual Studio auf CloudWatch Protokolle zugreifen, die mit anderen AWS Diensten und Ressourcen verknüpft sind.

### Lambda
<a name="cloudwatch-log-overview-additional-lambda"></a>

So zeigen Sie Log-Streams an, die mit einer Lambda-Funktion verknüpft sind:

**Anmerkung**  
Ihre Lambda-Ausführungsrolle muss über die entsprechenden Berechtigungen verfügen, um Protokolle an Logs zu CloudWatch senden. Weitere Informationen zu den für CloudWatch Logs erforderlichen Lambda-Berechtigungen finden Sie in der [https://docs.aws.amazon.com/lambda/latest/dg/monitoring-cloudwatchlogs.html#monitoring-cloudwatchlogs-prereqs](https://docs.aws.amazon.com/lambda/latest/dg/monitoring-cloudwatchlogs.html#monitoring-cloudwatchlogs-prereqs)

1. Erweitern Sie **Lambda** im AWS Toolkit Explorer.

1. Klicken Sie mit der rechten Maustaste auf die Funktion, die Sie anzeigen möchten, und wählen Sie dann **Protokolle anzeigen**, um die zugehörigen Log-Streams im **Dokumentfenster** zu öffnen.

So zeigen Sie Log-Streams mit der Lambda-Integration `function view` an:

1. Erweitern Sie **Lambda** im AWS Toolkit Explorer.

1. Klicken Sie mit der rechten Maustaste auf die Funktion, die Sie anzeigen möchten, und wählen Sie dann **Funktion anzeigen**, um die Funktionsansicht im **Dokumentfenster** zu öffnen.

1. Wechseln Sie von der `function view` Registerkarte Logs zur Registerkarte **Logs**. Dort werden die Log-Streams angezeigt, die der ausgewählten Lambda-Funktion zugeordnet sind.

### ECS
<a name="cloudwatch-log-overview-additional-ecs"></a>

Gehen Sie wie folgt vor, um Protokollressourcen anzuzeigen, die einem ECS-Task-Container zugeordnet sind.

**Anmerkung**  
Damit der Amazon ECS-Service Protokolle senden kann CloudWatch, muss jeder Container für eine bestimmte Amazon ECS-Task die erforderliche Konfiguration erfüllen. Weitere Informationen zur erforderlichen Einrichtung und Konfiguration finden Sie in der Anleitung [Using the AWS Logs Log Driver](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/using_awslogs.html).

1. Erweitern Sie **Amazon ECS** im AWS Toolkit Explorer.

1. Wählen Sie den Amazon ECS-Cluster aus, den Sie anzeigen möchten, um im **Dokumentfenster** eine neue Registerkarte für den **ECS-Cluster** zu öffnen.

1. Wählen Sie im Navigationsmenü auf der linken Seite der Registerkarte **ECS-Cluster** die Option **Aufgaben** aus, um alle mit dem Cluster verknüpften Aufgaben aufzulisten.

1. Wählen Sie in der **Aufgabenanzeige** eine Aufgabe aus und klicken Sie **auf den Link Protokolle anzeigen**, der sich in der unteren linken Ecke befindet.
**Anmerkung**  
In dieser Anzeige werden alle im Cluster enthaltenen Aufgaben aufgeführt. Der `View Logs` Link ist nur für jede Aufgabe sichtbar, die der erforderlichen Protokollkonfiguration entspricht.  
Wenn eine Aufgabe nur einem einzelnen Container zugeordnet ist, öffnet der Link „**Protokolle anzeigen**“ den Log-Stream dieses Containers.
Wenn eine Aufgabe mehreren Containern zugeordnet ist, öffnet der Link „**Logs anzeigen**“ das Dialogfeld „** CloudWatch Logs für ECS-Task anzeigen**“. Wählen Sie im Drop-down-Menü **Container:** den Container aus, für den Sie Logs anzeigen möchten, und wählen Sie dann **OK**.

1. Im **Dokumentfenster** wird eine neue Registerkarte geöffnet, auf der die Log-Streams angezeigt werden, die mit Ihrer Container-Auswahl verknüpft sind.