共用方式為

關於 Configuration Manager 中的記錄檔

  • 發行項

適用於：Configuration Manager (目前的分支)

在 Configuration Manager 中，用戶端和站台伺服器元件會在個別記錄檔中記錄處理資訊。 您可以使用這些記錄檔中的資訊，協助您針對可能發生的問題進行疑難解答。 根據預設，Configuration Manager 會啟用用戶端和伺服器元件的記錄。

本文提供有關 Configuration Manager 記錄檔的一般資訊。 它包含要使用的工具、如何設定記錄檔，以及可在何處找到這些記錄。 如需特定記錄檔的詳細資訊，請參閱 記錄檔參考。

運作方式

中的大部分程式 Configuration Manager 將作業資訊寫入至該程式專用的記錄檔。 記錄檔是由 或 .lo_ 擴展名所.log識別。 Configuration Manager 寫入檔案，.log直到該記錄檔達到其大小上限為止。 當記錄檔已滿時， .log 檔案會複製到同名但 .lo_ 擴展名為 的檔案，而進程或元件會繼續寫入 .log 檔案。 .log當檔案再次達到其大小上限時，.lo_檔案會被覆寫，而且進程會重複。 某些元件會藉由將日期和時間戳附加至記錄檔名稱，並保留 .log 擴展名來建立記錄檔歷程記錄。

記錄查看器工具

所有 Configuration Manager 記錄檔都是純文字，因此您可以使用記事本之類的任何文字讀取器來檢視它們。 記錄會使用最適合使用下列其中一個特殊工具檢視的唯一格式：

CMTrace

若要檢視記錄，請使用 Configuration Manager 記錄查看器工具 CMTrace。 它位於 \SMSSetup\Tools Configuration Manager 來源媒體的資料夾中。 CMTrace 工具會新增至新增至軟體連結庫的所有開機映射。 CMTrace 記錄檢視工具會與 Configuration Manager 用戶端一起自動安裝。 如需詳細資訊，請參閱 CMTrace。

OneTrace

OneTrace 是支援中心的記錄查看器。 其運作方式類似於 CMTrace，具有改善功能。 如需詳細資訊，請參閱 支援中心 OneTrace。

支援中心記錄檔查看器

支援中心 包含新式記錄查看器。 此工具會取代 CMTrace，並提供可自定義的介面，以支援索引標籤和可停駐視窗。 它具有快速的呈現層，而且可以在幾秒內載入大型記錄檔。 如需詳細資訊，請參閱 支援中心記錄檔查看器。

注意事項

支援中心記錄檔查看器和 OneTrace 會使用 Windows Presentation Foundation (WPF) 。 Windows PE 中無法使用此元件。 繼續搭配工作順序部署在開機映射中使用CMTrace。

設定記錄選項

您可以變更記錄檔的組態，例如詳細資訊層級、大小和歷程記錄。 有幾種方式可以變更這些設定：

您也可以使用 硬體清查從用戶端收集記錄設定 。

在用戶端安裝期間設定記錄選項

您可以在安裝期間設定客戶端記錄檔的組態。 使用下列屬性：

  • CCMENABLELOGGING
  • CCMDEBUGLOGGING
  • CCMLOGLEVEL
  • CCMLOGMAXHISTORY
  • CCMLOGMAXSIZE

如需詳細資訊，請 參閱用戶端安裝屬性。

使用 Configuration Manager Service Manager 設定記錄選項

您可以變更 Configuration Manager 儲存記錄檔的位置及其大小。

若要修改記錄檔的大小、變更記錄檔的名稱和位置，或強制多個元件寫入單一記錄檔，請執行下列步驟：

修改元件的記錄

  1. 在 Configuration Manager 控制台中，移至 [監視] 工作區，展開 [系統狀態]，然後選取 [月台狀態] 或 [元件狀態] 節點。

  2. 在功能區中，選取 [開始]，然後選取 [Configuration Manager Service Manager]。

  3. 當 Configuration Manager Service Manager 開啟時，請連線到您要管理的網站。 如果未顯示您想要管理的網站，請選取 [ 月臺]，選取 [ 連線]，然後輸入正確月臺的月臺伺服器名稱。

  4. 展開網站並移至 [元件 或 伺服器]，視您要管理的元件所在位置而定。

  5. 在右窗格中，選取一或多個元件。

  6. 在 [ 元件] 功能表上，選取 [ 記錄]。

  7. 在 [Configuration Manager元件記錄] 對話框中，完成您所選取專案的可用組態選項。

  8. 選取 [確定 ] 以儲存設定。

使用 Windows 登錄設定記錄選項

