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.
Zoekt u naar Tableau Server in Linux? Zie Locaties van serverlogboekbestanden.
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, C:\ProgramData\Tableau\Tableau Server\data\tabsvc\logs\
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
-
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 inC:\Users\<user>\.tableau\tsm
. - Het installatielogboek. Standaard bevindt het
app-install.log
-bestand zich inC:\ProgramData\Tableau\Tableau Server\logs
. - Het upgradelogboek. Standaard bevindt het
app-upgrade.log
-bestand zich inC:\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