CMTrace

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

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

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

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

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

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

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

使用方法

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

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

• ファイル
• ツール

[ファイル] メニュー

[ ファイル ] メニューでは、次の操作を使用できます。

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

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

開く

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

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

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

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

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

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

サーバーで開く

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

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

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

印刷

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

ユーザー設定

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

• [全般] タブ

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

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

  • 列: ログビューに表示される列とそれらが表示される順序を構成します。 デフォルトでは、[Log Text]、[Component]、[Date/Time]、および [Thread] が表示されます。

• [印刷] タブ

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

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

• [詳細設定 ] タブ

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

    注:

    通常、[ 更新間隔] は変更しないでください。 これにより、大きなログ ファイルを開くのにかかる時間が大幅に増加する可能性があります。

[ツール] メニュー

[ ツール] メニューでは、次の操作を使用できます。

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

検索

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

次を検索

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

クリップボードにコピー

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

Highlight

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

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

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

• 10 進数または 16 進数を入力すると、CMTrace は値を [スレッド] 列と照合しようとします。 この動作を使用して、1 つのスレッドと対話する可能性のある他のスレッドをフィルター処理せずに、そのスレッドの処理を強調表示します。

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

Filter

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

例:

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

エラー検索

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

一時停止

ログの監視を一時停止または再開します。 このアクションを使用する理由としては、以下のユース ケースが挙げられます。

• 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 この既定の場所を制御します。 クライアントでこの値を %windir%\CCM\Logs に設定している場合、CMTrace は、初めて実行するときにクライアント ログの場所でファイルを開きます。

次の手順

• ログ ファイル

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

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