Werken met logboekbestanden

Tableau Server maakt logboekbestanden aan als normaal onderdeel van de activiteiten. Mogelijk moet u de serverlogboekbestanden gebruiken wanneer u problemen met Tableau Server oplost of als de Tableau-ondersteuning u om logboeken vraagt om u te helpen een probleem op te lossen.

U kunt een gezipt logboekbestandarchief maken met behulp van de opdracht tsm maintenance ziplogs. Het gezipte archief bevat kopieën van de logboeken die u kunt uitpakken en bekijken of naar de Tableau-ondersteuning kunt sturen. Zodra u een kopie van het archief hebt, kunt u het archief van uw server verwijderen. Zie Momentopnamen van logboekbestanden (archieflogboeken) voor meer informatie over logboekbestandarchieven.

In deze verzameling onderwerpen vindt u informatie over het maken van logboekbestandarchieven, de inhoud van specifieke logboekbestanden en details over wanneer en hoe u een logboek kunt bekijken.

Inhoud van Tableau Server-logboeken

Alle Tableau Server-processen schrijven informatie over wat ze doen naar hun eigen logboekbestanden. Deze geven afzonderlijk gedetailleerde informatie over de acties van elk proces. Samen bevatten deze logboekbestanden gedetailleerde informatie over de interne communicatie tussen componenten van Tableau Server tijdens het verwerken van gebruikersverzoeken of het uitvoeren van geautomatiseerde taken. Tableau Server-logboeken bevatten alleen technische informatie die nuttig is voor probleemoplossing, zoals de status van verschillende componenten, acties die door verschillende processen worden ondernomen, communicatiepogingen, query's naar de database (exclusief resultaten) en timing van aanvragen.

Logboekbestanden kunnen specifieke data bevatten, zoals namen van databaseservers en hun IP-adressen en poorten, namen of IP-adressen van Tableau Server-computers en URL's en namen van de werkmappen en weergaven waartoe gebruikers toegang hebben.

Logboekbestanden bevatten geen gevoelige klantgegevens, zoals wachtwoorden, resultaten van query's of data die in de weergaven wordt weergegeven.

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.

