Sui file di log in Configuration Manager

  • 11/29/2019
  • 10 minuti per leggere
    • a
    • d

Si applica a: Configuration Manager (ramo corrente)

In Configuration Manager, i componenti client e site server registrano informazioni sul processo in file di log individuali. Puoi usare le informazioni in questi file di log per aiutarti a risolvere i problemi che potrebbero verificarsi. Per impostazione predefinita, Configuration Manager abilita la registrazione per i componenti client e server.

Questo articolo fornisce informazioni generali sui file di log di Configuration Manager. Include strumenti da utilizzare, come configurare i log e dove trovarli. Per ulteriori informazioni su specifici file di log, vedere Riferimento sui file di log.

Come funziona

La maggior parte dei processi in Configuration Manager scrive informazioni operative in un file di log dedicato a quel processo. I file di log sono identificati da estensioni di file .log o .lo_. Configuration Manager scrive su un file .log fino a quando quel log non raggiunge la sua dimensione massima. Quando il log è pieno, il file .log viene copiato in un file con lo stesso nome ma con estensione .lo_, e il processo o il componente continua a scrivere sul file .log. Quando il file .log raggiunge nuovamente la sua dimensione massima, il file .lo_ viene sovrascritto e il processo si ripete. Alcuni componenti stabiliscono una cronologia dei file di log aggiungendo una data e un’ora al nome del file di log e mantenendo l’estensione .log.

Strumenti per la visualizzazione dei log

Tutti i file di log di Configuration Manager sono testo semplice, quindi è possibile visualizzarli con qualsiasi lettore di testo come Notepad. I log usano una formattazione unica che è meglio visualizzare con uno dei seguenti strumenti specializzati:

  • CMTrace
  • OneTrace
  • Support Center log viewer

CMTrace

Per visualizzare i log, usa lo strumento CMTrace di Configuration Manager. Si trova nella cartella \SMSSetup\Tools del supporto sorgente di Configuration Manager. Lo strumento CMTrace viene aggiunto a tutte le immagini di avvio che vengono aggiunte alla Libreria Software. Lo strumento di visualizzazione dei log CMTrace viene installato automaticamente insieme al client di Configuration Manager. Per maggiori informazioni, vedi CMTrace.

OneTrace

A partire dalla versione 1906, OneTrace è un nuovo visualizzatore di log con Support Center. Funziona in modo simile a CMTrace, con miglioramenti. Per maggiori informazioni, vedi Support Center OneTrace.

Support Center log viewer

Support Center include un moderno log viewer. Questo strumento sostituisce CMTrace e fornisce un’interfaccia personalizzabile con supporto per schede e finestre agganciabili. Ha un livello di presentazione veloce e può caricare grandi file di log in pochi secondi. Per maggiori informazioni, vedi Support Center Log Viewer reference.

Note

Support Center e OneTrace utilizzano Windows Presentation Foundation (WPF). Questo componente non è disponibile in Windows PE. Continua ad usare CMTrace nelle immagini di avvio con distribuzioni in sequenza di attività.

Configura le opzioni di log

Puoi cambiare la configurazione dei file di log, come il livello verboso, la dimensione e la cronologia. Ci sono diversi modi per cambiare queste impostazioni:

  • Durante l’installazione del client
  • Utilizzando Configuration Manager Service Manager
  • Utilizzando il registro di Windows
  • Nella console di Configuration Manager

Configura opzioni di log durante l’installazione del client

Puoi impostare la configurazione dei file di log del client durante l’installazione. Usa le seguenti proprietà:

  • CCMENABLELOGGING
  • CCMDEBUGLOGGING
  • CCMLOGLEVEL
  • CCMLOGMAXHISTORY
  • CCMLOGMAXSIZE

Per maggiori informazioni, vedi Proprietà installazione client.

Configura le opzioni di log usando Configuration Manager Service Manager

Puoi cambiare dove Configuration Manager memorizza i file di log e la loro dimensione.

Per modificare la dimensione dei file di log, cambiare il nome e la posizione del file di log, o forzare più componenti a scrivere su un singolo file di log, esegui i seguenti passi:

Modifica del log per un componente

  1. Nella console di Configuration Manager, vai nell’area di lavoro Monitoraggio, espandi Stato del sistema, quindi seleziona il nodo Stato del sito o Stato del componente.

  2. Nella barra multifunzione, selezionare Start, quindi selezionare Configuration Manager Service Manager.

  3. Quando si apre Configuration Manager Service Manager, connettersi al sito che si vuole gestire. Se il sito che vuoi gestire non è mostrato, seleziona Site, seleziona Connect e poi inserisci il nome del server del sito corretto.

  4. Espandi il sito e vai a Components o Servers, a seconda di dove si trovano i componenti che vuoi gestire.

  5. Nel riquadro di destra, seleziona uno o più componenti.

  6. Nel menu Componenti, seleziona Logging.

  7. Nella finestra di dialogo Configuration Manager Component Logging, completa le opzioni di configurazione disponibili per la tua selezione.

  8. Seleziona OK per salvare la configurazione.

