Speicherorte der Tableau Server-Protokolle und -Protokolldateien

Das Generieren von Protokolldateien zählt zu den Standardaktivitäten in Tableau Server. Jeder Dienst, der als Teil von Tableau Server ausgeführt wird, generiert eigene Protokolle. Diese Protokolldateien enthalten Informationen darüber, was auf dem Server geschieht, was der Dienst oder Prozess tut und zur Vorgehensweise, wenn Fehler oder Warnungen generiert werden. Der Umfang der Informationen in den Protokollen hängt davon ab, welcher Dienst die Protokolle schreibt, wie die Protokollierungsebenen festgelegt sind und was auf dem Server geschieht.

Protokolldateien können hilfreich sein, um Probleme in Tableaus Server zu identifizieren und zu beheben. In einigen Fällen können Systemadministratoren Protokolle anzeigen und Hinweise auf die Geschehnisse anzeigen, aber in den meisten Fällen sind die Tableau Server-Protokolle für den Tableau-Support am hilfreichsten. Wenn Sie eine Anfrage beim Support öffnen, werden Sie möglicherweise aufgefordert, Protokolldateien von Ihrem Server zu senden.

Hinweis: Die von Tableau Server generierten spezifischen Verzeichnisse und Protokolle hängen von der von Ihnen ausgeführten Serverversion und von den von Ihnen konfigurierten Prozessen ab. Neue Dienste und Prozesse werden regelmäßig hinzugefügt, um neue Funktionen zu unterstützen. Weitere Einzelheiten zu Prozessen oder Diensten, zu denen möglicherweise Protokolle vorliegen, finden Sie unter Tableau Server-Prozesse.

Tableau Server-Protokolldateien in einem aktiven Cluster

Als bewährte Methode sollten Sie Protokolldateien in einer aktiven Tableau Server-Installation nicht bearbeiten oder löschen. Dies kann zu unerwartetem Verhalten oder Serverausfallzeiten führen. Die meisten Tableau Server-Protokolle werden an einen Speicherort im Datenverzeichnis geschrieben. Einige Protokolle werden an andere Speicherorte geschrieben.

Die einfachste und sicherste Methode zum Sammeln und Anzeigen von Serverprotokolldateien besteht darin, ein Protokollarchiv zu erstellen, bei dem es sich um eine gepackte Sammlung von Protokollen aller Knoten in einem Cluster handelt. Wenn Sie aus irgendeinem Grund alte Protokolle benötigen, beispielsweise für einen Vergleich mit neuen Protokollen nach einem Upgrade oder um sie bei der Fehlerbehebung im Rahmen eines Serverproblems an den Tableau-Support zu senden, erstellen Sie ein ZIP-Archiv, und verschieben Sie das Archiv an einen sicheren Speicherort, der nicht Teil Ihrer Tableau Server-Infrastruktur ist. Weitere Informationen zu Protokolldateien in einem Protokollarchiv finden Sie unter Server-Protokolldateien in einem gepackten Archiv.

Protokolle können viel Speicherplatz in Anspruch nehmen, insbesondere auf einem stark genutzten Server. Mithilfe des Befehls tsm maintenance cleanup können Sie Protokolle entfernen, die Sie nicht mehr behalten möchten oder benötigen. Wenn Sie die vorhandenen Protokolle jedoch möglicherweise noch einmal benötigen, sollten Sie vor der Bereinigung eine Archivierung in Erwägung ziehen.

Primäre Protokollspeicherorte in einer funktionierenden Tableau Server-Installation

Die meisten Tableau Server-Protokolle werden standardmäßig C:\ProgramData\Tableau\Tableau Server\data\tabsvc\logs\in das Datenverzeichnis geschrieben. Unterordner werden für jede Instanz eines Diensts mit einem Namen erstellt, der den Dienstnamen und den Versionscode enthält. Beispiel:

C:\ProgramData\Tableau\Tableau Server\data\tabsvc\logs\backgrounder

