Informazioni sui file di log in Configuration Manager

  • Articolo

Si applica a: Configuration Manager (Current Branch)

In Configuration Manager, i componenti client e del server del sito registrano le informazioni sul processo nei singoli file di log. È possibile usare le informazioni contenute in questi file di log per 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 Configuration Manager. Include strumenti da usare, come configurare i log e dove trovarli. Per altre informazioni su file di log specifici, vedere Informazioni di riferimento sui file di log.

Come funziona

La maggior parte dei processi in Configuration Manager scrivere informazioni operative in un file di log dedicato a tale processo. I file di log sono identificati da o .lo_ estensioni .log di file. Configuration Manager scrive in un .log file finché tale log non raggiunge le dimensioni massime. Quando il log è pieno, il .log file viene copiato in un file con lo stesso nome ma con l'estensione .lo_ e il processo o il componente continua a scrivere nel .log file. Quando il .log file raggiunge nuovamente le dimensioni massime, il .lo_ file viene sovrascritto e il processo si ripete. Alcuni componenti stabiliscono una cronologia dei file di log aggiungendo un indicatore di data e ora al nome del file di log e mantenendo l'estensione .log .

Strumenti del visualizzatore di log

Tutti i file di log Configuration Manager sono in testo normale, quindi è possibile visualizzarli con qualsiasi lettore di testo come blocco note. I log usano una formattazione univoca che è preferibile visualizzare con uno degli strumenti specializzati seguenti:

CMTrace

Per visualizzare i log, usare lo strumento Configuration Manager visualizzatore di log CMTrace. Si trova nella \SMSSetup\Tools cartella del supporto di origine Configuration Manager. Lo strumento CMTrace viene aggiunto a tutte le immagini di avvio aggiunte alla libreria software. Lo strumento di visualizzazione dei log di CMTrace viene installato automaticamente insieme al client Configuration Manager. Per altre informazioni, vedere CMTrace.

OneTrace

OneTrace è un visualizzatore di log con Support Center. Funziona in modo analogo a CMTrace, con miglioramenti. Per altre informazioni, vedere Support Center OneTrace.

Visualizzatore file di log di Support Center

Support Center include un visualizzatore di log moderno. Questo strumento sostituisce CMTrace e fornisce un'interfaccia personalizzabile con supporto per schede e finestre ancorabili. Ha un livello di presentazione veloce e può caricare file di log di grandi dimensioni in pochi secondi. Per altre informazioni, vedere Support Center Log File Viewer.

Nota

Support Center Log File Viewer e OneTrace usano Windows Presentation Foundation (WPF). Questo componente non è disponibile in Windows PE. Continuare a usare CMTrace nelle immagini di avvio con distribuzioni della sequenza di attività.

Configurare le opzioni di registrazione

È possibile modificare la configurazione dei file di log, ad esempio il livello dettagliato, le dimensioni e la cronologia. Esistono diversi modi per modificare queste impostazioni:

È anche possibile usare l'inventario hardware per raccogliere le impostazioni di log dai client.

Configurare le opzioni di registrazione durante l'installazione client

È possibile impostare la configurazione dei file di log client durante l'installazione. Usare le proprietà seguenti:

  • CCMENABLELOGGING
  • CCMDEBUGLOGGING
  • CCMLOGLEVEL
  • CCMLOGMAXHISTORY
  • CCMLOGMAXSIZE

Per altre informazioni, vedere Proprietà di installazione client.

Configurare le opzioni di registrazione usando Configuration Manager Service Manager

È possibile modificare la posizione in cui Configuration Manager archivia i file di log e le relative dimensioni.

Per modificare le dimensioni dei file di log, modificare il nome e il percorso del file di log o forzare la scrittura di più componenti in un singolo file di log, seguire questa procedura:

Modificare la registrazione per un componente

  1. Nella console Configuration Manager passare all'area di lavoro Monitoraggio, espandere Stato sistema e quindi selezionare il nodo Stato sito o Stato componente.

  2. Nella barra multifunzione selezionare Avvia e quindi selezionare Configuration Manager Service Manager.

  3. Quando si apre Configuration Manager Service Manager, connettersi al sito da gestire. Se il sito che si vuole gestire non viene visualizzato, selezionare Sito, selezionare Connetti e quindi immettere il nome del server del sito per il sito corretto.

  4. Espandere il sito e passare a Componenti o server, a seconda della posizione in cui si trovano i componenti da gestire.

  5. Nel riquadro destro selezionare uno o più componenti.

  6. Nel menu Componente selezionare Registrazione.

  7. Nella finestra di dialogo Configuration Manager Registrazione componenti completare le opzioni di configurazione disponibili per la selezione.

  8. Selezionare OK per salvare la configurazione.

