Le code source du package est disponible sur : https://github.com/myconstellation/constellation-packages/tree/master/PerfCounter

Installation

Depuis le “Online Package Repository” de votre Console Constellation, déployez le package PerfCounter :

Une fois le package télécharger votre repository local, sélectionnez la sentinelle sur laquelle déployer le package.

Pour finir, sur la page de Settings, vous devez obligatoirement définir le setting “PerfCounters”. Il s’agit d’un setting de type “ConfigurationSection” c’est à dire que la configuration de ce setting est décrite en XML.

<perfCounterSection xmlns="urn:PerfCounter">
  <perfCounters>     
    <perfCounter id="<< StateObject Name >>" categoryName="<<  Performance Counter Category Name >>" counterName="<< Performance Counter Counter Name >>"  instanceName="<< Optionnal Performance Counter Instance Name >>" />
  </perfCounters>
</perfCounterSection>

Vous devez spécifier une liste de <perfCounter> dont les attributs sont :

• id (obligatoire) : l’identifiant unique de ce compteur performance qui sera utilisé comme nom pour le StateObject
• categoryName (obligatoire) : la catégorie du compteur de performance
• counterName (obligatoire) : le nom du compteur de performance
• instanceName (optionnel) : le nom de l’instance du compteur de performance si nécessaire
• machineName (optionnel) : le nom de la machine sur laquelle récupérer le compteur de performance (si vide, c’est la machine il s’agit local)

Par exemple pour récupérer la mémoire RAM disponible (catégorie “Memory”, nom “Available MBytes”, aucune instance) :

<perfCounter id="MemoryAvailableMBytes" categoryName="Memory" counterName="Available MBytes"  />

Pour la consommation globale du CPU (catégorie “Processor”, nom “% Processor Time”, instance “_Total”) :

<perfCounter id="ProcessorTime" categoryName="Processor" counterName="% Processor Time" instanceName="_Total" />

Chaque produit (Constellation Server y compris) peuvent publier des compteurs de performances (ASP.NET, IIS, SQL Server, Windows, etc..). Vous pouvez donc facilement les injecter dans Constellation.

Par exemple, ci-dessous une configuration du package injectant dans Constellation les compteurs de performance relatif au processeur, mémoire RAM, interfaces réseau, disque physique C:, ASP.NET, la CLR .net, le service IIS et SQL Server :

