pj_dump: online nel cloud

PROGRAMMA:

NOME

pj_dump: scarica un file di traccia paje in un formato testuale simile a CSV

SINOSSI

pj_dump [VERSIONI] [RISORSE]

DESCRIZIONE

Le pj_dump(1) il comando traduce il file di traccia paje RISORSE in un formato testuale simile a CSV
(descritto sotto). È un programma utile per analizzare il comportamento di parallel e
applicazioni distribuite tracciate utilizzando una libreria che genera file di traccia in
il formato file Paje. Dopo aver scaricato il contenuto del file di traccia Paje in un file simile a CSV
modo, sei libero di analizzare il contenuto della traccia nel modo che preferisci. Puoi usare R
ad esempio per disegnare grafici a dispersione e diagrammi di Gantt. Se RISORSE non è fornito, allora il file
viene utilizzato l'input standard.

Per impostazione predefinita, pj_dump leggerà il file di traccia dall'inizio fino alla fine del file
trovato. Durante questo processo, pj_dump si affida alla biblioteca di Paje per ricreare in memoria il
comportamento registrato nei file di traccia. Ciò significa che pj_dump metterà in memoria
tutto il contenuto del file di traccia, anche se l'input è molto grande. Una volta tutti i contenuti
del file di traccia vengono simulati, pj_dump scarica le informazioni nel testo simile a CSV
formato descritto di seguito nella sezione DESCRIZIONE DELL'OUTPUT.

È possibile modificare il comportamento predefinito di pj_dump fornendo i parametri --start=INIZIO
che a --end=FINE dove START e END sono timestamp validi della traccia di input. Se fornito, esso
scarica solo il contenuto della traccia tra START e END. Tieni presente che, anche se utilizzato,
pj_dump simulerà l'intero file di traccia per mantenere la stessa semantica di comportamento. Un altro
il modo per modificare il comportamento predefinito è tramite --stop-at=ORA parametro. Se fornito,
pj_dump leggerà il file di traccia fino al timestamp TIME (considerando che il file di traccia è
completamente in ordine temporale) e scarica quanto simulato fino a quel momento. IL --no-rigoroso
Lo switch dovrebbe essere evitato e può essere utilizzato solo con i vecchi file di traccia Paje con il vecchio campo
nomi nelle definizioni degli eventi. IL --ignora-link-incompleti fare l'interruttore pj_dump ignorare
collegamenti incompleti in silenzio. Maggiori dettagli su questo interruttore di seguito, nella DESCRIZIONE DELL'USCITA
.

VERSIONI

pj_dump accetta le seguenti opzioni:

-un, --fermarsi a=ORARIO
Interrompere la simulazione della traccia alle TIME.

-S, --cominciare=INIZIO
Il dump inizia al timestamp START (invece del timestamp 0).

-e, --fine=FINE
Il dump termina con il timestamp END (invece di End Of File).

-N, --no-rigoroso
Supporta i vecchi nomi di campo nelle definizioni degli eventi.

-z, --ignora-link-incompleti
Ignora i collegamenti incompleti senza avvisi.

-tu, --definito dall'utente
Scarica i campi definiti dall'utente. Vedere la sezione CAMPI DEFINITI DALL'UTENTE di seguito.

-F, --flettere
Usa un lettore di file alternativo basato su flex/bison (sperimentale).

-?, --Aiuto
Mostra tutte le opzioni disponibili.

--uso
Dai un breve messaggio di utilizzo.

INGRESSO DESCRIZIONE

Le pj_dump(1) il comando prevede un input che segua il formato file Paje (come descritto in
il documento PDF elencato nella sezione RISORSE di questa pagina). Se FILE non viene fornito,
pj_dump(1) proverà a leggere dallo standard input.

USCITA DESCRIZIONE

E' più facile capire cosa c'è scritto se si conosce il Paje
terminologia (Contenitore, Stato, Variabile, Collegamento, Evento e le informazioni allegate a ciascuno
di questi). Dai un'occhiata alla descrizione del formato file Paje (link sotto nel file
sezione RISORSE) per ulteriori dettagli.

Il contenuto delle righe generate dal file pj_dump(1) i comandi sono separati da virgole,
definendo le colonne. Quindi, una riga come questa:

Contenitore, 0, LINK, 0, 4.48514, 4.48514, 9

ha sette colonne. La prima colonna è sempre una tra: Contenitore, Stato, Variabile, Evento o
Collegamento. Le restanti colonne della riga riportano informazioni specifiche a seconda della prima
colonna. Ecco una descrizione sintetica dei cinque diversi tipi di linee che troverai
uscita di pj_dump(1)

Contenitore, parentContainer, containerType, startTime, endTime, durata, nome
Stato, contenitore, stateType, startTime, endTime, durata, embricazione, valore
Variabile, contenitore, variableType, startTime, endTime, durata, valore
Evento, contenitore, eventType, ora, valore
Collegamento, contenitore, linkType, startTime, endTime, durata, valore, startContainer, endContainer

Vedi sotto una descrizione dettagliata con esempi per ciascuno di essi.

Contenitore
Tutte le righe che iniziano con Contenitore simile a questa:

Contenitore, 0, HOST, 0, 4.48514, 4.48514, Tremblay

1. "Contenitore"

2. "0" - Il nome del contenitore principale

3. "HOST" - Il tipo di questo contenitore

4. "0" - L'ora di inizio

5. "4.48514" - L'ora di fine

