Citrix Virtual Apps and Desktops

Citrix Virtual Apps and Desktops™ テレメトリーデータ要素

ブローカー

使用状況

ヘッダー

Key Description Example
ver テレメトリーイベントのバージョンを示します。 1
id 使用状況イベントの一意の識別子を示します。 d4ce7919-5d80-44de-a8fa-102923fe0ead
type Citrix Analytic Serviceがクラウド使用状況イベントを識別するために使用するイベントタイプを示します。 SendBrokerTelemetryData
st イベントがブローカーで生成されたときのタイムスタンプを示します。 2011-08-12T20:17:46.384Z
prod
使用状況イベントの元の製品と展開を識別します。
XenDesktop.Broker (Cloud)
OnPrem.Broker (OnPrem)
prodVer Citrix DaaS/Citrix Virtual Apps and Desktopsの製品バージョンを示します。 7.25.0.0

ペイロード

Field Description Example
TotalPublishedApps 公開されているアプリケーションの合計数を示します。 10
TotalPublishedDesktops 公開されているデスクトップの合計数を示します。 10
VDAs.Total VDAの合計数を示します。 10
VDAs.OSTypes Windows、Linux、MacなどのOSタイプ別のVDAの合計数を示します。 10
VDAs.OSVersions Windows 10、11、2022、2019などのOSバージョン別の合計数を示します。 10
VDAs.HostingLocations.Azure Azure、AWS、GCP、Nutanix、VMWare、XenServer、HyperVなどのサポートされている各ホスティングロケーションのVDA数を示します。




10




VDAs.HostingLocations.AWS
VDAs.HostingLocations.Nutanix
VDAs.HostingLocations.VMWare
VDAs.HostingLocations.XenServer
VDAs.HostingLocations.HyperV
VDAs.ProvisionedMethod.MCS Machine Creation Service (MCS) によってプロビジョニングされたマシンの数を示します。 10
VDAs.ProvisionedMethod.ManualOr3P 手動またはサードパーティによってプロビジョニングされたマシンの数を示します。 10
VDAs.SessionSupport.StaticSingle 静的に割り当てられたシングルセッションマシンの数を示します。 10
VDAs.SessionSupport.DynamicSingle 動的に割り当てられたシングルセッションマシンの数を示します。 10
VDAs.SessionSupport.Multi マルチセッションマシンの合計数を示します。 10
VDAs.RemotePCAccess.Windows OSタイプ(Windows、Mac、Linux)別のリモートPCアクセス・マシンの数を示します。

10

VDAs.RemotePCAccess.Linux
VDAs.RemotePCAccess.MacOS
VDAs.ActiveSessionRecordingAgents アクティブなセッション記録エージェントを持つVDAの数を示します。 5
VDAs.Subscriptions VDAのパブリッククラウドサブスクリプションの数を示します。 2
VDAs.LocationTypes VDAのロケーションタイプの数を示します。 2
AutoScale.DGWithAutoscaleEnabled Autoscale が有効になっているデリバリーグループの数を示します。 2
AutoScale.TotalMachinesCtrlByAutoscale オートスケールによって制御されるマシンの数を示します。 5
AutoScale.VerticalAutoscaleEnabledByDGandSite DGおよびサイトで Vertical Autoscale が有効になっているマシンの数を示します。 2
AutoScale.TaggedBasedAutoscaledDG タグベースのオートスケールされたデリバリーグループの数を示します。 2
DeliveryGroup.TotalRebootSchedulesEnabled Reboot Schedules が有効になっているデリバリーグループの数を示します。 2
DeliveryGroup.Total デリバリーグループの合計数を示します。 10
Policy.TotalPolicySets ポリシーセットの数を示します。 3
Policy.TotalPolicies グループポリシーの数を示します。 2
Policy.TotalPolicySettings グループ設定の数を示します。 2
PublishedPackageApps.AppVSingleAdmin AppVシングル管理者モードで公開されているパッケージ化されたアプリケーションの合計数を示します。 2
PublishedPackageApps.AppVDualAdmin AppVデュアル管理者モードで公開されているパッケージ化されたアプリケーションの合計数を示します。 2
PublishedPackageApps.Msix MSIXモードで公開されているパッケージ化されたアプリケーションの合計数を示します。 2
PublishedPackageApps.AppAttach AppAttachモードで公開されているパッケージ化されたアプリケーションの合計数を示します。 2
PublishedPackageApps.FlexApp FlexAppモードで公開されているパッケージ化されたアプリケーションの合計数を示します。 2