Konfigurationsdateispeicherorte in einer funktionierenden Tableau Server-Installation

Zusätzlich zu den Protokollen für die einzelnen Dienste oder Prozesse enthält ein config -Unterordner Konfigurationsinformationen zu dem Dienst.

C:\ProgramData\Tableau\Tableau Server\data\tabsvc\config\backgrounder

Der Tableau-Support kann Sie bitten, einige davon zu sammeln, wenn Sie mit ihm an einem Serverproblem arbeiten. Der Inhalt kann vom Support analysiert werden.

Protokolle, die nicht an den primären Speicherort geschrieben werden

Einige Protokolle gehören nicht zum Protokollhauptsatz und werden an andere Speicherorte als die normalen Protokollordner geschrieben:

  • Das TSM-Protokoll. Die Datei tsm.log befindet sich im Verzeichnis C:\Users\<user>\.tableau\tsm.
  • Das Installationsprotokoll. Standardmäßig befindet sich die Datei app-install.log im Verzeichnis C:\ProgramData\Tableau\Tableau Server\logs.
  • Das Upgrade-Protokoll. Standardmäßig befindet sich die Datei app-upgrade.log im Verzeichnis C:\ProgramData\Tableau\Tableau Server\logs.
  • Shell-Skript-Protokolle. Tableau Server-Skripte befinden sich im \scripts-Verzeichnis (Dies ist standardmäßig:C:\Program Files\Tableau\Tableau Server\packages\scripts.<version_code>\), und viele dieser Skripte generieren bei jeder Skriptausführung Protokolle. Skriptprotokolle werden unter dem folgenden Verzeichnis gespeichert:

    <install_drive>\<install\path>\logs\

    standardmäßig:

    C:\ProgramData\Tableau\Tableau Server\logs

Server-Protokolldateien in einem gepackten Archiv

Wenn Sie ein Problem mit Ihrem Server haben, sollten Sie die Tableau Server-Protokolldateien anzeigen oder an den Tableau-Support senden. Erstellen Sie mithilfe des Befehls tsm maintenance ziplogs ein gepacktes Archiv mit Protokolldateien aus allen Knoten Ihrer Installation. Standardmäßig werden Protokolldateiarchive von Tableau Server in der ZIP-Datei logs.zip erfasst. Sie können jedoch einen anderen Namen angeben, wenn Sie das Archiv erstellen. Sie können das Archiv vom Server auf einen lokalen Computer kopieren und dort öffnen oder an den Tableau Support senden.

Wenn Sie das Archiv entpacken, wird für jeden Knoten im Cluster ein Verzeichnis erstellt. In diesem Verzeichnis befinden sich Unterverzeichnisse für jeden Dienst oder Prozess, der diese Namenskonvention verwendet:

<service_name>_<instance>.<version>.<build>

Wenn mehrere Instanzen eines Dienstes auf einem Knoten vorhanden sind, gibt es mehrere Verzeichnisse für diesen Dienst, und zwar eins für jede Instanz. Wenn Sie beispielsweise über zwei Hintergrundprozesskomponenten auf einem Knoten verfügen, werden Verzeichnisse wie die folgenden angezeigt:

backgrounder_0.<version>.<build>
backgrounder_1.<version>.<build>

Die spezifischen Verzeichnisse und Protokolle in der ZIP-Datei hängen davon ab, welche Version von Tableau Server Sie haben und welche Prozesse Sie konfiguriert haben. Weitere Einzelheiten zu Prozessen oder Diensten, zu denen möglicherweise Protokolle vorliegen, finden Sie unter Tableau Server-Prozesse.

Temporäre Dateien

Jede Datei, die im nachstehenden Ordner mit exe_ beginnt, ist eine Tableau Server-Datei und kann gelöscht werden.

C:\ProgramData\Tableau\Tableau Server\temp

Vielen Dank für Ihr Feedback!Ihr Feedback wurde erfolgreich übermittelt. Vielen Dank.