About log files in Configuration Manager

• 11/29/2019
• 10 minutes to read
• • a
  • d

適用対象です。 Configuration Manager (現在のブランチ)

Configuration Manager では、クライアントおよびサイト サーバー コンポーネントは、個別のログ ファイルにプロセス情報を記録します。 これらのログ ファイル内の情報は、発生する可能性のある問題のトラブルシューティングに役立てることができます。 デフォルトでは、Configuration Manager はクライアントおよびサーバー コンポーネントのログを有効にします。

この文書では、Configuration Manager ログ ファイルに関する一般的な情報を提供します。 使用するツール、ログを構成する方法、およびログがある場所などが含まれます。 特定のログ ファイルの詳細については、「ログ ファイルの参照」を参照してください。

動作原理

Configuration Manager のほとんどのプロセスは、そのプロセス専用のログ ファイルに操作情報を書き込みます。 ログファイルは、.logまたは.lo_のファイル拡張子で識別されます。 Configuration Managerは、そのログが最大サイズに達するまで.logファイルに書き込みます。 ログがいっぱいになると、.log ファイルは同じ名前で拡張子が .lo_ のファイルにコピーされ、プロセスまたはコンポーネントは .log ファイルへの書き込みを続行します。 .logファイルが再び最大サイズに達すると、.lo_ファイルが上書きされ、このプロセスが繰り返されます。 一部のコンポーネントは、ログファイル名に日付と時間のスタンプを追加し、.log 拡張子を維持することによって、ログファイルの履歴を確立します。

Log Viewer tools

すべての Configuration Manager ログファイルはプレーンテキストなので、メモ帳などのテキストリーダーでそれらを表示することができます。 ログは独自の書式を使用しているため、次の専用ツールを使用して表示するのが最適です。

• CMTrace
• OneTrace
• Support Center log viewer

CMTrace

ログを表示するには、Configuration Manager ログ ビューア ツール CMTrace を使用します。 これは、Configuration Managerのソースメディアの\SMSSetup\Toolsフォルダに配置されています。 CMTraceツールは、ソフトウェアライブラリに追加されるすべてのブートイメージに追加されます。 CMTrace ログ表示ツールは、Configuration Manager クライアントと一緒に自動的にインストールされます。 詳細については、CMTrace.

OneTrace

バージョン1906から、OneTraceはSupport Centerの新しいログビューワーになりました。 CMTraceと同様に動作しますが、改良が加えられています。 詳細は、Support Center OneTraceを参照してください。

Support Center log viewer

Support Centerには、最新のログビューワが搭載されています。 このツールは CMTrace に代わるもので、タブやドッキング可能なウィンドウをサポートするカスタマイズ可能なインターフェイスを提供します。 また、高速なプレゼンテーション層を持ち、大きなログファイルを数秒で読み込むことができます。 詳細については、Support Center Log Viewer reference.

注意

Support Center および OneTrace は、Windows Presentation Foundation (WPF) を使用します。 このコンポーネントは Windows PE では使用できません。 8967>

ログ オプションの構成

冗長レベル、サイズ、および履歴など、ログ ファイルの構成を変更することができます。 これらの設定を変更するには、いくつかの方法があります。

• クライアントインストール時
• Configuration Managerサービスマネージャを使用する
• Windowsレジストを使用する
• Configuration Managerコンソール

Configure logging options during client installation

インストール中クライアントログファイルの設定をすることも可能です。 次のプロパティを使用します。

• CCMENABLELOGGING
• CCMDEBUGLOGGING
• CCMLOGLEVEL
• CCMLOGMAXHISTORY
• CCMLOGMAXSIZE

詳細については、「クライアント インストールのプロパティを参照してください」を参照します。

Configuration Manager サービス マネージャを使用したログ オプションの構成

Configuration Manager のログ ファイルの保存場所とそのサイズを変更できます。

ログファイルのサイズを変更したり、ログファイルの名前と場所を変更したり、複数のコンポーネントに単一のログファイルへの書き込みを強制するには、次の手順を実行します。

コンポーネントのログを変更

1. Configuration Managerコンソールで、監視ワークスペースに移動してシステム状態を展開し、サイト状態またはコンポーネント状態ノードのいずれかを選択します。

2. リボンの[スタート]を選択し、[Configuration Manager Service Manager]を選択します。

3. Configuration Manager Service Managerが開いたら、管理するサイトに接続します。 管理したいサイトが表示されていない場合は、［サイト］を選択し、［接続］を選択して、正しいサイトのサイトサーバ名を入力します。

4. サイトを展開して、管理したいコンポーネントが置かれている場所に応じて、［コンポーネント］または［サーバ］に移動します。