<perfCounterSection xmlns="urn:PerfCounter">
   <perfCounters>     

     <!-- Processor -->
     <perfCounter id="ProcessorTime" categoryName="Processor" counterName="% Processor Time" instanceName="_Total" />
     <perfCounter id="ProcessorQueueLength" categoryName="System" counterName="Processor Queue Length" />

     <!-- Disk -->
     <perfCounter id="Disk0_IdleTime" categoryName="PhysicalDisk" counterName="% Idle Time" instanceName="0 C:" />
     <perfCounter id="Disk0_SecPerRead" categoryName="PhysicalDisk" counterName="Avg. Disk sec/read"   instanceName="0 C:"/>
     <perfCounter id="Disk0_SecPerWrite" categoryName="PhysicalDisk" counterName="Avg. Disk sec/write"  instanceName="0 C:" />
     <perfCounter id="Disk0_QueueLength" categoryName="PhysicalDisk" counterName="Current Disk Queue Length"  instanceName="0 C:" />

     <!-- Memory -->
     <perfCounter id="MemoryAvailableMBytes" categoryName="Memory" counterName="Available MBytes"  />
     <perfCounter id="MemoryPagesPerSec" categoryName="Memory" counterName="Pages/sec"  />
     <perfCounter id="MemoryCacheBytes" categoryName="Memory" counterName="Cache Bytes"  />

     <!-- Network Interface -->
     <perfCounter id="NetworkIntefaceBytesPerSec" categoryName="Network Interface" counterName="Bytes Total/sec" instanceName="Broadcom NetXtreme 57xx Gigabit Controller"  />
     <perfCounter id="NetworkIntefaceOutputQueueLength" categoryName="Network Interface" counterName="Output Queue Length" instanceName="Broadcom NetXtreme 57xx Gigabit Controller" />

     <!-- Paging File -->
     <perfCounter id="PagingFileUsage" categoryName="Paging File" counterName="% Usage" instanceName="_Total"  />

     <!-- .NET CLR -->
     <perfCounter id="DotNetExceptionThrownPerSec" categoryName=".NET CLR Exceptions" counterName="# of Exceps Thrown / Sec" instanceName="_Global_" />
     <perfCounter id="DotNetTotalCommittedBytes" categoryName=".NET CLR Memory" counterName="# Total Committed Bytes" instanceName="_Global_" />

     <!-- ASP.NET -->
     <perfCounter id="AspNetRequestPerSec" categoryName="ASP.NET Applications" counterName="Requests/Sec" instanceName="__Total__" />
     <perfCounter id="AspNetApplicationRestart" categoryName="ASP.NET" counterName="Application Restarts" />
     <perfCounter id="AspNetRequestWaitTime" categoryName="ASP.NET" counterName="Request Wait Time" />
     <perfCounter id="AspNetRequestQueued" categoryName="ASP.NET" counterName="Requests Queued" />

     <!-- IIS -->
     <perfCounter id="IISGetRequestPerSec" categoryName="Web Service" counterName="Get Requests/sec" instanceName="_Total"  />
     <perfCounter id="IISPostRequestPerSec" categoryName="Web Service" counterName="Post Requests/sec" instanceName="_Total"  />
     <perfCounter id="IISCurrentConnections" categoryName="Web Service" counterName="Current Connections" instanceName="_Total"  />

     <!-- SQL Server -->
     <perfCounter id="SqlBufferCacheHitRatio" categoryName="MSSQL$SQL2012:Buffer Manager" counterName="Buffer cache hit ratio" />
     <perfCounter id="SqlPageLifeExpectancy" categoryName="MSSQL$SQL2012:Buffer Manager" counterName="Page life expectancy" />
     <perfCounter id="SqlBatchRequestsPerSec" categoryName="MSSQL$SQL2012:SQL Statistics" counterName="Batch Requests/Sec" />
     <perfCounter id="SqlSQLCompilationsPerSec" categoryName="MSSQL$SQL2012:SQL Statistics" counterName="SQL Compilations/Sec" />
     <perfCounter id="SqlSQLReCompilationsPerSec" categoryName="MSSQL$SQL2012:SQL Statistics" counterName="SQL Re-Compilations/Sec" />
     <perfCounter id="SqlUserConnections" categoryName="MSSQL$SQL2012:General Statistics" counterName="User Connections" />
     <perfCounter id="SqlLockWaitsPerSec" categoryName="MSSQL$SQL2012:Locks" counterName="Lock Waits/sec" instanceName="_Total" />
     <perfCounter id="SqlPageSplitsPerSec" categoryName="MSSQL$SQL2012:Access Methods" counterName="Page Splits/sec" />
     <perfCounter id="SqlProcessesBlocked" categoryName="MSSQL$SQL2012:General Statistics" counterName="Processes Blocked" />
     <perfCounter id="SqlCheckpointPagesPerSec" categoryName="MSSQL$SQL2012:Buffer Manager" counterName="Checkpoint Pages/sec" />

   </perfCounters>
 </perfCounterSection>

Vous pouvez également déployer ce package manuellement dans la configuration de votre Constellation :

<package name="perfcounter">
  <settings>
    <setting key="PerfCounters">
        <content>
          <perfCounterSection xmlns="urn:PerfCounter">
            <perfCounters>     
              <perfCounter id="<< StateObject Name >>" categoryName="<<  Performance Counter Category Name >>" counterName="<< Performance Counter Counter Name >>"  instanceName="<< Optionnal Performance Counter Instance Name >>" />
            </perfCounters>
          </perfCounterSection>
        </content>
      </setting>
  </settings>
