Registratieniveaus wijzigen

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.

ConfiguratiesleutelLocatie van de beïnvloede logboeken

(pad begint met C:\ProgramData\Tableau\Tableau Server\data\tabsvc\logs\)

tsm.log.level

Wijzigt TSM-registratieniveaus voor: clientfileservice, licenseservice, tabadminagent, tabadmincontroller, tabsvc

\<service>\<service>_node<n>-<instance>.log

voorbeeld: \clientfileservice\clientservice_node1-0.log

tsm.controlapp.log.level

Wijzigt TSM-registratieniveaus voor: controletoepassingen

\<service>\control_<service>_node<n>-<instance>.log

voorbeelden: \clientfileservice\control_clientservice_node1-0.log

\filestore\control_filestore_node1-0.log

<process>.native_api.log.level

Geldige procesnamen zijn: backgrounder, vizportal, vizqlserver, dataserver

Opmerking: deze kunnen niet dynamisch worden geconfigureerd.

\vizqlserver\*.txt

backgrounder.log.level

Wijzigt de registratieniveaus voor: Backgrounder

\backgrounder\*.log

clustercontroller.log.level

Wijzigt de registratieniveaus voor: clustercontroller

\clustercontroller\*.log

dataserver.log.level

Wijzigt de registratieniveaus voor: Data Server

\dataserver\*.log

filestore.log.level

Wijzigt de registratieniveaus voor: Bestandsarchief

\filestore\*.log

gateway.log.level

Wijzigt de registratieniveaus voor: Gateway-controleprocessen

\gateway\*.log

gateway.httpd.loglevel

Opmerking: toegevoegd in versie 2021.3.0

Wijzigt de registratieniveaus voor: Gateway

\gateway\*.log

hyper.log.level

Wijzigt de registratieniveaus voor: Hyper

\hyper\*.log

tdsservice.log.level

Wijzigt de registratieniveaus voor: service Eigenschappen databron

\tdsservice\*.log

tomcatcontainer.log.level

Wijzigt het registratieniveau voor microservices in: container voor interactieve microservices en de container voor niet-interactieve microservices

\tomcatcontainer\*.log

vizportal.log.level

Wijzigt de registratieniveaus voor: Toepassingsserver

\vizportal\*.log

vizqlserver.log.level

Wijzigt de registratieniveaus voor: VizQL Server

\vizqlserver\*.log

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 de informatie over het probleem hebt verzameld, stelt u de registratieniveaus opnieuw in, zodat er geen blijvende impact is op de prestaties en er geen extra schijfruimte wordt gebruikt.

Stel het registratieniveau opnieuw in op de standaardwaarde (info) met behulp van de juiste opdracht met een optie -d. U moet de in behandeling zijnde wijzigingen toepassen nadat u het niveau opnieuw hebt ingesteld. Als u de registratieniveaus voor Tableau Server-processen opnieuw instelt, moet u de server mogelijk stoppen voordat u de wijziging doorvoert en deze opnieuw starten nadat u de in behandeling zijnde wijzigingen hebt toegepast.

Voorbeelden:

  • tsm configuration set -k backgrounder.native_api.log.level -d
  • tsm configuration set -k tsm.log.level -d
Bedankt voor uw feedback.De feedback is verzonden. Dank u wel.