Configura le opzioni di registrazione usando il registro di Windows

Usa il registro di Windows sui server o sui client per cambiare le seguenti opzioni di registrazione:

  • Livello verboso
  • Storia massima
  • Dimensione massima

Quando si risolve un problema, è possibile abilitare la registrazione verbosa per Configuration Manager per scrivere ulteriori dettagli nei file di log.

Attenzione

Una configurazione errata di queste impostazioni può far sì che Configuration Manager registri una grande quantità di informazioni o nessuna. Mentre questi dati possono essere utili per la risoluzione dei problemi, siate cauti quando cambiate questi valori nei siti di produzione. Testare sempre queste modifiche in un ambiente di laboratorio prima. Può verificarsi una registrazione eccessiva, che potrebbe rendere difficile trovare informazioni rilevanti nei file di log.

Dopo aver apportato modifiche a queste impostazioni di registro, riavviare il componente:

  • Se si modificano le impostazioni del client, riavviare il servizio SMS Agent Host (CcmExec).
  • Se si modificano le impostazioni del server, riavviare il servizio SMS Executive.

Le impostazioni del registro variano a seconda del componente:

  • Client e management point
  • Site server
  • Ruolo del sistema del sito
  • Configuration Manager console

Opzioni di registrazione client e management point

Per configurare le opzioni di registrazione per tutti i componenti su un sistema del sito client o management point, configura questi valori REG_DWORD nella seguente chiave del registro di Windows:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\CCM\Logging\@Global

Nome Valori Descrizione
LogLevel 0: Verboso
1: Predefinito
2: Warnings and errors
3: Errors only
Il livello di dettaglio da scrivere nei file di log.
LogMaxHistory Un qualsiasi numero intero maggiore o uguale a zero, per esempio:
0: No history
1: Default
Quando un file di log raggiunge la dimensione massima, il client lo rinomina come backup e crea un nuovo file di log. Specificare quante versioni precedenti mantenere.
LogMaxSize Un qualsiasi numero intero maggiore o uguale a 10.000, per esempio:
250000
La dimensione massima del file di log in byte. Quando un log raggiunge la dimensione specificata, il client lo rinomina come file di cronologia e crea un nuovo file. Il valore predefinito è 250.000 byte.

Nota

Non cambiare altri valori che possono esistere in questa chiave di registro.

Per un debug avanzato, puoi anche aggiungere questo valore REG_SZ sotto la seguente chiave di registro di Windows:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\CCM\Logging\DebugLogging

Nome Valori Descrizione
Abilitato True: abilita i log di debug
False: disabilita i log di debug
Abilita i log di debug per la risoluzione dei problemi.

Questa impostazione fa sì che il client registri informazioni di basso livello per la risoluzione dei problemi. Evita di usare questa impostazione nei siti di produzione. Può verificarsi un log eccessivo, che potrebbe rendere difficile trovare informazioni rilevanti nei file di log. Assicurati di disattivare questa impostazione dopo aver risolto il problema.

Opzioni di log del server del sito

Puoi configurare le impostazioni globalmente o per un componente specifico sul server del sito di Configuration Manager.

Configura questi valori sotto la seguente chiave del registro di Windows:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\SMS\Tracing

Nome Valori Tipo Descrizione
SqlEnabled 1: enable SQL Server tracing
0: disable SQL Server tracing
REG_DWORD Add SQL Server trace logging to all site server logs.
ArchiveEnabled 1: abilita gli archivi dei log
0: disabilita gli archivi dei log
REG_DWORD Archivia i log del sito server in una locazione separata per la conservazione storica.
ArchivePath Un percorso di cartella valido, per esempio C:\Logs\Archive REG_SZ Il percorso per archiviare i log del server del sito.

Abilita solo il tracing di SQL Server per la risoluzione dei problemi. Evitare di usarlo nei siti di produzione. Può verificarsi una registrazione eccessiva, che potrebbe rendere difficile trovare informazioni rilevanti nei file di log. Assicurati di disattivare questa impostazione dopo aver risolto il problema.

Nota

Non cambiare altri valori che possono esistere in questa chiave di registro.

Per configurare le opzioni di registrazione per un componente specifico del server, configura questi valori REG_DWORD sotto la seguente chiave di registro di Windows:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\SMS\Tracing\<ComponentName>

Nome Valori Descrizione
LoggingLevel 0: Verboso
1: Predefinito
2: Warnings and errors
3: Errors only
Il livello di dettaglio da scrivere nei file di log.
LogMaxHistory Un qualsiasi numero intero maggiore o uguale a zero, per esempio:
0: No history
1: Default
Quando un file di log raggiunge la dimensione massima, il server lo rinomina come backup e crea un nuovo file di log. Specificare quante versioni precedenti mantenere.
MaxFileSize Un qualsiasi numero intero maggiore o uguale a 10.000, per esempio:
250000
La dimensione massima del file di log in byte. Quando un log raggiunge la dimensione specificata, il client lo rinomina come file di cronologia e crea un nuovo file. Il valore predefinito è 250.000 byte.
DebugLogging 1: abilita i log di debug
0: disabilita i log di debug
Abilita i log di debug per la risoluzione dei problemi. Evita di usare questa impostazione nei siti di produzione. Può verificarsi un log eccessivo, che potrebbe rendere difficile trovare informazioni rilevanti nei file di log. Assicurati di disattivare questa impostazione dopo aver risolto il problema.