使用伺服器或用戶端上的 Windows 登入變更下列記錄選項：

  • 詳細資訊層級
  • 記錄上限
  • 大小上限

針對問題進行疑難解答時，您可以啟用詳細信息記錄，讓 Configuration Manager 在記錄檔中寫入其他詳細數據。

警告

這些設定設定錯誤可能會導致 Configuration Manager 記錄大量資訊，或完全不會記錄任何資訊。 雖然這項數據有助於進行疑難解答，但是在生產網站中變更這些值時請小心。 請務必先在實驗室環境中測試這些變更。 可能會發生過多的記錄，這可能會讓您難以在記錄檔中找到相關信息。

對這些登錄設定進行變更之後，請重新啟動元件：

  • 如果您變更用戶端設定，請 (CcmExec) 重新啟動 SMS 代理程式主機 服務。
  • 如果您變更伺服器設定，請重新啟動 SMS Executive 服務。

登入設定會根據元件而有所不同：

用戶端和管理點記錄選項

若要設定用戶端或管理點站台系統上所有元件的記錄選項，請在下列 Windows 登錄機碼下 設定這些REG_DWORD 值：

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

名稱 值 描述
LogLevel 0：詳細
1：違約
2：警告和錯誤
3：僅錯誤		 要寫入記錄檔的詳細數據層級。
LogMaxHistory 任何大於或等於零的整數，例如：
0：沒有歷程記錄
1：違約		 當記錄檔達到大小上限時，用戶端會將其重新命名為備份，並建立新的記錄檔。 指定要保留多少舊版。
LogMaxSize 任何大於或等於 10,000 的整數，例如：
250000		 記錄檔大小上限，以位元組為單位。 當記錄檔成長至指定的大小時，用戶端會將它重新命名為記錄檔，並建立新的檔案。 默認值為 250,000 個字節。

注意事項

請勿變更可能存在於此登錄機碼中的其他值。

若要進行進階偵錯，您也可以在下列 Windows 登錄機碼下新增此 REG_SZ 值：

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\CCM\Logging\DebugLogging

名稱 值 描述
Enabled True：啟用偵錯記錄
False：停用偵錯記錄		 啟用偵錯記錄以進行疑難解答。

此設定會導致客戶端記錄低階資訊以進行疑難解答。 避免在生產網站中使用此設定。 可能會發生過多的記錄，這可能會讓您難以在記錄檔中找到相關信息。 解決此問題之後，請務必關閉此設定。

月臺伺服器記錄選項

您可以全域設定設定，或針對 Configuration Manager 月臺伺服器上的特定元件進行設定。

在下列 Windows 登錄機碼下設定這些值：

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\SMS\Tracing

名稱 值 類型 描述
SqlEnabled 1：啟用 SQL Server 追蹤
0：停用 SQL Server 追蹤		 REG_DWORD 將 SQL Server 追蹤記錄新增至所有月臺伺服器記錄。
ArchiveEnabled 1：啟用記錄檔封存
0：停用記錄檔封存		 REG_DWORD 封存 月臺伺服器記錄到個別位置以保留歷程記錄。
ArchivePath 有效的資料夾路徑，例如 C:\Logs\Archive REG_SZ 封存月臺伺服器記錄的路徑。

僅啟用 SQL Server 追蹤以進行疑難解答。 避免在生產網站中使用它。 可能會發生過多的記錄，這可能會讓您難以在記錄檔中找到相關信息。 解決此問題之後，請務必關閉此設定。

注意事項

請勿變更可能存在於此登錄機碼中的其他值。

若要設定特定伺服器元件的記錄選項，請在下列 Windows 登錄機碼下設定這些 REG_DWORD 值：

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

名稱 值 描述
LoggingLevel 0：詳細
1：違約
2：警告和錯誤
3：僅錯誤		 要寫入記錄檔的詳細數據層級。
LogMaxHistory 任何大於或等於零的整數，例如：
0：沒有歷程記錄
1：違約		 當記錄檔達到大小上限時，伺服器會將它重新命名為備份，並建立新的記錄檔。 指定要保留多少舊版。
MaxFileSize 任何大於或等於 10,000 的整數，例如：
250000		 記錄檔大小上限，以位元組為單位。 當記錄檔成長至指定的大小時，用戶端會將它重新命名為記錄檔，並建立新的檔案。 默認值為 250,000 個字節。
DebugLogging 1：啟用偵錯記錄
0：停用偵錯記錄		 啟用偵錯記錄以進行疑難解答。

[偵錯記錄] 設定會導致伺服器記錄低階資訊以進行疑難解答。 避免在生產網站中使用此設定。 可能會發生過多的記錄，這可能會讓您難以在記錄檔中找到相關信息。 解決此問題之後，請務必關閉此設定。

