Product Documentation

GetMachineFailureTrendsByType

Nov 06, 2015

按类型获取指定时间段内的计算机故障和成功次数列表,以及每种类型的趋势。趋势中的每个数据点表示在最后一个时间间隔(由 intervalLength 参数界定)内处于故障状态的计算机总数。可以指定某个特定的故障类型以限制查询,或者获取所有故障类型。

参数名称 类型 备注
startDate DateTime 要查询其计算机故障趋势的时间段的起始时间。必须采用 UTC 时间。如果不提取趋势,则不需要。
endDate DateTime 要查询其计算机故障趋势的时间段的结束时间。必须采用 UTC 时间。
intervalLength int 趋势的数据点之间的时间间隔(以分钟为单位)。
machineFailureType int (MachineFailureType) 如果提供了此参数(值大于 0),结果中将仅返回此计算机故障类型。否则(空值或 0 值),将返回所有故障类型列表。此整数与 MachineFailureType 枚举相对应。
sessionSupport int (SessionSupport) Nullable int。如果没有提供,则返回所有 sessionSupport 类型。Single=1,Multiple=2,Unknown=0

返回结果

MachineFailureTrend 对象的 IQueryable,包含每个 MachineFailureType 的以下信息。

如果请求所有类型,则将返回总和及 MachineFailureType = -1。

如果查询中包含 $expand=FailureTrend,则会检索每种故障类型的趋势和 TotalFailureCount 属性。

如果查询中包含 $expand=DesktopGroupBreakdown,还会检索每种故障类型的此属性。

属性名称 类型 备注
MachineFailureType int [MachineFailureType] 连接故障类型(请参阅:确定枚举值)。
TotalFailureCount int 在指定的 endDate 发生的故障总数。
FailureTrend List TrendItem 包含一个 UTC 日期 (DateTime) 和一个用于指示此故障类型在指定时间段内的计算机故障趋势的计数 (double)。
DesktopGroupBreakdown List DesktopGroupBreakdown 中包含 DesktopGroup 对象和计数 (int)。计数 (int) 表示在指定 endDate 处于故障状态的计算机总数。

示例

针对所有服务器操作系统计算机(即 sessionSupport =2),按每 30 分钟一个数据点检索 11 月 14 日上午 5 点 (UTC) 到 11 月 14 日上午 7 点 (UTC) 时间段内所有计算机故障类型的交付组细分和故障趋势:

http://{dc-host}/Citrix/Monitor/OData/v1/Methods/GetMachineFailureTrendsByType?startDate=datetime'2011-11-14T05:00:00'&endDate=datetime'2011-11-14T07:00:00'&intervalLength=30&machineFailureType=0&sessionSupport=2&$expand=FailureTrend,DesktopGroupBreakdown

针对桌面操作系统计算机按交付组细分进行检索。检索仅针对计算机故障类型 3(启动时卡住),时间跨度从 11 月 14 日上午 5 点 (UTC) 到 11 月 14 日上午 7 点 (UTC):

http://{dc-host}/Citrix/Monitor/OData/v1/Methods/GetMachineFailureTrendsByType?startDate=datetime'2011-11-14T05:00:00'&endDate=datetime'2011-11-14T07:00:00'&machineFailureType=3&sessionSupport=1&$expand=FailureTrend

对所有计算机会话类型的所有故障类型,按故障趋势进行检索。时间跨度从 11 月 14 日午夜 12 点 (UTC) 到 11 月 14 日晚上 11 点 (UTC),每小时采集一个数据点:

http://{dc-host}/Citrix/Monitor/OData/v1/Methods/GetMachineFailureTrendsByType?startDate=datetime'2011-11-14T00:00:00'&endDate=datetime'2011-11-14T23:00:00'&intervalLength=60&machineFailureType=0&$expand=FailureTrend