机器事件的数据结构

Last published : Nov 04, 2026

机器维度数据源

机器元数据 类型 可为空 描述 值
machineId GUID 是 机器标识符。
machineSid GUID 否 机器 AD 标识符。
machineName 字符串 否 用户定义的计算机名称。
machineIP 字符串 是 计算机的 IP 地址。
operatingSystem 字符串 否 计算机的操作系统。
deliveryGroupId GUID 否 交付组标识符。
deliveryGroupName 字符串 否 交付组名称。
siteId GUID 否 Citrix Virtual Apps and Desktops™ 站点标识符。
siteName 字符串 否 Citrix 虚拟应用和桌面 站点名称
machineProvisioningType 整数 否 描述计算机的预配方式 0: 未知, 1: MCS - 由 Machine Creation Services™ 预配的计算机(计算机必须是 VM), 2: PVS - 由 Provisioning Services 预配的计算机(可能是物理机、刀片服务器、VM), 3: Manual - 无自动化预配
hypervisorName 字符串 否 管理程序的名称
hypervisorId GUID 否 管理程序的唯一标识符
catalogName 字符串 否 目录代理名称
catalogId GUID 否 目录的唯一标识符
agentVersion 字符串 否 计算机上安装的 VDA 版本
hostedMachineName 字符串 是
hostingServerName 字符串 是
sessionSupport 字符串 否 指定目录中计算机的会话支持类型 1:单会话,2:多会话
状态 整数 否 计算机在过去 15 分钟内的最后已知状态 1:未注册,2:已注册,3:维护中,4:失败,5:已关机
statusChangeTime 时间戳 否 计算机状态在过去 15 分钟内发生变化的时间 值格式为“yyyy-MM-ddTHH: mm:ss.SSSZ”
machineActualStatus 整数 否 根据过去 15 分钟内发生的多次状态转换计算的机器状态。如果机器从注册状态变为未注册状态,则 machineActualStatus 为未注册。 1: 未注册, 2: 已注册, 3: 失败
machineFailureReason 字符串 是 机器进入失败状态的原因 故障未知
无故障(机器正常)
机器上次开机操作失败
机器开机后似乎未启动(VM 工具未转换为运行状态)
机器未在预期时间内注册,或其注册已被拒绝
机器报告其已达到最大容量
machineFailureType 字符串 是 值可以是以下任意一种: "Unknown", "None", "FailedToStart", "StuckOnBoot", "Unregistered", "MaxCapacity
machinePowerState 整数 否 表示机器电源状态 0: 未知
1: 不可用
2: 关闭
3: 开启
4: 已暂停
5: 正在开机
6: 正在关机
7: 暂停
8: 恢复
9: 未管理
10: 不支持
unregisteredStartTime 时间戳 是 机器进入未注册状态的时间 值格式为“yyyy-MM-ddTHH:mm:ss”
unregisteredEndTime 时间戳 是 机器从未注册状态退出的时间 值格式为“yyyy-MM-ddTHH:mm:ss”
isMaintenanceMode 布尔值 是 一个布尔标志,指示机器是否处于维护模式 0: 真, 1: 假
isUnregistered 布尔值 是 一个布尔标志,指示机器是否处于未注册状态 0: 真, 1: 假
machineFailureTime 时间戳 是 机器进入故障状态的时间 任何日期时间值
cpuSpikesCount 整数 是 表示在过去 15 分钟的间隔内,CPU 利用率超过 80% 的 CPU 阈值并持续 5 分钟或更长时间的次数。
usedMemory 小数 否 已用内存(字节)
totalMemory 整数 否 总可用内存(字节)
percentCpu 整数 否 机器上 CPU 的平均使用百分比
ramSpikeCount 整数 是 表示内存消耗超过 80% 内存阈值的次数。此外,在过去 15 分钟的间隔内持续了 5 分钟或更长时间。
sessionCount 整数 是 在过去 15 分钟内,在该机器上启动的会话总数(成功 + 失败)。
downTime 整数 是 以秒为单位计算的机器总停机时间。
consecutiveMachineFailure 整数 是 在过去 15 分钟的间隔内,机器上已知的连续故障。
activeSessionCount 整数 是 过去 15 分钟内某个时间间隔内的活动会话数。
successfulSessionCount 整数 否 过去 15 分钟内某个时间间隔内启动的成功会话数。
machineFailureOccurred 整数 是 过去 15 分钟内某个时间间隔内计算机上发生的会话失败。
unRegistrationCount 整数 否 机器在过去15分钟的间隔内进入注册状态的次数。