6. "4.48514" -La durata

7. "Tremblay" - Il nome di questo contenitore

Regione / Stato
Tutte le righe che iniziano con Regione / Stato simile a questa:

Stato, nodo48, SERVIZIO, 691, 692, 1, 0, prenotato

1. "Stato"

2. "node48" - Il nome del contenitore

3. "SERVIZIO" - Il tipo di questo stato

4. "691" - L'ora di inizio

5. "692" - L'ora di fine

6. "1" - La durata

7. "0" - Il livello di embricazione

8. "prenotato" - Il valore dello stato

Variabile
Tutte le righe che iniziano con Variabile simile a questa:

Variabile, Tremblay, pcompute, 2.15357, 2.17013, 0.016554, 9.8095e+07

1. "Variabile"

2. "Tremblay" - Il nome del contenitore

3. "pcompute" - Il nome della variabile

4. "2.15357" - L'ora di inizio

5. "2.17013" - L'ora di fine

6. "0.016554" - La durata

7. "9.8095e+07" - Il valore della variabile

Evento
Tutte le righe che iniziano con Evento simile a questa:

Evento, Tremblay, msmark, 3.4286, finish_send_tasks

1. "Evento"

2. "Tremblay" - Il nome del contenitore

3. "msmark" - Il nome dell'evento

4. "3.4286" - L'istante in cui si è verificato questo evento

5. "finish_send_tasks" - Il valore dell'evento

Link
Tutte le righe che iniziano con Link simile a questa:

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

1. "Collegamento"

2. "0" - Il nome del contenitore

3. "0-HOST1-LINK4" - Il tipo di questo collegamento

4. "0" - L'ora di inizio

5. "0" - L'ora di fine

6. "0" - La durata

7. "G" - Il valore di questo collegamento

8. "Tremblay" - Il contenitore iniziale

9. "9" - Il contenitore finale

Incompleto Collegamenti
Secondo la descrizione del formato file Paje, un collegamento è formato da due eventi:
PajeStartLink e PajeEndLink. Questi eventi vengono abbinati dal Paje Simulator utilizzando a
chiave fornita nel file di traccia. Se manca uno di questi due eventi per
qualche motivo arbitrario e il file di traccia termina (o il contenitore viene distrutto), lo farai
fare una simulazione con incompleto Collegamento. In generale, il Paje Simulator, e da
conseguenza pj_dump, considera questi collegamenti come errori ed elencali di seguito
maniera:

$ pj_dump ~/tracefile.paje
Elenco dei collegamenti incompleti nel contenitore '0':
Collegamento, 0, MSG_PROCESS_TASK_LINK, 0, -1, 0, SR, emittente-12, NULL
Collegamento, 0, MSG_PROCESS_TASK_LINK, 0.00013, -1, 0, SR, emittente-13, NULL
Collegamento, 0, MSG_PROCESS_TASK_LINK, 0.002868, -1, 0, SR, emittente-13, NULL
(...)
PajeLinkException: collegamenti incompleti alla fine del contenitore con nome '0'

L'azione migliore quando ciò accade è riparare il tracciante o il convertitore che lo ha generato
la traccia, poiché indica probabilmente qualche errore durante l'esecuzione. Se pensi
che questo errore è accettabile, puoi fornire il file -z passa alla pj_dump per dire a
Paje Simulator per ignorare i collegamenti incompleti. Tutto il file di traccia verrà scaricato e tutto
gli errori riguardanti i collegamenti incompleti verranno silenziosamente ignorati. Usare con cautela.

DEFINITO DALL'UTENTE CAMPI

I campi definiti dall'utente sono una funzionalità del formato file di traccia Paje da aggiungere ulteriori
informazioni in traccia che non appartengono ai campi tradizionali di ciascun evento
definizione. Una definizione di evento con quattro campi definiti dall'utente (dimensione, parametri, impronta e
Tag) si presenta così:

%EventDef PajeSetState 20
% Ora dell'appuntamento
% Stringa contenitore
% Stringa di tipo
% Stringa del valore
% Stringa di dimensioni
% Stringa parametri
% Stringa dell'impronta
% Stringa di etichetta
%EndEventDef

Il dump dei campi definiti dall'utente è disabilitato per impostazione predefinita in pj_dump. L'utente può attivare
loro passando -u (o --definito dall'utente) come argomento. In tal caso, l'output simile a CSV di
pj_dump verrà modificato rispetto alla definizione precedente (vedere DESCRIZIONE DELL'OUTPUT). Oltretutto
scaricando i campi predefiniti per ciascuna entità e contenitore della traccia, il CSV avrà
campi aggiuntivi che corrispondono ai campi definiti dall'utente. L'ordine in cui appaiono
nell'output obbedisce all'ordine della definizione dell'evento corrispondente. Quindi a Regione / Stato definito
con la definizione dell'evento 20 sopra avrà quattro campi aggiuntivi in ​​stile CSV
produzione.

RISORSE

Descrizione del file di traccia Paje:
http://paje.sourceforge.net/download/publication/lang-paje.pdf

Sito web principale: http://github.com/schnorr/pajeng/

REPORTING BUG

Segnala i bug di pj_dump ahttp://github.com/schnorr/pajeng/issues>

COPYRIGHT

Copyright (C) 2012-2014 Lucas M. Schnorr. L'uso gratuito di questo software è concesso ai sensi del
termini della GNU General Public License (GPL).

Utilizza pj_dump online utilizzando i servizi onworks.net