CMTrace

• 07/26/2019
• 8 minutes to read
• m
• d

Applicates to: Configuration Manager (現在のブランチ)

CMTrace は、Configuration Manager ツールの 1 つです。 次のタイプを含むログ ファイルを表示および監視できます:

• Configuration Manager または Client Component Manager (CCM) 形式のログ ファイル

• Windows Installer ログなどの ASCII または Unicode 平文ファイル

ハイライト、フィルタリング、エラー検索によりログ ファイルの解析に貢献するツールです。

バージョン 1806 から、CMTrace ログ表示ツールは Configuration Manager クライアントと一緒に自動的にインストールされるようになりました。 これはクライアントのインストール ディレクトリに追加され、デフォルトでは %WinDir%\CCM\CMTrace.exe.

バージョン 1906 から、OneTrace は Support Center と共に新しいログ ビューアとなりました。 CMTrace と同様に動作しますが、改良が加えられています。 詳細は、Support Center OneTrace.

Usage

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

CMTrace のほとんどの操作は、次のメニューから行います。

• File
• Tools

File メニュー

File メニューでは次の操作を行うことができます。

• Open
• Open on Server
• Print
• Preferences

Fileメニューには、最近8つのファイルもリストアップされます。

開く

ログ ファイルを参照するために、開くダイアログ ボックスを表示します。log)

以下の2つのオプションはデフォルトでは選択されていません：

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

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

Open on Server

Browse the Configuration Manager logs folders on a site system computer with the standard Browse dialog boxを使用してください。 また、リモート コンピュータのネットワークを参照することもできます。

参照するリモート コンピュータを選択すると、CMTrace は Configuration Manager 共有をチェックします。 1365>

ブラウズせずに既知のコンピュータに直接接続するには、[開く] アクションを使用します。

Print

Windows標準の印刷ダイアログボックスを表示します。 このアクションは、現在のログファイルをプリンタに送信します。 CMTrace PreferencesのPrintingタブの設定に従って出力をフォーマットします。

Preferences

CMTraceの設定を行います。

• General tab

  • Update Interval: CMTraceがログファイルへの変更をチェックし、新しい行をロードする頻度を制御します。 デフォルトでは、この値は 500 ミリ秒です。

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

  • Columns: ログ ビューで表示される列とその順序を設定します。 デフォルトでは、Log Text、Component、Date/Time、Thread が表示されます。

• Printing tab

  • Columns.Tab: ログ ビューに表示する列を設定します。 ログファイルを印刷するときに使用する列と、その表示順を設定します。 デフォルトでは、表示と同じ列を印刷します。

  • Orientation: ログファイルを印刷する際のデフォルトの印刷方向を設定します。 この設定は、[印刷]ダイアログ ボックスで変更できます。 デフォルトでは、縦向きが使用されます。

