Vèsyon 2.14.0
Ellexus – Manyèl Itilizatè Breeze Trace-Only

Entwodiksyon

Breeze HPC se yon zouti ki itilize pou rezoud pwoblèm deplwaman, ak ajisteman lè w ap enstale ak kouri aplikasyon konplèks Linux.
Breeze TraceOnly se yon ti telechajman ki pèmèt ou trase aplikasyon yo epi voye yo bay yon moun ki gen yon lisans Breeze konplè.
Ou pa ka gade nan done yo san yon lisans Breeze, men si machann lojisyèl ou a fè sa, Lè sa a, ou ka voye yo done pou yo ka travay sou ki pwoblèm nan.
Breeze TraceOnly trase agiman aplikasyon, anviwònman, ak depandans pou itilize nan depanaj pwoblèm konstriksyon oswa enstalasyon ak rezoud pwoblèm ki te koze pa manke. files oswa bibliyotèk.
Breeze TraceOnly anrejistre tou modèl I/O pou ou ka konprann kijan pwogram ou yo ap itilize rezo a ak file sistèm. Done sa yo ka itilize pou rezoud pwoblèm pèfòmans ak evalye kapasite aplikasyon w lan pou echèl nan anviwònman paralèl.

Enstalasyon

Telechaje dènye vèsyon Breeze TraceOnly nan nou websit epi ekstrè li yon kote ki sansib. Tanpri asire w ke ou telechaje vèsyon ki apwopriye a nan Breeze TraceOnly (32 oswa 64 bit) pou machin nan ou vle kouri sou li.
Breeze TraceOnly pa bezwen okenn otorizasyon oswa lisans espesyal epi nenpòt itilizatè ki otorize pou kouri aplikasyon an anba envestigasyon ka dirije.

Trase yon aplikasyon

Breeze TraceOnly ap kouri lè l sèvi avèk pwogram tras la. sh script ki disponib nan anyè ki pi wo nan enstalasyon an.
Pou trace ak profile yon aplikasyon ou jis tape trace-program. sh -f ki te swiv pa kòmand ou ak agiman. Pou egzanpample:
$ ./trace-program.sh -f ~/trace pwodiksyon fè tout
Si anyè pwodiksyon ki espesifye nan opsyon -f la egziste epi li deja gen tras done script la ap montre yon mesaj avètisman epi sòti.

3.1 Opsyon liy kòmand
Seksyon sa a bay lis tout opsyon liy kòmand ki valab yo itilize pa pwogram tras yo. sh. Tout opsyon pou trase-pwogram. sh, yo dwe espesifye anvan kòmandman an yo dwe trase.
–bash-alyas= file> -ab file>
Pwovizyon pou a file nan definisyon bash alyas. Breeze bezwen definisyon yo nan lòd yo trase alyas.
Yon alyas apwopriye file ka pwodwi pa kouri lòd sa a nan bash anvan ou kouri script sa a:
$ alyas > alias.txt
–post-tras =
-c

Egzekite yon lòd pòs-tras apre pwogram ki anba tras la fini.
Kòmand nan tèt li pa pral profiled, trase, kontwole, oswa throttled. Ou ka sèvi ak kòmandman sa a pou fè yon kout script post-traitement, oswa pou kreye yon drapo file, pa egzanp, –post-trace=" touche /chemen/pou/log/file". Si lòd la pa fini nan 10 minit, li pral touye.
–log =filenon>
-lfilenon>
Ekri mesaj erè Breeze nan espesifye a file. Si opsyon sa a pa mete, erè yo pral voye bay stderr.
– pèsistans yap ogmante jiska=
-f
Anyè ke done trase yo pral ekri nan, epi ki itilize pa Breeze TraceOnly pou depo tanporè. Opsyon sa a obligatwa.
-profile=
-p
Opsyon sa a vire profilage sou oswa koupe. Lè pèmèt Breeze kolekte anpil kalite estatistik sou operasyon an nan pwogram yo anba tras. Profilage se sou pa default, men fèmen sa a ka akselere trase ak diminye gwosè a nan pwodiksyon an. Ansanm egzak estatistik ke yo kolekte kontwole pa varyab anviwònman ki dekri nan Opsyon Profiling.
-pake
Kouri yon script pou detèmine pakè ki enstale sou sistèm lan pou Breeze ka detèmine ki kote file depandans yo soti. Off pa default. Sa a ajoute yon gwo sou tèt anvan ou kouri pwogram ou a epi yo ta dwe itilize sèlman si sa nesesè.
– deplase
Anyè kote done tras yo pral kopye apre kouri a fini. Yo ka itilize pou pi vit tan ekzekisyon pwogram nan anba tras pa antre nan depo lokal yo, epi transfere done yo nan depo rezo apre sa.
–remote=<[bsub][,lsbatch][,lsrun][,qsub][,rsh][,sbatch][,srun][,ssh]>
-remote= -r
Opsyon sa a kontwole si wi ou non Breeze pral swiv yon aplikasyon nan yon nouvo lame ekzekisyon.
Opsyon an ka espesifye swa kòm yon lis ki separe ak vigil kòmandman lanse travay oswa youn nan wi oswa non. Valè wi ekivalan a lis tout kòmandman valab pou lanse travay epi li se valè default pou opsyon sa a. Mete opsyon sa a pa enfim trase nenpòt travay timoun yo.
Lis kòmandman ki sipòte kounye a ke opsyon sa a rekonèt se bsub, pakèt, kouri, qsub, prese, kouri, ssh ak pakèt.
Nouvo lame a dwe gen yon enstalasyon Breeze ki idantik nan menm anyè ak premye machin nan, epi anyè pwodiksyon tras la dwe lokalize sou yon pataj. file sistèm ki monte nan menm kote sou chak machin.
–remote-job=wi
-travay-remote