セッション

ヘッダー

Field Description Example
ver ライセンス使用状況イベントのバージョンを示します。 1
id 使用状況イベントの一意の識別子を示します。 d4ce7919-5d80-44de-a8fa-102923fe0ead
type Citrix Analytic Serviceがクラウド使用状況イベントを識別するために使用するイベントタイプを示します。 Cloud.Licensing
st イベントがブローカーで生成されたときのタイムスタンプを示します。 2011-08-12T20:17:46.384Z
prod
使用状況イベントの元の製品と展開を識別します。
XenDesktop.Broker (Cloud)
OnPrem.Broker (OnPrem)
prodVer Citrix DaaSまたはCitrix Virtual Apps and Desktopsの製品バージョンを示します。 7.25.0.0
user



セッション起動を開始するユーザーを一意に識別するユーザーIDを識別します。値はスクランブルされます。



fullName: C648FE671A44B3F7 (常にスクランブルされます)
samName:C758LH671A44B3F7 (常にスクランブルされます)
upn: C7948FE671A44B3F7 (常にスクランブルされます)
userLicenseId:C265FE671A44B3F7 (常にスクランブルされます)
userSid: C097FE671A44B3F7 (常にスクランブルされます)
tenant -> id Citrix Cloud™アカウントの顧客IDを示します。オンプレミス展開の場合、このフィールドは適用されず、値はありません。 joj1mh0598tj
dvc -> dvcId セッション起動が開始されたデバイスを一意に識別するデバイスIDを示します。 AE18C4D5
dvc -> dvcName デバイスのフレンドリー名を示します。値はスクランブルされます。 C758LH671A44B3F7 (常にスクランブルされます)

ペイロード

Field Description Example
appProtectionKeyLoggingRequired セッションがキーロギング保護を有効にして起動されたかどうかを示します。 False
appProtectionScreenCaptureRequired セッションが画面キャプチャ保護を有効にして起動されたかどうかを示します。 False
cspTenantCustomerId CSPテナントのCitrix Cloudアカウントの顧客IDを示します。オンプレミス展開の場合、このフィールドは適用されず、値はありません。 6c2vtxgxyftt
isAnonymousUser 認証されていないセッションが起動されたかどうかを示します。 False
licenseActivityTimeStamp ペイロードが生成されたときのタイムスタンプを示します。 2011-08-12T20:17:46.384Z
licenseActivityType ライセンスイベントタイプを示します。このフィールドは、ライセンスイベントタイプが割り当てアクションまたはリリースアクションのどちらであるかを示します。 Connect
licenseModel 展開のライセンスモデルを示します。 UserDevice
productEdition 展開の製品エディションを示します。 Premium
productId 展開内の製品の製品IDを示します。 CAVDS
protocol セッションの起動に使用されるプロトコルを示します。 HDX™
sessionKey セッションの一意の識別子を示します。 uq390c5fc3-86eb-4df3-bd9a-f4a8fed2c9e2
sessionSupport セッションサポートタイプを示します。 SingleSession
sessionType セッションタイプを示します。 Application
ver ペイロードバージョンを示します。 1.3
workerSid セッションに使用されるVDAの一意の識別子を示します。値はスクランブルされます。 1E5LH671A44B3F7 (常にスクランブルされます)
isWindows365 セッションがWindows 365用に起動されたかどうかを示します。 True
entitlementType 顧客のライセンスエンタイトルメントタイプを示します。 Production
siteId サイトの一意の識別子を示します。 a35647d0-901c-4477-87e0-dcd781d455f4
desktopGroupId デスクトップまたはデリバリーグループの一意の識別子を示します。 e9d859dc-1bfc-4b3e-bad3-41806bb4e694
clientType Citrix Workspace™アプリのタイプを示します。 Windows
clientVersion Citrix Workspaceアプリのバージョンを示します。 23.5.1.83
workerCloudType VDAプロビジョニングに使用されるパブリッククラウドタイプを示します。 Azure
enabledFeatures セッションで有効になっている機能を示します。たとえば、AppProtectionScreenCaptureRequiredSessionRecording が有効になっているセッションでは、このフィールドの値は 66 です。 66
launchRequestSource
起動要求に使用される製品を記録します。オンプレミス StoreFront™ または Cloud StoreFront のいずれかです。
0 (StoreFront or 3P)
1 (Workspace)
isEvents の重大な障害を示します。 Unable to create ST Database.
heartBeatTime CIS または Citrix Analytic Service へのライセンスサーバーのハートビート時間を示します。 1689058813
vdaTelemetry









