適用於:Configuration Manager (目前的分支)
CMTrace 是其中一個 Configuration Manager 工具。 它可讓您檢視和監視記錄檔,包括下列類型:
Configuration Manager 或 Client Component 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 - 作業系統部署開機映像。 例如:
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 在載入大量行時,以指定的時間間隔更新記錄檢視。 根據預設,此選項會停用,值為零。
注意事項
一般而言,請勿修改 重新整理間隔。 它會大幅增加開啟大型記錄檔所需的時間。
工具功能表
您可以在 [工具] 功能表中執行下列動作:
Find
在開啟的記錄檔中搜尋指定的文字字串。
尋找下一個
尋找下一個相符字串,如先前在 [尋找] 對話方塊中所指定。
複製到剪貼簿
將選取的行以純文字格式複製到 Windows 剪貼簿。 如果您正在檢查 Configuration Manager 和 CCM 記錄檔,它會以與檢視相同的順序複製欄。 它會以一個 Tab 字元分隔每一欄。 將記錄複製到電子郵件訊息或其他文件時,請使用此動作。
[螢光筆]
輸入 CMTrace 用來搜尋每個記錄項目文字的字串。 接著,它會醒目提示任何符合您輸入字串的記錄文字。
醒目提示會使用您在 [喜好設定] 中指定的色彩。
若要關閉醒目提示,請清除此欄位中的字串。
如果您輸入十進位或十六進位數字,CMTrace 會嘗試將值與 [對話] 欄相符。 使用此行為來醒目提示單一執行緒的處理,而不篩選掉可能與其互動的其他執行緒。
若要依大小寫比較字串,請啟用 [區分大小寫] 選項。
篩選器
根據指定的準則顯示或隱藏記錄行。 將篩選套用至四個欄中的任何一個,無論它們是否顯示。 這些設定會套用至每個開啟的記錄檔。
範例:
- 在包含「動作」或「群組」的項目文字上篩選 smsts.log 。
- 篩選項目文字包含 “目的地” 的 InventoryAgent.log 。
錯誤查閱
以十進位或十六進位格式輸入或貼上錯誤碼,以顯示描述。 可能的錯誤來源包括: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 可以將自身與 .log 和 .lo_ 副檔名建立關聯。 當程式啟動時,它會檢查登錄,以判斷它是否已與這些檔案副檔名相關聯。 如果 CMTrace 尚未與任何檔案副檔名相關聯,系統會提示您將檔案副檔名與 CMTrace 相關聯。 如果您選取 [不要再問我],CMTrace 會在此電腦上執行時略過此檢查。
拖放
CMTrace 支援基本的拖放功能。 將記錄檔從 Windows 檔案總管拖曳到 CMTrace 中加以開啟。
其他提示
最後一個目錄登錄機碼
根據預設,CMTrace 會儲存您最後開啟的記錄位置。 此行為在網站伺服器上很有用,因為它每次都預設為記錄路徑。
第一次在用戶端上啟動它時,它預設為目前的工作目錄。 此位置可能是您儲存 CMTrace 的路徑,或類似 %userprofile%\Desktop的路徑。
登錄機碼HKEY_CURRENT_USER\Software\Microsoft\Trace32中的 [最後一個目錄] 值會控制這個預設位置。 如果您將此值設為 %windir%\CCM\Logs [用戶端上],則 CMTrace 會在您第一次執行時,開啟用戶端記錄檔位置中的檔案。
後續步驟
OneTrace 是帶有支援中心的記錄檢視器。 其運作方式與 CMTrace 類似,但有所改進。 如需詳細資訊,請參閱 OneTrace 支援中心。