Swiv travay aleka. Lè youn oswa plizyè travay timoun aleka yo te lanse apati yon kòmandman/script ki pi wo nivo Lè sa a, travay nan tèt nivo ap tann pou tout travay aleka yo fini. Opsyon sa a koupe pa default.
–koki=
-s
Chemen nan koki ou. Sa a se itilize nan trase sesyon entèaktif egzekite lè l sèvi avèk su, ssh, ak pwogram ki sanble.
–stat=
-S
Pa defo apèl nan fanmi stat ( stat, fstat, ak lstat) yo pa swiv ak profiled. Vire sa a ka ralanti trase ak ogmante gwosè a nan pwodiksyon an.
-tcsh
-t

Kouri kòmandman an yo dwe trase nan yon kokiy tcsh
–tcsh-alyas= file>
-nan file>
Pwovizyon pou a file nan definisyon tcsh oswa csh alyas. Breeze bezwen definisyon yo nan lòd yo trase alyas.
Yon alyas apwopriye file ka pwodwi pa kouri lòd sa a nan lajan kach oswa lajan kach anvan ou kouri script sa a:
$ alyas > alias.txt
–tras =
Opsyon sa a vire nan tras sou oswa koupe. Trase se sou pa default.
Valè all-io a pèmèt konplè I/O trase. Avèk –trace=all-io, Breeze TraceOnly kolekte done sou tout lekti, ekri, epi chèche anplis done trase estanda yo. Lè nou konsidere ke nan mòd nan swiv default (-trace = wi), sèlman premye li, ekri ak chèche operasyon pou chak. file se anrejistre. NB Sèvi ak –trace=all-io opsyon ka ralanti konsiderableman trase epi li ka ogmante gwosè a nan pwodiksyon an siyifikativman - pèmèt pwofil (sou pa default) pral bay pi fò nan enfòmasyon ki nesesè yo ak yon tèt pi ba.

–variante=
Opsyon sa a chwazi Variant Breeze la, ki pèmèt plis fonksyonalite trase.
Valè yo sipòte kounye a pèmèt MPI I/O trase pou MPICH
(–variant = mpich), MVAPICH (–variant = mvapich) ak OpenMPI
(–variant=ompi) aplikasyon yo.

3.2 Opsyon Profilage
Ansanm egzak estatistik ke yo kolekte kontwole pa varyab anviwònman an. Yo rezime varyab anviwònman sa yo anba a.
BREEZE_PROFILE_BOOT
Yon lis bokit ki separe ak vigil.
Breeze TraceOnly total file estatistik sistèm sou sous-ensemble espesifye nan file sistèm, ke nou refere yo kòm bokit.
Yon bokit ka nenpòt file oswa anyè. Si yon non bokit gen yon vigil li dwe chape ak yon sèl backslash \ karaktè.
Par défaut nan tout anyè nivo siperyè nan ou file sistèm ak tout pwen mòn aktif yo.
BREEZE_PROFILE_BUCKET_STATS
Boolean, "1" pou limen, "0" pou koupe.
Lè yo mete sou "1" Breeze TraceOnly kolekte estatistik sa yo.
Premyèman, konte kantite apèl nan fonksyon ki sèvi ak file sistèm. Fonksyon sa yo rasanble nan gwoup sa yo:

