關於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 一律包含目前記錄檔的路徑。

後續步驟