CMTrace

  • 發行項

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

CMTrace 是其中一個Configuration Manager工具。 它可讓您檢視和監視記錄檔，包括下列類型：

  • Configuration Manager或用戶端元件管理員 (CCM) 格式的記錄檔

  • 純 ASCII 或 Unicode 文字檔，例如 Windows Installer 記錄

此工具可透過醒目提示、篩選和錯誤查閱來協助分析記錄檔。

注意事項

CMTrace 不會自動向 Windows 註冊以開啟 .log 副檔名。 如需詳細資訊，請參閱 檔案關聯。

Configuration Manager 2107 版包含 CMTrace 記錄檢視器的多項效能改進。

位置

Configuration Manager會自動在下列位置安裝 CMTrace：

  • 月臺伺服器的工具目錄。 例如：cd.latest\SMSSETUP\Tools\CMTrace.exe
  • 管理點的安裝目錄。 例如：C:\SMS_CCM\CMTrace.exe
  • 用戶端安裝目錄。 例如：C:\Windows\CCM\CMTrace.exe
  • OS 部署開機映射。 例如：X:\sms\bin\x64\CMTrace.exe

如果您在另一個位置有 CMTrace 複本，請考慮移除它，並在其中一個預設路徑中使用複本。 如果它位於符合您商務需求的自訂位置，請確定您有一個程式可讓它保持在最新狀態。 如果您的自訂位置可能對其他客戶有利，請提出 產品意見反應。

如需詳細資訊，請 參閱直接連結至社群中樞專案。

使用情況

執行 CMTrace.exe。 第一次執行此工具時，您會看到檔案關聯的提示。 如需詳細資訊，請參閱 檔案關聯。

您可以從下列功能表在 CMTrace 中採取大部分的動作：

[檔案] 功能表

下列動作可在 [ 檔案 ] 功能表中取得：

[檔案] 功能表也會列出最近八個檔案。 從 [檔案] 功能表中選取其中一個記錄，以快速重新開啟其中一個記錄。

開啟

顯示 [開啟] 對話方塊以流覽記錄檔。

篩選下列類型的檔案檢視：

  • 記錄檔 (*.log)
  • 舊的記錄檔 (*.lo_)
  • 所有檔案 (*.*)

預設不會選取下列兩個選項：

  • 忽略現有的行：選取時，CMTrace 會忽略所選記錄檔的現有內容，並且只會在新增新行時顯示新行。 當您不需要記錄檔的完整歷程記錄時，請使用此選項只監視新的動作。

  • 合併選取的檔案：如果您啟用此選項並選取多個記錄檔，CMTrace 會合並檢視中選取的記錄。 它會將它們顯示為單一記錄檔。 合併的記錄檔會更新相同，並支援所有其他 CMTrace 功能，就像是單一記錄檔一樣。

在伺服器上開啟

使用標準 [流覽] 對話方塊，流覽月臺系統電腦上的 [Configuration Manager 記錄] 資料夾。 您也可以流覽遠端電腦的網路。

當您選取要流覽的遠端電腦時，CMTrace 會檢查Configuration Manager共用。 如果找不到具有Configuration Manager記錄檔的共用，則會顯示錯誤訊息。

若要直接連線到已知電腦而不流覽，請使用 [開 啟] 動作。 然後輸入伺服器名稱，並使用 UNC 格式共用。

列印

顯示 [標準 Windows 列印] 對話方塊。 此動作會將目前的記錄檔傳送至印表機。 它會根據 CMTrace 喜好設定之 [列印] 索引標籤上的設定來格式化輸出。

喜好設定

設定 CMTrace 的設定。 下列為可用的選項：

  • 一般 索引標籤

    • 更新間隔：控制 CMTrace 檢查記錄檔變更並載入新行的頻率。 根據預設，此值為 500 毫秒。

    • 醒目提示：設定 CMTrace 在醒目提示您選擇的記錄行時所使用的色彩。 根據預設，此色彩為基本黃色 (紅色：255、綠色：255、藍色：0) 。

    • 資料行：設定記錄檢視中可見的資料行及其顯示順序。 根據預設，它會顯示記錄文字、元件、日期/時間和執行緒。

  • 列印索引 標籤

    • 資料行：設定列印記錄檔時所使用的資料行及其顯示順序。 根據預設，它會列印與顯示相同的資料行。

    • 方向：設定列印記錄檔時的預設列印方向。 在 [列印] 對話方塊中覆寫此設定。 根據預設，它會使用直向方向。

  • 進階索引 標籤

    • 重新整理間隔：強制 CMTrace 在載入大量行時，以指定的間隔更新記錄檢視。 根據預設，此選項會停用，且值為零。

      注意事項

      一般而言，請勿修改 重新整理間隔。 它可以大幅增加開啟大型記錄檔所需的時間量。

工具功能表

[ 工具 ] 功能表中提供下列動作：

尋找

在開啟的記錄檔中搜尋指定的文字字串。

尋找下一個

尋找下一個相符的字串，如您先前在 [尋找] 對話方塊中指定。

複製到剪貼簿

將選取的行以純文字形式複製到 Windows 剪貼簿。 如果您要檢查Configuration Manager和 CCM 記錄檔，它會以與檢視相同的順序複製資料行。 它會依定位字元分隔每個資料行。 將記錄複製到電子郵件訊息或其他檔時，請使用此動作。

[螢光筆]

