产品文档
Citrix Analytics for Performance™
查看 PDF

会话事件的数据结构

December 19, 2025
投稿者: 
C C

会话维度数据源

会话元数据 类型 可为空 描述 值
sessionKey GUID 否 虚拟应用或桌面会话的标识符。  
userId 字符串 否 虚拟应用或桌面会话的用户 AD 标识符。  
userName 字符串 否 启动虚拟应用或桌面会话的用户的名称。  
deliveryGroupId GUID 否 交付组标识符  
deliveryGroupName 字符串 否 交付组名称  
siteId GUID 否 Citrix Virtual Apps and Desktops™ 站点标识符  
siteName 字符串 否 Citrix Virtual Apps and Desktops 站点名称  
machineId GUID 否 启动会话的计算机的计算机标识符。  
machineSid GUID 否 启动会话的计算机的计算机 AD 标识符。  
machineName 字符串 否 启动会话的计算机的名称。  
sessionLaunchStatus 字符串 否 会话启动状态 0（启动成功）、1（会话失败）、2（用户终止）
sessionStartTime 时间戳 否 会话启动时间 值格式为 “yyyy-MM-ddTHH:mm:ss”
protocol 字符串 是 用于启动会话的协议 HDX™、RDP、Console
sessionType 整数 是 会话类型 值映射为：0: 桌面、1: 应用程序
sessionEndTime 时间戳 是 会话结束时间 值格式为 “yyyy-MM-ddTHH:mm:ss”
stateChangedTime 时间戳 是 会话状态更改的时间 值格式为 “yyyy-MM-ddTHH:mm:ss”
sessionState 字符串 否 会话生命周期状态 值映射为：0: 未知、1: 已连接、2: 已断开连接、3: 已终止、4: 正在准备会话、5: 活动、6: 正在重新连接、7: 非代理会话、8: 其他、9: 待定
sessionLaunchType 字符串 否 会话启动类型 ICA®、ConnectionLease
endpointOS 字符串 是 Citrix Workspace™ 应用 - 操作系统类型 可能的值包括（例如）：Windows、Unix 或 Linux、HTML5、Macintosh、ThinOS、iOS、Chrome 和 Android。但是，操作系统类型可以包含更多选项。
endpointReceiverVersion 字符串 否 Citrix Workspace 应用版本  
endpointLocationContinent 字符串 否 启动会话的洲。  
endpointLocationCountry 字符串 否 启动会话的国家/地区。  
endpointLocationCity 字符串 否 启动会话的城市。  
endpointLocationLatitude 字符串 否 启动会话的纬度。  
endpointLocationLongitude 字符串 否 启动会话的经度。  
endpointLocationTimezone 字符串 否 启动会话地点的时区。  
isp 字符串 是 启动会话所使用的 ISP。  
gatewayFQDN 字符串 是 启动会话所通过的网关 FQDN。  
vdaIP 字符串 是 启动会话的 VDA 的 IP。  
connectionType 字符串 是 从 Citrix Workspace 应用建立的连接类型 内部、外部
connectionViaAG 字符串 是    
networkInterfaceType 字符串 否 端点设备的网络接口类型 Wi-Fi、以太网等
failureReason







整数







否







发生错误的故障类别







0 - “无”
1 - “客户端连接失败”
2 - “计算机故障”
3 - “无可用容量”
4 - “无可用许可证”
5 - “配置”
6 - “通信故障”
100 - “黑洞 VDA”
101 - “僵尸会话”
failureCode




























整数




























否




























指定故障类型




























