Citrix洞察服务
Citrix洞察服务(CIS)は計測を行って利用統計情報を収集し,ビジネス洞察を得るための,Citrixが提供するプラットフォームです。この計測機能と利用統計情報機能を使用することで,技術ユーザー(顧客,パートナー,エンジニア)は自己診断を行い,問題を解決し,環境を最適化することができます。独联体の詳細,最新情報,および機能について詳しくは,https://cis.citrix.comを参照してください(Citrixアカウントの資格情報が必要です)。
Citrixにアップロードされた情報はすべて,トラブルシューティングや診断,および以下の対象となる製品の品質,信頼性,パフォーマンス向上を目的として使用されます。
- Citrix洞察服务ポリシー:https://cis.citrix.com/legal
- 思杰公司のプライバシーポリシー://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软件
- 値の名前:经验计量学
- 値:0 = 無効、1 = 有効
动力壳を使用する場合、次のコマンドレットはインストール/アップグレード分析機能の自動アップロードを無効にします。
New ItemProperty-路径HKLM:\SOFTWARE\Citrix\MetaInstall-名称SendExperienceMetrics-属性类型DWORD-值0
XenDesktopServerSetup.exeまたはXenDesktopVDASetup.exeコマンドで自動アップロードを無効にするには、
/ disableexperiencemetrics
オプションを含めます。XenDesktopServerSetup.exeまたはXenDesktopVDASetup.exeコマンドで自動アップロードを有効にするには、
/ sendexperiencemetrics
オプションを含めます。
思杰公司カスタマーエクスペリエンス向上プログラム
思杰公司カスタマーエクスペリエンス向上プログラム(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 =有効
デフォルトでは,レジストリに启用
プロパティは表示されません。未指定のままの場合、自動アップロード機能は有効です。
动力壳を使用する場合、次のコマンドレットは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呼叫总部に参加するかどうかを選択できるページが表示されます。打电话回家は診断データを収集し、その後そのデータを含む利用統計情報パッケージを、分析およびトラブルシューティングの目的で定期的にCitrix Insight服务に直接アップロードします(デフォルトポート443上のHTTPS経由)。
Citrix虚拟应用程序和桌面では,打电话回家はCitrix遥测服务という名前のバックグラウンドサービスとして実行されます。詳しくは。”https://more.citrix.com/XD-CALLHOME」を参照してください。
Citrix Scoutでは、打电话回家のスケジュール機能も使用できます。詳しくは、「Citrix童子军」を参照してください。
収集される項目
Citrix诊断设施(CDF)トレースは,トラブルシューティングに役立つ情報を記録します。Call Homeは、一般的な障害(VDAの登録やアプリケーション/デスクトップの起動など)のトラブルシューティングに役立つCDFトレースのサブセットを収集します。このテクノロジは、常時トレース(AOT)と呼ばれます。AOTログはC:\Users\CitrixTelemetryService\Appdata\Local\CitrixAOTに保存されます。
打电话回家ではその他のWindows事件跟踪(ETW)情報が収集されることはなく、収集されるように設定することもできません。
また,打电话回家では以下の情報も収集されます:
- Citrix虚拟应用程序和桌面によって
HKEY_LOCAL_MACHINE \ \ Citrix的软件
に作成されたレジストリ - Citrix名前空間のWindows管理规范(WMI)情報。
- 実行中のプロセス一覧
- %程序数据% \ Citrix \ CDFに保存されているCitrixプロセスのクラッシュダンプ
- インストールとアップグレードの情報これには、製品全体の元安装程序ログ、失敗した微星ログ、微星ログアナライザーからの出力、店面ログ、ライセンスの互換性チェックログ、サイトの事前アップグレードテストの結果が含まれます。
トレース情報は収集時に圧縮されます。Citrix Telemetry Serviceは、最長8日間、圧縮されたトレース情報を最大10MB保持します。
- データを圧縮することで、打电话回家のVDA上の占有領域を小さくできます。
- プロビジョニングされたマシンでの眼压を避けるため、トレースはメモリで保持されます。
- トレースバッファでは、循環メカニズムを使用してトレースがメモリで保持されます。
打电话回家は「打电话回家キーデータポイント」に記載されたキーデータポイントを収集します
サマリーの構成と管理
全製品インストールウィザードの使用時、またはそれ以降に、动力壳コマンドレットを使用して、打电话回家に登録することができます。登録すると、デフォルトで、ローカルタイムの毎日曜日午前3.時頃に診断情報が収集され、思杰公司にアップロードされます。アップロードは、指定された時間の前後2.時間以内に行われます。つまり、デフォルトのスケジュールの場合、アップロードは午前3.時から午前5.時の間に行われます。
診断情報をスケジュールベースでアップロードしない場合(またはスケジュールを変更する場合)は,PowerShellコマンドレットを使用して診断情報を手動で収集し,アップロードするかローカルに保存してください。
打电话回家のスケジュールによるアップロード登録する場合、および診断情報を手動で思杰公司にアップロードする場合は、思杰公司のアカウントまたはCitrix云の資格情報を入力します。思杰公司は、アカウント資格情報を、顧客の識別とデータのアップロードに使用されるアップロードトークンに交換します。アカウント資格情報は保存されません。
アップロードが実行されると,Citrixアカウントに関連付けられたアドレスに通知メールが送信されます。
コンポーネントのインストール時に打电话回家を有効にした場合,後で無効にすることができます。
前提条件
- PowerShell 3.0またはそれ以降が実行されている必要があります。
- Citrix遥测服务が実行されている必要があります。
- システム変数
PSModulePath
は,C: \ Program Files \ Citrix \遥测服务\などの,遥测のインストールパスに設定する必要があります。
コンポーネントインストール時の打电话回家の有効化
VDAのインストールまたはアップグレード時:全製品インストーラーのグラフィカルインターフェイスを使用して虚拟投递代理をインストールまたはアップグレードする場合には,打电话回家に参加するかどうかを確認するメッセージが表示されます。2つのオプションがあります。
- 打电话回家に参加します。
- 打电话回家に参加しません。
VDAをアップグレードしていて、打电话回家に以前参加していた場合には、そのウィザードページは表示されません。
控制器のインストールまたはアップグレード時:グラフィカルインターフェイスを使用して传送控制器をインストールまたはアップグレードする場合には、打电话回家に参加するかどうかを確認するメッセージが表示されます。3.つのオプションがあります。
控制器をインストールする場合,そのサーバーがポリシー設定“サービスとしてログオン”が適用されるActive Directory GPOを持っていると,インストールウィザードで打电话回家ページ上の情報を構成できません。詳しくは。”CTX218094」を参照してください。
控制器をアップグレードしていて,打电话回家に以前登録していた場合,参加確認のメッセージは表示されません。
PowerShellコマンドレット
各コマンドレットの説明や、上記の一般的なユースケースでは使用されないパラメーターを含む包括的な構文は、动力壳ヘルプに記載されています。
プロキシサーバーを使用してアップグレードする方法については,”プロキシサーバーの構成」を参照してください。
スケジュールによるアップロードの有効化:収集された診断情報は、思杰公司に自動的にアップロードされます。カスタムスケジュール用の追加のコマンドレットを入力しない場合、デフォルトのスケジュールが使用されます。
$cred = Get-Credential Enable-CitrixCallHome -Credential $cred
スケジュールによるアップロードが有効になっていることを確認するには,”
Get-CitrixCallHomeGet-CitrixCallHome
“と入力します。有効な場合は。”IsEnabled=True
」および「IsMasterImage = False
“が返されます。マスターイメージから作成されたマシンでのスケジュールによるアップロードの有効化:マスターイメージでのスケジュールによるアップロードを有効にすると,マシンカタログで作成された各マシンを構成する必要がなくなります。
启用- citrixcallhome -Credential $ credit -MasterImage
スケジュールによるアップロードが有効になっていることを確認するには「回家“と入力します。有効な場合は。”
IsEnabled=True
」および「IsMasterImage=True
“が返されます。カスタムスケジュールの作成:診断情報の収集およびアップロードのスケジュールを,日次または週次で作成できます。
$timespan = New-TimeSpan -Hours hours -Minutes minutes set - citrixcallhomesschedule -TimeOfDay $timespan -DayOfWeek day -UploadFrequency {Daily|Weekly}
例:
次のコマンドレットでは,毎日午後10時20分にデータを収集してアップロードするスケジュールが作成されます。小时パラメーターには,24時間形式を使用します。上传频率
パラメーターの値が每日の場合,星期五
パラメーターは無視されます(指定されている場合)。
set - citrixcallhomesschedule - timeofday $timespan - uploadfrequency Daily设置
スケジュールを確認するには、「Get-CitrixCallHomeSchedule
」と入力します。上記の例では、「StartTime=22:20:00,DayOfWeek=Sunday(忽略),上传频率=每天
」が返される必要があります。
以下のコマンドレットでは、毎週水曜日の午後10時20分にデータを収集してアップロードするスケジュールが作成されます。
set - citrixcallhomesschedule - timeofday $timespan - dayofweek Wed - uploadfrequency Weekly
スケジュールを確認するには、「Get-CitrixCallHomeSchedule
」と入力します。上記の例では、「StartTime=22:20:00, DayOfWeek=周三,上传频率=每周
」が返される必要があります。
打电话回家の無効化
打电话回家を無効にするには,PowerShellコマンドレットかCitrix童子军を使用します。
AOTログは、打电话回家のスケジュールによるアップロードが無効な場合でも収集されディスクに保存されます。(スケジュールによるアップロードが無効な場合、AOTログは自動的にシトリックスにアップロードされません。)AOTログの収集およびローカル保存は無効化できます。
动力壳で打电话回家を無効にする
以下のコマンドレットを実行すると,診断データは自動的にシトリックスにアップロードされません。(キャンセル後も,Citrix童子军または遥测のPowerShellコマンドレットを使用した診断データのアップロードは実行できます)。
禁用Citrix CallHome
打电话回家が無効になったことを確認するには、回家
を入力します。無効な場合は。”IsEnabled=False
」および「IsMasterImage = False
“が返されます。
Citrix童子军を使用して収集スケジュールを無効にする
Citrix Scoutを使用して診断収集スケジュールを無効にするには、「収集スケジュールの設定“のガイドに従います。手順3で,(关闭)をクリックして選択したマシンのスケジュールをキャンセルします。
AOTログの収集を無効にする
以下のコマンドレットを実行すると(启用
フィールドを假
に設定)、AOTログは収集されません。
启用Citrix跟踪-侦听{“跟踪”:{“已启用”:false,“持久目录”:“C:\Users\Public”,“maxSizeBytes”:1000000,“sliceDurationSeconds”:300}”
听
パラメーターにはJSON形式の引数が含まれます。
打电话回家のアップロードのためにプロキシサーバーを構成
打电话回家が有効に設定されたマシンで,以下のタスクを実行します。以下の手順のサンプル図では,サーバーアドレスおよびポートは10.158.139.37:3128となっています。お客様の情報はこれとは異なります。
网状物ブラウザーにプロキシサーバー情報を追加します。Internet Explorerで、[インターネットオプション]>[接続]>[局域网の設定]の順に選択します。(局域网にプロキシサーバーを使用する]をオンにして、プロキシサーバーのアドレスとポート番号を入力します。
PowerShellで”
netsh winhttp导入代理源=ie
“を実行します。テキストエディターを使用して,TelemetryService.exe構成ファイルを編集します。このファイルは,C: \ Program Files \ Citrix \遥测服务にあります。以下の赤い枠内の情報を追加します。
遥测服务を再起動します。
动力壳で打电话回家コマンドレットを実行します。
手動による診断情報の収集およびアップロード
独联体Webサイトを使用して,診断情報のバンドルをCISにアップロードすることができます。PowerShellコマンドレットを使って、診断情報を収集してCISにアップロードすることもできます。
独联体Webサイトを使用してバンドルをアップロードするには,以下の手順に従います。
- Citrixのアカウント資格情報を使用してCitrix洞察服务にログオンします。
- 〔我的工作区〕を選択します。
- (Healthcheck)を選択し,次にデータの場所に移動します。
顺式では、データのアップロードを管理する複数の动力壳コマンドレットがサポートされます。このドキュメントでは、2.つの一般的なケースにおけるコマンドレットについて説明します。
Start-CitrixCallHomeUpload
コマンドレットを使用して,診断情報のパッケージを手動で収集してCISにアップロードします。(パッケージはローカルには保存されません)。Start-CitrixCallHomeUpload
コマンドレットを使用して、手動でデータを収集し、診断情報のパッケージをローカルに保存します。これにより、データをプレビューできるようになります。その後、发送Citrix CallHomeBundle
コマンドレットを使用して,パッケージのコピーを手動でCISにアップロードします。(最初に保存したデータはローカルに残ります)。
各コマンドレットの説明や、上記の一般的なユースケースでは使用されないパラメーターを含む包括的な構文は、动力壳ヘルプに記載されています。
顺式にデータをアップロードするコマンドレットを入力すると、アップロードを確認するメッセージが表示されます。アップロードの完了前にコマンドレットがタイムアウトした場合は、システムイベントログでアップロードのステータスをチェックしてください。サービスがすでにアップロードを実行している場合は、アップロード要求が拒否されることがあります。
データを収集して顺式へパッケージをアップロードする:
启动Citrix CallHomeUpload[-Credential]PSCredential[-InputPath字符串][描述字符串][附带时间字符串][数字字符串][名称字符串][UploadHeader字符串][AppendHeaders字符串][收集字符串][]
データを収集してローカルに保存する:
启动Citrix CallHomeUpload-OutputPath[-InputPath字符串][说明字符串][附带时间字符串][数字字符串][名称字符串][UploaderHeader字符串][AppendHeaders字符串][收集字符串][CommonParameters>]
使用できるパラメーターは次のとおりです。
- 证书:アップロード先をCISに設定します。
- 输入路径:パッケージに含めるzipファイルの場所。これは,Citrixサポートから要求される追加ファイルである可能性があります。拡張子. zipを含めてください。
- 输出路径:診断情報を保存する場所。このパラメーターは,打电话回家データをローカルに保存するときに必要です。
- 描述および事件时间:アップロードに関する自由形式の情報。
- SRNumber:Citrixテクニカルサポートのインシデント番号。
- 名称:パッケージの識別名。
- UploadHeader:独联体にアップロードするアップロードヘッダーを指定する,JSON形式の文字列。
- 附录标题:独联体にアップロードする追加ヘッダーを指定する,JSON形式の文字列。
收集:“{'collector':{'enabled':Boolean}”の形で、どのデータを修正または省略するかを指定するJSON形式の文字列。ここで、布尔值は符合事实的または错误的です。 有効な收藏家の値は以下のとおりです。
- “wmi”
- “过程”
- “注册表”
- “crashreport”
- “跟踪”
- “文件”
- msi的
- “本地数据”
- “sitedata”
- “sfb”
デフォルトでは,“sfb”以外のすべての收集器が有効です。
“sfb”收集器は,Skype业务の問題を診断するためにオンデマンドで使用するよう設計されています。“sfb”收集器は,“启用”パラメーターに加えて,ターゲットユーザーを指定する“帐户”パラメーターと“账户”パラメーターをサポートします。以下のいずれかの形式を使用します。
- -收集“{'sfb':{'account':'domain\\user1'}”
- “收集”{sfb:{“账户”:[域\ \ user1, '域\ \ user2 ']}}”
- 公共参数:PowerShellのヘルプを参照してください。
ローカルに保存されているデータをアップロードする:
发送- citrixcallhomebundle -Credential
路径
パラメーターにより,以前保存されたパッケージの場所を指定します。
例:
以下のコマンドレットでは、(WMI)コレクターからのデータを除く)打电话回家データの顺式へのアップロードが要求されます。このデータは、午後2.時30分に思杰公司サポートケース123456で記録された、Citrix配置VDAの登録エラーに関連するものです。アップロードされるパッケージには、打电话回家データに加えてファイル「c:\Diagnostics\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分に記録された思杰公司サポートケース223344に関連する打电话回家データが保存されます。このデータは、ネットワーク共有上の mydata.zipファイルに保存されます。保存されるパッケージには、打电话回家データに加えてファイル「c:\Diagnostics\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