aksepte	aksepte
aksè	aksè, chdir, lekti, chemen reyèl, stat, ...
konekte	konekte
kreye	kreye, louvri (si la file se kreye), tmpfile, mkdir, ...
efase	retire, rmdir, dekonekte, ...
chanje glob	chmod, lyen, chanje non, ...
glob	glob, glob64
louvri	louvri, louvri, ...
li	fgets, fried, map, read, reader, recv, scanf, …
chache	dous, chèche, remonte, ...
ekri	erè, ekri, enprime, mete, voye, avèti, ekri, ...

Dezyèmman, konte kantite byte li ak ekri ak distans rechèch la.
Chak nan estatistik sa yo se total pou chak nan file bokit sistèm configuré pa BREEZE_PROFILE_BOLET (gade pi wo a).
Pa défaut a "1" pou sou.
BREEZE_PROFILE_TIME_INTERVAL
Yon valè nonb antye relatif ki presize konbyen fwa yo rapòte estatistik yo.
Pa default, entèval tan yo sipoze bay nan milisgond, men ou ka klèman itilize inite "us" pou mikrosgond, "ms" pou milisgond, oswa "s" pou segonn.
Pa défaut a "1000ms" (1 segonn).
BREEZE_PROFILE_NETWORK_STATS
Boolean, "1" pou limen, "0" pou koupe.
Lè yo mete sou "1" Breeze TraceOnly kolekte kantite apèl nan fonksyon ki itilize rezo a. Fonksyon sa yo rasanble nan gwoup sa yo:

aksepte	aksepte
mare	mare
konekte tande	konekte
koute	koute
li	li, revwa, ...
ekri	ekri, voye,...

Estatistik sa yo rasanble pa chak adrès aleka jwenn aksè.
Pa défaut a "1" pou sou.
BREEZE_PROFILE_BUCKET_LATENCY
Boolean, "1" pou limen, "0" pou koupe.
Lè yo mete sou "1" Breeze TraceOnly mezire tan an pran pa apèl fonksyon ki itilize a file sistèm.
Fonksyon sa yo rasanble nan gwoup ki dekri anba BREEZE_PROFILE_BUCKET_STATS pi wo a (aksepte, aksè, konekte, chanje, glob, louvri, li, ekri).
Breeze kolekte latans maksimòm ak minimòm ak konte apèl ki tonbe nan chak nan ranje latansi konfigirasyon pa
BREEZE_PROFILE_TIME_RANGES (gade anba a), pou chak nan file bokit sistèm configuré pa BREEZE_PROFILE_BOOT.

Pa défaut a "1" pou sou.
BREEZE_PROFILE_NETWORK_LATENCY
Boolean, "1" pou limen, "0" pou koupe.
Lè yo mete sou "1" Breeze TraceOnly mezire tan an pran nan apèl fonksyon ki itilize rezo a.
Fonksyon sa yo rasanble nan gwoup ki dekri anba BREEZE_PROFILE_NETWORKS_STATS pi wo a (aksepte, mare, konekte, koute, li, ekri).
Breeze kolekte latans maksimòm ak minimòm ak konte apèl ki tonbe nan chak nan ranje latansi konfigirasyon pa
BREEZE_PROFILE_TIME_RANGES (gade anba a), pou chak adrès aleka, jwenn aksè.

Pa défaut a "1" pou sou.
BREEZE_PROFILE_TIME_RANGES
Yon lis limit entèval tan ki separe ak vigil.
Lè BREEZE_PROFILE_BUCKET_LATENCY oswa BREEZE_PROFILE_NETWORK_LATENCY limen, Breeze rasanble kantite apèl ki tonbe nan yon seri tan (konte apèl ki pran mwens pase 1us, konte apèl ki pran 1-10us, …).
Chak fwontyè entèval tan dwe espesifye kòm yon valè nonb antye relatif. Si yo pa espesifye, entèval la sipoze bay an milisgond, men ou ka klèman itilize inite "us" pou mikrosgond, "ms" pou milisgond, oswa "s" pou segonn.
Pou egzanpample, si ou mete:
BREEZE_PROFILE_TIME_RANGES=1us,1ms,1s
Lè sa a, gen kat seri defini: ≤1us, 1us-1ms, 1ms-1s, ak >1s.
Breeze TraceOnly pral aksepte jiska 15 valè pou anviwònman sa a (kidonk jiska 16 ranje).
Defaults to 1us,10us,100us,1ms,10ms,100ms,1s,10s,100s,1000s.
BREEZE_PROFILE_FAILED_IO
Boolean, "1" pou limen, "0" pou koupe.
Lè yo mete sou "1" Breeze TraceOnly kolekte kantite apèl fonksyon ki echwe.
Fonksyon sa yo rasanble nan gwoup ki dekri anwo yo (aksepte, jwenn aksè, mare, konekte, chanje, glob, koute, louvri, li, chèche, ekri).
Chak nan estatistik sa yo se total pou chak nan file bokit sistèm configuré pa BREEZE_PROFILE_BOLET (gade
pi wo a), ak pou chak adrès aleka (nan ka fonksyon rezo a).
Echèk yo ajoute pa nimewo erè (errno).
Pa défaut a "1" pou sou.
BREEZE_PROFILE_FS_TRAWL
Boolean, "1" pou limen, "0" pou koupe.
Lè yo mete sou "1" Breeze TraceOnly idantifye ka lè yon pwogram "trawls" la file sistèm, tès anpil ki pa egziste file chemen sistèm nan siksesyon.

