Sous-système d'utilisation
Les services du sous-système d'utilisation fournissent des statistiques d'exécution. Les informations suivantes peuvent être obtenues en utilisant les services de ce sous-système :
Le temps nécessaire (en millisecondes) à l'exécution d'un service (temps minimum, maximum et moyen)
Le nombre d'exécutions d'un service
Les services et abonnements JavaScript qui se sont terminés en raison d'un délai d'expiration. Consultez la section Statistiques relatives à l'exécution de scripts terminée en raison d'un délai d'expiration ci-dessous.
Temps nécessaire aux abonnements d'objets pour terminer l'exécution (temps minimum, maximum et moyen).
Taille de la mémoire (en octets) d'un abonnement d'objet si thisSub.JSONState est utilisé.
Les statistiques sont enregistrées à partir de l'heure à laquelle le serveur a été redémarré pour la dernière fois. Vous pouvez cependant les conserver en activant l'option Activer la persistance des statistiques. A l'aide du service WriteStatisticsReport, un fichier CSV contenant ces statistiques peut être créé dans le dossier ThingworxStorage.
* 
Les statistiques ne sont fournies que pour les services dont l'exécution est terminée. Un service dont l'exécution n'est pas arrivée à son terme ne sera pas inclus dans les statistiques.
Paramètre
Par défaut
Description
Activer les statistiques temporelles
false
Lorsque ce paramètre est activé, la plateforme collecte des statistiques. S'il est désactivé, aucune statistique liée aux services n'est consignée.
Activer les statistiques de taille de mémoire
false
Si ce paramètre est activé, la plateforme collecte des statistiques sur la taille de la mémoire. S'il est désactivé, aucune statistique liée aux services n'est consignée.
Activer la persistance des statistiques
false
Lorsque ce paramètre est activé et le serveur redémarré, toutes les statistiques d'exécution sont conservées. Les données sont conservées après le redémarrage de la plateforme.
* 
Il est recommandé d'utiliser l'option Activer la persistance des statistiques pour les données avec modifications peu fréquentes (par exemple, seulement quelques fois par jour) et où aucune valeur d'historique n'est requise. Veillez à ne pas utiliser l'option Activer la persistance des statistiques de façon excessive, car cela pourrait entraîner des performances médiocres.
Afficher les statistiques temporelles
true
Affiche les statistiques temporelles
Afficher les statistiques de taille de mémoire
false
Affiche les statistiques de taille de la mémoire
Activer l'agrégation du nom d'entité
true
Si plusieurs entités utilisent le même service, les statistiques agrégées des services sont affichées.
* 
L'activation de l'agrégation économise la mémoire. En la désactivant, vous risquez d'être confronté à des problèmes de performance. Si la mémoire devient trop volumineuse, exécutez le service ResetStatistics.
Afficher les centiles
false
Affiche des statistiques supplémentaires pour les centiles dans la table de configuration.
Services UtilizationStatistics
Service
Description
GetAuthenticationStatistics
Renvoie des données concernant le nombre d'authentifications pour un type d'authentification donné ainsi que leur résultat (réussite ou échec). Les types d'authentification incluent le formulaire de connexion, l'authentification HTTP de base, la clé d'application, l'authentification unique et les authentificateurs personnalisés.
GetEntityServiceStatistics
Renvoie le nombre minimum, maximum et moyen d'exécutions de services pour chaque entité.
* 
Si l'agrégation est activée, les données renvoyées pour un service couvrent toutes les entités.
GetEntityStatistics
Renvoie un ensemble de statistiques des services GetEntityServiceStatistics et GetEntitySubscriptionStatistics.
GetEntitySubscriptionStatistics
Renvoie les statistiques de temps et/ou de taille de mémoire (minimum, maximum, moyenne, nombre) pour l'exécution d'abonnements sur des événements d'entités.
GetPropertyVTQCount
Renvoie un décompte de propriétés compte tenu des critères de requête spécifiés. Pour plus d'informations, consultez la section Utilisation du service GetPropertyVTQCount.
GetQueryStatistics
Renvoie les statistiques des requêtes. Pour plus d'informations, consultez la rubrique Statistiques des requêtes.
GetStatistics
Renvoie toutes les statistiques des services GetEntityServiceStatistics, GetEntitySubscriptionStatistics et GetAuthenticationStatistics. Inclut le temps minimum, maximum et moyen, ainsi que le nombre pour chaque service exécuté. Les abonnements peuvent également inclure des statistiques de mémoire.
ResetAuthenticationStatistics
Réinitialise les statistiques d'authentification.
ResetEntityServiceStatistics
Réinitialise les statistiques des services d'entité.
ResetEntityStatistics
Réinitialise les statistiques des entités.
ResetQueryStatistics
Réinitialise les statistiques des requêtes. Pour plus d'informations, consultez la rubrique Statistiques des requêtes.
ResetStatistics
Réinitialise toutes les statistiques.
ResetEntitySubscriptionStatistics
Réinitialise les statistiques d'abonnement pour une entité.
WriteAuthenticationStatisticsReport
Génère un fichier CSV unique à l'emplacement suivant : ThingworxStorage/reports/UtilizationStatistics
WriteEntityServiceStatisticsReport
Génère un fichier CSV unique à l'emplacement suivant : ThingworxStorage/reports/UtilizationStatistics
WriteEntityStatisticsReport
Génère un fichier CSV unique à l'emplacement suivant : ThingworxStorage/reports/UtilizationStatistics
WriteEntitySubscriptionStatisticsReport
Génère un fichier CSV unique à l'emplacement suivant : ThingworxStorage/reports/UtilizationStatistics
WriteQueryStatisticsReport
Ecrit les statistiques des requêtes. Pour plus d'informations, consultez la rubrique Statistiques des requêtes.
WriteStatisticsReport
Génère un fichier CSV unique à l'emplacement suivant : ThingworxStorage/reports/UtilizationStatistics
Modèle de désignation des statistiques
Le modèle de désignation est le suivant :
Toutes les statistiques sont collectées sous le préfixe twx.stats.
Les statistiques d'authentification sont collectées sous le préfixe twx.stats.authentication.
Les statistiques d'entité sont collectées sous le préfixe twx.stats.entity.
Les statistiques des services d'entité sont collectées sous le préfixe twx.stats.entity.<nom de l'entité>.services.<nom du service>.
Les statistiques d'abonnement d'entité sont collectées sous les noms suivants : twx.stats.entity.<nom de l'entité>.subscriptions.<nom de l'abonnement>.
Les statistiques des requêtes sont collectées sous le préfixe twx.stats.query.
Les types de données des paramètres de désignation des services incluent les éléments suivants :
Préfixes : ajoutez un préfixe au début du service pour lequel vous souhaitez obtenir des statistiques. Par exemple, pour afficher uniquement les statistiques d'authentification, indiquez le préfixe twx.stats.authentication au service GetStatistics ou utilisez le service simplifié GetAuthententicationStatistics sans paramètres.
Expressions régulières : utilisables pour les services et les noms d'entité. Vous pouvez choisir d'afficher toutes les entités qui respectent le modèle d'expression régulière si l'option d'agrégation est désactivée. Vous pouvez également utiliser une expression régulière afin d'afficher certains services qui commencent par le mot Get. Le modèle d'expression régulière utilisé respecte le modèle Java, décrit à l'adresse https://docs.oracle.com/javase/8/docs/api/java/util/regex/Pattern.html.
Statistiques relatives à l'exécution de scripts terminée en raison d'un délai d'expiration
ThingWorx Platform arrête les scripts longs et consigne l'action dans le journal de la plateforme. ThingWorx Platform collecte également des statistiques sur l'arrêt de scripts provoqué par un délai d'expiration. Les statistiques sont enregistrées lorsque le temps d'exécution dépasse le délai d'expiration défini pour le script. La plateforme collecte les statistiques relatives aux services et aux abonnements écrits dans JavaScript.
* 
Par défaut, le délai d'expiration d'un script sur la plateforme ThingWorx est de 30 secondes. Dès lors qu'un script s'exécute plus longtemps que cela, la plateforme met fin à l'exécution. Un administrateur ThingWorx peut configurer le délai d'expiration des scripts dans la section des paramètres de base du fichier de configuration platform-settings.json. Consultez également la section Détails de la configuration du fichier platform-settings.json.
Les statistiques sont incluses dans les résultats à partir des services suivants du sous-système d'utilisation :
GetStatistics
GetEntityStatistics
GetEntityServiceStatistics
GetEntitySubscriptionStatistics
WriteStatisticsReport
WriteEntityStatisticsReport
WriteEntityServiceStatisticsReport
WriteEntitySubscriptionStatisticsReport
Les statistiques d'expiration des services sont indiquées selon le modèle de dénomination suivant :

twx.stats.entity.<entity-name>.services.<service-name>.timedout
De la même façon, les statistiques d'expiration des abonnements sont indiquées selon le modèle de dénomination suivant :

twx.stats.entity.<entity-name>.subscriptions.<subscription-name>.timedout
Grâce à ces statistiques timedout, il est possible de suivre le nombre de fois qu'un script a expiré ainsi que sa durée d'exécution.
Est-ce que cela a été utile ?