StoreFront のトラブルシューティング
インストールログ
StoreFront のインストールまたはアンインストール時に、StoreFront インストーラーによって C:\Windows\Temp\StoreFront ディレクトリに以下のログファイルが作成されます。ファイル名には、それらを作成したコンポーネントが反映され、タイムスタンプが含まれます。
- Citrix-DeliveryServicesRoleManager-*.log—StoreFront が対話形式でインストールされたときに作成されます。
- Citrix-DeliveryServicesSetupConsole-*.log—StoreFront がサイレントインストールされたとき、および StoreFront が対話形式またはサイレント形式でアンインストールされたときに作成されます。
- CitrixMsi-CitrixStoreFront-x64-*.log—StoreFront が対話形式またはサイレント形式でインストールおよびアンインストールされたときに作成されます。
イベントログ
StoreFront は、認証サービス、ストア、および Receiver for Web サイトの Windows イベントログをサポートしています。生成されたイベントはすべて StoreFront アプリケーションログに書き込まれ、イベントビューアーの [アプリケーションとサービスログ] > [Citrix Delivery Services] または [Windows ログ] > [アプリケーション] で表示できます。認証サービス、ストア、および Receiver for Web サイトの構成ファイルを編集することで、単一イベントの重複ログエントリの数を制御できます。
ログのスロットリング
-
テキストエディターを使用して、認証サービス、ストア、または Receiver for Web サイトの web.config ファイルを開きます。これらのファイルは通常、それぞれ C:\inetpub\wwwroot\Citrix\Authentication\、C:\inetpub\wwwroot\Citrix\storename\、および C:\inetpub\wwwroot\Citrix\storenameWeb\ ディレクトリにあります。ここで、storename はストア作成時に指定された名前です。
-
ファイル内で次の要素を見つけます。
<logger duplicateInterval="00:01:00" duplicateLimit="10">デフォルトでは、StoreFront は重複するログエントリの数を 1 分あたり 10 個に制限するように構成されています。
-
duplicateInterval属性の値を変更して、重複するログエントリが監視される期間を時、分、秒で設定します。duplicateLimit属性を使用して、ログのスロットリングをトリガーするために指定された時間間隔内にログに記録する必要がある重複エントリの数を設定します。
ログのスロットリングがトリガーされると、それ以降の同一のログエントリが抑制されることを示す警告メッセージがログに記録されます。時間制限が経過すると、通常のログ記録が再開され、重複するログエントリが抑制されなくなったことを示す情報メッセージがログに記録されます。
PowerShell および管理コンソールログ
PowerShell または管理コンソールを介して行われた構成変更は、C:\Program Files\Citrix\Receiver StoreFront\Admin\logs にログ記録されます。ログファイル名には、コマンドアクションとサブジェクト、およびコマンドシーケンスを区別するために使用できるタイムスタンプが含まれます。
診断ログ
StoreFront は診断ログを c:\Program Files\Citrix\Receiver StoreFront\admin\trace に書き込みます。
デフォルトでは、Error、Warning、Info レベルのメッセージがログに記録されます。ほとんどの場合、これには問題を診断するのに十分な情報が含まれています。
トラブルシューティングのために、追加の詳細ログを有効にすることができます。これは、Citrix® サポートから要求された場合にのみ必要です。パフォーマンスに影響を与える可能性があるため、トラブルシューティングが完了したら TraceLevel を Info に戻す必要があります。
詳細ログを有効にするには：
-
ローカル管理者権限を持つアカウントを使用して、Windows PowerShell を起動します。
-
コマンドを入力します。
Set-STFDiagnostics -All -TraceLevel "Verbose" -confirm:$False <!--NeedCopy-->これにより、確認を求めるプロンプトなしで、すべてのサービスの詳細ログが有効になります。このコマンドを入力すると、StoreFront サービスが再起動されます。PowerShell プロンプトが返されるまで待機し、サービスが再起動を完了したことを確認してください。これらのサービスが再起動している間、StoreFront サーバーはユーザーがアクセスできません。
-
問題を再現してログを作成します。
-
すべてのサービスのログをデフォルトレベルに戻します。
Set-STFDiagnostics -All -TraceLevel "Info" -confirm:$False <!--NeedCopy-->
診断ログをさらにカスタマイズできます。
-
StoreFront は、サービスごとに個別のログファイルを書き込みます。デフォルトでは、各ログファイルは最大 200MB で、StoreFront は古いログファイルをパージする前にサービスごとに最大 5 つのログファイルを書き込みます。書き込まれるログファイルのサイズまたは数をカスタマイズする必要がある場合は、
-FileSizeKbおよび-FileCountパラメーターを使用してこれを行うことができます。 -
-TraceLevelを使用して、ログに記録される詳細レベルを変更します。許可される値は、Off、Error、Warning、Info、またはVerboseです。 -
パラメーター
-Allを使用すると、すべてのサービスのログパラメーターが設定されます。-Service [Service name]を使用して、個々のサービスのログをカスタマイズできます。
Set-STFDiagnostics コマンドレットの詳細については、StoreFront PowerShell SDK ドキュメントを参照してください。
Launch.ica ファイルのログ記録
ユーザーがアプリまたはデスクトップを起動すると、StoreFront は launch.ica というファイルを生成します。Workspace アプリはこのファイルを読み取り、アプリまたはデスクトップへの接続方法を決定します。構成によっては、このファイルがメモリに保存され、直接アクセスできない場合があります。起動エラーを診断するには、launch.ica の内容を表示すると役立つことがあります。
クライアント PC で launch.ica ファイルのログ記録を有効にするには、次の手順を実行します。
-
レジストリエディターを使用して、次のレジストリキーに移動します。
32ビットシステム:
HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\ICA Client\Engine\Configuration\Advanced\Modules\Logging64ビットシステム:
HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Citrix\ICA Client\Engine\Configuration\Advanced\Modules\Logging -
次の 2 つの文字列キー値を設定します。
- LogFile=”ログファイルへのパス”
- LogICAFile=true
例：
LogFile=C:\ica\ica.log LogICAFile=true <!--NeedCopy-->
注：
トラブルシューティング以外の目的で環境内で ICA ファイルを使用することについては、CTX200126 でさらに詳しく説明されています。