Met de opdracht tsm maintenance ziplogs kunnen gebruikers niet alleen een gezipt archief van logboekbestanden genereren, maar ook Tableau Server-opslagplaatsdata opnemen als de optie -d is gespecificeerd. De opslagplaats bevat metadata van Tableau Server (bijvoorbeeld gebruikersnamen, groepen, projecten, machtigingen op Tableau Server, extractvernieuwingsschema's). De opslagplaats bevat ook informatie over de lay-out en verbinding van de werkmappen, maar bevat geen data zoals wachtwoorden, werkelijke data uit de database of data die in de weergave wordt weergegeven.

De data die in de weergaven wordt weergegeven, is afkomstig uit extractbestanden of databases en worden in het geheugen opgeslagen. Deze data wordt niet opgeslagen in logboeken of, in het geval van liveverbindingen, in aparte bestanden op Tableau Server-computers. Extractbestanden worden op Tableau Server-computers opgeslagen als .hyper-bestanden in de map dataengine, maar worden nooit opgenomen in het gezipte logboekarchief.

Onderzoek naar problemen met Tableau Server

De omvang en complexiteit van mogelijke problemen met Tableau Server betekenen dat er geen eenvoudig proces is waarmee u alle problemen kunt onderzoeken. Een algemene aanpak omvat echter de volgende stappen:

  1. Schoon bestaande logboekbestanden op om ze kleiner te maken. Zie Overbodige bestanden verwijderen voor meer informatie.

    Belangrijk: als u hulp nodig hebt van de Tableau-ondersteuning bij het oplossen van een probleem, zorg er dan voor dat u een gezipt archief van uw logboeken maakt voordat u ze opschoont. Bij het opschonen kan belangrijke informatie verloren gaan die de ondersteuning nodig heeft. Zie Momentopnamen van logboekbestanden (archieflogboeken) voor meer informatie over het maken van logboekarchieven.

  2. Stel het juiste registratieniveau in. Dit is iets waar de Tableau-ondersteuning u over zal informeren. Zie Registratieniveaus wijzigen voor meer informatie, inclusief de impact van verschillende registratieniveaus.
  3. Reproduceer het probleem dat u probeert op te lossen, zodat de logboeken de gebeurtenissen vastleggen die verband houden met het probleem.
  4. Maak een archief van de logboeken. Zie Momentopnamen van logboekbestanden (archieflogboeken) voor meer informatie.

    Belangrijk: gebruik dit archief wanneer u de logboekbestanden bekijkt. U mag geen bestanden rechtstreeks op de server bewerken, verplaatsen of verwijderen.

  5. Controleer het TSM-beheercontrollerlogboek (\tabadmincontroller\tabadmincontroller_node<n>-<n>.log) om inzicht te krijgen in elke configuratie of implementatie die door TSM is uitgevoerd via de opdrachtregel, web-UI of API, inclusief taken die door TSM zijn gestart. Begin met het controllerlogboek. Hier vindt u de meest nuttige informatie.

    Opmerking: tsm.log is minder omslachtig dan tabadmincontroller_*.log, maar kan wel nuttige, aanvullende informatie voor probleemoplossing bieden.

  6. Bekijk de Apache-logboeken (\httpd\access.####_##_##_##_##_##.log en \httpd\error.log) voor verzoeken die verband kunnen houden met het probleem dat u onderzoekt.

    De Apache-logboeken bevatten een behoorlijke hoeveelheid 'ruis' die niet van toepassing is op de problemen die u ondervindt.

    • Als u een verzoek vindt dat verband lijkt te houden met uw probleem, zoek dan in de directory vizqlserver voor vermeldingen die de unieke aanvraag-ID uit de Apache-logboeken bevatten.
    • Zoek naar de reactiecode en het bericht dat bij de aanvraag-ID hoort.
    • Zoek naar de naam van de werkmap, de weergave, het dashboard of de databron die betrekking heeft op uw probleem. Zorg ervoor dat u naar een relevante tijdstempel zoekt.
    • Als u een verzoek vindt dat verband lijkt te houden met uw probleem, kijk dan naar de reactiecode die bij het verzoek hoort. (in de 200 is goed, in de 500 geeft problemen aan.)
    • Zoek de unieke aanvraag-ID die is gekoppeld aan de aanvraag die u hebt geïdentificeerd (de unieke aanvraag-ID is een alfanumerieke tekenreeks van 24 tekens aan het einde van de aanvraag).
  7. Bekijk het logboekarchief verder om te zoeken naar andere berichten en mogelijke fouten.

    • Gebruik de aanvraag-ID uit de Apache-logboeken om de map vizqlserver van het logboekarchief te doorzoeken voor bestanden met gerelateerde logboekvermeldingen. Let op indicaties van een probleem (bijvoorbeeld foutmeldingen of langlopende query's).
    • De gratis opensourcetool Logshark kan een handige optie zijn voor het controleren van logboekarchieven. Zie Problemen met Tableau Server oplossen(Link wordt in een nieuw venster geopend) in Tableau Blueprint voor meer informatie.
  8. Controleer scriptlogging.

    Tableau Server bevat logboeken voor de meeste scripts die zijn opgenomen in de scriptsdirectory. Standaard:C:\Program Files\Tableau\Tableau Server\packages\scripts.<version_code>\ Deze logboeken worden opgeslagen in:

    • <install_drive>\<install\path>\logs\
      standaard: 
    • C:\ProgramData\Tableau\Tableau Server\logs\
  9. Neem contact op met de ondersteuning

    Als u het probleem niet zelf kunt oplossen of als de Tableau-ondersteuning u daarom vraagt, stuurt u het gezipte archief naar Tableau.

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