pj_dump - En ligne dans le Cloud

PROGRAMME:

Nom

pj_dump - vide un fichier de trace paje dans un format textuel de type CSV

SYNOPSIS

pj_dump [OPTIONS] [DOSSIER]

DESCRIPTION

Le pj_dump(1) la commande traduit le fichier de trace paje DOSSIER dans un format textuel de type CSV
(décrit ci-dessous). C'est un programme utile pour analyser le comportement de parallèles et
applications distribuées qui ont été tracées à l'aide d'une bibliothèque qui génère des fichiers de trace dans
le format de fichier Paje. Une fois que vous avez vidé le contenu du fichier de trace Paje dans un fichier de type CSV
manière, vous êtes libre d'analyser le contenu de la trace comme vous le souhaitez. Vous pouvez utiliser R
par exemple pour dessiner des nuages ​​de points et des diagrammes de Gantt. Si DOSSIER n'est pas fourni, alors le
l'entrée standard est utilisée.

Par défaut, pj_dump lira le fichier de trace du début jusqu'à la fin du fichier est
trouvé. Au cours de ce processus, pj_dump s'appuie sur la librairie Paje pour recréer en mémoire les
comportement enregistré dans les fichiers de trace. Cela signifie que pj_dump mettra en mémoire
tout le contenu du fichier de trace, même si l'entrée est très volumineuse. Une fois tout le contenu
du fichier de trace sont simulés, pj_dump vide les informations dans le texte de type CSV
format décrit ci-dessous dans la section DESCRIPTION DE LA SORTIE.

Vous pouvez modifier le comportement par défaut de pj_dump en fournissant les paramètres --start=DÉBUT
et --end=FIN où START et END sont des horodatages valides de la trace d'entrée. S'il est fourni, il
vide uniquement le contenu de la trace entre START et END. Notez que même s'il est utilisé,
pj_dump simulera l'ensemble du fichier de trace pour conserver la même sémantique de comportement. Un autre
moyen de changer le comportement par défaut est à travers le --stop-à=HEURE paramètre. Si fourni,
pj_dump lira le fichier de trace jusqu'à l'horodatage TIME (étant donné que le fichier de trace est
complètement chronométré) et vide ce qui a été simulé jusque-là. Les --no-strict
Le commutateur doit être évité et ne peut être utilisé qu'avec les anciens fichiers de trace Paje avec un ancien champ
noms dans les définitions d'événements. Les --ignore-liens-incomplets changer de marque pj_dump ignorer
liens incomplets en silence. Plus de détails sur ce commutateur ci-dessous, dans la DESCRIPTION DE LA SORTIE
.

OPTIONS

pj_dump accepte les options suivantes :

-une, --arrêté à=
Arrêtez la simulation de trace à TIME.

-Oui, --début=DEBUT
Le vidage commence à l'horodatage START (au lieu de l'horodatage 0).

-e, --finir=FIN
Le vidage se termine par l'horodatage END (au lieu de End Of File).

-n, --no-strict
Prend en charge les anciens noms de champs dans les définitions d'événements.

-z, --ignore-liens-incomplets
Ignorez les liens incomplets sans avertissements.

-tu, --défini par l'utilisateur
Videz les champs définis par l'utilisateur. Voir la section CHAMPS DÉFINIS PAR L'UTILISATEUR ci-dessous.

-F, --fléchir
Utilisez un lecteur de fichiers alternatif basé sur flex/bison (expérimental).

- ?, --Aidez-moi
Afficher toutes les options disponibles.

--usage
Donnez un court message d'utilisation.

CONTRIBUTION DESCRIPTION

Le pj_dump(1) commande attend une entrée qui suit le format de fichier Paje (comme décrit dans
le document PDF répertorié dans la section RESSOURCES de cette page). Si FILE n'est pas fourni,
pj_dump(1) essaiera de lire à partir de l'entrée standard.

SORTIE DESCRIPTION

Il est plus facile de comprendre ce qui est écrit ici si vous connaissez le Paje
terminologie (Conteneur, Etat, Variable, Lien, Evénement et les informations attachées à chaque
de ceux-ci). Jetez un œil à la description du format de fichier Paje (lien ci-dessous dans le
section RESSOURCES) pour plus de détails.

Le contenu des lignes générées par le pj_dump(1) les commandes sont séparées par des virgules,
définir les colonnes. Donc, une ligne comme celle-ci :

Conteneur, 0, LIEN, 0, 4.48514, 4.48514, 9

a sept colonnes. La première colonne est toujours l'une des suivantes : Conteneur, État, Variable, Événement ou
Relier. Les colonnes restantes de la ligne ont des informations spécifiques en fonction de la première
colonne. Voici une description synthétique des cinq différents types de lignes que vous trouverez comme
sortie de pj_dump(1):

Conteneur, parentContainer, containerType, startTime, endTime, durée, nom
État, conteneur, stateType, startTime, endTime, durée, imbrication, valeur
Variable, conteneur, variableType, startTime, endTime, durée, valeur
Événement, conteneur, eventType, heure, valeur
Lien, conteneur, linkType, startTime, endTime, durée, valeur, startContainer, endContainer

Voir ci-dessous une description détaillée avec des exemples pour chacun d'eux.

Contenant
Toutes les lignes commençant par Contenant ressemble à ca:

Conteneur, 0, HTE, 0, 4.48514, 4.48514, Tremblay

1. "Conteneur"

2. "0" - Le nom du conteneur parent

3. "HOST" - Le type de ce conteneur

4. "0" - L'heure de début