Nota

Non cambiare altri valori che possono esistere in questa chiave di registro.

Opzioni di registrazione del ruolo di sistema del sito

Puoi configurare le impostazioni globalmente o per un componente specifico su un sistema del sito che ospita un ruolo server di Configuration Manager.

Per configurare le opzioni di registrazione per un componente specifico del server, configura questi valori REG_DWORD sotto la seguente chiave del registro di Windows:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\SMS\<ComponentName>\Logging

Per esempio, per il ruolo del punto di distribuzione:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\SMS\DP\Logging

Nome Valori Descrizione
LogLevel 0: Verboso
1: Predefinito
2: Warnings and errors
3: Errors only
Il livello di dettaglio da scrivere nei file di log.
LogMaxHistory Un qualsiasi numero intero maggiore o uguale a zero, per esempio:
0: No history
1: Default
Quando un file di log raggiunge la dimensione massima, il server lo rinomina come backup e crea un nuovo file di log. Specificare quante versioni precedenti mantenere.
LogMaxSize Un qualsiasi numero intero maggiore o uguale a 10.000, per esempio:
250000
La dimensione massima del file di log in byte. Quando un log raggiunge la dimensione specificata, il server lo rinomina come file di cronologia e crea un nuovo file. Il valore predefinito è 250.000 byte.

Nota

Non cambiare altri valori che possono esistere in questa chiave di registro.

Opzioni di log della console di Configuration Manager

Per cambiare il livello verboso dell’AdminUI.log per la console di Configuration Manager, utilizzare la seguente procedura:

  1. Aprire il file di configurazione della console, Microsoft.ConfigurationManagement.exe.config, in un editor XML come Notepad. Il file di configurazione predefinito si trova nella seguente posizione: C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\bin\Microsoft.ConfigurationManagement.exe.config

    Importante

    A partire dalla versione 1910, questo percorso è cambiato per usare la cartella Microsoft Endpoint Manager. Assicurati di non usare una vecchia versione del file che potrebbe esistere in un’altra cartella.

  2. Sotto l’elemento system.diagnostics > sources > source, cambia l’attributo switchValue da Error a Verbose. Per esempio:

    Originale: <source name="SmsAdminUISnapIn" switchValue="Error">Nuovo: <source name="SmsAdminUISnapIn" switchValue="Verbose" >

  3. Salva il file e riavvia la console.

Configura le opzioni di log nella console di Configuration Manager

A partire dalla versione 1910, abilita o disabilita il log verboso su un client o una collezione dalla console:

  1. Nella console di Configuration Manager, vai nell’area di lavoro Assets and Compliance, seleziona il nodo Devices e scegli un dispositivo di destinazione.

  2. Nella barra multifunzione, nella scheda Home, nel gruppo Dispositivo, seleziona Diagnostica client. Scegli una delle azioni disponibili.

Per maggiori informazioni, vedi Diagnostica client.

Localizzazione dei file di log

Configuration Manager e i componenti dipendenti memorizzano i file di log in varie posizioni. Queste posizioni dipendono dal processo che crea il file di log e dalla configurazione del tuo ambiente.

Le seguenti posizioni sono quelle predefinite. Se avete personalizzato le directory di installazione nel vostro ambiente, i percorsi effettivi possono variare.

  • Client: C:\Windows\CCM\logs
  • Server: C:\Program Files\Microsoft Configuration Manager\Logs
  • Punto di gestione: C:\SMS_CCM\Logs
  • Configuration Manager console: C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\AdminUILog
  • IIS: C:\inetpub\logs\logfiles\w3svc1

Posizioni del log della sequenza di attività

La posizione del file smsts.log varia a seconda della fase della sequenza di attività:

  • In Windows PE prima del passo Format and Partition Disk: X:\Windows\temp\smstslog\smsts.log (X è l’unità RAM di Windows PE)
  • In Windows PE dopo il passo Formato e partizione del disco: X:\smstslog\smsts.log, poi copiato in C:\_SMSTaskSequence\Logs\smstslog\smsts.log quando l’unità è pronta
  • Nel nuovo sistema operativo Windows prima dell’installazione del client: C:\_SMSTaskSequence\Logs\smstslog\smsts.log
  • In Windows dopo l’installazione del client: C:\Windows\CCM\Logs\smstslog\smsts.log
  • In Windows dopo il completamento della sequenza di attività: C:\Windows\CCM\Logs\smsts.log

Tip

La variabile di sola lettura _SMSTSLogPath contiene sempre il percorso del file di log corrente.

Vedi anche

Lascia un commento

Il tuo indirizzo email non sarà pubblicato.