</package>

Détails du package

Les Settings

Les StateObjects

Vous retrouverez autant de StateObject que de compteur de performance enregistrés dans la configuration de votre package.

Les MessageCallbacks

Ce package n’expose aucun MessageCallback.

Quelques exemples

• Afficher les valeurs des PerfCounters de différents serveurs Windows sur une page Web
• Piloter une bande de LED en fonction du nombre de requête HTTP sur un serveur IIS avec un Arduino/ESP

The post PerfCounter : intégrez les compteurs de performance Windows dans Constellation appeared first on Constellation.

Vous pourrez alors exploiter ces indicateurs de performance avec des outils de supervision tel quel New Relic, Nagios, Cacti, dotcom-monitor, Applications Manager, ou plus simplement en utilisant la MMC “Analyseur de Performances” de Windows.

Vous pouvez également développer vos propres applications pour suivre les indicateurs de performance de votre serveur Constellation étant donné que ces compteurs Windows sont exposés en WMI (voir la documentation). Pour les développeurs .NET, la classe PerformanceCounter vous permettra d’interroger ces compteurs très facilement.

Pour finir, vous trouverez dans le catalogue de package gratuit, le package PerfCounter qui permet de publier en temps réel des compteurs de performance Windows en tant que StateObject. Autrement dit vous pouvez suivre l’activité et les performances de votre Constellation via des StateObjects de votre Constellation.

Activer les compteurs de performance

Pour activer les compteurs de performance, vous devez manuellement éditer le serveur de configuration pour ajouter la section et la clé de configuration suivante :

<appSettings>
  <add key="EnablePerformanceCounters" value="true" />
</appSettings>

Vous pouvez éditer ce fichier depuis la Console Constellation, depuis le SDK ou directement sur votre serveur avec votre éditeur favori.

Comme il s’agit d’une modification de bas niveau, vous devez nécessairement redémarrer le service Constellation :

• Soit via la MMC “Services” :

• Soit en ligne de commande :

net stop ConstellationServer && net start ConstellationServer

Vous pourrez ensuite suivre les indicateurs de performance de votre Constellation avec un outil de supervision, l’analyseur de performances de Windows ou même développer vos propres outils en exploitant l’API PerformanceCounter sous .NET ou WMI.

Utiliser l’analyseur de performances Windows

Dans les outils d’administration Windows, lancez la MMC “Analyseur de Performances” et cliquer sur le bouton “Ajouter” dans la toolbar.

Tous les compteurs Constellation sont disponibles dans la catégories “Constellation Server” puis sélectionnez le ou les compteurs à suivre :

A noter que cette fonctionnalité n’est disponible que sur un environnement Windows, la plateforme Linux n’ayant pas d’équivalent.

Utiliser le package PerfCounter

Le package PerfCounter permet de suivre des compteurs de performance Windows et de les injecter en tant que StateObject dans Constellation. Il est donc possible suivre l’activité et les performances de votre Constellation via des StateObjects de votre Constellation.

Pour plus d’information sur ce package et son utilisation : https://developer.myconstellation.io/package-library/perfcounter/ 

Ci-dessous la définition des compteurs de performance publiés Constellation pour le package PerfCounter :

