構成ログ

• 構成変更が行われた後の問題の診断とトラブルシューティング。ログはブレッドクラムトレイルを提供します。
• 変更管理を支援し、構成を追跡する。
• 管理アクティビティを報告する。

ログに記録される内容

• マシンカタログ
• デリバリーグループ（電源管理設定の変更を含む）
• 管理者ロールとスコープ
• ホストリソースと接続
• Studioを介したCitrixポリシー

• 仮想マシンまたはユーザーデスクトップの電源管理
• StudioまたはDirectorがユーザーにメッセージを送信する

• プール管理による仮想マシンの電源投入などの自律的な操作。
• グループポリシー管理コンソール (GPMC) を介して実装されたポリシーアクション。これらのアクションのログを表示するには、Microsoft ツールを使用します。
• レジストリ、データベースへの直接アクセス、または Studio、Director、PowerShell 以外のソースを介して行われた変更。
• 展開が初期化されると、最初の構成ログサービスインスタンスが構成サービスに登録されたときに、構成ログが利用可能になります。したがって、構成の初期段階はログに記録されません (たとえば、データベーススキーマが取得および適用されたとき、ハイパーバイザーが初期化されたときなど)。

構成ログの管理

• 構成ログデータベースのバックアップ戦略は、サイト構成データベースのバックアップ戦略とは異なる可能性があります。
• 構成ログ (および監視サービス) のために収集されるデータ量によって、サイト構成データベースで利用可能な領域に悪影響が及ぶ可能性があります。
• 3つのデータベースの単一障害点を分割します。

構成ログと強制ログの有効化と無効化

1. Web Studioにサインインし、左ペインでログを選択します。
2. アクションバーで設定を選択します。構成ログダイアログボックスには、データベース情報が含まれており、構成ログと強制ログが有効か無効かを示します。
3. 目的のアクションを選択します。
   構成ログを有効にするには、有効にするを選択します。これはデフォルト設定です。データベースに書き込めない場合、ログ情報は破棄されますが、操作は続行されます。
   構成ログを無効にするには、Disable を選択します。以前にログが有効になっていた場合、既存のログはPowerShell SDKで読み取り可能です。
   強制ログを有効にするには、Prevent changes to the site configuration when the database is not available を選択します。通常ログに記録される構成変更や管理アクティビティは、構成ログデータベースに書き込みが可能な場合にのみ許可されます。強制ログは、構成ログが有効になっている場合（Enable が選択されている場合）にのみ有効にできます。構成ログサービスが失敗し、高可用性が使用されていない場合、強制ログが有効であると見なされます。そのような場合、通常ログに記録される操作は実行されません。
   強制ログを無効にするには、データベースが利用できない場合にサイト構成の変更を許可するを選択します。構成ログデータベースにアクセスできない場合でも、構成変更および管理アクティビティは許可されます。これはデフォルト設定です。

構成ログデータベースの場所を変更する

1. サポートされているSQL Serverバージョンを使用して、データベースサーバーを作成します。
2. Web Studioにサインインし、左ペインでログを選択します。
3. アクションバーで設定を選択します。
4. 「ログ設定」ダイアログボックスで、「ログデータベースの変更」を選択します。
5. 「ログデータベースの変更」ダイアログボックスで、新しいデータベースサーバーを含むサーバーの場所を指定します。有効な形式については、「データベースアドレス形式」を参照してください。
6. Studioでデータベースを作成するには、「OK」をクリックします。プロンプトが表示されたら「OK」をクリックすると、データベースが自動的に作成されます。Studioは、現在のStudioユーザーの資格情報を使用してデータベースへのアクセスを試行します。失敗した場合は、データベースユーザーの資格情報の入力を求められます。その後、Studioはデータベーススキーマをデータベースにアップロードします。（資格情報はデータベース作成中のみ保持されます。）
7. データベースを手動で作成するには、「データベーススクリプトの生成」をクリックします。生成されたスクリプトには、データベースを手動で作成するための手順が含まれています。スキーマをアップロードする前に、データベースが空であり、少なくとも1人のユーザーがデータベースにアクセスして変更する権限を持っていることを確認してください。

構成ログコンテンツの表示

