Registrazione e diagnostica

Ultimo aggiornamento: 14/10/2026

QV2QS scrive log diagnostici strutturati durante ogni esecuzione. Il sistema di logging ha due livelli: un log di sistema persistente che sopravvive tra le esecuzioni, e un log strutturato per esecuzione che viene fornito con l'output di conversione.

Registro di sistema

QV2QS mantiene un file di log a rotazione in una posizione fissa sul disco. Il log di sistema si avvia quando l'eseguibile viene avviato e registra eventi a livello di applicazione indipendentemente da qualsiasi progetto o batch.

Posizione: %LOCALAPPDATA%\QV2QS\qv2qs.log

Il log di sistema utilizza un gestore di file a rotazione con le seguenti impostazioni.

Quando il file di log attivo raggiunge i 25 MB, QV2QS ruota il file e crea un nuovo file di log. I tre backup più recenti vengono conservati. I backup meno recenti vengono eliminati automaticamente.

Log strutturato per esecuzione

Ogni esecuzione di conversione produce un file di log separato contenente eventi dettagliati per tale esecuzione. Il file è denominato qv2qs_run_<version>_<timestamp>.log ed è scritto in formato valori separati da tabulazione (TSV) con una colonna di dati JSON.

Posizione predefinita: %LOCALAPPDATA%\QV2QS\logs\

In modalità progetto singolo, QV2QS promuove il file di log nella logs/ sottocartella della cartella di output del progetto (ad esempio, <outputDir>/Sales/logs/) dopo l'inizializzazione della cartella di output. Il file di log è incluso nell'output della conversione.

In modalità batch, i log per progetto vengono scritti nella sottocartella logs/ all'interno di ogni cartella di output del progetto.

Formato file di log

Ogni file di log inizia con una riga di intestazione TSV:

ts_utc	level	version	run_id	logger	event	message	data

Collisioni di Timestamp

Se due esecuzioni iniziano nello stesso secondo e producono lo stesso timestamp, QV2QS aggiunge _2, _3, o numeri successivi al nome del file per evitare la sovrascrittura.

Quale log controllare

QV2QS scrive su due log separati in diverse fasi di un'esecuzione. Il log di sistema è sempre disponibile. Il log per esecuzione viene creato solo dopo il completamento dell'inizializzazione all'avvio.

Livelli di log

Cinque livelli di log sono disponibili, elencati dal più al meno dettagliato.

Imposta il livello di log con --logLevel o la QV2QS_LOG_LEVEL variabile d'ambiente. Il flag CLI ha la precedenza quando entrambi sono impostati.

Imposta --logLevel DEBUG per acquisire l'output più dettagliato. Voci a livello di debug includono decisioni di conversione, chiamate API cloud, modifiche agli script e dettagli sull'elaborazione degli oggetti.

Per abilitare la registrazione di debug senza modificare la riga di comando, impostare la variabile di ambiente prima di eseguire QV2QS:

set QV2QS_LOG_LEVEL=DEBUG
QV2QS.exe --prjPath ./MyApp-prj --outputDir ./output --qvw MyApp.qvw --unbuildOnly

Pulizia dei log

I file di log si accumulano tra le esecuzioni nella directory di log persistente. Utilizza --cleanLogs per eliminare i file di log più vecchi di 30 giorni all'avvio di un'esecuzione. La pulizia si applica solo alla directory dei log persistenti; i log per progetto nelle directory di output non sono interessati.

Mascheramento segreto

Le voci di log mascherano automaticamente i valori sensibili. Le chiavi API, i token, le password e i segreti client vengono oscurati per mostrare solo gli ultimi quattro caratteri. Anche gli argomenti della riga di comando contenenti segreti vengono mascherati quando registrati.

Registrazione del motore QlikView Desktop

Quando la generazione PRJ è abilitata, QV2QS registra quale motore QlikView Desktop viene utilizzato per ogni file. L'evento di log prj_generate_start registra se il motore portatile in bundle o una versione installata nel sistema è attivo e include la versione del file dell'eseguibile in bundle, quando disponibile.

Una volta stabilita la connessione a QlikView Desktop, l'evento prj_qv_ready registra la versione di QlikView riportata dal motore in esecuzione (ad esempio, 12.100.20100.0). Quando viene utilizzato il motore in bundle, il campo exe_file_version registra la versione del file letta dall'eseguibile.

In modalità batch, l'evento di log prj_batch_prereq registra la selezione del motore e la versione in bundle per l'intero batch prima che vengano elaborati i file. Se non è disponibile né un motore in bundle né un'installazione di sistema, l'errore viene registrato come prj_batch_no_qv nel registro di sistema.

Imposta --logLevel DEBUG per acquisire i passaggi dettagliati di risoluzione del motore, inclusi i percorsi dei file controllati durante il rilevamento del motore.

Output della console vs. registrazione su file

L'output della console e la registrazione su file sono sistemi indipendenti.

L'output della console non appare nei file di log. Il --console silent flag elimina l'output della console senza influire sulla registrazione dei file.

Argomenti CLI

Scopri di più

• Riferimento argomento
• Risoluzione dei problemi