Product Documentation

GetConnectionFailureTrendsByTypeLatest

Nov 06, 2015

按类型获取从现在(UTC 服务器时间)开始的指定时间间隔数的连接故障次数列表,以及每种类型的趋势。趋势中的每个数据点表示在最后一个时间间隔(由 intervalLength 参数确定)内的连接故障总次数。可以指定用于限制查询的特定故障类型或获取所有故障类型。

参数名称 类型 备注
intervalLength int 趋势的数据点之间的时间间隔(以分钟为单位)。
numberOfIntervals int 请求数据点的数量。与 intervalLength 结合使用以计算 StartDate。
connectionFailureType int [ConnectionFailureType] 如果提供了此参数(值大于 0),结果中将仅返回此连接故障类型。否则(空值或 0 值),将返回所有故障类型列表。此整数与 ConnectionFailureType 枚举相对应。

返回结果

ConnectionFailureTrend 对象的 IQueryable,包含每个 ConnectionFailureType 的以下信息。

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

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

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

属性名称 类型 备注
ConnectionFailureType int [ConnectionFailureType] 连接故障类型(来自于枚举 ConnectionFailureType)。
FailureTrend List TrendItem 包含一个 UTC 日期 (DateTime) 和一个用于指定此故障类型在指定时间段内连接故障趋势的值(可为空值的双精度值)。
TotalFailureCount int 指定时间段的故障总数。
DesktopGroupBreakdown List DesktopGroupBreakdown 包含 DesktopGroup 对象(必须包含在扩展中才能返回)和计数 (int),用来表示指定时间段内的故障总数。

示例

按每分钟一个数据点检索过去 60 分钟内的交付组细分和故障趋势:

http://{dc-host}/Citrix/Monitor/OData/v1/Methods/GetConnectionFailureTrendsByTypeLatest?&intervalLength=1&numberOfIntervals=60&connectionFailureType=0&$expand=FailureTrend,DesktopGroupBreakdown,DesktopGroupBreakdown\DesktopGroup

仅检索过去 30 分钟内故障类型 4(无可用容量)的交付组细分

http://{dc-host}/Citrix/Monitor/OData/v1/Methods/GetConnectionFailureTrendsByTypeLatest?&intervalLength=1&numberOfIntervals=30&connectionFailureType=4&$expand=DesktopGroupBreakdown,DesktopGroupBreakdown\DesktopGroup

按每小时一个数据点检索过去 24 小时内所有故障类型的故障趋势:

http://{dc-host}/Citrix/Monitor/OData/v1/Methods/GetConnectionFailureTrendsByTypeLatest?&intervalLength=60&numberOfIntervals=24&connectionFailureType=0&$expand=FailureTrend