<!-- Constellation Server / StateObjects provider -->
<perfCounter id="ConstellationPushStateObject" categoryName="Constellation Server" counterName="# PushStateObject / sec" instanceName="default" />
<perfCounter id="ConstellationPushStateObjectCount" categoryName="Constellation Server" counterName="Total PushStateObject" instanceName="default" />
<perfCounter id="ConstellationUpdateStateObject" categoryName="Constellation Server" counterName="# UpdateStateObject / sec" instanceName="default" />
<perfCounter id="ConstellationUpdateStateObjectCount" categoryName="Constellation Server" counterName="Total UpdateStateObject" instanceName="default" />
<perfCounter id="ConstellationRequestStateObjects" categoryName="Constellation Server" counterName="# RequestStateObjects /sec" instanceName="default" />
<perfCounter id="ConstellationRequestStateObjectsCount" categoryName="Constellation Server" counterName="Total RequestStateObjects" instanceName="default" />
<perfCounter id="ConstellationSubscribeStateObjects" categoryName="Constellation Server" counterName="# SubscribeStateObjects / sec" instanceName="default" />
<perfCounter id="ConstellationSubscribeStateObjectsCount" categoryName="Constellation Server" counterName="Total SubscribeStateObjects" instanceName="default" />
<perfCounter id="ConstellationStateObjectsCount" categoryName="Constellation Server" counterName="Current StateObjects Count" instanceName="default" />
<perfCounter id="ConstellationStateObjectSubscriptionCount" categoryName="Constellation Server" counterName="Current StateObject Subscriptions" instanceName="default" />
<!-- Constellation Server / Messaging -->
<perfCounter id="ConstellationSendMessage" categoryName="Constellation Server" counterName="# SendMessage / sec" instanceName="default" />
<perfCounter id="ConstellationSendMessageCount" categoryName="Constellation Server" counterName="Total SendMessage" instanceName="default" />
<perfCounter id="ConstellationReceiveMessage" categoryName="Constellation Server" counterName="# ReceiveMessage / sec" instanceName="default" />
<perfCounter id="ConstellationReceiveMessageCount" categoryName="Constellation Server" counterName="Total ReceiveMessage" instanceName="default" />
<!-- Constellation Server / Logging -->
<perfCounter id="ConstellationWriteLog" categoryName="Constellation Server" counterName="# WriteLog / sec" instanceName="default" />
<perfCounter id="ConstellationWriteLogCount" categoryName="Constellation Server" counterName="Total WriteLog" instanceName="default" />
<!-- Constellation Server / Packages -->
<perfCounter id="ConstellationPackageConnections" categoryName="Constellation Server" counterName="Total Package connections" instanceName="default" />
<perfCounter id="ConstellationPackageDisconnections" categoryName="Constellation Server" counterName="Total Package disconnections" instanceName="default" />
<perfCounter id="ConstellationPackagesConnected" categoryName="Constellation Server" counterName="Current Packages connected" instanceName="default" />
<!-- Constellation Server / Sentinels -->
<perfCounter id="ConstellationSentinelConnections" categoryName="Constellation Server" counterName="Total Sentinel connections" instanceName="default" />
<perfCounter id="ConstellationSentinelDisconnections" categoryName="Constellation Server" counterName="Total Sentinel disconnections" instanceName="default" />
<perfCounter id="ConstellationSentinelsConnected" categoryName="Constellation Server" counterName="Current Sentinels connected" instanceName="default" />
<!-- Constellation Server / Consumers -->
<perfCounter id="ConstellationConsumerConnections" categoryName="Constellation Server" counterName="Total Consumers connections" instanceName="default" />
<perfCounter id="ConstellationConsumerDisconnections" categoryName="Constellation Server" counterName="Total Consumers disconnections" instanceName="default" />
<perfCounter id="ConstellationConsumerConnected" categoryName="Constellation Server" counterName="Current Consumers connected" instanceName="default" />
<!-- Constellation Server / API REST -->
<perfCounter id="ConstellationWebApiSubscriptionCount" categoryName="Constellation Server" counterName="Current subscriptions (HTTP REST API)" instanceName="default" />
<perfCounter id="ConstellationWebApiRequestInProcess" categoryName="Constellation Server" counterName="Current long-polling requests (HTTP REST API)" instanceName="default" />

The post Surveiller et monitorer les indicateurs de performance du serveur Constellation appeared first on Constellation.