pmdabash - En ligne dans le Cloud

PROGRAMME:

Nom

pmdabash - Agent de domaine Bourne-Again SHell Trace Performance metrics

SYNOPSIS

$PCP_PMDAS_DIR/bash/pmdabash [-C] [-d domaine] [-l fichier journal] [-I intervalle] [-t temps mort] [-U
Nom d'utilisateur] fichier de configuration

DESCRIPTION

pmdabash est un agent de domaine de métrique de performance expérimental (PMDA) qui exporte "xtrace"
événements d'un tracé bash(1) processus. Cela inclut les informations d'exécution de la commande
qui serait généralement envoyé à l'erreur standard avec le set -x option à la coque.

Les métriques d'événement sont exportées montrant chaque commande exécutée, le nom de la fonction et la ligne
numéro dans le script et un horodatage. De plus, l'identifiant de processus pour le shell
et son processus parent sont exportés.

Cela nécessite bash version 4 ou ultérieure.

Une brève description du pmdabash les options de ligne de commande sont les suivantes :

-d Il est absolument crucial que les mesures de performance domaine le nombre spécifié ici est
unique et cohérent. C'est-à-dire, domaine devrait être différent pour chaque PMDA sur un
hôte, et le même domaine doit être utilisé pour le même PMDA sur tous les hôtes.

-l Emplacement du fichier journal. Par défaut, un fichier journal nommé bash.log est écrit dans le
répertoire courant de pmcd(1) quand pmdabash est démarré, c'est-à-dire $PCP_LOG_DIR/pmcd. Si
le fichier journal ne peut pas être créé ou n'est pas accessible en écriture, la sortie est écrite dans le standard
erreur à la place.

-s Durée (en secondes) entre les évaluations suivantes du fichier de trace du shell
descripteur(s). La valeur par défaut est de 2 secondes.

-m Quantité maximale de mémoire autorisée pour chaque file d'attente d'événements (une par processus tracé).
La valeur par défaut est de 2 mégaoctets.

-U Compte d'utilisateur sous lequel exécuter l'agent. La valeur par défaut est le "pcp" non privilégié
compte dans les versions actuelles de PCP, mais dans les anciennes versions, le compte superutilisateur
("root") a été utilisé par défaut.

INSTALLATION

Pour qu'un hôte exporte les noms, le texte d'aide et les valeurs des performances bash
métriques, procédez comme suit en tant que root :

# cd $PCP_PMDAS_DIR/bash
# ./Installer

Dès qu'un script shell instrumenté (voir sélection INSTRUMENTATION ci-dessous) est exécuté, avec
traçage activé, de nouvelles valeurs métriques apparaîtront - aucune autre configuration de l'agent n'est
nécessaire.

Si vous souhaitez annuler l'installation, procédez comme suit en tant que root :

# cd $PCP_PMDAS_DIR/bash
# ./Supprimer

pmdabash est lancé par pmcd(1) et ne doit jamais être exécuté directement. L'installation et
Supprimer les scripts notifier pmcd(1) lorsque l'agent est installé ou supprimé.

INSTRUMENTATION

Afin de permettre le flux de données d'événement entre un bash(1) scénario et pmdabash, le script
doit prendre les mesures suivantes :

#!/ Bin / sh
source $PCP_DIR/etc/pcp.sh

pcp_trace sur $@ # activer le traçage
echo "éveillé, $count"

pcp_trace off # désactiver le traçage

Le traçage peut être activé et désactivé autant de fois que vous le souhaitez par le script. En cas de succès
l'installation de l'agent, plusieurs métriques seront disponibles :

$ pminfo bash
bash.xtrace.numclients
bash.xtrace.maxmem
bash.xtrace.queuemem
bash.xtrace.count
bash.xtrace.records
bash.xtrace.parameters.pid
bash.xtrace.parameters.parent
bash.xtrace.parameters.lineno
fonction bash.xtrace.parameters
bash.xtrace.parameters.commande

Lorsqu'un script instrumenté est en cours d'exécution, la génération des enregistrements d'événements peut être vérifiée
en utilisant l' pmévénement(1) commande, comme suit :

$ pmevent -t 1 -x '' bash.xtrace.records
hôte: localhost
échantillons : tous
bash.xtrace.records["4538 ./test-trace.sh 1 2 3"] : 5 enregistrements d'événements
10:00:05.000 --- l'enregistrement d'événement [0] marque 0x19 (point, id, parent) ---
bash.xtrace.parameters.pid 4538
bash.xtrace.parameters.parent 4432
bash.xtrace.parameters.lineno 43
bash.xtrace.parameters.command "true"
10:00:05.000 --- l'enregistrement d'événement [1] marque 0x19 (point, id, parent) ---
bash.xtrace.parameters.pid 4538
bash.xtrace.parameters.parent 4432
bash.xtrace.parameters.lineno 45
bash.xtrace.parameters.command "(( count++ ))"
10:00:05.000 --- l'enregistrement d'événement [2] marque 0x19 (point, id, parent) ---
bash.xtrace.parameters.pid 4538
bash.xtrace.parameters.parent 4432
bash.xtrace.parameters.lineno 46
bash.xtrace.parameters.command "echo 'réveillé, 3'"
10:00:05.000 --- l'enregistrement d'événement [3] marque 0x19 (point, id, parent) ---
bash.xtrace.parameters.pid 4538
bash.xtrace.parameters.parent 4432
bash.xtrace.parameters.lineno 47
bash.xtrace.parameters.command "fatigué 2"
10:00:05.000 --- l'enregistrement d'événement [4] marque 0x19 (point, id, parent) ---
bash.xtrace.parameters.pid 4538
bash.xtrace.parameters.parent 4432
bash.xtrace.parameters.lineno 38
bash.xtrace.parameters.function "fatigué"
bash.xtrace.parameters.command "sommeil 2"

Utiliser pmdabash en ligne en utilisant les services onworks.net