5. 右ペインで、1つまたは複数のコンポーネントを選択します。

6. コンポーネントメニューで、ログを選択します。

7. 設定マネージャーコンポーネントログのダイアログボックスで、選択に使用できる設定オプションを完了します。

8. 設定を保存するにはOKを選択して下さい。

Windowsレジストリを使用してログオプションを構成する

サーバーまたはクライアントでWindowsレジストリを使用して、次のログオプションを変更します。

• 詳細レベル
• 最大履歴
• 最大サイズ

問題のトラブルシューティング時に、ログファイルに追加の詳細を書き込むために Configuration Manager の詳細ログを有効にすることができます。

これらのレジストリ設定を変更した後、コンポーネントを再起動します。

• クライアント設定を変更した場合、SMS Agent Hostサービス（CcmExec）を再起動します。

レジストリ設定は、コンポーネントによって異なります。

• クライアントと管理ポイント
• サイトサーバー
• サイトシステムの役割
• 設定マネージャコンソール

クライアントと管理ポイントのログオプション

クライアントまたは管理ポイントのサイトシステム上のすべてのコンポーネントに対してログオプションを構成するには、以下のWindowsレジストリキー下のこれらのREG_DWORD値を構成してください。

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\CCM\Logging\@Global

名前	値	説明
LogLevel	0.LogLevel 0 0: Verbose 1 です。 Default 2 です。 警告とエラー 3: エラーのみ	ログファイルに書き込む詳細レベル
LogMaxHistory	0以上の任意の整数、例: 0: 歴史なし 1.LogMaxHistoryは、ログファイルに書き込む詳細レベル。 Default	ログファイルが最大サイズに達すると、クライアントはバックアップとしてその名前を変更し、新しいログファイルを作成します。 保存する以前のバージョンの数を指定します。
LogMaxSize	10000以上の任意の整数，例： 250000	ログファイルの最大サイズをバイトで指定します。 ログが指定したサイズになると、クライアントはそのログを履歴ファイルとして名前を変更し、新しいファイルを作成します。 デフォルト値は250,000バイトです。

高度なデバッグのために、このREG_SZ値を以下のWindowsレジストリキーの下に追加することもできます。

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\CCM\Logging\DebugLogging

名前	値	説明
Enabled	True: デバッグ ログを有効 False: デバッグ ログを無効	トラブルシューティングのためのデバッグ ログを有効にすることができます。

この設定により、クライアントはトラブルシューティングのために低レベルの情報をログに記録するようになります。 この設定は、運用サイトでは使用しないでください。 過剰なログ収集が発生し、ログファイルから関連情報を見つけることが困難になる可能性があります。

サイト サーバー ログ オプション

Configuration Manager サイト サーバーのグローバルまたは特定のコンポーネントに対して設定を構成することができます。

これらの値は、次の Windows レジストリ キーで構成します：

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\SMS\Tracing

名前	値	タイプ	説明
SqlEnabled	1: enable SQL Server tracing 0: disable SQL Server tracing	REG_DWORD	Add SQL Server trace logging to all site servers logs.
ArchiveEnabled	1: ログアーカイブを有効 0: ログアーカイブを無効	REG_DWORD	歴史的保存のためにサイトサーバーログを別の場所にアーカイブする。
ArchivePath	有効なフォルダパス、たとえば C:\Logs\Archive	REG_SZ	サイト サーバー ログをアーカイブするパス。

SQL Server トレースはトラブルシューティングの目的でのみ有効にします。 本番サイトでの使用は避けてください。 過剰なログが発生し、ログ ファイルから関連情報を見つけることが困難になる可能性があります。 問題を解決したら、この設定を必ずオフにしてください。

特定のサーバーコンポーネントのログオプションを設定するには、次のWindowsレジストリキーでこれらのREG_DWORD値を設定します：

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\SMS\Tracing\<ComponentName>

0.LoggingLevel (ログレベル・ログレベル) Verbose
1 です。 Default
2 です。 警告とエラー
3: エラーのみ

