会话事件的数据结构

Last published : Nov 04, 2026
Related information
数据导出到可观测性平台（预览版）

会话维度数据源

会话元数据 类型 可为空 描述 值
sessionKey GUID 否 虚拟应用程序或桌面会话的标识符。
userId 字符串 否 虚拟应用程序或桌面会话的用户 AD 标识符。
userName 字符串 否 启动了虚拟应用程序或桌面会话的用户的名称。
deliveryGroupId GUID 否 交付组标识符
deliveryGroupName 字符串 否 交付组名称
siteId GUID 否 Citrix Virtual Apps and Desktops™ 站点标识符
siteName 字符串 否 思杰虚拟应用和桌面站点名称
machineId GUID 否 启动会话的计算机的计算机标识符。
machineSid GUID 否 启动会话的计算机的计算机 AD 标识符。
machineName 字符串 否 启动会话的机器名称。
sessionLaunchStatus 字符串 否 会话启动状态 0（成功启动）、1（会话失败）、2（用户终止）
sessionStartTime 时间戳 否 会话启动时间 值格式为“yyyy-MM-ddTHH:mm:ss”
协议 字符串 是 启动会话所使用的协议 HDX™、RDP、控制台
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 整数 否 会话响应能力（以毫秒为单位），定义了 ICA 会话在过去 15 分钟间隔内的平均往返时间。 >= 0
icaRttScore 整数 否 IcaRtt（会话响应能力）分数是根据当前的 IcaRtt 值以及与该指标基线阈值的偏差计算的。 0–100
重新连接次数 整数 否 在过去 15 分钟间隔内发生的自动重新连接次数。 >= 0
reconnectScore 整数 否 reconnectScore（会话弹性）分数是根据当前自动重新连接的次数以及与该指标基线阈值的偏差计算的。 0–100
logonDuration 小数 否 此会话的总登录持续时间（会话的总初始化时间），以秒为单位。
brokeringDuration 小数 是 Broker 初始化会话所花费的总时间，以秒为单位。
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 整数 否 身份验证分数是根据当前的 authenticationDuration 值以及与该指标基线阈值的偏差计算得出的。 0–100
logonScriptsScore 整数 否 登录脚本分数是根据当前的 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 整数 是 ICA 会话在过去 15 分钟内的平均网络延迟。 >=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