• Advanced tab

  • Refresh Interval.IO：ログファイルを更新する間隔。 大量の行を読み込むとき、CMTraceが指定された間隔でログ表示を更新するように強制します。 デフォルトでは、このオプションは値0で無効です。

    注意

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

  ツールメニュー

  ツールメニューでは、次の操作が可能です。

  • Find
  • Find Next
  • Copy to Clipboard
  • Highlight
  • Filter
  • Error Lookup
  • Pause
  • Show/Hide Details
  • Show/Hide Info Pane

  Find

  開いているログファイルから指定文字列を検索する。

  検索ダイアログボックスで指定した文字列を検索します。

  Copy to Clipboard

  選択した行をプレーンテキストとしてWindowsのクリップボードにコピーします。 Configuration ManagerおよびCCMログファイルを調査している場合、ビューと同じ順序で列をコピーします。 各カラムはタブ文字で区切られます。

  Highlight

  CMTrace が各ログ エントリのテキストを検索するのに使用する文字列を入力します。

  • ハイライトは、環境設定で指定した色を使用します。

  • ハイライトをオフにするには、このフィールドから文字列をクリアします。

  • 10進数または16進数を入力すると、CMTrace は Thread 列に値をマッチさせようとします。

  • 大文字と小文字を区別して文字列を比較するには、[Case sensitive] オプションを有効にします。 表示されているかどうかに関係なく、4つの列のいずれかにフィルタを適用します。

    例:

    • Filter smsts.log on entry text containing “the action” or “the group”.
    • Filter InventoryAgent.log where entry text contains “destination”.

    エラー検索

    Typed or paste an error code in either decimal or hexadecimal format to display a description. 考えられるエラーソースは次のとおりです。 Windows、WMI、または Winhttp。

    Pause

    ログ監視を一時停止または再開します。 このアクションを使用する理由としては、次の使用例が考えられます。

    • CMTrace がログファイル情報を早く表示する場合

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

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

    詳細を表示/隠す

    ログテキスト以外のすべての列を表示または非表示にします。 また、ログテキストのカラムをウィンドウの幅に拡大します。 この操作は、ディスプレイの解像度が低いコンピュータでログを表示しているときに使用します。

    Note

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

    Show/Hide Info Pane

    情報ペインを表示または隠します。 この操作は、ディスプレイの解像度が低いコンピュータでログを表示しているときに使用します。 1365>

    ログペイン

    ログペインは、CMTraceウィンドウの上部にあります。

    行を選択すると、Windows の選択カラースキームを使用して一時的に強調表示されます。

    強調表示された行は、ツールメニューのハイライトオプションで定義した条件に一致します。

    CMTrace は、エラーのある行を赤色の背景と黄色の文字色で表示します。 CCM形式のログでは、ログエントリは、エントリがエラーであることを示す明示的なタイプ値を持っています。 その他のログ形式では、CMTraceは各エントリで “error “に一致する文字列を大文字小文字を区別せずに検索します。

    警告の行は黄色の背景で表示されます。 CCM 形式のログでは、ログエントリは警告としてエントリを示す明示的なタイプ値を持っています。 他のログ形式では、CMTrace は各エントリで “warn” に一致する任意のテキスト文字列を大文字と小文字を区別せずに検索します。

    Info pane

    情報ペインは CMTrace ウィンドウの下部にあります。 以下の機能があります。

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

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

    • フォーマットされたテキストを表示するためにキャリッジ リターンが表示される

    • 。 読みやすい

    • ログペインに表示しきれない長いエントリを読みやすい

    ツールメニューの［情報ペインの表示/非表示］オプションで情報ペインを表示/非表示にすることができます。 情報ペインがログ ウィンドウの半分以上を占める場合、CMTrace は自動的にそれを隠します。

    Progress bar

    ログ ファイルを最初に開いたとき、CMTrace は情報ペインをプログレス バーで置き換えます。 このプログレスバーは、既存のファイルの内容をどれだけ読み込んだかを示しています。 進捗が100%に達すると、CMTraceは進捗バーを削除し、情報ペインに置き換えます。 1365>

    Status bar

    Configuration Manager 形式および CCM 形式のログ ファイルでは、ステータス バーに、選択したログ エントリの経過時間が表示されます。 1つのエントリを選択した場合、最初のログエントリから選択したエントリまでの時間が表示されます。 複数のエントリーを選択した場合は、選択した一番上のエントリーから、選択した一番下のエントリーまでの時間を計算します。 CMTrace はこの情報を次のようにフォーマットします。

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

    Windows シェル統合

    CMTrace はファイルの関連付けとドラッグ アンド ドロップをサポートします。

    File associations

    CMTrace では .log および .lo_ ファイル名の拡張子で関連付けることが可能です。 プログラムを起動すると、レジストリをチェックして、これらのファイル名拡張子にすでに関連付けされているかどうかを判断します。 CMTrace がまだどのファイル名拡張子とも関連付けられていない場合、ファイル名拡張子を CMTrace と関連付けるように要求されます。 1365>

    Drag-and-drop

    CMTrace は、基本的なドラッグ アンド ドロップ機能をサポートしています。 1365>

    Other tips

    Last Directory registry key

    CMTrace は、デフォルトで、最後に開いたログの場所を保存します。 この動作は、毎回ログ パスがデフォルトになるため、サイト サーバーで便利です。

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

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

    • Log files

    • Support Center Log File Viewer

    • Support Center OneTrace

    も参照してください。