Product Documentation

GetMachineFailureTrend

Nov 06, 2015

获取指定时间段内的并发计算机故障趋势。趋势中的每个数据点表示在最后一个时间间隔(由 intervalLength 参数界定)内任意时间发生故障的最大计算机数。通过指定特定计算机故障类型,可以限制查询,或者获取所有故障类型。

参数名称 类型 备注
startDate DateTime 要查询其连接故障趋势的时间段的起始时间。必须采用 UTC 时间。
endDate DateTime 要查询其连接故障趋势的时间段的结束时间。必须采用 UTC 时间。
intervalLength int 趋势的数据点之间的时间间隔(以分钟为单位)。
desktopGroupsFilter 字符串 限制趋势结果的交付组 UID 列表(以逗号分隔)。
machineFailureTypeFilter 字符串 限制趋势结果的连接故障类型整数列表(以逗号分隔)。此整数与 MachineFaultStateCode 枚举相对应。如果未提供,返回此趋势中汇总的所有类型。
sessionSupportFilter int 限制趋势结果的计算机类型整数列表,以逗号分隔 (Single=1, Multiple=2, Unknown=0)。没有值能返回所有类型

返回结果

TrendItem 对象列表 (FailureTrend)。

属性名称 类型 备注
FailureTrend List TrendItem 包含一个 UTC 日期 (DateTime) 和一个用于指示指定过滤器在指定时间段内的计算机故障趋势的故障计数 (int)。

示例

获取 24 小时内指定桌面操作系统计算机类型的两个交付组所有类型的计算机故障的趋势(每 15 分钟采集一个数据点)。

http://{dc-host}/Citrix/Monitor/OData/v1/Methods/GetMachineFailureTrend?start=datetime'2011-09-30T00:00:00'&end=datetime'2011-10-01T00:00:00'intervalLength=15&sessionSupportFilter='1'&desktopGroupsFilter='04D53BBE-F5CC-11E0-B401-3F054824019B,0FBEFBBE-F5CC-11E0-9472-40054824019B'

获取 24 小时内所有交付组和会话类型,以及类型为“启动失败”和“启动时卡住”的计算机故障的趋势(每 2 小时采集一个数据点)。

http://{dc-host}/Citrix/Monitor/OData/v1/Methods/GetMachineFailureTrend?start=datetime'2011-09-23T00:00:00'&end=datetime'2011-10-01T00:00:00'intervalLength=240&machineFailureTypeFilter='2,3'