Citrix洞察服务
Citrix洞察服务(CIS)は計測を行って利用統計情報を収集し,ビジネス洞察を得るための,Citrixが提供するプラットフォームです。この計測機能と利用統計情報機能を使用することで,技術ユーザー(顧客,パートナー,エンジニア)は自己診断を行い,問題を解決し,環境を最適化することができます。独联体の詳細,最新情報,および機能について詳しくは,https://cis.citrix.comを参照してください(Citrixアカウントの資格情報が必要です)。
Citrixにアップロードされた情報はすべて,トラブルシューティングや診断,および以下の対象となる製品の品質,信頼性,パフォーマンス向上を目的として使用されます。
- Citrix洞察服务ポリシー:https://cis.citrix.com/legal
- Citrixのプライバシーポリシー://m.giftsix.com/about/legal/privacy.html
Citrix虚拟应用程序和桌面のリリースでは,以下の技術がサポートされます。
独联体およびCitrix分析に追加(および別途):工作室をインストール(またはアップグレード)すると,谷歌分析が自動的に収集され(後でアップロードされ)ます。工作室をインストールした後,レジストリキーHKLM \ Software \ Citrix \ DesktopStudio \ GAEnabledでこの設定を変更できます。値1で収集とアップロードを有効にし,0で収集とアップロードを無効にします。
インストールとアップグレード分析
全製品インストーラーを使用してCitrix虚拟应用程序和桌面コンポーネントを展開またはアップグレードする場合,インストールプロセスに関する匿名の情報が,コンポーネントをインストール/アップグレードするマシンで収集および保存されます。このデータは,インストールに関するカスタマーエクスペリエンス向上のために使用されます。
この情報は,ローカルの% ProgramData % \ Citrix \概念不同に保存されます。
このデータの自動アップロードは,全製品インストーラーのグラフィックおよびコマンドラインインターフェイスの両方で,デフォルトで有効です。
- デフォルト値はレジストリ設定で変更できます。インストール/アップグレードの前にレジストリ設定を変更すると,全製品インストーラーの使用時にその値が使用されます。
- コマンドラインインターフェイスを使用して,コマンドにオプションを指定してインストール/アップグレードする場合,デフォルト設定をオーバーライドできます。
自動アップロードの制御:
インストール/アップグレード分析の自動アップロードを制御するレジストリ設定(デフォルト= 1):
- 場所:HKEY_LOCAL_MACHINE \ \ Citrix \ MetaInstall软件
- 値の名前:SendExperienceMetrics
- 値:0 = 無効、1 = 有効
PowerShellを使用する場合,次のコマンドレットはインストール/アップグレード分析機能の自動アップロードを無効にします。
New-ItemProperty -Path HKLM:\SOFTWARE\Citrix\MetaInstall -Name SendExperienceMetrics -PropertyType DWORD -Value 0
XenDesktopServerSetup.exeまたはXenDesktopVDASetup.exeコマンドで自動アップロードを無効にするには,
/ disableexperiencemetrics
オプションを含めます。XenDesktopServerSetup.exeまたはXenDesktopVDASetup.exeコマンドで自動アップロードを有効にするには,
/ sendexperiencemetrics
オプションを含めます。
Citrixカスタマーエクスペリエンス向上プログラム
Citrixカスタマーエクスペリエンス向上プログラム(CEIP)に参加すると,匿名の統計および使用状況情報が,シトリックス製品の品質およびパフォーマンスを向上させる目的で送信されます。詳しくは,https://more.citrix.com/XD-CEIPを参照してください。
サイトの作成中またはアップグレード中の登録
CEIPには,サイトの作成時に自動で登録されます(最初の交付控制器のインストール後)。サイトの作成からおよそ7日後に,初回データアップロードが行われます。登録は,サイトの作成後にいつでも取り消すことができます。工作室のナビゲーションペイン([製品サポート]タブ)で[構成]ノードを選択してガイダンスに従って操作します。
Citrix虚拟应用程序和桌面環境をアップグレードする場合:
- CEIPをサポートしないバージョンからアップグレードする場合,参加するかどうかを確認するメッセージが表示されます。
- CEIPをサポートするバージョンからアップグレードし,参加が有効になっていた場合,CEIPはアップグレードしたサイトで有効になります。
- CEIPをサポートするバージョンからアップグレードし,参加が無効になっていた場合,CEIPはアップグレードしたサイトで無効になります。
- CEIPをサポートするバージョンからアップグレードし,参加が不明な場合,参加するかどうかを確認するメッセージが表示されます。
収集された情報は匿名になるため,Citrix洞察服务へのアップグレード後は表示されません。
VDAのインストール時の登録
デフォルトでは,ユーザーはWindows VDAのインストール時にCEIPに自動登録されます。このデフォルトはレジストリ設定で変更できます。VDAインストールの前にレジストリ設定を変更すると,その値が使用されます。
CEIPへの自動登録を制御するレジストリ設定(デフォルト= 1):
場所:HKEY_LOCAL_MACHINE \ Citrix \ \软件遥测\ CEIP値の名前:启用値:0 =無効,1 =有効
デフォルトでは,レジストリに启用
プロパティは表示されません。未指定のままの場合,自動アップロード機能は有効です。
PowerShellを使用する場合,次のコマンドレットはCEIPへの登録を無効にします。
New-ItemProperty -Path HKLM:\SOFTWARE\Citrix\Telemetry\CEIP -Name Enabled -PropertyType DWORD -Value 0
収集されたランタイムデータポイントは,定期的に出力フォルダ(デフォルトは% programdata % / Citrix / VdaCeip)にファイルとして書き込まれます。
VDAのインストールからおよそ7日後に,初回データアップロードが行われます。
他の製品およびコンポーネントのインストール時の登録
CEIPへは,関連するCitrix製品,コンポーネント,テクノロジ(Citrix部署、AppDNA Citrixライセンスサーバー,窗户向けCitrix工作区アプリ,ユニバーサルプリントサーバー,会话记录)のインストール時にも参加できます。インストールと参加のデフォルト値について詳しくは,該当のドキュメントを参照してください。
Citrix打电话回家
Citrix虚拟应用程序和桌面で特定のコンポーネントおよび機能をインストールする場合,Citrix打电话回家に参加するかどうかを選択できるページが表示されます。Call Homeは診断データを収集し、その後そのデータを含む利用統計情報パッケージを、分析およびトラブルシューティングの目的で定期的にCitrix Insight Servicesに直接アップロードします(デフォルトポート443上のHTTPS経由)。
Citrix虚拟应用程序和桌面では,打电话回家はCitrix遥测服务という名前のバックグラウンドサービスとして実行されます。詳しくは,https://more.citrix.com/XD-CALLHOMEを参照してください。
Citrix童子军では,打电话回家のスケジュール機能も使用できます。詳しくは。”Citrix童子军“を参照してください。
収集される項目
Citrix诊断设施(CDF)トレースは,トラブルシューティングに役立つ情報を記録します。Call Homeは、一般的な障害(VDAの登録やアプリケーション/デスクトップの起動など)のトラブルシューティングに役立つCDFトレースのサブセットを収集します。このテクノロジは、常時トレース(AOT)と呼ばれます。AOTログはC:\Users\CitrixTelemetryService\Appdata\Local\CitrixAOTに保存されます。
打电话回家ではその他の事件跟踪窗口(ETW)情報が収集されることはなく,収集されるように設定することもできません。
また,打电话回家では以下の情報も収集されます:
- Citrix虚拟应用程序和桌面によって
HKEY_LOCAL_MACHINE \ \ Citrix的软件
に作成されたレジストリ - Citrix名前空間のWindows管理规范(WMI)情報
- 実行中のプロセス一覧
- %程序数据% \ Citrix \ CDFに保存されているCitrixプロセスのクラッシュダンプ
- インストールとアップグレードの情報これには,製品全体のMetainstallerログ,失敗したMSIログ,MSIログアナライザーからの出力,店面ログ,ライセンスの互換性チェックログ,サイトの事前アップグレードテストの結果が含まれます。
トレース情報は収集時に圧縮されます。Citrix Telemetry Serviceは、最長8日間、圧縮されたトレース情報を最大10MB保持します。
- データを圧縮することで,打电话回家のVDA上の占有領域を小さくできます。
- プロビジョニングされたマシンでのIOPを避けるため,トレースはメモリで保持されます。
- トレースバッファーでは,循環メカニズムを使用してトレースがメモリで保持されます。
打电话回家は。”打电话回家のキーデータポイント“に記載されているキーデータポイントを収集します。
サマリーの構成と管理
全製品インストールウィザードの使用時,またはそれ以降に,PowerShellコマンドレットを使用して,打电话回家に登録することができます。登録すると,デフォルトで,ローカルタイムの毎日曜日午前3時頃に診断情報が収集され,Citrixにアップロードされます。アップロードは,指定された時間の前後2時間以内に行われます。つまり,デフォルトのスケジュールの場合,アップロードは午前3時から午前5時の間に行われます。
診断情報をスケジュールベースでアップロードしない場合(またはスケジュールを変更する場合)は,PowerShellコマンドレットを使用して診断情報を手動で収集し,アップロードするかローカルに保存してください。
打电话回家のスケジュールによるアップロード登録する場合,および診断情報を手動でCitrixにアップロードする場合は,CitrixのアカウントまたはCitrix云の資格情報を入力します。Citrixは,アカウント資格情報を,顧客の識別とデータのアップロードに使用されるアップロードトークンに交換します。アカウント資格情報は保存されません。
アップロードが実行されると,Citrixアカウントに関連付けられたアドレスに通知メールが送信されます。
コンポーネントのインストール時に打电话回家を有効にした場合,後で無効にできます。
前提条件
- PowerShell 3.0またはそれ以降が実行されている必要があります。
- Citrix遥测服务が実行されている必要があります。
- システム変数
PSModulePath
は,C: \ Program Files \ Citrix \遥测服务\などの,遥测のインストールパスに設定する必要があります。
コンポーネントインストール時の打电话回家の有効化
VDAのインストールまたはアップグレード時:全製品インストーラーのグラフィカルインターフェイスを使用して虚拟投递代理をインストールまたはアップグレードする場合には,打电话回家に参加するかどうかを確認するメッセージが表示されます。2つのオプションがあります。
- 打电话回家に参加します。
- 打电话回家に参加しません。
VDAをアップグレードしていて,打电话回家に以前参加していた場合には,そのウィザードページは表示されません。
控制器のインストールまたはアップグレード時:グラフィカルインターフェイスを使用して交付控制器をインストールまたはアップグレードする場合には,打电话回家に参加するかどうかを確認するメッセージが表示されます。3つのオプションがあります。
控制器をインストールする場合,そのサーバーがポリシー設定“サービスとしてログオン”が適用されるActive Directory GPOを持っていると,インストールウィザードで打电话回家ページ上の情報を構成できません。詳しくは,CTX218094を参照してください。
控制器をアップグレードしていて,打电话回家に以前登録していた場合,参加確認のメッセージは表示されません。
PowerShellコマンドレット
各コマンドレットの説明や,上記の一般的なユースケースでは使用されないパラメーターを含む包括的な構文は,PowerShellヘルプに記載されています。
プロキシサーバーを使用してアップグレードする方法については,”プロキシサーバーの構成“を参照してください。
スケジュールによるアップロードの有効化:収集された診断情報は,Citrixに自動的にアップロードされます。カスタムスケジュール用の追加のコマンドレットを入力しない場合,デフォルトのスケジュールが使用されます。
$cred = Get-Credential Enable-CitrixCallHome -Credential $cred
スケジュールによるアップロードが有効になっていることを確認するには,”
Get-CitrixCallHomeGet-CitrixCallHome
“と入力します。有効な場合は。”IsEnabled = True
“および”IsMasterImage = False
“が返されます。マスターイメージから作成されたマシンでのスケジュールによるアップロードの有効化:マスターイメージでのスケジュールによるアップロードを有効にすると,マシンカタログで作成された各マシンを構成する必要がなくなります。
启用- citrixcallhome -Credential $ credit -MasterImage
スケジュールによるアップロードが有効になっていることを確認するには”Get-CitrixCallHome“と入力します。有効な場合は。”
IsEnabled = True
“および”IsMasterImage = True
“が返されます。カスタムスケジュールの作成:診断情報の収集およびアップロードのスケジュールを,日次または週次で作成できます。
$timespan = New-TimeSpan -Hours hours -Minutes minutes set - citrixcallhomesschedule -TimeOfDay $timespan -DayOfWeek day -UploadFrequency {Daily|Weekly}
例:
次のコマンドレットでは,毎日午後10時20分にデータを収集してアップロードするスケジュールが作成されます。小时パラメーターには,24時間形式を使用します。UploadFrequency
パラメーターの値が每日の場合,DayOfWeek
パラメーターは無視されます(指定されている場合)。
$timespan - New-TimeSpan - hours 22 - minutes 20 set - citrixcallhomesschedule - timeofday $timespan - uploadfrequency Daily
スケジュールを確認するには,”Get-CitrixCallHomeSchedule
“と入力します。上記の例では。”StartTime=22:20:00, DayOfWeek=Sunday(忽略),Upload Frequency=Daily
“が返される必要があります。
以下のコマンドレットでは,毎週水曜日の午後10時20分にデータを収集してアップロードするスケジュールが作成されます。
$timespan - New-TimeSpan - hours 22 - minutes 20 set - citrixcallhomesschedule - timeofday $timespan - dayofweek Wed - uploadfrequency Weekly
スケジュールを確認するには,”Get-CitrixCallHomeSchedule
“と入力します。上記の例では。”StartTime=22:20:00, DayOfWeek=周三,上传频率=每周
“が返される必要があります。
打电话回家の無効化
打电话回家を無効にするには,PowerShellコマンドレットかCitrix童子军を使用します。
AOTログは,打电话回家のスケジュールによるアップロードが無効な場合でも収集されディスクに保存されます。(スケジュールによるアップロードが無効な場合,AOTログは自動的にCitrixにアップロードされません)AOTログの収集およびローカル保存は無効化できます。
PowerShellで打电话回家を無効にする
以下のコマンドレットを実行すると,診断データは自動的にCitrixにアップロードされません。(キャンセル後も,Citrix童子军または遥测のPowerShellコマンドレットを使用した診断データのアップロードは実行できます)。
Disable-CitrixCallHome
打电话回家が無効になったことを確認するには,Get-CitrixCallHome
を入力します。無効な場合は。”IsEnabled = False
“および”IsMasterImage = False
“が返されます。
Citrix童子军を使用して収集スケジュールを無効にする
Citrix童子军を使用して診断収集スケジュールを無効にするには,”収集スケジュールの設定“のガイドに従います。手順3で,(关闭)をクリックして選択したマシンのスケジュールをキャンセルします。
AOTログの収集を無効にする
以下のコマンドレットを実行すると(启用
フィールドを假
に設定),AOTログは収集されません。
Enable-CitrixTrace着‘{“跟踪”:{“启用”:假的,“persistDirectory”:“C: \ \公共用户”,“maxSizeBytes”:1000000,“sliceDurationSeconds”:300}}”
听
パラメーターにはJSON形式の引数が含まれます。
打电话回家のアップロードのためにプロキシサーバーを構成
打电话回家が有効に設定されたマシンで,以下のタスクを実行します。以下の手順のサンプル図では,サーバーアドレスおよびポートは10.158.139.37:3128となっています。お客様の情報はこれとは異なります。
Webブラウザーにプロキシサーバー情報を追加します。ieで,[インターネットオプション]>[接続]>[局域网の設定)の順に選択します。(局域网にプロキシサーバーを使用する]をオンにして,プロキシサーバーのアドレスとポート番号を入力します。
PowerShellで”
Netsh winhttp import proxy source=ie
“を実行します。テキストエディターを使用して,TelemetryService.exe構成ファイルを編集します。このファイルは,C: \ Program Files \ Citrix \遥测服务にあります。以下の赤い枠内の情報を追加します。
遥测服务を再起動します。
PowerShellで打电话回家コマンドレットを実行します。
手動による診断情報の収集およびアップロード
独联体Webサイトを使用して,診断情報のバンドルをCISにアップロードすることができます。PowerShellコマンドレットを使って、診断情報を収集してCISにアップロードすることもできます。
独联体Webサイトを使用してバンドルをアップロードするには,以下の手順に従います。
- Citrixのアカウント資格情報を使用してCitrix洞察服务にログオンします。
- (我的空间)を選択します。
- (Healthcheck)を選択し,次にデータの場所に移動します。
独联体では,データのアップロードを管理する複数のPowerShellコマンドレットがサポートされます。このドキュメントでは,2つの一般的なケースにおけるコマンドレットについて説明します。
Start-CitrixCallHomeUpload
コマンドレットを使用して,診断情報のパッケージを手動で収集してCISにアップロードします。(パッケージはローカルには保存されません)。Start-CitrixCallHomeUpload
コマンドレットを使用して,手動でデータを収集し,診断情報のパッケージをローカルに保存します。これにより,データをプレビューできるようになります。その後,Send-CitrixCallHomeBundle
コマンドレットを使用して,パッケージのコピーを手動でCISにアップロードします。(最初に保存したデータはローカルに残ります)。
各コマンドレットの説明や,上記の一般的なユースケースでは使用されないパラメーターを含む包括的な構文は,PowerShellヘルプに記載されています。
独联体にデータをアップロードするコマンドレットを入力すると,アップロードを確認するメッセージが表示されます。アップロードの完了前にコマンドレットがタイムアウトした場合は,システムイベントログでアップロードのステータスをチェックしてください。サービスが既にアップロードを実行している場合は,アップロード要求が拒否されることがあります。
データを収集してCISへパッケージをアップロードする:
Start-CitrixCallHomeUpload [-Credential] PSCredential [-InputPath string] [-Description string] [-IncidentTime string] [-SRNumber string] [-Name string] [-UploadHeader string] [-AppendHeaders string] [-Collect string] []
データを収集してローカルに保存する:
Start-CitrixCallHomeUpload -OutputPath [-InputPath String] [-Description String] [-IncidentTime String] [-SRNumber String] [-Name String] [-UploaderHeader String] [-AppendHeaders String] [-Collect strings] []
使用できるパラメーターは次のとおりです。
- 证书:アップロード先をCISに設定します。
- InputPath:パッケージに含めるzipファイルの場所。これは,Citrixサポートから要求される追加ファイルである可能性があります。拡張子. zipを含めてください。
- OutputPath:診断情報を保存する場所。このパラメーターは,打电话回家データをローカルに保存するときに必要です。
- 描述および事件时间:アップロードに関する自由形式の情報。
- SRNumber:Citrixテクニカルサポートのインシデント番号。
- 名称:パッケージの識別名。
- UploadHeader:独联体にアップロードするアップロードヘッダーを指定する,JSON形式の文字列。
- AppendHeaders:独联体にアップロードする追加ヘッダーを指定する,JSON形式の文字列。
收集:“{“收藏家”:{“启用”:布尔}}“の形で,どのデータを修正または省略するかを指定するJSON形式の文字列。ここで,布尔は真的または假です。有効な收集器の値は以下のとおりです。
- “wmi”
- “过程”
- “注册表”
- “crashreport”
- “跟踪”
- “文件”
- msi的
- “localdata”
- “sitedata”
- “sfb”
デフォルトでは,“sfb”以外のすべての收集器が有効です。
“sfb”收集器は,Skype业务の問題を診断するためにオンデマンドで使用するよう設計されています。“sfb”收集器は,“启用”パラメーターに加えて,ターゲットユーザーを指定する“帐户”パラメーターと“账户”パラメーターをサポートします。以下のいずれかの形式を使用します。
- “收集”{sfb:{“账户”:“域\ \ user1}}”
- “收集”{sfb:{“账户”:[域\ \ user1, '域\ \ user2 ']}}”
- CommonParameters:PowerShellのヘルプを参照してください。
ローカルに保存されているデータをアップロードする:
发送- citrixcallhomebundle -Credential
路径
パラメーターにより,以前保存されたパッケージの場所を指定します。
例:
以下のコマンドレットでは,(WMIコレクターからのデータを除く)打电话回家データのCISへのアップロードが要求されます。このデータは,午後2時30分にCitrixサポートケース123456で記録された,Citrix供应VDAの登録エラーに関連するものです。アップロードされるパッケージには,打电话回家データに加えてファイル“c: \ \ ExtraData.zip诊断”が含まれます。
C:\PS>Start-CitrixCallHomeUpload -InputPath " C:\诊断\ extradita .zip" -Description "注册失败与Citrix Provisioning VDAs" -IncidentTime "14:30" -SRNumber 123456 -Name "RegistrationFailure-021812016" -Collect "{'wmi':{'enabled':false}}" -UploadHeader "{'key1':'value1'}" -AppendHeaders "{'key2':'value2'}"
以下のコマンドレットでは,午前8時15分に記録されたCitrixサポートケース223344に関連する打电话回家データが保存されます。このデータは,ネットワーク共有上のmydata.zipファイルに保存されます。保存されるパッケージには,打电话回家データに加えてファイル“c: \ \ ExtraData.zip诊断”が含まれます。
C:\PS>Start-CitrixCallHomeUpload -OutputPath \mynetwork\myshare\mydata.zip -InputPath " C:\ Diagnostics\ExtraData.zip" -Description "Diagnostics for incident number 223344" -IncidentTime "8:15" -SRNumber 223344
以下のコマンドレットでは,以前保存したデータパッケージがアップロードされます。
$cred=Get-Credential C:\PS>Send-CitrixCallHomeBundle -Credential $cred -Path \mynetwork\myshare\mydata.zip——NeedCopy >