InstanaPCP et les compteurs de performances d' Windows

Modifier en ligne

Sur Windows, l'application « InstanaPCP » se lance automatiquement au démarrage de l'agent. L'application « InstanaPCP » effectue les opérations suivantes :

  • Configure l'environnement pour le traçage automatique des applications hébergées par IIS.
  • Collecte des métriques pour les processus en cours d'exécution (tels que la récupération de place et l'unité centrale) et les envoie à l'agent.
  • Envoie à l'agent la liste des processus en cours d'exécution sur l'hôte Windows.
  • Collecte les métriques de compteur de performances personnalisées définies dans le fichier configuration.yaml .

Compteurs de performances

Modifier en ligne

Instana prend en charge deux méthodes de collecte des processus et de leurs métriques à partir d'un hôte Windows.

La première méthode (méthode par défaut) :

Au démarrage, « InstanaPCP » crée une ProcessNameFormat entrée de registre dont la valeur est 2 « ». Ce paramètre modifie le format du nom du processus de processname à processname_processid dans les chemins de registre suivants :

  1. HKLM:\SYSTEM\CurrentControlSet\Services\.NETFramework\Performance
  2. HKLM:\SYSTEM\CurrentControlSet\Services\PerfProc\Performance

La deuxième méthode :

Cette méthode repose sur une logique réécrite et ne nécessite aucune modification du format du nom du processus. Pour utiliser cette méthode, définissez la variable INSTANA_COLLECT_METRICS_BY_PROCESS_READING d'environnement sur ou 1true au niveau de l'hôte. Cette méthode offre davantage de souplesse puisqu'elle ne modifie pas le format du nom du processus; elle constituera à l'avenir l'option par défaut et la seule prise en charge.

Compteurs de performance personnalisés

Modifier en ligne

Instana permet de surveiller des compteurs de performances personnalisés. Les compteurs de performances personnalisés sont désactivés par défaut. Pour activer les compteurs de performances personnalisés, mettez à jour le fichier configuration.yaml comme illustré dans l'exemple suivant:

com.instana.plugin.perfcounters:
  enabled: true

Les compteurs de performances sont définis avec quatre valeurs et noms différents. Les compteurs de performances sont regroupés par catégorie. Ils peuvent être liés à une instance spécifique ou être à l'échelle de l'hôte. Pour décrire un compteur de manière unique, une syntaxe similaire à l'exemple suivant est utilisée:

[host]\[category]([instance])\[counter name]

instance peut être facultatif en fonction du compteur. Le compteur suivant est un exemple:

\Processor Information(_Total)\% Processor Time

Les attributs du compteur de l'exemple sont expliqués dans la liste suivante:

  • host est vide. Le compteur est destiné à l'hôte en cours (localhost).
  • category est Processor Information.
  • instance est _Total.
  • counter name correspond à % de temps processeur.

Instana ne prend en charge que les requêtes sur localhost les compteurs.

Certaines catégories sont uniquement de type hôte ; instance n'est pas défini pour ces catégories. L'exemple suivant illustre une catégorie à l'échelle de l'hôte:

\System\Processor Queue Length

Une fois l'indicateur activé, définissez les compteurs à surveiller. Mettez à jour la configuration comme illustré dans l'exemple suivant:

com.instana.plugin.perfcounters:
  enabled: true
  counters:
    - category: [name of the counters category]
      instance: [instance name]
      counters:
        - [name of the counter]

La sortie suivante montre des exemples de valeurs pour les compteurs:

com.instana.plugin.perfcounters:
  enabled: true
  counters:
    - category: Processor Information
      instance: _Total
      counters:
        - "% Processor Time"
