Log di Tableau Server e percorsi dei file di log

Tableau Server genera file di log come parte del normale funzionamento. Ogni servizio eseguito in Tableau Server genera i propri log. Questi file di log includono informazioni su ciò che sta accadendo sul server, quali operazioni sta eseguendo il servizio o il processo e se vengono generati errori o avvisi. La quantità di informazioni nei log dipende dal servizio che sta scrivendo i log, dai livelli di registrazione impostati e da quali eventi si stanno verificando sul server.

I file di log possono essere utili per identificare e risolvere i problemi di Tableau Server. In alcuni casi, gli amministratori di sistema potrebbero essere in grado di esaminare i log e trovare indicazioni sul problema, ma nella maggior parte delle situazioni i log di Tableau Server sono utili soprattutto per il servizio di assistenza di Tableau. Quando apri un caso con l’assistenza tecnica, ti potrebbe essere richiesto di inviare file di log dal server.

Nota: le directory e i log specifici generati da Tableau Server dipendono dalla versione del server in esecuzione e dai processi configurati. Nuovi servizi e processi vengono aggiunti periodicamente per supportare nuove funzionalità. Per informazioni dettagliate sui processi o i servizi per cui sono disponibili log, consulta Processi di Tableau Server.

File di log di Tableau Server in un cluster attivo

Come procedura consigliata, non modificare o eliminare i file di log in un’installazione attiva di Tableau Server. Questa operazione può causare comportamenti imprevisti o tempi di inattività del server. La maggior parte dei log di Tableau Server viene scritta in un percorso nella directory dei dati. Alcuni log vengono scritti in altri percorsi.

Il modo più semplice e sicuro per raccogliere e visualizzare i file di log del server è creare un archivio di log, ovvero una raccolta compressa di log da tutti i nodi di un cluster. Se pensi di aver bisogno dei log precedenti per qualsiasi motivo, ad esempio per eseguire un confronto con i nuovi log dopo aver eseguito un upgrade o per inviarli all’assistenza Tableau per la risoluzione di un problema del server, crea un archivio zip e sposta l’archivio in un percorso sicuro non incluso nell’infrastruttura di Tableau Server. Per maggiori informazioni sui file di log in un archivio di log, consulta File di log del server in un archivio compresso.

I log possono occupare molto spazio, in particolare su un server utilizzato intensamente. Puoi utilizzare il comando tsm maintenance cleanup per rimuovere i log indesiderati o non più necessari. Se tuttavia ritieni che potrebbe essere utile conservare i log esistenti, valuta se archiviarli prima di eseguire la pulizia.

Principali percorsi dei log in un’installazione di Tableau Server funzionante

La maggior parte dei log di Tableau Server viene scritta nella directory dei dati/var/opt/tableau/tableau_server/data/tabsvc/logs/. Vengono create sottodirectory per ogni istanza di un servizio, con un nome che include il nome del servizio e il codice della versione. Ad esempio:

/var/opt/tableau/tableau_server/data/tabsvc/logs/backgrounder

Percorsi dei file di configurazione in un’installazione di Tableau Server funzionante

Oltre ai log per ogni servizio o processo, una sottodirectory config contiene le informazioni di configurazione sul servizio.

/var/opt/tableau/tableau_server/data/tabsvc/config/backgrounder

Gli addetti del servizio di assistenza Tableau potrebbero richiedere di raccogliere alcuni di questi file, se stai collaborando con loro alla risoluzione di un problema del server. I contenuti possono essere analizzati dal servizio di assistenza.

Log non scritti nel percorso principale

Alcuni log non fanno parte dell’insieme principale di log e vengono scritti in percorsi diversi dalle normali directory dei log:

  • Il log TSM. Il file tsm.log si trova in <home dir>/.tableau/tsm .
  • Il log di installazione. Il file app-install.log si trova in /var/opt/tableau/tableau_server/logs .
  • Il log di aggiornamento. Il file app-upgrade.log si trova in /var/opt/tableau/tableau_server/logs .
  • Log di script Bash. La maggior parte degli script Bash di Tableau Server che si trovano nella directory /scripts (/opt/tableau/tableau_server/packages/scripts.<version>) genera i propri log. Questi vengono scritti nella directory /var/tmp ogni volta che viene eseguito uno script.

File di log del server in un archivio compresso

Puoi esaminare i file di log di Tableau Server o inviarli all’assistenza Tableau in caso di problemi del server. Utilizza il comando tsm maintenance ziplogs per creare un archivio compresso di file di log da tutti i nodi dell’installazione. Per impostazione predefinita, gli archivi dei file di log di Tableau Server vengono raccolti in un file zip denominato logs.zip, ma puoi specificare un nome di file diverso quando crei l’archivio. Puoi copiare l’archivio dal server in un computer locale e aprirlo, oppure inviarlo all’assistenza Tableau.

Quando decomprimi l’archivio, viene creata una directory per ogni nodo del cluster. In tale directory sono presenti sottodirectory per ogni servizio o processo, utilizzando la seguente convenzione di denominazione:

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

Se vi sono più istanze di un servizio in un nodo, saranno presenti più directory per tale servizio, una per ogni istanza. Ad esempio, se hai due istanze di Gestione componenti in background su un nodo, vedrai directory come queste:

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

Le directory e i log specifici nel file zip dipendono dalla versione di Tableau Server in esecuzione e dai processi configurati. Per informazioni dettagliate sui processi o i servizi per cui sono disponibili log, consulta Processi di Tableau Server.

Grazie per il tuo feedback.Il tuo feedback è stato inviato. Grazie!