• ログの詳細を表示します。 高レベルの操作は、1つ以上のサービスおよびSDK呼び出し（低レベルの操作）をもたらします。上部のペインで高レベルの操作を選択すると、下部のペインに低レベルの操作が表示されます。
• 表示を並べ替えます。 列ヘッダーをクリックして表示を並べ替えます。
• ログをフィルターします。 日間隔やカスタム期間などのフィルター条件を設定するか、検索ボックスにメインタスクの完全または部分的な名前を入力して表示を絞り込みます。検索を使用した後に標準表示に戻るには、検索ボックスのテキストをクリアします。
• ログをエクスポートします。 選択したログまたはすべてのログをCSVファイルにエクスポートして、アーカイブまたは詳細な分析を行います。
• 列をカスタマイズします。 クライアントIPやラベルなどのデフォルト以外の列を追加して、表示をニーズに合わせて調整します。
• ラベルを管理します。 イベントログのラベルを追加、編集、削除して、ログの整理と追跡を強化します。

• 操作が完了する前に失敗した場合、ログ操作がデータベースで完了しない可能性があります。たとえば、開始レコードに対応する停止レコードがない場合などです。このような場合、ログには情報が不足していることが示されます。時間範囲に基づいてログを表示すると、データが条件に一致する場合、不完全なログが表示されます。
  たとえば、過去5日間のログを要求し、過去5日間に開始時刻があるログに終了時刻がない場合、そのログは含まれます。
• PowerShellコマンドレットを呼び出すスクリプトを使用する場合、親の高レベル操作を指定せずに低レベル操作を作成すると、構成ログは代理の高レベル操作を作成します。

レポートを生成する

• CSVレポートには、指定された時間間隔のすべてのログデータが含まれます。データベース内の階層データは、単一のCSVテーブルにフラット化されます。データのどの側面もファイル内で優先されません。書式設定は使用されず、人間が読めることは想定されていません。ファイル（MyReportという名前）には、普遍的に利用可能な形式でデータが含まれています。CSVファイルは、データのアーカイブや、Microsoft Excelなどのレポート作成ツールやデータ操作ツールのデータソースとしてよく使用されます。
• HTMLレポートは、指定された時間間隔のログデータを人間が読める形式で提供します。変更を確認するための構造化されたナビゲート可能なビューを提供します。HTMLレポートは、SummaryとDetailsという名前の2つのファイルで構成されます。Summaryには、各操作がいつ、誰によって行われたか、およびその結果といった高レベルの操作が一覧表示されます。各操作の横にあるDetailsリンクをクリックすると、Detailsファイル内の低レベル操作に移動し、追加情報が表示されます。

• レポートの日付範囲を選択します。
• レポート形式（CSV、HTML、またはその両方）を選択します。
• レポートを保存する場所を参照します。

構成ログコンテンツを削除する

• 委任管理: 展開構成を読み取ることができる委任管理ロールが必要です。完全管理者ロールにはこの権限があります。カスタムロールには、その他の権限カテゴリで「読み取り専用」または「管理」が選択されている必要があります。
  構成ログデータを削除する前にバックアップを作成するには、カスタムロールにログ権限カテゴリで「読み取り専用」または「管理」が選択されている必要もあります。
• SQL Serverデータベース: データベースからレコードを削除する権限を持つSQL Serverログインが必要です。これには2つの方法があります。
  • データベースサーバー上のあらゆるアクティビティを実行できるsysadminサーバーロールを持つSQL Serverデータベースログインを使用します。または、serveradminまたはsetupadminサーバーロールを使用すると、削除操作を実行できます。
  • 展開でより高いセキュリティが必要な場合は、データベースからレコードを削除する権限を持つデータベースユーザーにマッピングされた非sysadminデータベースログインを使用します。
    1. SQL Server Management Studioで、「sysadmin」以外のサーバーロールを持つSQL Serverログインを作成します。
    2. ログインをデータベース内のユーザーにマッピングします。SQL Serverは、ログインと同じ名前のユーザーをデータベース内に自動的に作成します。
    3. データベースロールメンバーシップで、データベースユーザーのロールメンバーの少なくとも1つを指定します: ConfigurationLoggingSchema_ROLEまたはdbowner。
    詳細については、SQL Server Management Studioのドキュメントを参照してください。

1. Web Studioにサインインし、左ペインでログを選択します。
2. アクションバーでログの削除を選択します。
3. ログを削除する前にバックアップを作成するかどうかを尋ねられます。バックアップを作成することを選択した場合は、バックアップアーカイブが保存される場所を参照します。バックアップはCSVファイルとして作成されます。

APIおよびPowerShellログを表示する

構成ログにメタデータを関連付ける