注意事項

請勿變更可能存在於此登錄機碼中的其他值。

月臺系統角色記錄選項

您可以全域設定設定，或針對裝載 Configuration Manager 伺服器角色之月台系統上的特定元件進行設定。

若要設定特定伺服器元件的記錄選項，請在下列 Windows 登錄機碼下設定這些 REG_DWORD 值：

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

例如，針對發佈點角色：

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\SMS\DP\Logging

名稱 值 描述
LogLevel 0：詳細
1：違約
2：警告和錯誤
3：僅錯誤		 要寫入記錄檔的詳細數據層級。
LogMaxHistory 任何大於或等於零的整數，例如：
0：沒有歷程記錄
1：違約		 當記錄檔達到大小上限時，伺服器會將它重新命名為備份，並建立新的記錄檔。 指定要保留多少舊版。
LogMaxSize 任何大於或等於 10,000 的整數，例如：
250000		 記錄檔大小上限，以位元組為單位。 當記錄檔成長至指定的大小時，伺服器會將它重新命名為記錄檔，並建立新的檔案。 默認值為 250,000 個字節。

注意事項

請勿變更可能存在於此登錄機碼中的其他值。

Configuration Manager 主控台記錄選項

若要變更 Configuration Manager 主控台AdminUI.log的詳細資訊層級，請使用下列程式：

  1. 在 [記事本] 之類的 XML 編輯器中，開啟控制台配置檔 Microsoft.ConfigurationManagement.exe.config。 預設組態檔位於下列位置： C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\bin\Microsoft.ConfigurationManagement.exe.config

  2. 在 system.diagnostics>來源來源>元素下，將 switchValue 屬性從 Error 變更為 。Verbose 例如：

    原始： <source name="SmsAdminUISnapIn" switchValue="Error"> 新增： <source name="SmsAdminUISnapIn" switchValue="Verbose" >

  3. 儲存盤案，然後重新啟動主控台。

在 Configuration Manager 控制台中設定記錄選項

從主控台啟用或停用用戶端或集合上的詳細資訊記錄：

  1. 在 Configuration Manager 控制台中，移至 [資產與兼容性] 工作區，選取 [裝置] 節點，然後選擇目標裝置。

  2. 在功能區中的 [ 首頁] 索引標籤上，選取 [ 裝置 ] 群組中的 [ 客戶端診斷]。 選擇其中一個可用的動作。

如需詳細資訊，請參閱 客戶端診斷。

用戶端記錄設定的硬體清查

從 2107 版開始，您可以啟用硬體清查來收集客戶端記錄檔設定。 啟用硬體清查類別 Client Diagnostics (CCM_ClientDiagnostics) ，然後選取下列屬性：

  • 已啟用偵錯記錄
  • 已啟用記錄
  • 記錄層級
  • 歷程記錄檔案計數
  • 記錄檔大小上限

注意事項

預設不會啟用此清查類別。

如需詳細資訊，請 參閱啟用或停用現有的硬體清查類別。

尋找記錄檔

Configuration Manager和相依元件會將記錄檔儲存在各種位置。 這些位置取決於建立記錄檔和環境設定的程式。

下列位置是預設值。 如果您自定義環境中的安裝目錄，實際路徑可能會有所不同。

  • 客戶： C:\Windows\CCM\logs
  • 伺服器： C:\Program Files\Microsoft Configuration Manager\Logs
  • 管理點： C:\SMS_CCM\Logs
  • Configuration Manager 主控台：C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\AdminUILog
  • IIS： C:\inetpub\logs\logfiles\w3svc1

工作順序記錄位置

工作順序記錄檔 的位置smsts.log 視工作順序的階段而有所不同：

  • 在 Windows PE 中， 在 [格式化] 和 [磁碟分區 ] 步驟之前： X:\Windows\temp\smstslog\smsts.log (X 是 Windows PE RAM 磁碟驅動器)
  • 在 Windows PE 的 [格式化和分割磁碟] 步驟之後：X:\smstslog\smsts.log，然後在磁碟驅動器準備就緒時複製到C:\_SMSTaskSequence\Logs\smstslog\smsts.log
  • 在安裝用戶端之前，在新的 Windows OS 中： C:\_SMSTaskSequence\Logs\smstslog\smsts.log
  • 在 Windows 中安裝客戶端之後： C:\Windows\CCM\Logs\smstslog\smsts.log
  • 在 Windows 中，工作順序完成之後： C:\Windows\CCM\Logs\smsts.log

提示

只讀工作順序變數 _SMSTSLogPath 一律包含目前記錄檔的路徑。

後續步驟