Profile Managementログファイルを確認する
ログファイルは、システム動作のトラブルシューティングを行う際に役立ちます。Profile Managementの設定を確認した後、Profile Managementのログ記録を有効にし、問題を再現してログファイルを確認します。
詳細な手順は次のとおりです。
- すべてのイベントとアクションに対してProfile Managementのログ記録を有効にします。
- マシンで問題を再現します。
-
%SystemRoot%\system32\LogFiles\UserProfileManagerフォルダーにあるProfile Managementログファイル（例: #computername#.#domainname#_pm.log）でエラーと警告を確認します。それぞれ「ERROR」または「WARNINGS」という単語を検索して見つけます。ログファイルの詳細は、この記事の後半にあるリファレンスを参照してください。
- ユーザーストアへのパスが正しいことを確認します。
- Active Directoryからのすべての情報が正しく読み取られたことを確認します。
- タイムスタンプを確認して、時間がかかりすぎるアクションがないか調べます。
ヒント:
Microsoft Excelを使用してProfile Managementログファイルを確認できます。詳細については、Knowledge Centerの記事CTX200674を参照してください。
Profile Managementのログ記録を有効にする
Profile Management展開で問題のトラブルシューティングを行う場合にのみ、すべてのイベントとアクションに対してProfile Managementのログ記録を有効にしてください。問題が解決したら、ログ記録を無効にし、機密情報が含まれている可能性があるためログファイルを削除してください。
このセクションでは、GPOとUPMPolicyDefaults_all.iniを使用して、すべてのイベントとアクションのログ記録を有効にする方法について説明します。
この目標は、Citrix Studio と Workspace Environment Management (WEM) を使用しても達成できます。詳細については、Profile Management を集中管理する場所を決定する を参照してください。
GPO を使用してログ記録を有効にする
GPO を使用してすべてのイベントとアクションの Profile Management ログ記録を有効にするには、次の手順に従います。
-
グループポリシー管理エディターを開き、グループポリシーオブジェクトを作成します。
-
ポリシー > 管理用テンプレート: ポリシー定義 (ADMX ファイル) > Citrix コンポーネント > Profile Management > ログ設定 にアクセスします。
-
次のように Profile Management のログ記録を有効にします。
- ログ記録を有効にする をダブルクリックします。
- 有効 をクリックします。
- OK をクリックします。
-
Profile Management ですべてのイベントとアクションをログに記録するように有効にします。
- ログ設定 をダブルクリックします。
- すべてのイベントとアクションを選択します。それらの説明の詳細については、イベントとアクション を参照してください。
- OK をクリックします。
-
ログファイルのデフォルトの最大サイズを変更するには、次の手順に従います。
- ログファイルの最大サイズ をダブルクリックします。
- 「有効にする」をクリックし、「最大サイズ (バイト単位)」フィールドにサイズを入力します。
- 「OK」をクリックします。
「ヒント:」:
最大サイズに達すると、Profile Management はバックアップファイルを1つ保持します (例: Logfilename.log.bak)。
-
マシンで
gpupdate /forceコマンドを実行します。これらのポリシーはマシンで有効になります。
ログ設定ポリシーの詳細については、「Profile Management ポリシーの説明とデフォルト」を参照してください。
.ini ファイルを使用してログを有効にする
UPMPolicyDefaults_all.ini を使用してすべてのイベントとアクションに対して Profile Management のログ記録を有効にするには、次の手順に従います。
- Profile Management のインストールフォルダー (デフォルトでは C:\Program Files\Citrix\User Profile Manager) で
UPMPolicyDefaults_all.iniを開きます。 -
Log settings を検索して設定を見つけます。
ログ記録に関連する設定 (/en-us/profile-management/current-release/media/troubleshoot-ini-log-settings.png)
-
LoggingEnabledに1を入力します。 -
LogLevelWarningsからLogLevelUserNameまでの各パラメーターに1を入力します。これらのパラメーターの詳細については、「イベントとアクション」を参照してください。 - ログファイルのデフォルトの最大サイズを変更するには、必要に応じて
MaxLogSizeにサイズを入力します。 - ログファイルのデフォルトフォルダを変更するには、必要に応じて
PathToLogFileのパスを入力します。
参照
このセクションでは、以下の情報を提供します。
ログの種類
この表は、Profile Managementのトラブルシューティングに使用できるログを一覧表示します。
| 通称 | ログファイル名 | 場所 | ログ情報の種類 |
|---|---|---|---|
| Profile Managementログファイル | #computername#.#domainname#_pm.log | %SystemRoot%\system32\LogFiles\UserProfileManager | 情報メッセージ、警告、エラーは、Profile Managementログファイルに書き込まれます。ドメイン名はコンピューターのドメインです。コンピューター名を特定できない場合、このログファイルはUser Profile Manager.logという名前になります。コンピューター名が利用可能であるにもかかわらずドメインを特定できない場合、ログファイルは#computername#_pm.logという名前になります。 |
| Profile Management構成ログファイル | #computername#.#domainname#_pm_config.log | %SystemRoot%\system32\LogFiles\UserProfileManager | 構成ログファイルは、ログ記録がオフになっている場合でも、GPOおよび.iniファイルの設定をキャプチャします。コンピューター名を特定できない場合、User Profile Manager_pm_configという名前になります。コンピューター名が利用可能であるにもかかわらずドメインを特定できない場合、ログファイルは#computername#_pm_config.logという名前になります。 |
| Windowsイベントログ | Application.evtx | %SystemRoot%\System32\winevt\Logs\ | Microsoftイベントビューアーで表示するWindowsイベントは、主にエラー報告に使用されます。エラーのみが書き込まれます。 |
イベントとアクション
この表は、Profile Managementがログに記録できるイベントとアクションを示します。
| 種類 | 説明 | .iniのパラメーター |
|---|---|---|
| 一般的な警告 | すべての一般的な警告。 | LogLevelWarnings |
| 一般情報 | すべての一般的な情報。 | LogLevelInformation |
| ファイルシステム通知 | 処理されたファイルまたはフォルダーが変更されるたびに、1つのログエントリが作成されます。 | LogLevelFileSystemNotification |
| ファイルシステムアクション | Profile Managementによって実行されるファイルシステム操作。 | LogLevelFileSystemActions |
| レジストリアクション | Profile Managementによって実行されるレジストリアクション。 | LogLevelRegistryActions |
| ログオフ時のレジストリの相違点 | セッション中に変更されたHKCUハイブ内のすべてのレジストリキー。重要: この設定は、ログファイルに大量の出力を生成します。 | LogLevelRegistryDifference |
| Active Directoryアクション | Profile ManagementがActive Directoryをクエリするたびに、エントリがログファイルに書き込まれます。 | LogLevelActiveDirectoryActions |
| ポリシー値 | Profile Managementサービスが開始されるか、ポリシーの更新が行われると、ポリシー値がログファイルに書き込まれます。 | LogLevelPolicyUserLogon |
| ログオン | ログオン中のアクションのシーケンスがログファイルに書き込まれます。 | LogLevelLogon |
| ログオフ | ログオフ中のアクションのシーケンスがログファイルに書き込まれます。 | LogLevelLogoff |
| パーソナライズされたユーザー情報 | 該当する場合、ユーザー名とドメイン名はログファイルの専用列に記録されます。 | LogLevelUserName |
ログファイルフィールド
Profile Managementログファイルの各行には、セミコロンで区切られた複数のフィールドがあります。この表は、ログファイルフィールドを一覧表示します。
| フィールド | 説明 |
|---|---|
| 日付 | ログエントリの日付 |
| 時刻 | ログエントリの時刻（ミリ秒を含む） |
| 重大度 | INFORMATION、WARNING、またはERRORのいずれか |
| ドメイン | ユーザーのドメイン（該当する場合） |
| ユーザー名 | ユーザー名（該当する場合） |
| セッションID | セッションID（該当する場合） |
| スレッドID | この行を作成したスレッドのID |
| 関数と説明 | その時点で実行されていたProfile Management関数の名前とログメッセージ |