Configurare le opzioni di registrazione usando il Registro di sistema di Windows

Usare il Registro di sistema di Windows nei server o nei client per modificare le opzioni di registrazione seguenti:

  • Livello dettagliato
  • Cronologia massima
  • Dimensioni massime

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

Avviso

La configurazione errata di queste impostazioni può causare Configuration Manager registrare grandi quantità di informazioni o nessuna. Anche se questi dati possono essere utili per la risoluzione dei problemi, prestare attenzione quando si modificano questi valori nei siti di produzione. Prima di tutto, testare sempre queste modifiche in un ambiente lab. Può verificarsi una registrazione eccessiva, che potrebbe rendere difficile trovare informazioni rilevanti nei file di log.

Dopo aver apportato modifiche a queste impostazioni del Registro di sistema, riavviare il componente:

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

Le impostazioni del Registro di sistema variano a seconda del componente:

Opzioni di registrazione del client e del punto di gestione

Per configurare le opzioni di registrazione per tutti i componenti in un sistema del sito del client o del punto di gestione, configurare questi valori REG_DWORD nella chiave del Registro di sistema di Windows seguente:

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

Nome Valori Descrizione
Loglevel 0:Dettagliato
1:Predefinito
2: avvisi ed errori
3: solo errori		 Livello di dettaglio da scrivere nei file di log.
LogMaxHistory Qualsiasi numero intero maggiore o uguale a zero, ad esempio:
0: nessuna cronologia
1:Predefinito		 Quando un file di log raggiunge le dimensioni massime, il client lo rinomina come backup e crea un nuovo file di log. Specificare quante versioni precedenti mantenere.
LogMaxSize Qualsiasi numero intero maggiore o uguale a 10.000, ad esempio:
250000		 Dimensioni massime del file di log in byte. Quando un log raggiunge le dimensioni specificate, il client lo rinomina come file di cronologia e crea un nuovo file. Il valore predefinito è 250.000 byte.

Nota

Non modificare altri valori che possono esistere in questa chiave del Registro di sistema.

Per il debug avanzato, è anche possibile aggiungere questo valore REG_SZ nella chiave del Registro di sistema di Windows seguente:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\CCM\Logging\DebugLogging

Nome Valori Descrizione
Abilitato True: abilitare i log di debug
False: disabilitare i log di debug		 Abilita la registrazione di debug a scopo di risoluzione dei problemi.

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

Opzioni di registrazione del server del sito

È possibile configurare le impostazioni a livello globale o per un componente specifico nel server del sito Configuration Manager.

Configurare questi valori nella chiave del Registro di sistema di Windows seguente:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\SMS\Tracing

Nome Valori Tipo Descrizione
SqlEnabled 1: abilitare la traccia SQL Server
0: disabilitare la traccia SQL Server		 REG_DWORD Aggiungere SQL Server registrazione di traccia a tutti i log del server del sito.
ArchiveEnabled 1: abilitare gli archivi di log
0: disabilitare gli archivi di log		 REG_DWORD Archiviare i log del server del sito in un percorso separato per la conservazione cronologica.
ArchivePath Percorso di cartella valido, ad esempio C:\Logs\Archive REG_SZ Percorso di archiviazione dei log del server del sito.

Abilitare la traccia SQL Server solo a scopo di 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. Assicurarsi di disattivare questa impostazione dopo aver risolto il problema.

Nota

Non modificare altri valori che possono esistere in questa chiave del Registro di sistema.

Per configurare le opzioni di registrazione per un componente server specifico, configurare questi valori REG_DWORD nella chiave del Registro di sistema di Windows seguente:

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

Nome Valori Descrizione
LoggingLevel 0:Dettagliato
1:Predefinito
2: avvisi ed errori
3: solo errori		 Livello di dettaglio da scrivere nei file di log.
LogMaxHistory Qualsiasi numero intero maggiore o uguale a zero, ad esempio:
0: nessuna cronologia
1:Predefinito		 Quando un file di log raggiunge le dimensioni massime, il server lo rinomina come backup e crea un nuovo file di log. Specificare quante versioni precedenti mantenere.
Maxfilesize Qualsiasi numero intero maggiore o uguale a 10.000, ad esempio:
250000		 Dimensioni massime del file di log in byte. Quando un log raggiunge le dimensioni specificate, il client lo rinomina come file di cronologia e crea un nuovo file. Il valore predefinito è 250.000 byte.
DebugLogging 1: abilitare i log di debug
0: disabilitare i log di debug		 Abilita la registrazione di debug a scopo di risoluzione dei problemi.

