Product Documentation

GetConnectionFailureTrendsByType

Oct 21, 2016

Obtient une liste des nombres d'échec de connexion par type, avec une tendance pour chaque type, pour la période de temps spécifiée. Chaque point de données dans la tendance représente le nombre total d’échecs de connexion dans le dernier intervalle (paramètre intervalLength). Permet de spécifier un type d'échec particulier pour limiter la requête ou obtenir tous les types d'échec.

Nom de paramètre Type Commentaires
startDate DateTime Début de la fenêtre de temps à interroger pour la tendance d'échec de connexion. Doit être UTC.
endDate DateTime Fin de la fenêtre de temps à interroger pour la tendance d'échec de connexion. Doit être UTC.
intervalLength Int Intervalle entre les points de données en minutes pour la tendance.
connectionFailureType Int [ConnectionFailureType] Si fourni (> 0), retourne uniquement ce type d'échec de connexion dans les résultats. Sinon, (une valeur nulle ou égale à zéro) retourne une liste de tous les types d'échec. Ce nombre entier correspond à une enum ConnectionFailureType.

Retours

Un IQueryable des objets ConnectionFailureTrend qui contiennent les informations suivantes pour chaque ConnectionFailureType.

Si tous les types sont requis, la somme est alors également retournée avec ConnectionFailureType = -1

Si $expand=FailureTrend est inclus dans la requête, la tendance et les propriétés TotalFailureCount sont alors récupérées pour chaque type d'échec.

Si $expand=DesktopGroupBreakdown est inclus dans la requête, cette propriété est également récupérée pour chaque type d'échec.

Nom de la propriété Type Commentaires
ConnectionFailureType int [ConnectionFailureType] Type d'échec de connexion (depuis l'enum ConnectionFailureType).
FailureTrend List TrendItem contient une date UTC (DateTime), et une valeur (double nullable) pour indiquer la tendance des échecs de connexion pendant la période spécifiée pour ce type d'échec.
TotalFailureCount int Nombre total d'échecs pendant la période spécifiée.
DesktopGroupBreakdown List DesktopGroupBreakdown contient un objet DesktopGroup (doit être inclus dans le développement pour être retourné) et Count (int) représente le nombre total d’échecs dans la fenêtre de temps spécifiée.

Exemples

Récupérez les défaillances des groupes de mise à disposition et la tendance d'échec pour tous les types d'échec du 14 novembre à 5 heures du matin (UTC) au 14 novembre à 7 heures du matin (UTC) avec un point de données toutes les 30 minutes :

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

Récupérez la défaillance du groupe de mise à disposition uniquement pour le type de défaillance 4 (aucune capacité disponible) du 14 novembre à 5 heures du matin (UTC) au 14 novembre à 7 heures du matin (UTC)

http://{dc-host}/Citrix/Monitor/OData/v1/Methods/GetConnectionFailureTrendsByType?startDate=datetime'2011-11-14T05:00:00'&endDate=datetime'2011-11-14T07:00:00'&connectionFailureType=4&$expand=DesktopGroupBreakdown,DesktopGroupBreakdown\DesktopGroup

Récupérez la tendance d'échec pour tous les types de défaillance du 14 novembre à minuit (UTC) au 14 novembre à 11 heures du soir (UTC) avec un point de données toutes les heures :

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