Hilfe zu Tableau Server für Windows

Standardmäßig protokollieren Tableau Services Manager (TSM) und Tableau Server Ereignisse auf der Ebene Info. Sie können dies ändern, wenn Sie mehr Informationen erfassen müssen (z. B. beim Arbeiten mit dem Tableau-Support).

Sie sollten Protokollebenen nur erhöhen, wenn Sie ein Problem beheben müssen, nach Anweisung des Supports. Für debug sollten Sie nur dann eine Protokollstufe einstellen, wenn Sie ein bestimmtes Problem untersuchen. Folgende Auswirkungen ergeben sich aus dem Ändern von Protokollebenen:

• Wenn Sie die Protokollebene auf debug oder trace erhöhen, erhöht sich damit die Menge der protokollierten Informationen, und das kann sich wiederum erheblich auf die Leistung auswirken. Stellen Sie das Problem wieder her und setzen Sie die Protokollstufe auf info zurück.
• Legen Sie die Protokollebene auf warn oder error festlegen, kann das die Menge an Informationen so stark reduzieren, dass sie für den Tableau-Support nicht nützlich ist.

Hinweis: Bei der Protokollierung auf der DEBUG-Ebene werden beim Start von Tableau alle Umgebungsinformationen erfasst. Das bedeutet, dass vertrauliche Informationen in einer Umgebungsvariablen in ein Protokoll aufgenommen werden können. Die Protokollierung auf der Standardstufe INFO sammelt nur sichere Umgebungsinformationen.

Protokollstufen

Die im Folgenden aufgeführten Protokollstufen sind in aufsteigender Reihenfolge nach der Menge der protokollierten Informationen aufgeführt:

• off(aus)
• fatal(schwerwiegend)
• error(Fehler)
• warn(warnen)
• info (the default) (Info (der Standard))
• debug(debuggen)
• trace(Ablaufverfolgung)

Ändern von Protokollstufen

Legen Sie Protokollstufen für TSM- und Tableau Server-Prozesse mit einem der Konfigurationsschlüssel vom Typ tsm configuration set fest. Welchen Schlüssel Sie verwenden, hängt davon ab, für welche Komponente von TSM oder Tableau Server Sie die Protokollstufe ändern möchten.

Dynamische Konfiguration der Protokollebene

In Version 2020.2 haben wir die dynamische Konfiguration eingeführt. Die Funktion wurde in nachfolgenden Versionen erweitert. Wenn Sie nur die Protokollierungsebenen für eine oder mehrere dieser Komponenten ändern und die entsprechende Version von Tableau ausführen, können Sie die Protokollierungsebenen ändern, ohne Tableau Server neu zu starten.

Diese Protokollierungsebenen sind dynamisch konfigurierbar, beginnend mit diesen Versionen:

• 2020.2: tsm-Dienste (tsm.log.level ) und Kontrollanwendungsdienste (tsm.controllerapp.log.level ).
• 2020.3: Hintergrundprozesskomponente (backgrounder.log.level ), Cluster-Controller (clustercontroller.log.level ), Datenserver (dataserver.log.level ), Dateispeicher (filestore.log.level ), Datenquelleneigenschaften (tdsservice.log.level ) und VizQL-Server (vizqlserver.log.level ).
• 2020.4: Hinzunahme des interaktiven Microservice-Containers (tomcatcontainer.log.level) und des Anwendungsservers (vizportal.log.level).

Konfigurationsschlüssel zum Ändern der Protokollierungsebenen

Diese Tabelle enthält sowohl dynamisch konfigurierbare als auch nicht dynamisch konfigurierbare Schlüssel.

Weitere Informationen finden Sie unter tsm configuration set-Optionen.

Wenn Sie nur dynamisch konfigurierbare Protokollierungsebenen ändern möchten, müssen Sie den Server nicht anhalten oder starten (weitere Informationen finden Sie oben unter Dynamische Konfiguration der Protokollebene). Wenn Sie andere Protokollierungsebenen ändern möchten, müssen Sie Tableau Server möglicherweise beenden, bevor Sie die Protokollierungsebenen ändern, und anschließend neu starten. Wenn dies der Fall ist, werden Sie dazu aufgefordert.

Legen Sie auf einer Installation auf mehreren Knotenpunkten von Tableau Server die Protokollstufen auf dem ursprünglichen Knotenpunkt fest.

So ändern Sie die Protokollstufe:

1. (Optional für die dynamisch konfigurierbare Protokollierungsebene in 2020.2.0 und höher) Beenden Sie Tableau Server, indem Sie eine Eingabeaufforderung öffnen und Folgendes eingeben:

   tsm stop

2. Stellen Sie die Protokollebene ein, indem Sie tsm configuration set -k <config.key> -v <config_value> eingeben,

   wobei <config.key> einer der Schlüssel in der obigen Tabelle und <config_value> eine gültige Protokollstufe ist.

   Beispiele:

   • tsm configuration set -k backgrounder.native_api.log.level -v debug                    

   • tsm configuration set -k tsm.log.level -v debug

   • tsm configuration set -k tsm.controlapp.log.level -v debug

3. Wenden Sie ausstehende Änderungen an, indem Sie den Befehl tsm pending-changes apply ausführen.

4. (Optional, nur wenn der Server angehalten wird) Starten Sie Tableau Server, indem Sie den folgenden Befehl ausführen:

   tsm start

Zurücksetzen von Protokollstufen

Nachdem Sie das Problem reproduziert und Informationen zum Problem gesammelt haben, setzen Sie die Protokollierungsebenen zurück, um zu vermeiden, dass es bleibende Auswirkungen auf die Leistung gibt und weiterer Festplattenspeicherplatz belegt wird.

In Tableau Server 2026.2 und höher können Sie mit tsm maintenance log-levels-Befehlen alle Dienstprotokollierungsebenen anzeigen und auf ihre Standardwerte zurücksetzen. Weitere Informationen dazu finden Sie unter tsm maintenance.

• Um alle Konfigurationen auf Protokollebene vor dem Zurücksetzen anzuzeigen, führen Sie Folgendes aus:

  tsm maintenance log-levels list

• Um alle Konfigurationen auf Protokollebene auf ihre Standardwerte zu setzen, führen Sie Folgendes aus:

  tsm maintenance log-levels reset

Bei früheren Versionen von Tableau Server oder zum Zurücksetzen bestimmter Schlüssel führen Sie den Befehl tsm configuration set mit der Option -d aus.

Beispiele:

• tsm configuration set -k backgrounder.native_api.log.level -d

• tsm configuration set -k tsm.log.level -d

Sie müssen ausstehende Änderungen nach dem Zurücksetzen von Protokollebenen anwenden. Wenn Sie Protokollebenen für Tableau Server-Prozesse zurücksetzen, überprüfen Sie die Liste der ausstehenden Änderungen. Wenn für die Aktualisierung ein Neustart erforderlich ist, stoppen Sie den Server, übernehmen Sie die Änderungen und starten Sie den Server dann erneut.