Product Documentation

GetMachineFailureTrendsByType

Nov 17, 2015

Obtiene una lista de fallos de máquina y recuentos correctos por tipo, junto con una tendencia para cada tipo, del período de tiempo especificado. Cada punto de datos de la tendencia representa la cantidad total de máquinas en un estado fallido en el último intervalo (parámetro intervalLength). Puede especificar un tipo de fallo determinado para limitar la consulta u obtener todos los tipos de fallo.

Nombre del parámetro Escriba Comentarios
startDate DateTime Inicio de la ventana de tiempo que se va a consultar para la tendencia de los fallos de máquina. Debe ser UTC. No es necesario si no se obtienen tendencias.
endDate DateTime Fin de la ventana de tiempo que se va a consultar de la tendencia de los fallos de máquina. Debe ser UTC.
intervalLength int Intervalo entre puntos de datos en minutos de la tendencia.
machineFailureType int (MachineFailureType) Si se proporciona (>0), devuelve solo ese tipo de fallo de máquina en los resultados. De lo contrario (null o cero), devuelve una lista de todos los tipos de fallo. Este número entero corresponde a la enumeración MachineFailureType.
sessionSupport int (SessionSupport) Enteros que aceptan valores null. Si no se proporciona, devuelve todos los tipos de sessionSupport. Única=1, Múltiple=2, Desconocida=0

Devuelve

Un IQueryable de objetos MachineFailureTrend que contiene la siguiente información para cada MachineFailureType.

Si se solicitan todos los tipos, la suma también se devuelve con MachineFailureType=-1

Si $expand=FailureTrend se incluye en la consulta, la tendencia y las propiedades TotalFailureCount se recuperan para cada tipo de fallo.

Si $expand=DesktopGroupBreakdown se incluye en la consulta, esa propiedad también se recupera para cada tipo de fallo.

Nombre de propiedad Escriba Comentarios
MachineFailureType int [MachineFailureType] Tipo de fallo de conexión (consulte: Determinación de los valores de enumeración).
TotalFailureCount int Número total de fallos en el endDate especificado.
FailureTrend List TrendItem contiene una propiedad UTC Date (DateTime) y una propiedad Count (double) para indicar la tendencia de los fallos de máquina durante el período de tiempo especificado de este tipo de fallo.
DesktopGroupBreakdown List DesktopGroupBreakdown contiene un objeto DesktopGroup y un Count (int) para representar la cantidad total de máquinas en un estado de fallo en el endDate especificado.

Ejemplos

Recuperar el desglose de los grupos de entrega y la tendencia de los fallos de todos los tipos de fallo de máquina desde el 14 de noviembre a las 5:00 h (UTC) hasta el 14 de noviembre a las 7:00 h (UTC), con un punto de datos cada 30 minutos para todas las máquinas con sistema operativo de servidor (es decir, sessionSupport=2):

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

Recuperar el desglose de los grupos de entrega solo del tipo de fallo de máquina n.º 3 (Atascadas en el arranque) desde el 14 de noviembre a las 5:00 h (UTC) hasta el 14 de noviembre a las 7:00 h (UTC) para las máquinas con sistema operativo de escritorio:

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

Recuperar la tendencia de los fallos de todos los tipos de fallo de máquina y de todos los tipos de sesión de máquina desde el 14 de noviembre a las 0:00 h (UTC) hasta el 14 de noviembre a las 23:00 h (UTC) con un punto de datos cada hora:

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