5. "4.48514" - L'heure d'arrivée

6. "4.48514" -La durée

7. "Tremblay" - Le nom de ce conteneur

État
Toutes les lignes commençant par État ressemble à ca:

État, node48, SERVICE, 691, 692, 1, 0, réservé

1. "État"

2. "node48" - Le nom du conteneur

3. "SERVICE" - Le type de cet état

4. "691" - L'heure de début

5. "692" - L'heure d'arrivée

6. "1" - La durée

7. "0" - Le niveau d'imbrication

8. "réservé" - La valeur de l'état

Variable
Toutes les lignes commençant par Variable ressemble à ca:

Variable, Tremblay, pcalculer, 2.15357, 2.17013, 0.016554, 9.8095e+07

1. "Variable"

2. "Tremblay" - Le nom du conteneur

3. "pcompute" - Le nom de la variable

4. "2.15357" - L'heure de début

5. "2.17013" - L'heure de fin

6. "0.016554" - La durée

7. "9.8095e+07" - La valeur de la variable

Event
Toutes les lignes commençant par Event ressemble à ca:

Événement, Tremblay, msmark, 3.4286, finish_send_tasks

1. "Événement"

2. "Tremblay" - Le nom du conteneur

3. "msmark" - Le nom de l'événement

4. "3.4286" - L'instant où cet événement a eu lieu

5. "finish_send_tasks" - La valeur de l'événement

Lien
Toutes les lignes commençant par Lien ressemble à ca:

Lien, 0, 0-HOST1-LINK4, 0, 0, 0, G, Tremblay, 9

1. "Lien"

2. "0" - Le nom du conteneur

3. "0-HOST1-LINK4" - Le type de ce lien

4. "0" - L'heure de début

5. "0" - L'heure de fin

6. "0" - La durée

7. "G" - La valeur de ce lien

8. "Tremblay" - Le conteneur de départ

9. "9" - Le conteneur de fin

Couverture Liens
Selon la description du format de fichier Paje, un lien est formé par deux événements :
PajeStartLink et PajeEndLink. Ces événements sont appariés par le simulateur Paje à l'aide d'un
clé qui est fournie dans le fichier de trace. Si l'un de ces deux événements manque pour
une raison arbitraire et le fichier de trace se termine (ou le conteneur est détruit), vous
faire une simulation avec incomplet Gauche. Généralement, le Simulateur Paje, et par
conséquence pj_dump, considérez ces liens comme des erreurs et répertoriez-les ci-dessous
manière:

$pj_dump ~/tracefile.paje
Liste des liens incomplets dans le conteneur '0' :
Lien, 0, MSG_PROCESS_TASK_LINK, 0, -1, 0, SR, diffuseur-12, NULL
Lien, 0, MSG_PROCESS_TASK_LINK, 0.00013, -1, 0, SR, diffuseur-13, NULL
Lien, 0, MSG_PROCESS_TASK_LINK, 0.002868, -1, 0, SR, diffuseur-13, NULL
(...)
PajeLinkException : liens incomplets à la fin du conteneur avec le nom '0'

La meilleure action lorsque cela se produit est de réparer le traceur ou le convertisseur qui a généré
la trace, car cela indique probablement une erreur lors de l'exécution. Si vous pensez
que cette erreur est acceptable, vous pouvez fournir le -z basculer vers pj_dump dire au
Paje Simulator pour ignorer les liens incomplets. Tout le fichier de trace sera vidé et tout
les erreurs concernant les liens incomplets seront ignorées en silence. Utiliser avec précaution.

DÉFINI PAR L'UTILISATEUR DES CHAMPS

Les champs définis par l'utilisateur sont une fonctionnalité du format de fichier de trace Paje pour ajouter des
des informations dans la trace qui n'appartiennent pas aux champs traditionnels de chaque événement
définition. Une définition d'événement avec quatre champs définis par l'utilisateur (Taille, Paramètres, Empreinte et
Tag) ressemble à ceci :

%EventDef PajeSetState 20
% Heure Date
% chaîne de conteneur
% Saisissez la chaîne
% Chaîne de valeur
Chaîne de taille %
% chaîne de paramètres
% Chaîne d'empreinte
% Chaîne de balise
%FinEventDef

Le vidage des champs définis par l'utilisateur est désactivé par défaut dans pj_dump. L'utilisateur peut activer
eux en passant -u (ou --défini par l'utilisateur) comme argument. Ce faisant, la sortie de type CSV de
pj_dump sera modifié par rapport à la définition ci-dessus (voir DESCRIPTION DE LA SORTIE). outre
en vidant les champs par défaut pour chaque entité et conteneur de la trace, le CSV aura
des champs supplémentaires qui correspondent aux champs définis par l'utilisateur. L'ordre dans lequel ils apparaissent
dans la sortie obéit à l'ordre de la définition de l'événement correspondant. Donc un État défini
avec la définition d'événement 20 ci-dessus aura quatre champs supplémentaires dans le CSV-like
sortie.

RESSOURCES

Description du fichier de trace Paje :
http://paje.sourceforge.net/download/publication/lang-paje.pdf

Site Internet principal : http://github.com/schnorr/pajeng/

DE LA LIGNE BOGUES

Signaler les bogues pj_dump àhttp://github.com/schnorr/pajeng/issues>

DROIT D'AUTEUR

Copyright (C) 2012-2014 Lucas M. Schnorr. L'utilisation gratuite de ce logiciel est accordée sous le
termes de la licence publique générale GNU (GPL).

Utilisez pj_dump en ligne à l'aide des services onworks.net