CMTrace

Configuration Manager (現在のブランチ) に適用

CMTrace は、Configuration Manager ツールの 1 つです。 これにより、次の種類を含むログ ファイルを表示および監視できます。

• Configuration Managerまたはクライアント コンポーネント マネージャー (CCM) 形式のログ ファイル

• Windows インストーラー ログなどのプレーン ASCII または Unicode テキスト ファイル

このツールは、強調表示、フィルター処理、エラー検索によってログ ファイルを分析するのに役立ちます。

注:

CMTrace は、.log ファイル拡張子を開くために Windows に自動的に登録されません。 詳細については、「 ファイルの関連付け」を参照してください。

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 を削除し、既定のパスのいずれかでコピーを使用することを検討してください。 ビジネス要件を満たすカスタムの場所にある場合は、それを最新の状態に保つプロセスがあることを確認してください。 カスタムの場所が他の顧客にとって有益な場合は、 製品のフィードバックを提出してください。

詳細については、「 コミュニティ ハブ項目への直接リンク」を参照してください。

使用方法

CMTrace.exeを実行します。 ツールを初めて実行すると、ファイルの関連付けを求めるプロンプトが表示されます。 詳細については、「 ファイルの関連付け」を参照してください。

CMTrace では、次のメニューからほとんどのアクションを実行します。

• ファイル
• ツール

[ファイル] メニュー

[ ファイル ] メニューでは、次のアクションを使用できます。

• Open
• サーバーで開く
• 印刷
• ユーザー設定

[ファイル] メニューには、最近使用した 8 つのファイルも一覧表示されます。 [ファイル] メニューからログを選択して、これらのログの 1 つをすばやく再度開きます。

開く

[開く] ダイアログ ボックスを表示して、ログ ファイルを参照します。

次の種類のファイルのビューをフィルター処理します。

• ログ ファイル (*.log)
• 古いログ ファイル (*.lo_)
• すべてのファイル (*.*)

既定では、次の 2 つのオプションは選択されていません。

• [既存の行を無視する]: オンにすると、CMTrace は選択したログ ファイルの既存の内容を無視し、新しい行が追加されたときにのみ表示されます。 ログ ファイルの完全な履歴が不要な場合にのみ、このオプションを使用して新しいアクションを監視します。

• 選択したファイルをマージする: このオプションを有効にして複数のログ ファイルを選択すると、CMTrace によって選択したログがビューにマージされます。 1 つのログ ファイルであるかのように表示されます。 マージされたログは同じように更新され、1 つのログ ファイルであるかのように他のすべての CMTrace 機能がサポートされます。

サーバーで開く

標準の [参照] ダイアログ ボックスを使用して、サイト システム コンピューター上の [Configuration Manager ログ] フォルダーを参照します。 リモート コンピューターのネットワークを参照することもできます。

参照するリモート コンピューターを選択すると、CMTrace によってConfiguration Manager共有がチェックされます。 Configuration Managerログ ファイルを含む共有が見つからない場合は、エラー メッセージが表示されます。

参照せずに既知のコンピューターに直接接続するには、[ 開く ] アクションを使用します。 次に、UNC 形式を使用してサーバー名と共有を入力します。

印刷

標準の [Windows 印刷] ダイアログ ボックスを表示します。 このアクションにより、現在のログ ファイルがプリンターに送信されます。 CMTrace 基本設定の [印刷] タブの設定に従って出力を書式設定します。

ユーザー設定

CMTrace の設定を構成します。 次のオプションを利用できます。

• [全般 ] タブ

  • 更新間隔: CMTrace がログ ファイルの変更をチェックし、新しい行を読み込む頻度を制御します。 既定では、この値は 500 ミリ秒です。

  • 強調表示: 選択したログ行を強調表示するときに CMTrace が使用する色を設定します。 既定では、この色は基本的な黄色 (赤: 255、緑: 255、青: 0) です。

  • [列]: ログ ビューに表示される列と、それらが表示される順序を構成します。 既定では、ログ テキスト、コンポーネント、日付/時刻、スレッドが表示されます。

• [印刷 ] タブ

  • [列]: ログ ファイルの印刷時に使用する列と、ログ ファイルの表示順序を構成します。 既定では、表示と同じ列が出力されます。

  • [向き]: ログ ファイルを印刷するときの既定の印刷方向を設定します。 [印刷] ダイアログ ボックスでこの設定をオーバーライドします。 既定では、縦向きが使用されます。

• [詳細設定 ] タブ

  • 更新間隔: 多数の行を読み込むときに、指定した間隔で CMTrace にログ ビューを強制的に更新します。 既定では、このオプションは 0 の値で無効になっています。

    注:

    一般に、 更新間隔は変更しないでください。 大きなログ ファイルを開くためにかかる時間が大幅に長くなる可能性があります。

[ツール] メニュー

[ ツール] メニューでは、次のアクションを使用できます。

• 検索
• 次を検索
• クリップボードにコピー
• Highlight
• フィルター
• エラー検索
• Pause
• 詳細の表示/非表示
• 情報ウィンドウの表示/非表示

検索

開いているログ ファイルで、指定したテキスト文字列を検索します。

次を検索

[検索] ダイアログ ボックスで指定した次の一致する文字列を検索します。

クリップボードにコピー

選択した行をプレーン テキストとして Windows クリップボードにコピーします。 Configuration Managerおよび CCM ログ ファイルを調べる場合は、ビューと同じ順序で列がコピーされます。 各列をタブ文字で区切ります。 このアクションは、電子メール メッセージまたはその他のドキュメントにログをコピーするときに使用します。

Highlight

