Commande probevctrl

Editer en ligne

Objectif

Modifie et affiche les paramètres de traçage dynamique ProbeVue et les sessions ProbeVue .

Syntaxe

probevctrl [ -c attribut = valeur ] [ -C ] [ -f { milli|micro } ] [ -d sessionID ] [ -l ] [ -n attribut = valeur ] [ -p ] [-s { id_session_probev } ] [ -t ] [ -u liste_utilisateurs ] [-T { show|start|stop|reset } ]

Descriptif

La commande probevctrl change et affiche les paramètres de traçage dynamique ProbeVue , la taille de la mémoire tampon de trace par processeur, la mémoire réservée consommée, l'utilisateur propriétaire de la session, l'identificateur du processus qui a démarré la session et les informations indiquant si la session comporte des sondes du noyau pour les sessions ProbeVue .

Les paramètres ProbeVue suivants sont configurables:
  • Statut ProbeVue (activé/désactivé).
  • Mémoire réservée maximale (Mo) allouée à toutes les sessions ProbeVue .
  • Mémoire réservée maximale (ko) allouée pour la session ProbeVue d'un utilisateur non privilégié, y compris la mémoire des tampons de trace.
  • Nombre de sessions ProbeVue simultanées autorisées pour un utilisateur standard.
  • Taille par défaut des mémoires tampon de trace par processeur (ko).
  • Durée minimale en millisecondes qu'un utilisateur normal peut demander au consommateur de trace de lire à partir de ses mémoires tampon de trace.
  • Période par défaut, en millisecondes, pendant laquelle les mémoires tampon ProbeVue seront lues par le consommateur de trace.
  • Taille de la pile de calcul par processeur utilisée par une session ProbeVue (ko).
  • Intervalle de temps minimal autorisé pour l'utilisateur root global dans les sondes d'intervalle.
  • Pourcentage de mémoire allouée à la structure de données dynamique.
  • Taille de la table locale par processeur en ko.
  • Nombre de contextes d'erreur de page pour la gestion des erreurs de page.
  • Nombre maximal d'unités d'exécution qu'une session ProbeVue doit prendre en charge lorsqu'elle comporte des variables locales d'unité d'exécution.
  • Taille maximale de la mémoire tampon par UC, en octets, utilisée par une action de sonde Net .
  • Durée maximale, en millisecondes, qu'une action de vérification Systrasse peut prendre lorsque l'action est lancée dans un contexte d'interruption.
  • Durée maximale, en millisecondes, qu'une action de vérification Sysproc peut prendre lorsque l'action est lancée dans un contexte d'interruption.
  • Durée maximale, en millisecondes, d'une action de sonde Io lorsque l'action est lancée dans un contexte d'interruption.
  • Durée maximale, en millisecondes, qu'une action de vérification Net peut prendre lorsque l'action est lancée dans un contexte d'interruption.
  • Durée maximale, en millisecondes, d'une action de sonde Intervalle lié à l'UC lorsque l'action est démarrée dans le contexte d'interruption.
Seul l'utilisateur root ou les utilisateurs disposant de l'autorisation aix.ras.probevue.manage peuvent mettre à jour les paramètres ProbeVue et afficher toutes les sessions ProbeVue . Sinon, les utilisateurs ne peuvent afficher que les sessions qui leur appartiennent. Chaque session s'affiche au format suivant:
Sid ID de processus Uid Taille de mémoire tampon en octets Mémoire consommée en octets Sondes de noyau Profilage
Sid PID UID Taftaille memory oui ou non oui ou non

Par défaut, ProbeVue est activé. La tentative de désactivation de ProbeVue lorsque les sessions ProbeVue sont actives échouera.

Indicateurs