L'impostazione DebugLogging consente al server di registrare informazioni di basso livello per la risoluzione dei problemi. Evitare di usare questa impostazione nei siti di produzione. Può verificarsi una registrazione eccessiva, che potrebbe rendere difficile trovare informazioni rilevanti nei file di log. Assicurarsi di disattivare questa impostazione dopo aver risolto il problema.

Nota

Non modificare altri valori che possono esistere in questa chiave del Registro di sistema.

Opzioni di registrazione dei ruoli del sistema del sito

È possibile configurare le impostazioni a livello globale o per un componente specifico in un sistema del sito che ospita un ruolo server Configuration Manager.

Per configurare le opzioni di registrazione per un componente server specifico, configurare questi valori REG_DWORD nella chiave del Registro di sistema di Windows seguente:

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

Ad esempio, per il ruolo del punto di distribuzione:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\SMS\DP\Logging

Nome Valori Descrizione
Loglevel 0:Dettagliato
1:Predefinito
2: avvisi ed errori
3: solo errori		 Livello di dettaglio da scrivere nei file di log.
LogMaxHistory Qualsiasi numero intero maggiore o uguale a zero, ad esempio:
0: nessuna cronologia
1:Predefinito		 Quando un file di log raggiunge le dimensioni massime, il server lo rinomina come backup e crea un nuovo file di log. Specificare quante versioni precedenti mantenere.
LogMaxSize Qualsiasi numero intero maggiore o uguale a 10.000, ad esempio:
250000		 Dimensioni massime del file di log in byte. Quando un log raggiunge le dimensioni specificate, il server lo rinomina come file di cronologia e crea un nuovo file. Il valore predefinito è 250.000 byte.

Nota

Non modificare altri valori che possono esistere in questa chiave del Registro di sistema.

Configuration Manager opzioni di registrazione della console

Per modificare il livello dettagliato di AdminUI.log per la console di Configuration Manager, seguire questa procedura:

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

  2. Nell'elementodi originesystem.diagnostics>sources> modificare l'attributo switchValue da Error a Verbose. Ad esempio:

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

  3. Salvare il file e riavviare la console.

Configurare le opzioni di registrazione nella console di Configuration Manager

Abilitare o disabilitare la registrazione dettagliata su un client o una raccolta dalla console:

  1. Nella console Configuration Manager passare all'area di lavoro Asset e conformità, selezionare il nodo Dispositivi e scegliere un dispositivo di destinazione.

  2. Nella scheda Home della barra multifunzione selezionare Diagnostica client nel gruppo Dispositivo. Scegliere una delle azioni disponibili.

Per altre informazioni, vedere Diagnostica client.

Inventario hardware per le impostazioni del log client

A partire dalla versione 2107, è possibile abilitare l'inventario hardware per raccogliere le impostazioni dei file di log client. Abilitare la classe di inventario hardware, Diagnostica client (CCM_ClientDiagnostics) e quindi selezionare gli attributi seguenti:

  • Registrazione debug abilitata
  • Registrazione abilitata
  • Livello di log
  • Conteggio file cronologia
  • Dimensioni massime file di log

Nota

Questa classe di inventario non è abilitata per impostazione predefinita.

Per altre informazioni, vedere Abilitare o disabilitare le classi di inventario hardware esistenti.

Individuazione dei file di log

Configuration Manager e i componenti dipendenti archivia i file di log in diverse posizioni. Questi percorsi dipendono dal processo che crea il file di log e dalla configurazione dell'ambiente.

Le posizioni seguenti sono le impostazioni predefinite. Se le directory di installazione sono state personalizzate nell'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

Percorsi del log della sequenza di attività

Il percorso del file di log della sequenza di attività smsts.log varia a seconda della fase della sequenza di attività:

  • In Windows PE prima del passaggio Formato e disco partizione : X:\Windows\temp\smstslog\smsts.log (X è l'unità RAM di Windows PE)
  • In Windows PE dopo il passaggio Formato e disco di partizione : X:\smstslog\smsts.log, quindi 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

Consiglio

La variabile della sequenza di attività di sola lettura _SMSTSLogPath contiene sempre il percorso del file di log corrente.

Passaggi successivi