App Layering、User Personalization Layer、User Profile management、Workspace Environment Management™、および HDX 機能でキャプチャされるペイロードを示します。









vdaTelemetry
SessionTelemetry
CPM_feature: 32
HDX1: 66
HDX2: 0
MachineTelemetry
AL_productVersion: 23.12.0.1001
UPL_isEnabled: 1
CPM_version: 22.3.4000
wem_enableMethod: 1
wem_agentVersion: 2402.1

Studio

使用状況

ヘッダー

フィールド 説明
ver ライセンス使用状況イベントのバージョンを示します。 1
id 使用状況イベントの一意の識別子を示します。 8c2e20a5-ca3f-4401-ad69-d037933c40a0
type Citrix Analytic Service がクラウド使用状況イベントを識別するために使用するイベントタイプを示します。 Studio.Usage
st Studio でイベントが生成されたときのタイムスタンプを示します。 2024-03-22T01:32:23.4056195Z
prod 使用状況イベントの元の製品と展開を識別します。 XenDesktop.Studio
prodVer Citrix DaaS/Citrix Virtual Apps and Desktops 製品バージョンを示します。 7.42.0.0

ペイロード

Field Description Example
AdminLoginList 一意の管理者SamAccountNameのリストを示します。値はスクランブルされています。 {AdminLoginList: [UFMJ+JvXOTHO9mQDsOweiw= =]}(常にスクランブルされます)
TotalApiRequests OrchestrationサービスのAPIリクエストを示します。 {TotalApiRequests: 1000}
BackupCount Studio管理者によって操作されたバックアップの数を示します。 {BackupCount: 200}
RestoreCount Studio管理者によって操作されたリストアの数を示します。 {RestoreCount: 20}

Director

使用状況レポート

ヘッダー

Field Description Example
ver ライセンス使用状況イベントのバージョンを示します。 1
id 使用状況イベントの一意の識別子を示します。 8c2e20a5-ca3f-4401-ad69-d037933c40a0
type Citrix Analytic Serviceがクラウド使用状況イベントを識別するために使用するイベントタイプを示します。 Telemetry
st Studioでイベントが生成されたときのタイムスタンプを示します。 2024-03-22T01:32:23.4056195Z
prod 使用状況イベントの発生元製品と展開を識別します。 XenApp.Monitor
prodVer Director製品のバージョンを示します。 7.42.0.0
dvcName サーバー名 C758LH671A44B3F7

ペイロード

Field Description Example
AdminLoginCount


これは、管理者のログイン数を提供するペイロードのセクションです。


type: AdminLogin
stats
          0: 1
                1: 7
FeatureUsageCount



このペイロードのセクションには、Directorで使用される主要機能の数が含まれています。



  type: FeatureUsage
         stats
                 0: 15
                 1: 20
                 5: 10
OdataUsageCount








このペイロードのセクションには、OData APIの使用状況の数が含まれています。








