Risoluzione dei problemi

For AI agents: a documentation index is available at /llms.txt; a markdown version of this page is available at /v1.2.0.0/it/docs/08-troubleshooting/index.md.

Problemi comuni e soluzioni

“Il file non è un file di log di debug DNS valido”

• Assicurati di convertire un vero file di log di debug del server DNS.
• Il file dovrebbe iniziare con Message logging started at o contenere voci di query DNS.
• Se sei sicuro che il file sia valido ma l’intestazione è diversa, usa -SkipHeaderValidation.

Il file di output è vuoto o incompleto

• Verifica che il file di input contenga voci di log valide.
• Alcuni log possono contenere solo informazioni di intestazione se non sono state effettuate query.
• Controlla che il file di log non sia corrotto e contenga dati di query effettivi.

L’elaborazione è molto lenta

• Assicurati di avere memoria sufficiente e che il disco non sia sovraccarico.
• Considera di elaborare file di log più piccoli.
• Valuta l’uso di -CompressOutput con elaborazioni programmate per gestire batch più piccoli.

Errori “Accesso negato”

• Esegui PowerShell con i permessi appropriati per leggere i file di log sorgente e scrivere nella directory di destinazione.
• I file di log DNS potrebbero richiedere accesso da amministratore.

L’output compresso è più grande del previsto

• I log con molti valori unici si comprimono meno efficacemente; questo può essere normale.
• La compressione ZIP comunque di solito ottiene una riduzione sostanziale.

Il file delle statistiche non corrisponde alle aspettative

• Verifica di usare -OutputType Both o -OutputType Statistic.
• Le statistiche sono conteggi aggregati (raggruppamenti giornalieri), quindi i valori rappresentano totali.

Segnalazione dei problemi

Se incontri problemi non coperti qui:

1. Verifica di usare l’ultima versione del modulo.
2. Controlla le Issues su GitHub per problemi simili.
3. Raccogli informazioni diagnostiche:
   • Versione di PowerShell ($PSVersionTable)
   • Versione del modulo (Get-Module DNSServer.DebugLogParser)
   • File di log di esempio (se possibile)
   • Messaggio di errore completo e traccia dello stack
4. Apri una nuova issue su GitHub con i dettagli.