Remarque: Le nom du compteur est placé entre guillemets (") en raison du caractère spécial %_

Si vous avez besoin de plus de compteurs par catégorie, ajoutez-les au tableau counters comme illustré dans l'exemple suivant:

com.instana.plugin.perfcounters:
  enabled: true
  counters:
    - category: Memory
      counters:
        - Page Faults/sec
        - Cache Faults/sec
        - Page Reads/sec
Remarque : instance n'est pas défini dans cet exemple, car la catégorie « Mémoire » s'applique à l'ensemble de l'hôte.
Remarque : l'interrogation des compteurs de performances est une opération intrinsèquement coûteuse. Si vous disposez de nombreux compteurs, cela a un impact sur les performances de l'agent.

L'exemple suivant illustre plusieurs catégories et compteurs:

com.instana.plugin.perfcounters:
  enabled: true
  counters:
    - category: System
      counters:
        - Processor Queue Length
        - System Calls/sec
    - category: Process
      instance: _Total
      counters:
        - Private bytes
        - Working Set
        - Thread Count
    - category: Memory
      counters:
        - Page Faults/sec
        - Cache Faults/sec
        - Page Reads/sec
    - category: .NET CLR Exceptions
      instance: _Global_
      counters:
        - "# of Exceps Thrown / sec"
        - "# of Pinned Objects"

L'exemple suivant illustre un tableau de bord hôte avec des compteurs de performances:

Figure 1. Exemple de tableau de bord des compteurs de performances
Exemple de tableau de bord Compteurs de performances

Pour plus d'aide, ouvrez un dossier de support.

Traitement des incidents

Modifier en ligne

Si vous rencontrez d'autres problèmes, contactez le support IBM .

InstanaPCP n'est pas en cours d'exécution

Modifier en ligne

Type de problème de surveillance : clr_instana_pcp_not_running

Le message d'avertissement InstanaPCP does not seem to be running peut apparaître dans le journal de votre agent. Ce message s'affiche lorsque l'agent ne parvient pas à interagir avec InstanaPCP. L'agent démarre InstanaPCP au début du processus d'amorçage, puis il peut communiquer avec InstanaPCP. L'agent ne peut pas démarrer InstanaPCP au début du processus d'amorçage si l'une des erreurs suivantes se produit:

  • L'agent ne s'exécute pas avec des privilèges suffisants (il ne s'exécute pas en tant que système local ou administrateur).
  • La version d'.NET Framework. installée sur l'hôte n'est pas prise en charge. Seules les versions .NET Framework, 4.5.1 et les versions ultérieures sont prises en charge.
  • InstanaPCP a redémarré en raison d'une surconsommation de mémoire.

Si ce message apparaît à plusieurs reprises, effectuez les vérifications suivantes:

  1. Vérifiez si l'utilisateur qui exécute l'agent dispose de privilèges d'administration locaux. Si l'utilisateur ne dispose pas de privilèges d'administration locaux, accordez des privilèges d'administration locaux à l'utilisateur ou utilisez un autre compte utilisateur. Lorsque vous installez l'agent « Instana » à partir du package d'installation, le service s'exécute généralement sous l'identité « Local System », ce qui lui confère les privilèges nécessaires.

  2. Vérifiez la version d'.NET Framework installée sur votre ordinateur. Le programme d'installation d' Windows installe automatiquement la version minimale d'.NET Framework requise pour InstanaPCP. Toutefois, si vous installez l'agent hôte à partir d'une archive ZIP, vous devrez peut-être installer .NET Framework. Si vous n'êtes pas certain de disposer de la bonne version d'.NET Framework, rendez-vous sur le site \system\com\instana\agent-windows-extensions<latest>\agent-windows-extensions--<latest> directory, puis exécutez manuellement le fichier InstanaPCP en tant que programme d'installation autonome à partir de la ligne de commande. Si la version d'.NET Framework. appropriée n'est pas installée, un message s'affiche.

  3. Vérifiez si vous voyez des messages liés à la surconsommation dans le journal comme suit:

    InstanaPCP.exe Private-Bytes is above warning-treshhold for XXX times now

Killing InstanaPCP.exe for excessive memory-usage. Possible memory-leak in native Windows-Libraries.

Ces messages s'affichent si l'un des problèmes suivants se produit:

  • Sur la machine Windows où InstanaPCP est hébergé, la version d'IIS est antérieure à la version 7, et une fuite de mémoire s'est produite. Cette fuite peut être corrigée en installant une mise à jour Microsoft. Ce problème peut se produire sur les ordinateurs équipés d' Windows s 2008. Avant d'installer cette mise à jour Microsoft, contactez le support technique d' IBM afin de vérifier si une fuite de mémoire s'est produite sur votre ordinateur. L'équipe d'assistance d' IBM peut vous fournir le lien permettant de mettre à jour votre suite Microsoft.

  1. De nombreuses applications d'.NET s sont en cours d'exécution sur le serveur, et ces applications génèrent de nombreuses traces. Augmentez les limites de mémoire pour InstanaPCP en modifiant les paramètres suivants dans votre fichier configuration.yaml d'agent :

    com.instana.plugin.clr:
  pcp_warn_limit: <MB-treshold before warning>
  pcp_stop_limit: <MB-treshold  to stop / restart the process>

InstanaPCP non connecté

Modifier en ligne

Type de problème de surveillance : clr_instana_pcp_not_connected

L'agent hôte ne peut pas se connecter au processus InstanaPCP, ce qui empêche l'extraction et le traitement des données de traçage et des métriques d'exécution pour les processus .NET.

Ce problème est généralement un échec transitoire, qui se résout rapidement après l'initialisation de InstanaPCP . Si ce problème n'est pas résolu, contactez le support IBM .