type: OData_v3
         stats
                 0: 1
                 2: 7
                 5: 9
 type: OData_v4
        stats
                0: 1
                2: 8
                6: 7
AppUsage




公開されたアプリケーションの週ごとの使用状況メトリックを示します。




type: AppUsage
    headers: applicationName,processName,totalDurationInMinutes
    period: 01/05/24-07/05/24
    values: [
        Calc_AWTSVDA-1907R,calc.exe,0.13,
        Notepad_AWTSVDA-1907R,notepad.exe,4]
UniqueAppUsers




公開されたアプリケーションの月ごとのユニークユーザー数と合計アプリケーション起動数を示します。




type: UniqueAppUsers
    headers: applicationName,totalLaunches,totalUniqueUsers
    period: 04/24
    values: [
        Calc_AWTSVDA-1907R,100,10,
        Notepad_AWTSVDA-1907R,200,20]
DesktopUsage



公開されたデスクトップの週ごとの使用状況メトリックを示します。



type: DesktopUsage
    headers: desktopGroupName,sessionSupport,totalDurationInMinutes
    period: 01/05/24-07/05/24
    values: [
        RdsDesktopAndAppGroup,1,10]
UniqueDesktopUsers



公開されたデスクトップの月ごとのユニークユーザー数と合計起動数を示します。



type: UniqueDesktopUsers
    headers: desktopGroupName,totalLaunches,totalUniqueUsers
    period: 04/24
    values: [
        RdsDesktopAndAppGroup,10,5]
AvgLogonDuration



平均ログオン時間を示します。



type: AvgLogonDuration
    headers: totalUserLogons, avgLogonDurationInSeconds
    period: 01/05/24-07/05/24
    values: [
        200,4]
CostSaved




顧客が1か月に節約したコストを示します。




type: CostSaved
    headers: hypervisor,costSaved,currency
    period: 04/24
    values: [
        1,221.02,1
        2,301.02,2]

StoreFront構成

使用状況

ヘッダー

Field Description Example
ver ライセンス使用状況イベントのバージョンを示します。 1.0
id 使用状況イベントの一意の識別子を示します。 d4ce7919-5d80-44de-a8fa-102923fe0ead
type CASがクラウド使用状況イベントを識別するために使用するイベントタイプを示します。 Configuration
st StoreFrontでイベントが生成されたときのタイムスタンプを示します。 2011-08-12T20:17:46.384Z
prod 使用状況イベントの発生元製品と展開を識別します。 OnPrem.StoreFront
prodVer StoreFrontのバージョン(内部)を示します。 3.30.0.0

ペイロード

Field Description Example
serverName StoreFrontが実行されているサービスのホスト名を示します。 storefront-01.storefront.local
deploymentId StoreFront展開の一意の識別子を示します。 f47ac10b-58cc-4372-a567-0e02b2c3d479
installedWithCVAD StoreFrontがCVADと同時にインストールされたかどうかを示します。 false
cpuCores CPUコアの総数を示します。 4
cpuModel StoreFrontを実行しているCPUを示します。 12th Gen Intel(R) Core(TM) i7-1255U 1.70 GHz
ramGb RAMの総容量(GB単位)を示します。 16
numServersInGroup サーバーグループ内のサーバー数を示します。 3
stores StoreFrontストア構成のJSONブロブを示します。Storeオブジェクトの配列です。一部の値はスクランブルされています。 Example
rfWebSites StoreFront RFWeb構成のJSONブロブを示します。RFWeb構成オブジェクトの配列です。 Example
gateways ゲートウェイ構成オブジェクトのJSONブロブを示します。ゲートウェイオブジェクトの配列です。 Example
authServices 認証サービス構成オブジェクトのJSONブロブを示します。認証サービスオブジェクトの配列です。 Example
IsPiiScrambled true

フィールド「stores」の例