名前	値	説明
ログレベル	ログファイルに書き込む詳細レベル
LogMaxHistory	0以上の任意の整数、例: 0: 歴史なし 1.LogMaxHistoryは、ログファイルに書き込む詳細レベル。 Default	ログファイルが最大サイズに達すると、サーバーはバックアップとしてその名前を変更し、新しいログファイルを作成します。 保存する以前のバージョンの数を指定します。
MaxFileSize	10000以上の任意の整数，例： 250000	ログファイルの最大サイズをバイト単位で指定します。 ログが指定したサイズになると、クライアントはそのログを履歴ファイルとして名前を変更し、新しいファイルを作成します。 デフォルト値は 250,000 バイトです。
DebugLogging	1: enable debug logs 0: disable debug logs	トラブルシューティングのためのデバッグログを可能にします。 この設定は、運用サイトでは使用しないでください。 過剰なログ収集が発生し、ログファイルから関連情報を見つけることが困難になる可能性があります。 注意 このレジストリ キーに存在する他の値を変更しないでください。 サイト システム ロールのログ オプション グローバルまたは Configuration Manager サーバ ロールをホストするサイト システムの特定のコンポーネントの設定を構成することができます。 特定のサーバー コンポーネントのログ オプションを構成するには、次の Windows レジストリ キーでこれらの REG_DWORD 値を構成します： HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\SMS\<ComponentName>\Logging たとえば、配布ポイント ロールの場合。 HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\SMS\DP\Logging Name Values Description LogLevel 0: Verbose 1 です。 Default 2 です。 警告とエラー 3: エラーのみ ログファイルに書き込む詳細レベル LogMaxHistory 0以上の任意の整数、例: 0: 歴史なし 1.LogMaxHistoryは、ログファイルに書き込む詳細レベルを指定します。 Default ログファイルが最大サイズに達すると、サーバーはバックアップとしてその名前を変更し、新しいログファイルを作成します。 保存する以前のバージョンの数を指定します。 LogMaxSize 10000以上の任意の整数，例： 250000 ログファイルの最大サイズをバイト単位で指定します。 ログが指定したサイズになると、サーバーはそのログを履歴ファイルとして名前を変え、新しいファイルを作成します。 デフォルト値は 250,000 バイトです。 注意 このレジストリ キーに存在する他の値を変更しないでください。 Configuration Manager コンソール ログ オプション AdminUI.Log の詳細レベルを変更するためには、次のようにします:1:1:1.0:1.0. メモ帳などのXMLエディタで、コンソール構成ファイルMicrosoft.ConfigurationManagement.exe.configを開きます。 デフォルトの設定ファイルは、以下の場所にあります。 C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\bin\Microsoft.ConfigurationManagement.exe.config 重要 バージョン 1910 以降、このパスは Microsoft Endpoint Manager フォルダーを使用するように変更されました。 他のフォルダーに存在する可能性のある古いバージョンのファイルを使用しないように注意してください。 システム.診断 > ソース > ソース要素で switchValue 属性を Error から Verbose に変更します。 例： Original: <source name="SmsAdminUISnapIn" switchValue="Error">New: <source name="SmsAdminUISnapIn" switchValue="Verbose" > ファイルを保存し、コンソールを再起動します。 Configuration Manager コンソールでログオプションを設定する バージョン 1910 で、クライアントまたはコレクションでの詳細ログの有効/無効をコンソールから設定します。 構成マネージャーコンソールでは、資産およびコンプライアンスのワークスペースに行き、デバイスノードを選択してターゲットデバイスを選択します。 リボンの［ホーム］タブで、［デバイス］グループの［クライアント診断］を選択します。 詳細については、「クライアント診断」を参照してください。 ログファイルの場所 設定マネージャと依存コンポーネントは、さまざまな場所にログファイルを保存します。 これらの場所は、ログ ファイルを作成するプロセスおよび環境の構成によって異なります。 次の場所が既定値です。 お使いの環境でインストールディレクトリをカスタマイズした場合、実際のパスは異なる場合があります。 Client: C:\Windows\CCM\logs Server: C:\Program Files\Microsoft Configuration Manager\Logs Management point: C:\SMS_CCM\Logs コンフィギュレーションマネージャーのコンソールです。 C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\AdminUILog IIS: C:\inetpub\logs\logfiles\w3svc1 Task sequence log locations The location of task sequence log file smsts.log vary depending on the phase of task sequence: In Windows PE before Format and Partition Disk step.Installation: X:\Windows\temp\smstslog\smsts.log (X は Windows PE RAM ドライブ) Format and Partition Disk のステップの後の Windows PE では。 X:\smstslog\smsts.log、その後ドライブの準備ができたらC:\_SMSTaskSequence\Logs\smstslog\smsts.logにコピー クライアントがインストールされる前の新しいWindows OSで。 C:\_SMSTaskSequence\Logs\smstslog\smsts.log クライアントがインストールされた後のWindowsの場合。 C:\Windows\CCM\Logs\smstslog\smsts.log タスクシーケンスが完了した後のWindowsの場合。 C:\Windows\CCM\Logs\smsts.log ヒント 読み取り専用のタスクシーケンス変数 _SMSTSLogPath には、常に現在のログファイルのパスが格納されます。