0 - “未知错误”
1 - “无故障”
2 - “会话准备失败”
3 - “注册超时”
4 - “连接超时”
5 - “许可证不可用”
6 - “票证失败”
7 - “未知故障”
8 - “一般故障”
9 - “资源处于维护模式”
10 - “应用程序已禁用”
11 - “所需功能未获得许可”
12 - “VDA 不可用”
13 - “VDA 已在使用中”
14 - “请求的协议不允许”
15 - “资源不可用”
16 - “活动会话重新连接已禁用”
17 - “找不到要重新连接的会话”
18 - “VDA 启动失败”
19 - “会话被拒绝”
20 - “设置配置失败”
21 - “已达到应用程序的总并发使用限制”
22 - “已达到应用程序的每用户使用限制”
23 - “VDA 无法联系”
24 - “已达到每台计算机的使用限制”
25 - “已达到每个授权的使用限制”
51 - “端点到计算机通信错误”
52 - “网关到计算机通信错误”
100 - “VDA 不可用”
101 - “VDA 不工作”
failureReasonString 字符串 是 failureReasonString 映射到 failureReason 的字符串值。  
failureCodeString 字符串 是 failureCodeString 映射到 failureCode 的字符串值。  
sessionScore 整数 否 基于性能因素的会话体验分数 -1–100
userScore 整数 否 根据会话体验和故障率计算的用户体验分数。 0 -100
icaRtt 整数 否 会话响应能力（以毫秒为单位），定义了过去 15 分钟内 ICA 会话的平均往返时间。 >= 0
icaRttScore 整数 否 IcaRtt（会话响应能力）分数是根据当前的 IcaRtt 值以及与该指标基线阈值的偏差计算的。 0–100
reconnects 整数 否 过去 15 分钟内发生的自动重新连接次数。 >= 0
reconnectScore 整数 否 reconnectScore（会话弹性）分数是根据当前的自动重新连接次数以及与该指标基线阈值的偏差计算的。 0–100
logonDuration 小数 否 此会话的总登录持续时间（会话的总初始化时间），以秒为单位。  
brokeringDuration 小数 是 代理在初始化会话时花费的总时间，以秒为单位。  
vmStartDuration 小数 是 登录过程中启动 VM 所花费的总时间，以秒为单位。  
hdxConnectionDuration 小数 是 登录过程中 HDX 连接所花费的总时间，以秒为单位。  
authenticationDuration 小数 是 登录过程中身份验证所花费的总时间，以秒为单位。  
gpoDuration 小数 是 登录过程中 GPO 处理所花费的总时间，以秒为单位。  
logonScriptsDuration 小数 是 登录过程中登录脚本处理所花费的总时间，以秒为单位。  
profileLoadDuration 小数 是 登录过程中配置文件加载所花费的总时间，以秒为单位。  
interactiveSessionsDuration 小数 是 初始化交互式会话（包括 shell 初始化时间）所花费的总时间，以秒为单位。  
logonDurationScore 整数 否 logonDuration 分数是根据当前的 logonDuration 值以及与该指标基线阈值的偏差计算的。 0–100
gpoScore 整数 否 GPO 分数是根据当前的 GPO 值以及与该指标基线阈值的偏差计算的。 0–100
profileLoadScore 整数 否 profileLoad 分数是根据当前的 profileLoadDuration 值以及与该指标基线阈值的偏差计算的。 0–100
interactiveSessionScore 整数 否 interactiveSession 分数是根据当前的 interactiveSessionDuration 值以及与该指标基线阈值的偏差计算的。 0–100
brokeringScore 整数 否 代理分数是根据当前的 brokeringDuration 值以及与该指标基线阈值的偏差计算的。 0–100
vmStartScore 整数 否 vmStart 分数是根据当前的 vmStartDuration 值以及与该指标基线阈值的偏差计算的。 0–100
hdxConnectionScore 整数 否 hdxConnection 分数是根据当前的 hdxConnectionDuration 值以及与该指标基线阈值的偏差计算的。 0–100
authenticationScore 整数 否 authentication 分数是根据当前的 authenticationDuration 值以及与该指标基线阈值的偏差计算的。 0–100
logonScriptsScore 整数 否 logonScripts 分数是根据当前的 logonScriptsDuration 值以及与该指标基线阈值的偏差计算的。 0–100
profileSize 整数 是 用户的总配置文件大小。 > 0
totalFileCount 整数 是 该配置文件中的文件总数。 > 0
largeFileCount 整数 是 该配置文件中的大文件总数。 > 0
failureScore 整数 否 根据过去 15 分钟内故障次数与会话启动次数的比例计算。 0–100
failureCount 整数 否 过去 15 分钟内发生的总故障数。 >= 0
launchAttempts 整数 否 过去 15 分钟内尝试启动的总次数。 >=0
machineFailureCount 整数 否 计算机故障总数。 >=0
clientConnectionFailureCount 整数 否 客户端连接故障总数。 >=0
capacityFailureCount 整数 否 容量故障总数。 >=0
configurationFailureCount 整数 否 配置故障总数。 否
licenseFailureCount 整数 否 许可证故障总数。 >=0
communicationFailureCount 整数 否 通信故障总数。 >=0
inputBandwidthAvailable 整数 是 过去 15 分钟内 ICA 会话消耗的平均输入带宽。 >=0
inputBandwidthConsumed 整数 是 过去 15 分钟内 ICA 会话消耗的平均输入带宽。 >=0
outputBandwidthAvailable 整数 是 过去 15 分钟内平均可用输出带宽。 >=0
outputBandwidthUsed 整数 是 过去 15 分钟内平均使用的输出带宽。 >=0
networkLatency 整数 是 过去 15 分钟内 ICA 会话的平均网络延迟。 >=0
endpointLinkSpeed 整数 是 端点设备网络接口（如 Wi-Fi、以太网）的链路速度 >=0
endpointSignalStrength 整数 是 端点设备的信号强度。 >=0
avgEndpointThroughputBytesReceived 整数 是 网络接口上接收的总字节数。 >=0
avgEndpointThroughputBytesSent 整数 是 网络接口上发送的总字节数。 >=0
wanLatency 整数 是 此子因素是衡量从虚拟机到网关的延迟。高 WAN 延迟表示端点计算机网络运行缓慢。当用户在地理位置上离网关越远时，WAN 延迟会增加。 >=0
dcLatency 整数 是 此子因素是衡量从 Citrix Gateway 到服务器 (VDA) 的延迟。高数据中心延迟表示服务器网络缓慢导致的延迟。此指标仅在本地网关加入 CAS 时可用。 >=0
hostDelay 整数 是 此子因素衡量服务器操作系统引起的延迟。高 ICA RTT、低数据中心和 WAN 延迟以及高主机延迟表示主机服务器上存在应用程序错误。 >=0
wanLatencyScore 整数 否 WAN 延迟分数是根据 wanLatency 值以及与相同指标基线阈值的偏差计算的。 0–100
dcLatencyScore 整数 否 DC 延迟分数是根据 dcLatency 值以及与相同指标基线阈值的偏差计算的。 0–100
hostDelayScore 整数 否 主机延迟分数是根据主机延迟值以及与相同指标基线阈值的偏差计算的。 0–100
会话事件的数据结构
December 19, 2025
投稿者: 
C C
December 19, 2025
投稿者: 
C C

在本文中

站点反馈 | Your privacy choices footer link您的隐私选择 | 隐私和法律条款 | Cookie 首选项 | 同意设置 | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.