Help voor Tableau Server op Windows

Standaard registreren Tableau Services Manager (TSM) en Tableau Server gebeurtenissen op het niveau info. U kunt dit wijzigen als u meer informatie wilt verzamelen (bijvoorbeeld als u met de Tableau-ondersteuning samenwerkt).

Als best practice geldt dat u het registratieniveau niet mag verhogen, tenzij u een probleem wilt oplossen, zoals aangegeven door de ondersteuning. U dient alleen het registratieniveau op debug in te stellen wanneer u een specifiek probleem onderzoekt. Het wijzigen van het registratieniveau kan de volgende gevolgen hebben:

• Het verhogen van het registratieniveau naar debug of trace vergroot de hoeveelheid geregistreerde informatie en kan een aanzienlijke impact hebben op de prestaties. Reproduceer het probleem en zet het registratieniveau vervolgens terug naar info.
• Het registratieniveau instellen op warn of error kan de hoeveelheid informatie zo ver verminderen dat deze niet meer bruikbaar is voor de Tableau-ondersteuning.

Opmerking: bij het registreren op het niveau DEBUG wordt er volledige omgevingsinformatie verzameld wanneer Tableau start. Dit betekent dat gevoelige informatie in een omgevingsvariabele kan worden opgenomen in een logboek. Registreren op het standaardniveau INFO verzamelt alleen veilige informatie over de omgeving.

Registratieniveaus

De volgende registratieniveaus worden weergegeven in volgorde van toenemende hoeveelheid geregistreerde informatie:

• off
• fatal
• error
• warn
• info (de standaard)
• debug
• trace

Registratieniveaus wijzigen

Stel registratieniveaus in voor TSM- en Tableau Server-processen met behulp van de tsm configuration set-configuratiesleutels. Welke sleutel u gebruikt, hangt af van het component van TSM of Tableau Server waarvoor u het registratieniveau wilt wijzigen.

Dynamische configuratie van registratieniveau

In versie 2020.2 hebben we dynamische configuratie geïntroduceerd. In latere releases zijn de mogelijkheden uitgebreid. Als u alleen de registratieniveaus voor een of meer van deze componenten wijzigt en u de juiste versie van Tableau gebruikt, kunt u de registratieniveaus wijzigen zonder Tableau Server opnieuw te hoeven opstarten.

Deze registratieniveaus zijn dynamisch configureerbaar, te beginnen met de volgende versies:

• 2020.2 - tsm-services (tsm.log.level) en toepassingsservices beheren (tsm.controllerapp.log.level).
• 2020.3 - backgrounder (backgrounder.log.level), clustercontroller (clustercontroller.log.level), dataserver (dataserver.log.level), bestandsarchief (filestore.log.level), eigenschappen databron (tdsservice.log.level) en VizQL-server (vizqlserver.log.level).
• 2020.4 - voegt interactieve microservicecontainer (tomcatcontainer.log.level) en toepassingsserver (vizportal.log.level) toe.

Configuratiesleutels voor het wijzigen van registratieniveaus

Deze tabel bevat zowel dynamisch configureerbare sleutels als sleutels die niet dynamisch configureerbaar zijn.

Zie tsm configuration set-opties voor meer informatie.

Als u alleen dynamisch configureerbare registratieniveaus wijzigt, hoeft u de server niet te stoppen of te starten (zie Dynamische configuratie van registratieniveau hierboven voor meer informatie). Als u andere registratieniveaus wijzigt, moet u Tableau Server mogelijk eerst stoppen voordat u de registratieniveaus wijzigt. Daarna moet u Tableau Server opnieuw opstarten. Als dit het geval is, wordt u hierom gevraagd.

Stel bij een installatie met meerdere knooppunten van Tableau Server de registratieniveaus in vanaf het eerste knooppunt.

Het registratieniveau wijzigen:

1. (Optioneel voor dynamisch configureerbare registratieniveaus in 2020.2.0 en hoger) Stop Tableau Server door een opdrachtprompt te openen en het volgende te typen:

   tsm stop

2. Stel het registratieniveau in door tsm configuration set -k <config.key> -v <config_value> te typen

   waarbij <config.key> een van de sleutels in de bovenstaande tabel is en <config_value> een geldig registratieniveau is.

   Voorbeelden:

   • 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. Pas in behandeling zijnde wijzigingen toe door de opdracht tsm pending-changes apply uit te voeren.

4. (Optioneel, alleen als de server is gestopt) Start Tableau Server door de volgende opdracht uit te voeren:

   tsm start

Registratieniveaus opnieuw instellen

Nadat u het probleem hebt gereproduceerd en informatie over het probleem hebt verzameld, stelt u de registratieniveaus opnieuw in om blijvende impact op de prestaties en gebruik van extra schijfruimte te voorkomen.

In Tableau Server 2026.2 en hoger kunt u met tsm maintenance log-levels-opdrachten alle serviceregistratieniveaus bekijken en opnieuw instellen op de standaardwaarden. Zie tsm maintenance voor meer informatie.

• Als u alle configuraties van registratieniveaus wilt zien voordat u deze opnieuw instelt, voert u het volgende uit:

  tsm maintenance log-levels list

• Als u alle configuraties van registratieniveaus wilt instellen op de standaardwaarden, voert u het volgende uit:

  tsm maintenance log-levels reset

Voor eerdere versies van Tableau Server of als u specifieke sleutels opnieuw wilt instellen, voert u de opdracht tsm configuration set uit met de optie -d.

Voorbeelden:

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

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

U moet de lopende wijzigingen toepassen nadat u de registratieniveaus opnieuw hebt ingesteld. Als u de registratieniveaus voor Tableau Server-processen opnieuw instelt, controleer dan de lijst met lopende wijzigingen. Als de update vereist dat de server opnieuw wordt opgestart, stopt u de server, past u de wijzigingen toe en start u de server weer op.