File chalut sistèm ka rive lè anviwònman an mal configuré, pou egzanpample, si PATH a gen anpil eleman, e konsa pwogram yo gen pou chèche anpil kote pou jwenn la files ke yo bezwen. Sou distribye file sistèm sa a ka lakòz degradasyon pèfòmans grav.
Breeze defini yon "chalu" kòm yon sekans san enteripsyon nan BREEZE_PROFILE_TRAWL_LENGTH (gade anba a) oswa plis apèl echwe nan menm fonksyon an. Chalu a fini swa pa yon apèl siksè nan fonksyon sa a oswa pa yon apèl nan yon fonksyon diferan.
Breeze anrejistre kantite apèl echwe nan chalut la, non an nan file ki asosye ak dènye apèl ki echwe a, ak tan an pran nan sekans antye nan apèl echwe yo.
Pa défaut a "1" pou sou.

BREEZE_PROFILE_TRAWL_LONGTH
Yon valè nonb antye relatif ki espesifye kantite minimòm apèl ki echwe ke Breeze konsidere kòm yon "trawl". Gade BREEZE_PROFILE_FS_TRAWL
pi wo a.
Pa défaut a "4".
BREEZE_PROFILE_RESOURCE_USAGE
Boolean, "1" pou limen, "0" pou koupe.
Lè yo mete sou "1" Breeze rapòte memwa a ak CPU itilize pa pwogram nan ke yo te profiled.
Breeze anrejistre "dimansyon total pwogram" (memwa vityèl rezève) ak "gwosè seri rezidan" (memwa kat) jan /proc/[pid]/state rapòte. Gade "man proc(5)" pou plis detay.
Breeze anrejistre tou "tan CPU itilizatè" ak "tan CPU sistèm" kòm yon kantite mikrosgond depi dènye mezi a.
Li anrejistre tou "chanjman kontèks volontè" ak "chanjman kontèks envolontè". Valè yo reprezante delta nan dènye mezi a.

Pa défaut a "1" pou sou.
BREEZE_PROFILE_SYMLINK_COUNT
Boolean, "1" pou limen, "0" pou koupe.
Lè yo mete sou "1" Breeze TraceOnly konte kantite lyen senbolik ki dwe swiv pou rezoud chak. file chemen sistèm itilize pa pwogram nan anba tras.
Breeze total konte a nan file operasyon sistèm nan longè chèn symlink la, jiska BREEZE_PROFILE_SYMLINK_DEPTH (gade anba a).
Pa défaut a "1" pou sou.
BREEZE_PROFILE_SYMLINK_PROFONDÈ
Yon valè nonb antye relatif ki presize longè maksimòm yon chèn lyen senbolik ke Breeze TraceOnly pral swiv. Gade BREEZE_PROFILE_SYMLINK_COUNT pi wo a.
Pa défaut a "5".

