Product Documentation

GetConnectionFailureTrendsByTypeLatest

Oct 21, 2016

Obtient une liste du nombre d'échecs de connexion par type, avec une tendance pour chaque type, pour le nombre d'intervalles spécifiés (temps serveur UTC). 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
intervalLength int Intervalle entre les points de données en minutes pour la tendance.
numberOfIntervals int Nombre de points de données requis. Utilisé avec intervalLength pour calculer StartDate.
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 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 la répartition des groupes de mise à disposition et la tendance d'échec pour les dernières 60 minutes avec un point de données toutes les minutes :

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

Récupérez la répartition des groupes de mise à disposition uniquement pour le type d'échec 4 (aucune capacité disponible) pour les dernières 30 minutes

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

Récupérez la tendance d'échec pour tous les types d'échec pour les dernières 24 heures avec un point de données toutes les heures :

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