-
-
-
構成ログ
This content has been machine translated dynamically.
Dieser Inhalt ist eine maschinelle Übersetzung, die dynamisch erstellt wurde. (Haftungsausschluss)
Cet article a été traduit automatiquement de manière dynamique. (Clause de non responsabilité)
Este artículo lo ha traducido una máquina de forma dinámica. (Aviso legal)
此内容已经过机器动态翻译。 放弃
このコンテンツは動的に機械翻訳されています。免責事項
이 콘텐츠는 동적으로 기계 번역되었습니다. 책임 부인
Este texto foi traduzido automaticamente. (Aviso legal)
Questo contenuto è stato tradotto dinamicamente con traduzione automatica.(Esclusione di responsabilità))
This article has been machine translated.
Dieser Artikel wurde maschinell übersetzt. (Haftungsausschluss)
Ce article a été traduit automatiquement. (Clause de non responsabilité)
Este artículo ha sido traducido automáticamente. (Aviso legal)
この記事は機械翻訳されています.免責事項
이 기사는 기계 번역되었습니다.책임 부인
Este artigo foi traduzido automaticamente.(Aviso legal)
这篇文章已经过机器翻译.放弃
Questo articolo è stato tradotto automaticamente.(Esclusione di responsabilità))
Translation failed!
構成ログ
注：
構成ログの記録は、Citrix Cloudアカウントでどの言語を選択した場合でも、英語でのみ表示されます。これらの記録に関連付けられている日付と時刻は、MM/DD/YY形式で、協定世界時（UTC）で表されます。
-
構成ログは、Citrix Virtual Apps and Desktops™およびCitrix DaaS（旧称：Citrix Virtual Apps and Desktopsサービス）の展開構成の変更と管理アクティビティをCitrix Cloudのログデータベースに記録する機能です。ログに記録されたコンテンツは、次の目的で使用できます。
- 構成変更後の問題の診断とトラブルシューティング。ログは追跡記録を提供します
- 変更管理の支援と構成の追跡
- 管理アクティビティのレポート
このCitrix DaaS™では、構成ログは常に有効になっており、無効にすることはできません。
Studioから、日付範囲または全文検索でフィルタリングされた構成ログコンテンツを表示できます。PowerShellを使用してCSVレポートを生成することもできます。このコンソールからログコンテンツを編集または削除することはできません。Remote PowerShell SDKを使用して、ログからの定期的なデータ削除をスケジュールできます。
DaaS構成ログの保持期間の更新
DaaSテナントのパフォーマンスを維持するため、2024年9月9日より、構成ログの保持期間は180日に設定されます。
- 2024年9月9日時点で180日より古いログは削除されます。単一のDaaSテナントに対するDaaSの制限を拡大し続けることで、この実装は、お客様にとって最高のパフォーマンスと回復力を保証します。
ベストプラクティスとして、お客様には四半期ごとのエクスポートメカニズムを設けることをお勧めします。これはPowerShellを介して行うことができます。レポートの生成を参照してください。また、お客様には定期的なデータ削除をスケジュールすることをお勧めします。定期的なデータ削除のスケジュールを参照してください。
必要な権限（委任管理を参照）：
- Citrix Cloud™のフル管理者、Citrix DaaSクラウド管理者、および読み取り専用管理者は、Studioで構成ログを表示できます
- フル管理者とクラウド管理者は、PowerShellを使用してログアクティビティのCSVレポートをダウンロードすることもできます
ログに記録される内容
次の操作がログに記録されます。
- 管理セクションおよび監視ノードから開始された構成変更と管理アクティビティ
- PowerShellスクリプト
-
REST APIリクエスト
-
注：
データベースのセットアップや管理など、Citrix Cloudプラットフォームの内部操作のログエントリは表示されません。
ログに記録される構成変更の例には、次の操作（作成、編集、削除、割り当て）が含まれます。
- マシンカタログ
- デリバリーグループ（電源管理設定の変更を含む）
- 管理者ロールとスコープ
- ホストリソースと接続
- Studioを介したCitrix®ポリシー
ログに記録される管理変更の例には、次の操作が含まれます。
- 仮想マシンまたはユーザーデスクトップの電源管理
- ユーザーにメッセージを送信する管理または監視機能
次の操作はログに記録されません。（これらの多くは、顧客管理者には利用できません。）
- プール管理による仮想マシンの電源投入などの自動操作
- グループポリシー管理コンソール（GPMC）を介して実装されたポリシーアクション。これらのアクションのログを表示するには、Microsoftツールを使用します
- レジストリを介して、またはStudio、Monitor、PowerShell以外のソースから行われた変更
構成ログコンテンツの表示
構成ログコンテンツを表示するには、次の手順に従います。
- Citrix Cloudにサインインします。
- DaaSタイルで、管理をクリックします。
-
- 左側のペインでログを選択し、イベントタブをクリックします。
-
デフォルトでは、イベントログは管理者名で一覧表示されます。必要に応じて、次のタスクを実行できます。
- 表示の並べ替え
- ログのフィルタリング
- ログのエクスポート
- 列のカスタマイズ
-
ラベルの管理
-
表示の特性：
- 管理および監視中に作成された高レベルの操作は、上部中央のペインに表示されます。高レベルの操作は、1つ以上のサービスとPowerShell SDK呼び出し（低レベルの操作）をもたらします。上部中央のペインで高レベルの操作を選択すると、下部のペインに低レベルの操作が表示されます。
- 親の高レベル操作を指定せずにPowerShellで低レベル操作を作成すると、構成ログは代替の高レベル操作を作成します。
- 操作が完了する前に失敗した場合、ログ操作はデータベースで完了しない可能性があります。たとえば、開始レコードに対応する停止レコードがない場合などです。このような場合、ログには情報が不足していることが示されます。時間範囲に基づいてログを表示すると、ログ内のデータが基準に一致する場合、不完全なログが表示されます。たとえば、過去5日間のログを要求し、過去5日間の開始時刻を持つログに終了時刻がない場合、それは含まれます。
- 注意：データベースのセットアップや管理など、Citrix Cloudプラットフォームの内部操作のログエントリは表示されません。
マシンカタログ操作に関連するタスクの表示
-
マシンカタログ操作に関連するタスクを表示するには、ログ > タスクに移動します。タスクタブには、Machine Creation Services™（MCS）またはProvisioning Services（PVS）を介して作成されたカタログに関連するタスクのみが表示されます。具体的には、次のマシンカタログ操作に関連するタスクが表示されます。
- カタログの作成
- カタログのクローン作成
- マシンの追加
- マシンの削除
- カタログの更新（イメージまたはマシンの更新）
- マシン更新のロールバック
ヒント：
タスクタブには、プロビジョニングスキームの変更（プロビジョニングスキームの作成または変更）に関連するタスクのみが表示されます。
タスクは次の状態になります。
- 完了
- 未開始
- 実行中
- キャンセル済み
- 失敗
- 不明
実行中のタスクをキャンセルするには、タスクを選択し、キャンセルをクリックします。キャンセルが完了するまでに時間がかかります。
ログに記録されるタスクの例には、次の操作が含まれます。
- 特定のカタログのイメージ更新が完了しました
- 特定のカタログのイメージ更新中にエラーが発生しました
- 特定のカタログのイメージ更新がキャンセルされました
- 特定のカタログへのVMのプロビジョニング
- 特定のカタログからのVMの削除
- 特定のカタログを作成しました
デフォルトでは、中央のペインの表示には、ログに記録されたタスクが日付で区切られて時系列順（最新のエントリが最初）に一覧表示されます。列ヘッダーで表示を並べ替えることができます。完了したタスクをクリアするには、タスクタブの下にある完了したタスクをクリアをクリックします。表示する列を選択するには、テーブルの右上隅にある表示する列アイコンを選択します。
APIログの表示
- REST APIログを表示するには、[ログ] > [API] に移動します。[API] タブには、特定の期間に行われたREST APIリクエストが表示されます。
以下の考慮事項に注意してください。
- REST APIログは、コンソールからサインアウトするとクリアされます。(ブラウザウィンドウを更新した場合もクリアされます。)
- API呼び出しを伴うコンソール内の操作はすべて、対応するAPIリクエストが[API] タブに表示されます。
- 表示には、APIリクエストが日付で区切られて時系列順に（最新のエントリが最初）リストされます。表示されるAPIリクエストの最大数は1,000です。
PowerShellログの表示
- その日に行ったUIアクションに対応するPowerShellコマンドを表示するには、[ログ] > [PowerShell] タブに移動します。
構成ログへのメタデータの関連付け
-
ログレコードに
MetadataMapと呼ばれるname-valueペアを関連付けることで、構成ログにメタデータを添付できます。 -
注:
-
-
- メタデータは、高レベルの操作オブジェクトにのみ添付できます。
- メタデータは、実行時に既存のレコードに関連付けられます。
メタデータの設定
PowerShellコマンド Set-LogHighLevelOperationMetadata を実行して、ログレコードを MetadataMap に関連付けます。
Set-LogHighLevelOperationMetadata は次のパラメーターを受け取ります。
- Id: 高レベル操作のID。
-
InputObject: メタデータを追加する高レベル操作。これは
Idパラメーターの代替であり、高レベル操作オブジェクトまたはオブジェクトのリストがPowerShellコマンドに渡されます。 -
Name: 追加するメタデータのプロパティ名。プロパティは、指定された高レベル操作に対して一意である必要があります。プロパティには、次の文字を含めることはできません。
()\/;:#.*?=<>|[]"' - Value: プロパティの値。
-
Map: プロパティの (名前、値) ペアの辞書。これは、
-Nameおよび-Valueパラメーターを使用してメタデータを設定する代替手段です。
たとえば、ID 40 のすべての高レベルログレコードにメタデータを添付するには、次のPowerShellコマンドを実行します。
Get-LogHighLevelOperation – Id 40 | Set-LogHighLevelOperationMetadata -Name A -Value B
ユーザー abc@example.com を持つ高レベルレコードにメタデータを添付するには、次のPowerShellコマンドを実行します。
Get-LogHighLevelOperation – User `abc@example.com` | Set-LogHighLevelOperationMetadata -Name C -Value D
メタデータを使用した取得
関連付けられたメタデータを使用してログレコードを取得するには、次のPowerShellコマンドを実行します。
-
キーと値で検索:
Get-LogHighLevelOperation -Metadata "Key:Value" -
値と任意のキーで検索:
Get-LogHighLevelOperation -Metadata "*:Value" -
キーと任意の値で検索:
Get-LogHighLevelOperation -Metadata "Key:*"
メタデータの削除
PowerShellコマンド Remove-LogHighLevelOperationMetadata を実行して、関連付けられたメタデータを削除します。
Remove-LogHighLevelOperationMetadata は次のパラメーターを受け取ります。
- Id: 高レベル操作のID。
-
InputObject: メタデータを追加する高レベル操作。これは
Idパラメーターの代替であり、高レベル操作オブジェクトまたはオブジェクトのリストがPowerShellコマンドに渡されます。 - Name: 削除するメタデータのプロパティ名。指定されたオブジェクトのすべてのメタデータを削除するには、$null に設定します。
- Map: プロパティの (名前、値) ペアの辞書。これは、ハッシュテーブル (@{“name1” = “val1”; “name2” = “val2”} で作成) または文字列辞書 (new-object “System.Collections.Generic.Dictionary[String, String]” で作成) のいずれかです。マップ内のキーと名前が一致するプロパティが削除されます。
レポートの生成
構成ログデータを含むCSVまたはHTMLレポートを生成するには、Citrix Virtual Apps and Desktops Remote PowerShell SDK の ConfigLogging Service 用 PowerShell コマンドレットを使用します。詳細については、以下を参照してください。
定期的なデータ削除のスケジュール設定
Remote PowerShell SDK を使用して、構成ログデータベースにデータが保持される期間を指定します。(この機能はStudioでは利用できません。) Citrix DaaS では、フルアクセス権が必要です。
Set-LogSite コマンドレットの -LoggingDBPurgeDurationDays パラメーターは、構成ログデータベースにデータが自動的に削除されるまでに保持される日数を指定します。
- デフォルトでは、このパラメーターの値は0です。ゼロ値は、構成ログデータベース内のデータが自動的に削除されることはないことを意味します。
- ゼロ以外の値を設定すると、データベースは120分ごとに1回チェックされます。保持期間よりも古いデータは削除されます。
Get-LogSite を使用して、パラメーターの現在の値を表示します。
オンプレミス版Citrix Virtual Apps and Desktopsとの相違点
オンプレミス版Virtual Apps and Desktops製品の構成ログに慣れている場合、Citrix Cloud版にはいくつかの相違点があります。Citrix Cloudでは、次の点が異なります。
- 構成ログは常に有効です。無効にすることはできません。強制ログは利用できません。
- 構成ログデータベースはCitrix Cloudプラットフォームで管理されているため、その場所を変更することはできません。
- 構成ログの表示には、Citrix Cloudプラットフォーム内で実行される操作やアクティビティは含まれません。
- ログに記録された操作のCSVまたはHTMLレポートを作成するには、PowerShellが唯一の選択肢です。オンプレミス製品では、レポートはCitrix StudioまたはPowerShellから生成できます。
- 構成ログの内容を削除することはできません。
共有
共有
This Preview product documentation is Citrix Confidential.
You agree to hold this documentation confidential pursuant to the terms of your Citrix Beta/Tech Preview Agreement.
The development, release and timing of any features or functionality described in the Preview documentation remains at our sole discretion and are subject to change without notice or consultation.
The documentation is for informational purposes only and is not a commitment, promise or legal obligation to deliver any material, code or functionality and should not be relied upon in making Citrix product purchase decisions.
If you do not agree, select I DO NOT AGREE to exit.