[{
            "BaseUrl": "baseUrl",
            "StorePath": "/",
            "EnabledFeatures": 21 bit bitmap,
            "ResourceTypeFilteringEnabled": "disabled|Citrix.MPS.Application;Citrix.MPS.Desktop",
            "DefaultRfWebSite": "/Citrix/StoreWeb",
            "GatewaysUsed": [
                "gatewayId"
            ],
            "VdaLogonDataProvider": "",
            "ResourceFeeds": [
                {
                    "FeedName": "<resourceFeedName>|scrambled",
                    "Type": "CVAD",
                    "LoadBalancingEnabled": true,
                }
            ],
            "AdvancedAggregation": {
                 "Enabled": true,
                 "GroupingCount": 1,
                 "ControllersPushIdenticalResources": true,
                 "LoadBalanced": true,
                 "AnyPrimaryFarms": true,
                 "AnyBackupFarms": true,
            }
}]
<!--NeedCopy-->

ストアが見つからない場合、空の配列 [] になります。

フィールド「rfWebSites」の例

[{
    "SiteId": "siteId",
    "BaseUrl": "baseUrl",
    "StorePath": "storePath",
    "UiExperienced": 0,
    "EnabledFeatures": 9 bit,
    "AuthMethodsEnabled": [
        "ad"
    ],
    "CanUsersDownloadApps": {
        "Enabled": true,
        "Windows": "exe",
        "MacOS": "dmg"
    },
    "WorkspaceControl": {
        "Enabled": true,
        "LogoffAction": 0,
        "AutoReconnectAtLogon": true,
        "ShowReconnectButton": true,
        "ShowDisconnectButton": true
    },
    "MultiClickTimeout": 1,
    "UiViews": [
        "apps",
        "desktops"
    ],
    "DefaultTab": 0,
}]
<!--NeedCopy-->

rfWebSites が見つからない場合、空の配列 [] になります。

フィールド gateways の例

[{
            "GatewayId": "gatewayId",
            "IsCloudGateway": true,
            "LoadBalancingSTAEnabled": true,
            "SessionReliabilityEnabled": true,
            "RequestTicketsFromTwoSTA": true,
            "Version": "1234",
            "LogonType": "domain",
            "SmartCardFallbackEnabled": true
}]
<!--NeedCopy-->

gateways が見つからない場合、空の配列 [] になります。

フィールド authServices の例

[{
    "SiteId": "SiteId",
    "Store": "StoreAuth",
    "AuthMethodsEnabled": [
        "ad"
    ],
    "PasswordChangeWhenExpired": 0,
    "PasswordRemindersForm": 1,
    "DelegateCredentialValidationToCitrix": true,
    "ValidatePasswordsOnDeliveryControllers": true
}]
<!--NeedCopy-->

認証サービスが見つからない場合、空の配列 [] になります。

StoreFront ログイン

使用方法

ヘッダー

フィールド 説明
ver ライセンス使用状況イベントのバージョン 1.0
id 使用状況イベントの一意の識別子 d4ce7919-5d80-44de-a8fa-102923fe0ead
type CAS がクラウド使用状況イベントを識別するために使用するイベントタイプ Login
st Broker でイベントが生成されたときのタイムスタンプ 2011-08-12T20:17:46.384Z
prod 使用状況イベントの元の製品と展開を識別 OnPrem.StoreFront
prodVer StoreFront のバージョン (内部) 3.30.0.0

ペイロード

フィールド 説明
user



起動を開始したユーザー。値はスクランブルされます



