StoreFront のトラブルシューティング
インストールログ
StoreFront のインストール時またはアンインストール時に、StoreFront インストーラーによって、C:\Windows\Temp\StoreFront ディレクトリに以下のログファイルが作成されます。ファイル名には、それらを作成したコンポーネントが反映され、タイムスタンプが含まれます。
- Citrix-DeliveryServicesRoleManager-*.log—ストアフロントが対話形式でインストールされたときに作成されます。
- 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 にログ記録されます。ログファイル名には、コマンドアクションとサブジェクト、およびコマンドシーケンスを区別するために使用できるタイムスタンプが含まれています。
診断ロギング
以前は、診断ログはデフォルトでエラーのみをログに記録していました。
2203 LTSR CU5 リリース以降、デフォルトで Error、Warning、Info レベルのメッセージがログに記録されます。ほとんどの場合、これにより問題の診断に十分な情報が含まれます。
トレースログを有効にするには、ローカル管理者権限を持つアカウントを使用して Windows PowerShell を起動し、次のパラメーターを指定してコマンド Set-STFDiagnostics を使用します。
- -All。すべてのインスタンスとサービスに対してトレースを更新する必要があることを示すフラグ。
- -TraceLevel。トレース詳細のレベルが上がるにつれて、-TraceLevel に許可される値は、Off、Error、Warning、Info、または Verbose です。生成されるデータ量が多いため、トレースは StoreFront のパフォーマンスに大きな影響を与える可能性があります。トラブルシューティングのために特に必要とされない限り、Info または Verbose レベルは推奨されません。
オプションのパラメーター:
- -FileSizeKb。トレースファイルのサイズ (KB)。
- -FileCount。ディスク上に一度に保持するトレースファイルの数。
- -confirm:$False。StoreFront コマンドレットを毎回実行できるように、Windows のプロンプトを抑制します。
トレース出力は c:\Program Files\Citrix\Receiver StoreFront\admin\trace に送信されます。
例示
デバッグ目的で、すべてのサービスに対してVerboseレベルのトレースを有効にするには：
Set-STFDiagnostics -All -TraceLevel "Verbose" -confirm:$False
<!--NeedCopy-->
Verboseレベルのトレースを無効にし、すべてのサービスのトレースレベルをデフォルト値に戻すには：
Set-STFDiagnostics -All -TraceLevel "Info" -confirm:$False
<!--NeedCopy-->
Set-STFDiagnostics コマンドレットの詳細については、StoreFront PowerShell SDK ドキュメントを参照してください。
Launch.icaファイルのログ記録
ユーザーがアプリまたはデスクトップを起動すると、StoreFrontはlaunch.icaというファイルを生成します。Workspaceアプリはこのファイルを読み取り、アプリまたはデスクトップへの接続方法を決定します。構成によっては、このファイルはメモリに保存され、直接アクセスできない場合があります。起動エラーを診断するには、launch.icaの内容を表示すると役立つことがあります。
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=”ログファイルへのパス”
- ICAファイルログ=true
例えば：
LogFile=C:\ica\ica.log LogICAFile=true <!--NeedCopy-->
注：
トラブルシューティング以外の目的で環境内でICAファイルを使用することについては、CTX200126でさらに詳しく説明されています。