-c
Indique des paramètres ProbeVue non utilisateur. Les arguments de cet indicateur doivent être séparés par des virgules ou placés entre guillemets et séparés par des virgules ou des espaces. Si l'indicateur -p ou -t n'est pas spécifié avec cet indicateur, les nouvelles valeurs seront prises en compte dans les sessions d'amorçage et d'amorçage suivantes. Les paires Valeur-attribut valides sont les suivantes:
Trace= {on | off}
Indique si ProbeVue doit être activé ou désactivé.
Default_buffer_size=Taille_buffe_par_défaut
Indique la taille par défaut des tampons de suivi par processeur en ko. Elle est détaillée jusqu'à la page 4ko suivante.
Max_total_mem_size=Max_total_mem_size
Indique la mémoire réservée maximum en Mo consommable par toute l'infrastructure préfabriquée ProbeVue.
Default_read_rate=Valeur_liste_défaut
Indique la période par défaut en millisecondes pendant laquelle les tampons ProbeVue seront lus par le consommateur de suivi.
stack_size=taille_stack_dans_4Kpages
Indique la taille de la pile de calcul par processus en ko. Elle est détaillée jusqu'à la page 4ko suivante.
Local_table_size=Numéro
Indique la taille de la table locale par processeur en ko. La moitié de l'espace alloué à la table locale est utilisée par des chaînes temporaires. La valeur par défaut est 4 Ko.
Min_interval=Intervalle en ms
Indique l'intervalle de temps minimal autorisé pour l'utilisateur root global dans les vérifications d'intervalle.
Num_pagefaults=Numéro
Indique le nombre de contextes d'erreur de page pour la gestion des erreurs de page. Le nombre spécifié de contextes d'erreur de page est préalloué lors de l'initialisation de l'infrastructure ProbeVue .
Num_threads_traced=Numéro
Indique le nombre maximal d'unités d'exécution qu'une session ProbeVue peut prendre en charge lorsqu'elle comporte des variables locales d'unité d'exécution. L'infrastructure ProbeVue préalloue toutes les variables locales d'unité d'exécution au début d'une session pour le nombre maximal d'unités d'exécution spécifiées avec cet attribut.
Max_net_buf_size=Numéro
Indique la taille maximale de la mémoire tampon par UC, en octets, utilisée par une action de sonde Net .
Max_intr_systrcprb_time=Numéro
Indique la durée maximale, en millisecondes, qu'une action de vérification peut prendre pour s'exécuter lorsque l'action de la sonde Systrasse est démarrée dans un contexte d'interruption.
Max_intr_sysprocprb_time=Numéro
Indique la durée maximale, en millisecondes, qu'une action de vérification peut prendre pour s'exécuter lorsque l'action de la sonde Sysproc est démarrée dans un contexte d'interruption.
Max_intr_ioprb_time=Numéro
Indique la durée maximale, en millisecondes, qu'une action de vérification peut prendre pour s'exécuter lorsque l'action de la sonde Io est démarrée dans un contexte d'interruption.
Max_intr_netprb_time=Numéro
Indique la durée maximale, en millisecondes, qu'une action de vérification peut prendre pour s'exécuter lorsque l'action de la sonde Net est démarrée dans un contexte d'interruption.
Async_stats_fetch_interval=Numéro
Indique l'intervalle d'extraction asynchrone en millisecondes pour extraire les statistiques système. Cet attribut est une valeur globale qui s'applique à toutes les sessions ProbeVue . ProbeVue définit l'intervalle d'extraction asynchrone en fonction de cette valeur. La valeur par défaut du paramètre réglable est de 1000 millisecondes. Les modifications de la valeur accordable n'affectent pas les sessions en cours d'exécution et la valeur spécifiée n'est utilisée que pour les nouvelles sessions.
Fetch_stats_async_only={yes | no}
Indique que toutes les statistiques système doivent être extraites en mode asynchrone même si l'extraction synchrone est possible. La valeur par défaut de ce paramètre est no. Les modifications de la valeur accordable n'affectent pas les sessions en cours d'exécution et la valeur spécifiée ne sera utilisée que pour les nouvelles sessions.
Max_intr_cpuboundprb_time=Numéro
Indique la durée maximale, en millisecondes, qu'une action de vérification peut prendre pour s'exécuter lorsque l'action de la sonde Intervalle lié à l'UC est démarrée dans un contexte d'interruption.
-C
Définit le paramètre de session ProbeVue sur les valeurs initiales. L'option -C utilise la configuration actuelle du système pour déterminer les valeurs initiales de configuration (High Config ou Low Config) à définir et met à jour les paramètres de démarrage actuels et suivants. Pour plus d'informations sur les valeurs de configuration élevées et faibles des paramètres optimisables, voir la rubrique ProbeVue dynamic tracing facility .
Remarque: Avant d'utiliser l'indicateur -C , vérifiez qu'aucune session ProbeVue n'est active.
-d sessionId
Affiche la liste des sondes activées pour la session spécifiée. Lorsque vous spécifiez all comme ID de session, les sondes de toutes les sessions ProbeVue qui peuvent être affichées par l'utilisateur s'affichent. Une liste de sessions ProbeVue et l'ID de session associé peuvent être obtenus à l'aide de la commande probevctrl .
-f
Indique le format dans lequel les données utilisées pour les actions de sonde doivent être affichées. L'option -f peut être utilisée avec l'option -T et elle affiche des actions sur une session spécifique. Les formats possibles sont les suivants:
milli
Affiche le temps en millisecondes.
micro
Affiche l'heure en microsecondes.
Le format par défaut est Milli.
-l
Répertorie la valeur actuelle des paramètres de configuration ProbeVue . Si l'indicateur -p ou -t n'est pas spécifié, les valeurs de paramètre de la session d'amorçage actuelle sont affichées.
-n
Indique les paramètres configurables pour les utilisateurs réguliers. Les arguments de cette option doivent être séparés par des virgules ou placés entre guillemets et séparés par des virgules ou des espaces. Si l'indicateur -p ou -t n'est pas spécifié avec cet indicateur, les nouvelles valeurs seront prises en compte dans les sessions d'amorçage et d'amorçage suivantes. Les paires Valeur-attribut valides sont les suivantes:
Max_mem_size=Tape_m_max
Indique la mémoire réservée maximum en Mo consommable par une session ProbeVue.
Max_sessions=Max_sessn
Indique le nombre maximal de sessions simultanées autorisées.
Min_read_rate=_taux-min_min
Indique la période minimum en millisecondes pendant laquelle un utilisateur standard peut demander au consommateur de trace de lire à partir de ses tampons de trace.
Pin_mem_dvar_pc=Pin_mem_dvar_pc
Indique le pourcentage de mémoire pouvant être allouée à la structure de données dynamiques pour les variables de type dynamique. Cette mémoire peut être utilisée pour les variables dynamiques de type de trace de pile et de tableau associatif. La valeur de ce paramètre est définie dans la plage 10-100. La valeur par défaut est 50.
-p
Indique que les valeurs par défaut de l'amorçage suivant doivent être mises à jour et affichées.
-s probevue_session_id
Indique la session sur laquelle l'action doit être exécutée. Cet indicateur doit être utilisé avec l'indicateur -T .
-u
Indique une liste d'utilisateurs séparés par des virgules dont les sessions ProbeVue doivent être répertoriées. Si l'indicateur -u n'est pas spécifié, toutes les sessions ProbeVue que l'utilisateur peut afficher sont affichées. Un utilisateur disposant de l'autorisation aix.ras.probevue.manage peut afficher toutes les sessions ProbeVue du système. Les utilisateurs ne disposant pas de cette autorisation peuvent afficher uniquement les sessions ProbeVue qu'ils possèdent.
-t
Indique que les valeurs par défaut de la session d'amorçage actuelle doivent être mises à jour et affichées.
-T show | start | stop | reset
Indique s'il faut afficher, démarrer, arrêter ou réinitialiser le profilage de l'action de sonde pour la session spécifiée par l'indicateur -s . L'indicateur -s doit être utilisé avec cet indicateur.

Exemples

  1. Pour modifier la taille de la mémoire tampon d'amorçage suivante et activer la fonction de trace dynamique, entrez:
    probevctrl -c trace=on,default_buffer_size=8 -p
    ou
    probevctrl -c "trace=on default_buffer_size=8" -p
  2. Pour répertorier la configuration ProbeVue d'amorçage suivante, entrez:
    probevctrl -l -p
  3. Pour répertorier la configuration ProbeVue actuelle, entrez:
    probevctrl -l -t
  4. Pour répertorier toutes les sessions ProbeVue , entrez:
    probevctrl
  5. Pour répertorier toutes les sessions ProbeVue appartenant à l'utilisateur invité, entrez:
    probevctrl -u guest
  6. Pour augmenter le pourcentage de mémoire réservée allouée aux structures de données dynamiques (trace de pile et tableau associatif) pour le prochain amorçage à partir d'une valeur par défaut 50 -75, entrez:
    probevctrl -n  pin_mem_dvar_pc = 75