3.3 Trase aplikasyon sou lame aleka
Breeze TraceOnly kounye a sipòte aplikasyon pou trase sou lame aleka lè l sèvi avèk bsub, batch, run, qsub, rsh, batch, run, ak ssh.
Pwogram tras inisyal la. ka script la sh dwe soumèt bay pwogramasyon travay sipòte tankou sub oswa sub dirèkteman osi lontan ke enstalasyon an Breeze TraceOnly disponib atravè chemen an menm sou tout nœuds lame aleka posib.
Anplis de sa, si pwogram nan anba tras kouri yon lòd sou yon nouvo lame ekzekisyon atravè youn nan kòmandman yo sipòte, Breeze.
Tracey pral eseye re-ekri kòmandman an pou travay sa a pral remonte tou. Anyè pwodiksyon yo itilize pou kòmandman sou lame aleka a pral kreye anba anyè pwodiksyon ki espesifye nan opsyon inisyal -f la, ki se poutèt sa dwe disponib sou tout nœuds lame aleka posib, epi li rele:
/remote tras- -
Anplis de sa, si yo te soumèt kòmandman an kòm yon pati nan yon etalaj travay yo pral ajoute endèks la nan etalaj travay ki anba tras la bay yon spesifikasyon anyè pwodiksyon konplè nan /remote tras- - -

3.4 Limitasyon
Pou trase yon kòmand konpoze tankou command1 && command2 oswa yon tiyo tankou command1 | komand2, ou dwe site kòmandman an nan lòd yo anpeche koki a entèprete kòmand1 kòm yon agiman nan trase-pwogram. sh ak kanalizasyon pwodiksyon li yo nan command2. Pou egzanpample:
$ ./trace-program.sh -f "kòmand1 | komand2"
Lòt opsyon an se vlope tout lòd la nan yon kokiy. Pou egzanpample: $ ./trace-program.sh -f ; sh -c \ cd /apps; ./io_command | komand2
Li enpòtan pou sonje ke Breeze TraceOnly pa pral otomatikman detekte kòmandman konpoze lè re-ekri soumèt travay bay lame aleka.
Altènativman, ou ka sous trace-program.sh, egzekite kòmandman ou vle trase epi sòti koki a:
$ . ./trace-program.sh -f
$ cd / apps
$ ./io_command | komand2
$ sòti
3.5 Trase memwa-map files
Lè w ap trase aplikasyon pou kat jeyografik la files nan memwa ak mmap, Breeze trase operasyon kat inisyal la si li te sipòte pa yon file.
Nenpòt operasyon ki vin apre sou zòn memwa nan tèt li yo pa remonte. Pou egzanpample, lè yon aplikasyon rele yon kat, Breeze ap trase operasyon an li/ekri pou la file an kesyon. Si aplikasyon an ta li/ekri nan zòn memwa a, Breeze pa pral trase operasyon I/O memwa yo.
Si yon aplikasyon rele yon kat ak yon drapo MAP_ANONYMOUS (sa vle di, kat la pa apiye pa okenn file), Breeze pa pral trase operasyon kat jeyografik la. Breeze tou pa trase operasyon munmap, ki efase yon kat ki egziste deja.

Retire enfòmasyon konfidansyèl nan pwodiksyon tras la

Li posib ke pandan y ap trase yon aplikasyon Breeze TraceOnly ka te kaptire enfòmasyon ou pa vle pataje ak ekip la ki pral analize pwodiksyon an tras tankou konfidansyèl file non.
Pa default Breeze, TraceOnly kreye binè files kòm sa a se pi plis espas-efikas, sepandan, li posib konvèti sa a pwodiksyon binè nan tèks plenn lè l sèvi avèk dekode-tras la. sh script ki ka jwenn nan anyè ki pi wo nan enstalasyon an.
Script la pran de paramèt: $ ./decode-trace.sh <anyè antre/dekode/ [anyè pwodiksyon] Si anyè pwodiksyon an pa defini, script la pral mete tras dekode a nan <anyè antre/dekode/
La ta dwe yon anyè pwodiksyon Breeze TraceOnly. Sa a pral swa anyè a pase kòm opsyon nan -f nan yon pwogram tras. sh kòmand oswa yon anyè tras ki te kreye kòm rezilta nan kouri yon kòmand sou yon lame aleka (jan sa dekri nan seksyon Aplikasyon trase sou lame aleka pi wo a).
Tout fisèl, non, ak varyab nan tras la yo ki nan lis la file yo rele fisèl nan nivo siperyè a nan estrikti anyè tras dekode. Sa a file ka modifye ak nenpòt tèks klè file editè ki pèmèt itilizatè a chanje nenpòt valè konfidansyèl.
Yon fwa tout done konfidansyèl yo te mete ajou, yo ka voye vèsyon tèks la nan tras la bay ekip la ki pral analize tras la nan plas pwodiksyon binè orijinal la.

Dokiman / Resous

Breeze Zouti HPC yo itilize pou rezoud deplwaman [pdfManyèl Itilizatè Zouti HPC yo itilize pou rezoud deplwaman

Referans

• Manyèl itilizatè