fullName: C648FE671A44B3F7 (常にスクランブルされます)
samName:C758LH671A44B3F7 (常にスクランブルされます)
upn: C7948FE671A44B3F7 (常にスクランブルされます)
userLicenseId:C265FE671A44B3F7 (常にスクランブルされます)
userSid: C097FE671A44B3F7 (常にスクランブルされます)
serverName StoreFront が実行されているサービスのホスト名 storefront-01.storefront.local
loginMethodRfWeb ユーザーが RFWeb から StoreFront にログインするために使用した方法 0
loginMethodAuth ユーザーが認証サービスから StoreFront にログインするために使用した方法 0
gatewayURL ログイン中に使用された NetScaler Gateway netscaler-gateway.com
enabledFeatures 有効な機能のビットマスク 12
userAgent ログインに使用されたクライアントの UserAgent CitrixReceiver/22.11.0.19 Linux/5.17.15 X1Class CWACapable CWA/22.11.0.19
baseUrl ユーザーがログインするストア storefront-dev.storefront.dev
storePath ユーザーがログインするストア /Citirx/StoreWeb
apiUsed クライアントが Store または PNAgent API を使用しているかどうか 0
deviceId StoreFront へのログインに使用されるデバイス。値はスクランブルされます john-doe
transactionId 単一のトランザクション中に送信/生成されるトランザクション ID 773aba9e-5b91-4ef9-8782-c4afb75698e7

委任管理者

使用方法

ヘッダー

Key 説明
ver ライセンス使用状況イベントのバージョンを示します。 1
id 使用状況イベントの一意の識別子を示します。 8c2e20a5-ca3f-4401-ad69-d037933c40a0
type Citrix Analytic Serviceがクラウド使用状況イベントを識別するために使用するイベントタイプを示します。 DelegatedAdmin.Usage
st Delegated Adminでイベントが生成されたときのタイムスタンプを示します。 2024-03-22T01:32:23.4056195Z
prod
使用状況イベントの発生元となる製品と展開を識別します。
XenDesktop.DelegatedAdmin (Cloud)
OnPrem.DelegatedAdmin (OnPrem)
prodVer Citrix DaaSまたはCitrix Virtual Apps and Desktopsの製品バージョンを示します。 7.42.0.0

ペイロード

Key 説明
TotalCustomScopes カスタムスコープの総数を示します。 2
TotalCustomRoles カスタムロールの総数を示します。 4

ライセンス テレメトリー データのスクランブル

ライセンス テレメトリーで送信される情報の機密性を考慮し、Citrix はデータをスクランブルするオプションを提供します。

次の表に、スクランブルできるデータを示します。

フィールド 説明
user



セッション起動を開始するユーザーを一意に識別するユーザーID。



  • fullName: C648FE671A44B3F7
  • samName: C758LH671A44B3F7
  • upn: C7948FE671A44B3F7
  • userLicenseId: C265FE671A44B3F7
  • userSid: C097FE671A44B3F7
dvc -> dvcName デバイスのフレンドリ名。 C758LH671A44B3F7
workerSid セッションに使用されるVDAの一意の識別子。 1E5LH671A44B3F7
AdminLoginList 一意の管理者SamAccountNameのリスト。 {AdminLoginList: [UFMJ+JvXOTHO9mQDsOweiw= =]}
stores StoreFrontストア構成JSONブロブ。Storeオブジェクトの配列。一部の値はスクランブルされます
deviceId StoreFrontへのログインに使用されるデバイス。 john-doe

スクランブルを有効または無効にするには、Delivery Controllerで次のPowerShellコマンドを実行します。

注:

Citrix Service Provider™ (CSP) のお客様の場合、スクランブルは常に無効になっています。CSP のお客様は、PowerShell コマンドを使用してスクランブルを有効にすることはできません。

  1. Delivery ControllerホストからPowerShellウィンドウを開きます。
  2. asnp citrix コマンドを実行して、Citrix固有のPowerShellモジュールをロードします。
  3. スクランブルを有効または無効にするには、次のコマンドを実行します。

    デフォルトでは、値は 1 または true であり、ライセンス テレメトリー データのスクランブルが有効になります。

    無効にするには:

    Set-BrokerServiceConfigurationData Core.ScrambleLicensingData -SettingValue $false
    <!--NeedCopy-->
    

    スクランブルを無効にした後、次のコマンドを使用して有効にできます。

    Set-BrokerServiceConfigurationData Core.ScrambleLicensingData -SettingValue $true
    <!--NeedCopy-->
    
Citrix Virtual Apps and Desktops™ テレメトリーデータ要素