Konfigurieren der Protokollierung - Amazon Redshift

Konfigurieren der Protokollierung

Sie können die Protokollierung im Treiber aktivieren, um bei der Diagnose von Problemen zu helfen.

Sie können Treiberinformationen mit den folgenden Methoden protokollieren.

Sie geben die Konfigurationsinformationen an den Treiber in der Verbindungs-URL an. Weitere Informationen zur Syntax der Verbindungs-URL finden Sie unter Erstellen der Verbindungs-URL.

Verwendung der Protokolldateien

Aktivieren Sie die Protokollierung nur lange genug, um ein Problem zu erfassen. Die Protokollierung reduziert die Leistung und kann eine große Menge an Datenträgerplatz verbrauchen.

Legen Sie den LogLevel-Schlüssel in Ihrer Verbindungs-URL fest, um die Protokollierung zu aktivieren und den Grad an Details anzugeben, die in den Protokolldateien enthalten sein sollen. In der folgenden Tabelle sind die Protokollierungsebenen aufgeführt, die von der Amazon-Redshift-JDBC-Treiberversion 2.1 bereitgestellt werden, angefangen bei der kürzesten bis hin zur ausführlichsten.

LogLevel-Wert Description (Beschreibung)

1

Protokollieren Sie schwerwiegende Fehlerereignisse, die beim Treiber zum Abbruch führen.

2

Protokollieren Sie Fehlerereignisse, bei denen der Treiber weiter ausgeführt werden kann.

3

Protokollieren Sie Ereignisse, die zu einem Fehler führen können, wenn keine Aktion ausgeführt wird.

4

Protokollieren Sie allgemeine Informationen, die den Fortschritt des Treibers beschreiben.

5

Protokollieren Sie detaillierte Informationen, die nützlich für das Debugging des Treibers sind.

6

Protokollieren Sie alle Treiberaktivitäten.

So richten Sie die Protokollierung ein, die Protokolldateien verwendet

  1. Legen Sie in der Eigenschaft LogLevel fest, wie genau die Informationen in den Protokolldateien sein sollen.

  2. Geben Sie in der Eigenschaft LogPath den vollständigen Pfad zu dem Ordner an, in dem Sie Protokolldateien speichern möchten.

    Die folgende Verbindungs-URL aktiviert beispielsweise die Protokollierungsebene 3 und speichert die Protokolldateien im Ordner C:\temp: jdbc:redshift://redshift.company.us-west- 1.redshift.amazonaws.com:9000/Default;DSILogLevel=3; LogPath=C:\temp

  3. Um sicherzustellen, dass die neuen Einstellungen wirksam werden, starten Sie Ihre JDBC-Anwendung neu und stellen Sie erneut eine Verbindung zum Server her.

    Der Amazon-Redshift-JDBC-Treiber erzeugt die folgenden Protokolldateien an dem in der Eigenschaft LogPath angegebenen Speicherort:

    • Die Datei redshift_jdbc.log, die Treiberaktivitäten protokolliert, die nicht für eine Verbindung spezifisch sind.

    • Die Datei edshift_jdbc_connection_[Nummer].log für jede Verbindung mit der Datenbank, wobei [Nummer] eine Zahl ist, die jede Protokolldatei identifiziert. Diese Datei protokolliert Treiberaktivitäten, die für die Verbindung spezifisch sind.

Wenn der LogPath-Wert ungültig ist, sendet der Treiber die protokollierten Informationen an den Standardausgabestream (System.out)

Verwenden von LogStream oder LogWriter

Aktivieren Sie die Protokollierung nur lange genug, um ein Problem zu erfassen. Die Protokollierung reduziert die Leistung und kann eine große Menge an Datenträgerplatz verbrauchen.

Legen Sie den LogLevel-Schlüssel in der Verbindungs-URL fest, um die Protokollierung zu aktivieren, und geben Sie an, welche Details an den im DriverManager angegebenen LogStream oder LogWriter gesendet werden.

So aktivieren Sie die Protokollierung, die LogStream oder LogWriter verwendet:

  1. Um den Treiber so zu konfigurieren, dass allgemeine Informationen protokolliert werden, die den Fortschritt des Treibers beschreiben, legen Sie die LogLevel-Eigenschaft auf 1 oder INFO fest.

  2. Um sicherzustellen, dass die neuen Einstellungen wirksam werden, starten Sie Ihre JDBC-Anwendung neu und stellen Sie erneut eine Verbindung zum Server her.

So deaktivieren Sie die Protokollierung, die LogStream oder LogWriter verwendet:

  1. Entfernen Sie die LogLevel-Eigenschaft aus der Verbindungs-URL.

  2. Um sicherzustellen, dass die neuen Einstellungen wirksam werden, starten Sie Ihre JDBC-Anwendung neu und stellen Sie erneut eine Verbindung zum Server her.