Tableau Server-logboeken en locaties van logboekbestanden

Tableau Server genereert logboekbestanden als normaal onderdeel van de werking ervan. Elke service die als onderdeel van Tableau Server wordt uitgevoerd, genereert zijn eigen logboeken. Deze logboekbestanden bevatten informatie over wat er op de server gebeurt, wat de service of het proces doet en welke fouten of waarschuwingen er eventueel worden gegenereerd. De hoeveelheid informatie in de logboeken hangt af van welke service de logboeken schrijft, wat de registratieniveaus zijn en wat er op de server gebeurt.

Logboekbestanden kunnen nuttig zijn bij het identificeren en oplossen van problemen met Tableau Server. In sommige gevallen kunnen systeembeheerders logboeken bekijken en aanwijzingen vinden over wat er gebeurt, maar in de meeste gevallen zijn de Tableau Server-logboeken het nuttigst voor de Tableau-ondersteuning. Wanneer u een case opent bij de ondersteuning, wordt u mogelijk gevraagd om logboekbestanden vanuit uw server te verzenden.

Opmerking: de specifieke directory's en logboeken die door Tableau Server worden gegenereerd, zijn afhankelijk van de versie van de server die u gebruikt en de processen die u hebt geconfigureerd. Er worden periodiek nieuwe services en processen toegevoegd ter ondersteuning van nieuwe functionaliteit. Zie Tableau Server-processen voor details over processen of services waarvoor u mogelijk logboeken kunt vinden.

Tableau Server-logboekbestanden op een actief cluster

Als best practice geldt dat u logboekbestanden in een actieve Tableau Server-installatie niet mag bewerken of verwijderen. Dit kan namelijk onverwacht gedrag of uitval van de server veroorzaken. De meeste Tableau Server-logboeken worden naar een locatie in de datadirectory geschreven. Sommige logboeken worden naar andere locaties geschreven.

De eenvoudigste en veiligste manier om serverlogboekbestanden te verzamelen en te bekijken, is door een logboekarchief te maken. Dit is een gezipte verzameling van logboeken van alle knooppunten in een cluster. Als u denkt dat u om welke reden dan ook oude logboeken nodig hebt, bijvoorbeeld om ze te vergelijken met nieuwe logboeken na een upgrade of om ze naar de Tableau-ondersteuning te sturen bij het oplossen van een serverprobleem, maakt u een gezipt archief en verplaatst u het archief naar een veilige locatie die geen deel uitmaakt van uw Tableau Server-infrastructuur. Zie Serverlogboekbestanden in een gezipt archief voor meer informatie over logboekbestanden in een logboekarchief.

Logboeken kunnen veel ruimte in beslag nemen, vooral op een server die veel wordt gebruikt. U kunt de opdracht tsm maintenance cleanup gebruiken om logboeken te verwijderen die u niet meer wilt of nodig hebt. Als u echter denkt dat u uw bestaande logboeken toch nodig hebt, kunt u overwegen deze te archiveren voordat u de opschoning uitvoert.

Primaire logboeklocaties in een werkende Tableau Server-installatie

De meeste Tableau Server-logboeken worden naar de datadirectory geschreven, standaard C:\ProgramData\Tableau\Tableau Server\data\tabsvc\logs\. Submappen worden voor elke instantie van een service gemaakt, met een naam die de servicenaam en de versiecode bevat. Bijvoorbeeld:

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

Locaties van configuratiebestanden in een werkende Tableau Server-installatie

Naast logboeken voor elke service of elk proces bevat een config -submap configuratie-informatie over de service.

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

Het kan zijn dat de Tableau-ondersteuning u vraagt om hier een aantal van te verzamelen als u met hen samenwerkt aan een serverprobleem. De inhoud kan door de ondersteuning worden geanalyseerd.

Logboeken die niet op de primaire locatie zijn geschreven

Een paar logboeken maken geen deel uit van de hoofdset van logboeken en worden naar andere locaties dan de normale logboekmappen geschreven:

  • Het TSM-logboek. Het tsm.log-bestand bevindt zich in C:\Users\<user>\.tableau\tsm.
  • Het installatielogboek. Standaard bevindt het app-install.log-bestand zich in C:\ProgramData\Tableau\Tableau Server\logs.
  • Het upgradelogboek. Standaard bevindt het app-upgrade.log-bestand zich in C:\ProgramData\Tableau\Tableau Server\logs.
  • Shell-scriptlogboeken. Tableau Server-scripts bevinden zich in de directory \scripts (Standaard:C:\Program Files\Tableau\Tableau Server\packages\scripts.<version_code>\) en veel van deze genereren logboeken elke keer dat een script wordt uitgevoerd. Scriptlogboeken worden opgeslagen in:

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

    standaard:

    C:\ProgramData\Tableau\Tableau Server\logs

Serverlogboekbestanden in een gezipt archief

Mogelijk wilt u de logboekbestanden van Tableau Server bekijken of deze naar de Tableau-ondersteuning sturen als u een probleem met uw server ondervindt. Gebruik de opdracht tsm maintenance ziplogs om een gezipt archief te maken van logboekbestanden van alle knooppunten in uw installatie. Standaard worden de logboekbestandarchieven van Tableau Server verzameld in een zipbestand met de naam logs.zip, maar u kunt een andere bestandsnaam opgeven wanneer u het archief maakt. U kunt het archief van de server naar een lokale computer kopiëren en het daar openen of het naar de Tableau-ondersteuning sturen.

Wanneer u het archief uitpakt, wordt er voor elk knooppunt in het cluster een directory gemaakt. In die directory staan subdirectory's voor elke service of elk proces, volgens de volgende naamgevingsconventie:

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

Als er meerdere instanties van een service op een knooppunt staan, zijn er meerdere directory's voor die service, één voor elke instantie. Als u bijvoorbeeld twee Backgrounders op een knooppunt hebt, ziet u directory's zoals deze:

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

De specifieke directory's en logboeken in het zipbestand zijn afhankelijk van welke versie van Tableau Server u hebt en welke processen u hebt geconfigureerd. Zie Tableau Server-processen voor details over processen of services waarvoor u mogelijk logboeken kunt vinden.

Tijdelijke bestanden

Elk bestand dat begint met exe_ in de onderstaande map is een Tableau Server-bestand en kan worden verwijderd.

C:\ProgramData\Tableau\Tableau Server\temp

Bedankt voor uw feedback.De feedback is verzonden. Dank u wel.