CMTrace が各ログ エントリのテキストを検索するために使用する文字列を入力します。 次に、入力した文字列と一致するログ テキストが強調表示されます。

• 強調表示では、[基本設定] で指定した色が使用されます。

• 強調表示をオフにするには、このフィールドから文字列をクリアします。

• 10 進数または 16 進数を入力すると、CMTrace は値と Thread 列の照合を試みます。 この動作を使用して、操作する可能性のある他のスレッドを除外せずに、1 つのスレッドの処理を強調表示します。

• 大文字と小文字を区別して文字列を比較するには、[ 大文字と小文字を区別する] オプションを有効にします。

Filter

指定した条件に基づいてログ行を表示または非表示にします。 表示されているかどうかに関係なく、4 つの列のいずれかにフィルターを適用します。 これらの設定は、開いている各ログ ファイルに適用されます。

例:

• "アクション" または "グループ" を含むエントリ テキストで smsts.log をフィルター処理します。
• エントリ テキストに "destination" が含まれている InventoryAgent.log をフィルター処理します。

エラー検索

エラー コードを 10 進数または 16 進形式で入力または貼り付けて説明を表示します。 考えられるエラー ソースは、Windows、WMI、または Winhttp です。

一時停止

ログ監視を中断または再起動します。 次のユース ケースは、このアクションを使用する理由の一部です。

• CMTrace がログ ファイル情報を表示する速度が速すぎる場合

• ログ監視を一時停止すると、現在のファイルが新しいログにロールオーバーしても CMTrace に表示される情報は失われません

• ログ ファイルを調べながら CMTrace が新しいデータを表示しないようにする場合

詳細の表示/非表示

ログ テキスト以外のすべての列を表示または非表示にします。 また、ログ テキスト列をウィンドウの幅に展開します。 表示解像度が低いコンピューターでログを表示する場合は、このアクションを使用します。 より多くのログ テキストが表示されます。

注:

プレーンテキスト ファイルを表示すると、CMTrace は常に空であるため、詳細を自動的に非表示にします。

情報ウィンドウの表示/非表示

[情報] ウィンドウを表示または非表示にします。 表示解像度が低いコンピューターでログを表示する場合は、このアクションを使用します。 ログ記録の詳細が表示されます。

[ログ] ウィンドウ

ログ ウィンドウは CMTrace ウィンドウの上部にあります。 ログ ファイルの行が表示されます。

線を選択すると、Windows 選択配色を使用して一時的に強調表示されます。

強調表示された線は、[ツール] メニューの [強調表示] オプションで定義した条件と一致します。 強調表示では、[ 基本設定] で指定した色が使用されます。

CMTrace では、赤い背景と黄色のテキストの色を使用して、エラーのある行が表示されます。 CCM 形式のログでは、ログ エントリには、エントリをエラーとして示す明示的な型の値があります。 その他のログ形式の場合、CMTrace は、"error" と一致するテキスト文字列について、各エントリで大文字と小文字を区別しない検索を行います。

黄色の背景を使用して警告を含む線が表示されます。 CCM 形式のログでは、ログ エントリには、エントリを警告として示す明示的な型の値があります。 その他のログ形式の場合、CMTrace は、"warn" と一致するテキスト文字列について、各エントリで大文字と小文字を区別しない検索を行います。

情報ウィンドウ

[情報] ウィンドウは CMTrace ウィンドウの下部にあります。 これには、次の機能が含まれます。

• 現在選択されているログ エントリの詳細

• ログ テキストを表示するテキスト ボックス

• 書式設定されたテキストを読みやすくするために、キャリッジ リターンが表示されます

• ログ ウィンドウに完全に表示されない長いエントリを読みやすくする

[ツール] メニューの [情報ウィンドウの表示/非表示] オプションを使用して、[情報] ウィンドウを表示または非表示にします。 [情報] ウィンドウがログ ウィンドウの半分以上を占める場合、CMTrace によって自動的に非表示になります。

進行状況バー

ログ ファイルを初めて開くと、CMTrace によって [情報] ウィンドウが進行状況バーに置き換えられます。 この進行状況は、読み込まれている既存のファイル コンテンツの量を示します。 進行状況は 100% に達し、CMTrace は進行状況バーを削除し、[情報] ウィンドウに置き換えます。 大きなファイルを読み込むと、この動作により、読み込みにかかる時間が示されます。

ステータス バー

Configuration Manager形式および CCM 形式のログ ファイルの場合、ステータス バーには、選択したログ エントリの経過時間が表示されます。 1 つのエントリを選択すると、ツールは最初のログ エントリから選択したエントリまでの時間を表示します。 複数のエントリを選択すると、一番上のエントリから最も一番下のエントリまでの時間が計算されます。 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 にログ ファイルをドラッグして開きます。

その他のヒント

Last Directory レジストリ キー

既定では、CMTrace は最後に開いたログの場所を保存します。 この動作は、既定では毎回ログ パスに設定されるため、サイト サーバーで役立ちます。

クライアントで初めて起動すると、既定で現在の作業ディレクトリになります。 この場所は、CMTrace を保存したパス、または のような %userprofile%\Desktopパスです。

レジストリ キーHKEY_CURRENT_USER\Software\Microsoft\Trace32の Last Directory 値によって、この既定の場所が制御されます。 クライアントでこの値を に %windir%\CCM\Logs 設定すると、CMTrace は初めて実行するときにクライアント ログの場所にファイルを開きます。

次の手順

• ログ ファイル

• サポート センターのログ ファイル ビューアー

OneTrace は、サポート センターを備えたログ ビューアーです。 CMTrace と同様に機能し、機能強化が行われました。 詳細については、「 サポート センター OneTrace」を参照してください。