Configuration Managerのログ ファイルについて
Configuration Manager (現在のブランチ) に適用
Configuration Managerでは、クライアントとサイト サーバーのコンポーネントは、個々のログ ファイルにプロセス情報を記録します。 これらのログ ファイルの情報を使用して、発生する可能性のある問題のトラブルシューティングに役立てることができます。 既定では、Configuration Managerでは、クライアント コンポーネントとサーバー コンポーネントのログ記録が有効になります。
この記事では、Configuration Managerログ ファイルに関する一般的な情報を提供します。 これには、使用するツール、ログを構成する方法、およびログを見つける場所が含まれています。 特定のログ ファイルの詳細については、「 ログ ファイルリファレンス」を参照してください。
メカニズム
Configuration Managerのほとんどのプロセスは、そのプロセス専用のログ ファイルに操作情報を書き込みます。 ログ ファイルは、 または .lo_
ファイル拡張子によって.log
識別されます。 Configuration Managerは、.log
そのログが最大サイズに達するまでファイルに書き込みます。 ログがいっぱいになると、 .log
ファイルは同じ名前の拡張子を持つ .lo_
ファイルにコピーされ、プロセスまたはコンポーネントは引き続きファイルに .log
書き込みます。 ファイルが .log
最大サイズに達すると、 .lo_
ファイルは上書きされ、プロセスが繰り返されます。 一部のコンポーネントでは、ログ ファイル名に日付とタイム スタンプを追加し、拡張子を保持することで、ログ ファイルの履歴を .log
確立します。
ログ ビューアー ツール
Configuration Managerログ ファイルはすべてプレーン テキストであるため、メモ帳などの任意のテキスト リーダーで表示できます。 ログには、次のいずれかの特殊なツールで最適に表示される一意の書式設定が使用されます。
CMTrace
ログを表示するには、Configuration Manager ログ ビューアー ツール CMTrace を使用します。 これは、\SMSSetup\Tools
Configuration Managerソース メディアのフォルダーにあります。 CMTrace ツールは、ソフトウェア ライブラリに追加されるすべてのブート イメージに追加されます。 CMTrace ログ表示ツールは、Configuration Manager クライアントと共に自動的にインストールされます。
詳細については、「 CMTrace」を参照してください。
OneTrace
OneTrace は、サポート センターを備えたログ ビューアーです。 CMTrace と同様に機能し、機能強化が行われました。 詳細については、「 サポート センター OneTrace」を参照してください。
サポート センターのログ ファイル ビューアー
サポート センター には、最新のログ ビューアーが含まれています。 このツールは CMTrace を置き換え、タブとドッキング可能なウィンドウをサポートするカスタマイズ可能なインターフェイスを提供します。 表示層が高速で、数秒で大きなログ ファイルを読み込むことができます。 詳細については、「 サポート センター ログ ファイル ビューアー」を参照してください。
注:
サポート センターのログ ファイル ビューアーと OneTrace では、Windows Presentation Foundation (WPF) を使用します。 このコンポーネントは Windows PE では使用できません。 引き続き、タスク シーケンスのデプロイでブート イメージで CMTrace を使用します。
ログ オプションを構成する
詳細レベル、サイズ、履歴など、ログ ファイルの構成を変更できます。 これらの設定を変更するには、いくつかの方法があります。
- クライアントのインストール中
- Configuration Manager Service Managerの使用
- Windows レジストリの使用
- Configuration Manager コンソールで
ハードウェア インベントリを使用 して、クライアントからログ設定を収集 することもできます。
クライアントのインストール中にログ オプションを構成する
インストール中にクライアント ログ ファイルの構成を設定できます。 次のプロパティを使用します。
- CCMENABLELOGGING
- CCMDEBUGLOGGING
- CCMLOGLEVEL
- CCMLOGMAXHISTORY
- CCMLOGMAXSIZE
詳細については、「 クライアント インストールのプロパティ」を参照してください。
Configuration Manager Service Managerを使用してログ オプションを構成する
ログ ファイルConfiguration Manager格納する場所とそのサイズを変更できます。
ログ ファイルのサイズを変更するには、ログ ファイルの名前と場所を変更するか、複数のコンポーネントに 1 つのログ ファイルへの書き込みを強制するには、次の手順を実行します。
コンポーネントのログ記録を変更する
Configuration Manager コンソールで、[監視] ワークスペースに移動し、[システムの状態] を展開し、[サイトの状態] ノードまたは [コンポーネントの状態] ノードを選択します。
リボンで [スタート] を選択し、[Configuration Manager Service Manager] を選択します。
Configuration Manager Service Managerが開いたら、管理するサイトに接続します。 管理するサイトが表示されない場合は、[ サイト] を選択し、[ 接続] を選択し、正しいサイトのサイト サーバーの名前を入力します。
管理するコンポーネントの場所に応じて、サイトを展開し、[ コンポーネント ] または [ サーバー] に移動します。
右側のウィンドウで、1 つ以上のコンポーネントを選択します。
[ コンポーネント ] メニューの [ ログ記録] を選択します。
[Configuration Manager コンポーネント ログ] ダイアログ ボックスで、選択に使用できる構成オプションを完了します。
[ OK] を選択 して構成を保存します。
Windows レジストリを使用してログ オプションを構成する
サーバーまたはクライアントの Windows レジストリを使用して、次のログ オプションを変更します。
- 詳細レベル
- 履歴の最大数
- 最大サイズ
問題のトラブルシューティング時に、ログ ファイルに追加の詳細を書き込むConfiguration Managerの詳細ログを有効にすることができます。
警告
これらの設定の構成が誤ると、Configuration Managerが大量の情報をログに記録したり、まったくログに記録しなかったりする可能性があります。 このデータはトラブルシューティングに役立ちますが、運用サイトでこれらの値を変更する場合は注意が必要です。 ラボ環境でこれらの変更を最初にテストしてください。 過剰なログ記録が発生する可能性があるため、ログ ファイル内の関連情報を見つけることが困難になる可能性があります。
これらのレジストリ設定を変更したら、コンポーネントを再起動します。
- クライアント設定を変更する場合は、 SMS エージェント ホスト サービス (CcmExec) を再起動します。
- サーバーの設定を変更する場合は、 SMS エグゼクティブ サービスを再起動します。
レジストリ設定は、コンポーネントによって異なります。
クライアントと管理ポイントのログ オプション
クライアントまたは管理ポイント サイト システム上のすべてのコンポーネントのログ オプションを構成するには、次の Windows レジストリ キーの下にこれらの REG_DWORD 値を構成します。
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\CCM\Logging\@Global
名前 | 値 | 説明 |
---|---|---|
LogLevel |
0 :詳細1 :既定2 : 警告とエラー3 : エラーのみ |
ログ ファイルに書き込む詳細レベル。 |
LogMaxHistory | 0 以上の任意の整数 (例:0 : 履歴なし1 :既定 |
ログ ファイルが最大サイズに達すると、クライアントによってバックアップとして名前が変更され、新しいログ ファイルが作成されます。 保持する以前のバージョンの数を指定します。 |
LogMaxSize | 10,000 以上の任意の整数 (例: 250000 |
最大ログ ファイル サイズ (バイト単位)。 ログが指定したサイズに拡大すると、クライアントによって履歴ファイルとして名前が変更され、新しいファイルが作成されます。 既定値は 250,000 バイトです。 |
注:
このレジストリ キーに存在する可能性がある他の値は変更しないでください。
高度なデバッグのために、次の Windows レジストリ キーの下にこの REG_SZ 値を追加することもできます。
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\CCM\Logging\DebugLogging
名前 | 値 | 説明 |
---|---|---|
有効 |
True : デバッグ ログを有効にするFalse : デバッグ ログを無効にする |
トラブルシューティングのためにデバッグ ログを有効にします。 |
この設定により、クライアントはトラブルシューティングのために低レベルの情報をログに記録します。 運用環境では、この設定を使用しないでください。 過剰なログ記録が発生する可能性があるため、ログ ファイル内の関連情報を見つけることが困難になる可能性があります。 問題を解決した後は、必ずこの設定をオフにしてください。
サイト サーバーのログ オプション
Configuration Manager サイト サーバーでは、グローバルに、または特定のコンポーネントの設定を構成できます。
次の Windows レジストリ キーでこれらの値を構成します。
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\SMS\Tracing
名前 | 値 | 型 | 説明 |
---|---|---|---|
SqlEnabled |
1 : SQL Serverトレースを有効にする0 : トレースSQL Server無効にする |
REG_DWORD | SQL Serverトレース ログをすべてのサイト サーバー ログに追加します。 |
ArchiveEnabled |
1 : ログ アーカイブを有効にする0 : ログ アーカイブを無効にする |
REG_DWORD | 履歴を保持するために、サイト サーバーのログを別の場所にアーカイブします。 |
ArchivePath | たとえば、有効なフォルダー パス C:\Logs\Archive |
REG_SZ | サイト サーバー ログをアーカイブするパス。 |
トラブルシューティング目的でのみSQL Serverトレースを有効にします。 運用環境では使用しないでください。 過剰なログ記録が発生する可能性があるため、ログ ファイル内の関連情報を見つけることが困難になる可能性があります。 問題を解決した後は、必ずこの設定をオフにしてください。
注:
このレジストリ キーに存在する可能性がある他の値は変更しないでください。
特定のサーバー コンポーネントのログ オプションを構成するには、次の Windows レジストリ キーでこれらの REG_DWORD 値を構成します。
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\SMS\Tracing\<ComponentName>
名前 | 値 | 説明 |
---|---|---|
LoggingLevel |
0 :詳細1 :既定2 : 警告とエラー3 : エラーのみ |
ログ ファイルに書き込む詳細レベル。 |
LogMaxHistory | 0 以上の任意の整数 (例:0 : 履歴なし1 :既定 |
ログ ファイルが最大サイズに達すると、サーバーはログ ファイルの名前をバックアップとして変更し、新しいログ ファイルを作成します。 保持する以前のバージョンの数を指定します。 |
MaxFileSize | 10,000 以上の任意の整数 (例: 250000 |
最大ログ ファイル サイズ (バイト単位)。 ログが指定したサイズに拡大すると、クライアントによって履歴ファイルとして名前が変更され、新しいファイルが作成されます。 既定値は 250,000 バイトです。 |
デバッグ ログ |
1 : デバッグ ログを有効にする0 : デバッグ ログを無効にする |
トラブルシューティングのためにデバッグ ログを有効にします。 |
[デバッグ ログ] 設定を使用すると、サーバーはトラブルシューティングのために低レベルの情報をログに記録します。 運用環境では、この設定を使用しないでください。 過剰なログ記録が発生する可能性があるため、ログ ファイル内の関連情報を見つけることが困難になる可能性があります。 問題を解決した後は、必ずこの設定をオフにしてください。
注:
このレジストリ キーに存在する可能性がある他の値は変更しないでください。
サイト システムの役割のログ オプション
Configuration Manager サーバーの役割をホストするサイト システムで、グローバルまたは特定のコンポーネントの設定を構成できます。
特定のサーバー コンポーネントのログ オプションを構成するには、次の Windows レジストリ キーでこれらの REG_DWORD 値を構成します。
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\SMS\<ComponentName>\Logging
たとえば、配布ポイントロールの場合:
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\SMS\DP\Logging
名前 | 値 | 説明 |
---|---|---|
LogLevel |
0 :詳細1 :既定2 : 警告とエラー3 : エラーのみ |
ログ ファイルに書き込む詳細レベル。 |
LogMaxHistory | 0 以上の任意の整数 (例:0 : 履歴なし1 :既定 |
ログ ファイルが最大サイズに達すると、サーバーはログ ファイルの名前をバックアップとして変更し、新しいログ ファイルを作成します。 保持する以前のバージョンの数を指定します。 |
LogMaxSize | 10,000 以上の任意の整数 (例: 250000 |
最大ログ ファイル サイズ (バイト単位)。 ログが指定したサイズに拡大すると、サーバーによって履歴ファイルとして名前が変更され、新しいファイルが作成されます。 既定値は 250,000 バイトです。 |
注:
このレジストリ キーに存在する可能性がある他の値は変更しないでください。
コンソールログオプションConfiguration Manager
Configuration Manager コンソールの AdminUI.log の詳細レベルを変更するには、次の手順に従います。
メモ帳などの XML エディターで、コンソール構成ファイル Microsoft.ConfigurationManagement.exe.configを開きます。 既定の構成ファイルは次の場所にあります。
C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\bin\Microsoft.ConfigurationManagement.exe.config
system.diagnostics>sources source>要素の下で、switchValue 属性を から
Error
にVerbose
変更します。 例:オリジナル:
<source name="SmsAdminUISnapIn" switchValue="Error">
新規:<source name="SmsAdminUISnapIn" switchValue="Verbose" >
ファイルを保存し、コンソールを再起動します。
Configuration Manager コンソールでログ オプションを構成する
コンソールからクライアントまたはコレクションに対する詳細ログ記録を有効または無効にします。
Configuration Manager コンソールで、[資産とコンプライアンス] ワークスペースに移動し、[デバイス] ノードを選択し、ターゲット デバイスを選択します。
リボンの [ ホーム ] タブの [ デバイス ] グループで、[ クライアント診断] を選択します。 使用可能なアクションのいずれかを選択します。
詳細については、「 クライアント診断」を参照してください。
クライアント ログ設定のハードウェア インベントリ
バージョン 2107 以降では、ハードウェア インベントリを有効にしてクライアント ログ ファイルの設定を収集できます。 ハードウェア インベントリ クラスである クライアント診断 (CCM_ClientDiagnostics) を有効にし、次の属性を選択します。
- デバッグ ログの有効化
- ログ記録が有効
- ログ レベル
- 履歴ファイル数
- ログ ファイルの最大サイズ
注:
このインベントリ クラスは、既定では有効になっていません。
詳細については、「既存の ハードウェア インベントリ クラスを有効または無効にする」を参照してください。
ログ ファイルの検索
Configuration Managerコンポーネントと依存コンポーネントは、さまざまな場所にログ ファイルを格納します。 これらの場所は、ログ ファイルを作成するプロセスと環境の構成によって異なります。
既定値は次のとおりです。 環境内のインストール ディレクトリをカスタマイズした場合、実際のパスが異なる場合があります。
- クライアント:
C:\Windows\CCM\logs
- サーバー:
C:\Program Files\Microsoft Configuration Manager\Logs
- 管理ポイント:
C:\SMS_CCM\Logs
- Configuration Managerコンソール:
C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\AdminUILog
- Iis:
C:\inetpub\logs\logfiles\w3svc1
タスク シーケンス ログの場所
タスク シーケンス ログ ファイル smsts.log の場所は、タスク シーケンスのフェーズによって異なります。
- フォーマット とパーティションディスク ステップの前にWindows PEで:
X:\Windows\temp\smstslog\smsts.log
(XはWindows PE RAMドライブです) -
[フォーマットとパーティション ディスクの後の 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 には、常に現在のログ ファイルのパスが含まれます。