[Introduction]

La famille InterSystems IRIS a un utilitaire intéressant : ^SystemPerformance (aussi connu comme ^pButtons pour Caché et Ensemble) qui génère les informations sur les performances de la base de données dans un fichier HTML lisible. Lorsque vous exécutez ^SystemPerformance sur IRIS pour Windows, un fichier HTML est créé dans lequel notre propre journal de performances mgstat et notre journal de performances Windows sont inclus.

^SystemPeformance génère un excellent rapport, cependant, vous devez extraire manuellement les sections du journal d'un fichier HTML et les coller dans un éditeur de feuille de calcul comme Excel pour créer un graphique visuel des performances. De nombreux développeurs partagent déjà des conseils et des utilitaires utiles pour le faire ici (à voir: un excellent article de la communauté des développeurs rédigé par  @Murray.Oldfield )

Maintenant, je présente un nouvel utilitaire ^mypButtons!

[Quoi de neuf par rapport aux autres outils]

(Charger mypButtons.mac depuis OpenExchange)

• ^mypButtons combine les journaux de performances mgstat et Windows sur une seule ligne. Par exemple, vous pouvez créer un graphique incluant à la fois « PhyWrs » (mgstat) et « Disk Writes/sec » (Win perfmon) dans la même période.  
• ^mypButtons lit plusieurs fichiers HTML à la fois et génère un seul fichier CSV combiné.
• ^mypButtons génère un seul fichier CSV sur votre ordinateur portable. Il est donc beaucoup plus facile de créer votre graphique à votre guise.
• ^mypButtons génère un CSV et comprend des colonnes que je recommande fortement de vérifier dans un premier temps pour voir les performances du produit InterSystems. Ainsi, tout le monde peut profiter d'un graphique de performances avec cet utilitaire si facilement !

Attention! Si vous souhaitez lire mypButtons.csv, veuillez charger les fichiers HTML SystemPerformance avec le profil "every 1 second".

[Comment l'exécuter]

do readone^mypButtons("C:\temp\dir\myserver_IRIS_20230522_130000_8hours.html","^||naka")

Lit un fichier HTML SystemPerformance et stocke les informations dans une globale donnée. Dans cet exemple, il lit myserver_IRIS_20230522_130000_8hours.html et le stocke dans ^||naka.

do readdir^mypButtons("C:\temp\dir","^||naka")

Lit tous les fichiers HTML SystemPerformance dans un dossier donné et stocke les informations dans une globale donnée. Dans cet exemple, il lit tous les fichiers HTML sous C:\temp\dir et les stocke dans ^||naka.

do writecsv^mypButtons("C:\temp\csv","^||naka")

Génère les trois fichiers csv suivants dans un dossier donné à partir d'une globale donnée.

• mgstat.csv
• perfmon.csv
• mesboutons.csv

Ici, mypButtons.csv inclut par défaut les colonnes suivantes, que je recommande fortement de vérifier en premier pour voir les performances :

• mgstat : Glorefs, PhyRds, Gloupds, PhyWrs, WDQsz, WDphase
• perfmon : Mo disponibles, lectures de disque/s, écritures de disque/s, % de temps processeur

Cet utilitaire fonctionne pour InterSystems IRIS, InterSystems IRIS for Health, Caché et Ensemble pour Windows.

[Exemples d'étapes pour créer le graphique de performances de votre serveur IRIS avec ^mypButtons]

(1) Tout d'abord, exécutez ^SystemPerformance pour enregistrer à la fois notre propre outil de performances mgstat et le moniteur de performances Windows perfmon. Par défaut, InterSystems IRIS dispose de quelques profils pour que vous puissiez en profiter bientôt. Essayez ceci depuis le terminal IRIS.

%SYS> do ^SystemPerformance
Current log directory: c:\intersystems\iris\mgr\
Windows Perfmon data will be left in raw format.
Available profiles:
　　1 12hours - 12-hour run sampling every 10 seconds
　　2 24hours - 24-hour run sampling every 10 seconds
　　3 30mins - 30-minute run sampling every 1 second
　　4 4hours - 4-hour run sampling every 5 seconds
　　5 8hours - 8-hour run sampling every 10 seconds
　　6 test - 5-minute TEST run sampling every 30 seconds
select profile number to run: 3

Attention! Si vous souhaitez lire mypButtons.csv, veuillez utiliser le profil "toutes les 1 secondes". Par défaut, vous verrez le profil « 30 minutes » qui échantillonne toutes les secondes. Si vous souhaitez créer d'autres profils, voir notre documentation pour plus de details.

(2) Après l'échantillonnage, un fichier HTML sera généré sous irisdir\mgr, dont le nom ressemble à JP7320NAKAHASH_IRIS_20231115_100708_30mins.html. Ouvrez le fichier HTML généré et vous verrez de nombreuses données de performances séparées par des virgules dans les sections mgstat et perfmon .

(3) Chargez-le avec ^mypButtons comme ci-dessous.

USER> do readone^mypButtons("C:\InterSystems\IRIS\mgr\JP7320NAKAHASH_IRIS_20231115_100708_30mins.html","^||naka")

Cela chargera le HTML dans le fichier donnée en premier paramètre et enregistrera les données de performances dans la globale donnée dans le deuxième paramètre.

(4) Générez un CSV avec ^mypButtons comme ci-dessous.

USER> do writecsv^mypButtons("C:\temp","^||naka")

Cela produira trois fichiers CSV sous le dossier donné dans le premier paramètre à partir du global dans le deuxième paramètre. Ouvrez mypButtons.csv dans Excel et vous pouvez voir que mgstat et perfmon sont sur la même ligne chaque seconde. Voir cette capture d'écran - les colonnes surlignées en jaune sont mgstat et les colonnes surlignées en bleu sont perfmon.

(5) Créons un graphique simple à partir de ce CSV, c'est si facile. Choisissez la colonne B Time et la colonne C Glorefs, sélectionnez le menu Insérer , les graphiques linéaires 2D comme ci-dessous.

Ce graphique vous montrera les informations « Nombres de références globales par seconde ». Désolé, il y a eu très peu d'activités dans mon instance IRIS, donc mon exemple de graphique ne vous passionne pas, mais je pense que ce graphique du serveur de production vous donnera beaucoup d'informations utiles !

(6) mypButtons.csv inclut des colonnes sélectionnées que vous devriez vérifier en premier. La série d'articles de Murray vous expliquera pourquoi ces colonnes sont importantes pour voir les performances..

[Modifier ^mypButtons pour les colonnes de rapport]

Si vous souhaitez modifier les colonnes signalées dans mypButtons.csv, veuillez modifier manuellement l'e label writecsv. Il rapporte les colonnes définies dans cette zone.

J'espère que mon article et mon utilitaire vous inciteront à vérifier les performances d'InterSystems IRIS. Bon SystemPerformance😆