輸入 CMTrace 用來搜尋每個記錄專案文字的字串。 然後，它會反白顯示任何符合您輸入之字串的記錄文字。

  • 醒目提示會使用您在 [喜好設定] 中指定的色彩。

  • 若要關閉醒目提示，請清除此欄位中的字串。

  • 如果您輸入十進位或十六進位數位，CMTrace 會嘗試比對執行緒資料行的值。 使用此行為來醒目提示單一線程的處理，而不會篩選掉可能與其互動的其他執行緒。

  • 若要依大小寫比較字串，請啟用區分 大小寫的選項。

篩選器

根據指定的準則顯示或隱藏記錄行。 將篩選套用至四個數據行中的任何一個，而不論它們是否可見。 這些設定會套用至每個開啟的記錄檔。

範例：

  • 篩選包含「動作」或「群組」的專案文字 smsts.log 。
  • 篩選 InventoryAgent.log， 其中的專案文字包含 「destination」。

錯誤查閱

輸入或貼上十進位或十六進位格式的錯誤碼，以顯示描述。 可能的錯誤來源包括：Windows、WMI 或 WinHTTP。

暫停

暫停或重新開機記錄監視。 下列使用案例是使用此動作的一些可能原因：

  • 當 CMTrace 太快顯示記錄檔資訊時

  • 當您暫停記錄監視時，如果目前的檔案回復到新的記錄檔，CMTrace 顯示的資訊不會遺失

  • 當您檢查記錄檔時，當您想要停止 CMTrace 顯示新資料時

顯示/隱藏詳細資料

顯示或隱藏記錄文字以外的所有資料行。 它也會將記錄文字資料行展開為視窗的寬度。 當您在低顯示解析度的電腦上檢視記錄時，請使用此動作。 它會顯示更多記錄文字。

注意事項

檢視純文字檔時，CMTrace 會自動隱藏詳細資料，因為它們一律是空的。

顯示/隱藏資訊窗格

顯示或隱藏 [資訊] 窗格。 當您在低顯示解析度的電腦上檢視記錄時，請使用此動作。 它會顯示更多記錄詳細資料。

記錄窗格

記錄窗格位於 CMTrace 視窗的頂端。 它會顯示記錄檔中的行。

當您選取一行時，會使用 Windows 選取色彩配置暫時反白顯示。

醒目提示的行符合您在 [工具] 功能表中使用[反白顯示] 選項所定義的準則。 醒目提示會使用您在 [ 喜好設定] 中指定的色彩。

CMTrace 會使用紅色背景和黃色文字色彩來顯示有錯誤的行。 在 CCM 格式的記錄中，記錄專案具有明確類型值，表示專案為錯誤。 針對其他記錄格式，CMTrace 會在每個專案中針對任何符合 「error」 的文字字串執行不區分大小寫的搜尋。

它會使用黃色背景顯示具有警告的行。 在 CCM 格式的記錄中，記錄專案具有明確類型值，表示專案為警告。 針對其他記錄格式，CMTrace 會在每個專案中針對任何符合 「warn」 的文字字串執行不區分大小寫的搜尋。

[資訊] 窗格

[資訊] 窗格位於 CMTrace 視窗的底部。 它包含下列功能：

  • 目前選取之記錄專案的詳細資料

  • 顯示記錄文字的文字方塊

  • 它會顯示歸位字元，讓格式化的文字更容易閱讀

  • 更容易讀取未在 [記錄檔] 窗格中完全顯示的長專案

使用 [工具] 功能表上的 [顯示/隱藏資訊窗格] 選項來顯示或隱藏 [資訊] 窗格。 如果 [資訊] 窗格佔用超過一半的記錄視窗，CMTrace 會自動隱藏它。

進度列

當您第一次開啟記錄檔時，CMTrace 會以進度列取代 [資訊] 窗格。 此進度表示已載入多少現有的檔案內容。 進度達到 100%，CMTrace 會移除進度列，並將它取代為 [資訊] 窗格。 當您載入大型檔案時，此行為可讓您指出載入可能需要多久的時間。

狀態列

針對Configuration Manager格式和 CCM 格式的記錄檔，狀態列會顯示所選記錄專案的經過時間。 如果您選取單一專案，此工具會顯示從第一個記錄專案到所選取專案的時間。 如果您選取多個專案，它會計算從最上層選取專案到最下層選取專案的時間。 CMTrace 會格式化這項資訊，如下所示：

Elapsed time is <hours>h <minutes>m <seconds>s <milliseconds>ms (<seconds+milliseconds> seconds)

Windows 殼層整合

CMTrace 支援 檔案關聯 和 拖放。

檔案關聯

CMTrace 可以將自己與 .log 建立關聯，並.lo_副檔名。 當程式啟動時，它會檢查登錄，以判斷它是否已經與這些副檔名相關聯。 如果 CMTrace 尚未與任何副檔名相關聯，系統會提示您將副檔名與 CMTrace 產生關聯。 如果您選取 [不要再詢問我]，CMTrace 會在這部電腦上執行時略過這項檢查。

拖放

CMTrace 支援基本的拖放功能。 將記錄檔從 Windows 檔案總管拖曳至 CMTrace 以開啟它。

其他秘訣

最後一個目錄登錄機碼

根據預設，CMTrace 會儲存您開啟的最後一個記錄位置。 此行為在月臺伺服器上很有用，因為它每次都會預設為記錄路徑。

第一次在用戶端上啟動時，它會預設為目前的工作目錄。 此位置可能是您儲存 CMTrace 的路徑，或類似 的 %userprofile%\Desktop 路徑。

登錄機碼中的 HKEY_CURRENT_USER\Software\Microsoft\Trace32Last Directory值會控制這個預設位置。 如果您在用戶端上將此值設定為 %windir%\CCM\Logs ，則 CMTrace 會在第一次執行時，在用戶端記錄檔位置中開啟檔案。

後續步驟

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