Útgáfa 2.14.0
Ellexus – Breeze Trace-Only notendahandbók
Inngangur
Breeze HPC er tól sem notað er til að leysa dreifingu og stilla vandamál þegar þú setur upp og keyrir flókin Linux forrit.
Breeze TraceOnly er lítið niðurhal sem gerir þér kleift að rekja forrit og senda þau til einhvers sem hefur fullt Breeze leyfi.
Þú getur ekki skoðað gögnin án Breeze leyfis, en ef hugbúnaðarframleiðandinn þinn gerir það, þá geturðu sent þeim gögn svo þeir geti fundið út hvað vandamálið er.
Breeze TraceOnly rekur röksemdir forrita, umhverfi og ósjálfstæði til að nota við bilanaleit bygginga eða uppsetningarvandamála og leysa vandamál af völdum vantar files eða bókasöfn.
Breeze TraceOnly skráir einnig I/O mynstur svo að þú getir skilið hvernig forritin þín nota netið og file kerfi. Þessi gögn er hægt að nota til að leysa frammistöðuvandamál og meta getu umsóknar þinnar til að skalast í samhliða umhverfi.
Uppsetning
Sæktu nýjustu útgáfuna af Breeze TraceOnly frá okkar websíðuna og draga hana út einhvers staðar skynsamlega. Gakktu úr skugga um að þú halar niður viðeigandi útgáfu af Breeze TraceOnly (32 eða 64 bita) fyrir vélina sem þú vilt keyra hana á.
Breeze TraceOnly krefst ekki sérstakra heimilda eða leyfis og getur verið keyrt af hvaða notanda sem hefur heimild til að keyra forritið sem er til rannsóknar.
Að rekja umsókn
Breeze TraceOnly er keyrt með rekjaforritinu. sh forskrift sem er fáanleg á efstu stigi möppu uppsetningar.
Til að rekja og profile forrit sem þú skrifar bara trace-program. sh -f fylgt eftir með skipun þinni og rökum. Til dæmisample:
$ ./trace-program.sh -f ~/trace framleiðsla gera allt
Ef úttaksskráin sem tilgreind er í valmöguleikanum -f er til og inniheldur þegar rekja gögn mun handritið birta viðvörunarskilaboð og hætta.
3.1 Skipanalínuvalkostir
Eftirfarandi hluti sýnir alla gilda skipanalínuvalkosti sem rekjaforritin nota. sh. Allir möguleikar til að rekja forrit. sh, verður að tilgreina fyrir skipunina sem á að rekja.
–bash-aliases= file> -ab file>
Framboð a file af bash alias skilgreiningum. Breeze þarf skilgreiningarnar til að rekja samnefni.
Hentugt samheiti file hægt að búa til með því að keyra eftirfarandi skipun í bash áður en þetta handrit er keyrt:
$ alias > alias.txt
–post-trace=
-c
Framkvæma post-trace skipun eftir að forritinu undir rekja er lokið.
Skipunin sjálf mun ekki vera atvinnumaðurfiled, rakið, fylgst með eða stöðvað. Þú getur notað þessa skipun til að keyra stutta eftirvinnsluforskrift eða til að búa til fána file, td –post-trace=" snertið /path/to/log/file“. Ef skipunin lýkur ekki innan 10 mínútna mun hún drepast.
–log=filenafn >
-lfilenafn >
Skráðu Breeze villuboð í tilgreindu file. Ef þessi valkostur er ekki stilltur verða villur sendar til stderr.
–úttak=
-f
Skráin sem rakningargögn verða skrifuð í og sem er notuð af Breeze TraceOnly fyrir tímabundna geymslu. Þessi valkostur er nauðsynlegur.
-profile=
-p
Þessi valkostur kveikir eða slökkir á prófílgreiningu. Þegar kveikt er á því safnar Breeze margs konar tölfræði um rekstur forritanna sem eru rekin. Sjálfgefið er kveikt á sniði, en ef slökkt er á þessu getur það flýtt fyrir rakningu og dregið úr stærð úttaksins. Nákvæmt sett af tölfræði sem er safnað er stjórnað af umhverfisbreytum sem lýst er í sniðvalkostum.
-pakkar
Keyrir skriftu til að ákvarða pakkana sem eru settir upp á kerfinu þannig að Breeze geti ákvarðað hvar file ósjálfstæðir hafa komið frá. Slökkt sjálfgefið. Þetta bætir við miklum kostnaði áður en forritið er keyrt og ætti aðeins að nota ef þörf krefur.
-flytja
Skrá þar sem rakningargögn verða afrituð eftir að keyrslu lýkur. Má nota til að flýta fyrir keyrslutíma forritsins sem er rekið með því að skrá þig inn á staðbundna geymslu og flytja gögnin í netgeymslu eftir það.
–fjarstýring=<[bsub][,lsbatch][,lsrun][,qsub][,rsh][,sbatch][,srun][,ssh]>
–fjarstýring= -r
Þessi valkostur stjórnar því hvort Breeze fylgir forriti yfir á nýjan keyrsluhýsil eða ekki.
Hægt er að tilgreina valmöguleikann sem annað hvort kommuaðskilinn lista yfir studdar ræstingarskipanir eða ein af já eða nei. Gildið já jafngildir því að skrá allar gildar ræsingarskipanir og er sjálfgefið gildi fyrir þennan valkost. Með því að stilla þennan valmöguleika á nei slekkur það á rekstri barnastarfa.
Listi yfir skipanir sem þessi valkostur styður nú er bsub, batch, run, qsub, rush, run, ssh og batch.
Nýi gestgjafinn verður að vera með sömu Breeze uppsetningu í sömu möppu og fyrsta vélin, og rekjaúttaksskráin verður að vera staðsett á sameiginlegri file kerfi sem er fest á sama stað á hverri vél.
–fjarstarf=já
-fjar-starf
Fylgstu með fjarstörfum. Þegar eitt eða fleiri afskekkt undirverk eru sett af stað frá stjórn/forriti á efstu stigi þá bíður efsta starfið þar til öll ytri störfin ljúki. Þessi valkostur er sjálfgefið slökktur.
–skel=
-s
Leiðin að skelinni þinni. Þetta er notað til að rekja gagnvirkar lotur sem keyrðar eru með su, ssh og svipuðum forritum.
–stat=
-S
Sjálfgefið er að símtöl í stat fjölskyldunni (stat, fstat og lstat) eru ekki rakin og profiled. Ef kveikt er á þessu gæti það hægja á rekja og auka stærð framleiðslunnar.
-tcsh
-t
Keyrðu skipunina sem á að rekja í tcsh skel
–tcsh-aliases= file>
-kl file>
Framboð a file af tcsh eða csh alias skilgreiningum. Breeze þarf skilgreiningarnar til að rekja samnefni.
Hentugt samheiti file er hægt að búa til með því að keyra eftirfarandi skipun í reiðufé eða reiðufé áður en þetta handrit er keyrt:
$ alias > alias.txt
–rekja=
Þessi valkostur breytist til að rekja eða slökkva. Sjálfgefið er kveikt á rekningum.
Gildið all-io gerir fullkomna I/O rakningu kleift. Með –trace=all-io safnar Breeze TraceOnly gögnum um allar lestur, skrif og leitir til viðbótar við staðlaða rakningargögnin. Meðan á sjálfgefna rakningarhamnum ( –trace=yes) er aðeins fyrsta lestur, ritun og leitaraðgerð fyrir hverja file er skráð. ATHUGIÐ Að nota –trace=all-io valmöguleikann gæti hægt á rakningu verulega og gæti aukið stærð úttaksins verulega – að virkja sniðgreiningu (sjálfgefið) mun gefa flestar nauðsynlegar upplýsingar með lægri kostnaði.
–afbrigði=
Þessi valkostur velur Breeze afbrigðið, sem gerir frekari rekningarvirkni kleift.
Núverandi studd gildi gera MPI I/O rakningu kleift fyrir MPICH
(–variant=mpich), MVAPICH (–variant=mvapich) og OpenMPI
(–variant=ompi) forrit.
3.2 Sniðstillingarvalkostir
Nákvæmt sett af tölfræði sem er safnað er stjórnað af umhverfisbreytum. Þessar umhverfisbreytur eru teknar saman hér að neðan.
BREEZE_PROFILE_FÖUUR
Listi yfir fötur aðskilinn með kommum.
Breeze TraceOnly samanlagður file kerfistölfræði yfir tilgreind undirmengi file kerfi, sem við vísum til sem fötur.
Föt getur verið hvaða sem er file eða skrá. Ef heiti fötu inniheldur kommu verður að sleppa því með einum afturská \ staf.
Sjálfgefið er að allar efstu möppur í þínum file kerfi og allir virkir festingarpunktar.
BREEZE_PROFILE_BUCKET_STATS
Boolean, „1“ fyrir kveikt, „0“ fyrir slökkt.
Þegar stillt er á „1“ safnar Breeze TraceOnly eftirfarandi tölfræði.
Í fyrsta lagi telur fjölda símtala í aðgerðir sem nota file kerfi. Þessar aðgerðir eru settar saman í eftirfarandi hópa:
| samþykkja | samþykkja |
| aðgangur | aðgangur, chdir, lestur, raunveruleg leið, tölfræði, … |
| tengja | tengja |
| búa til | búa til, opna (ef file er búið til), tmpfile, mkdir, … |
| eyða | fjarlægja, rmdir, aftengja, … |
| skipta um hnött | chmod, hlekkur, endurnefna, … |
| hnöttur | glob, glob64 |
| opið | opna, opna, … |
| lesa | fgets, steikt, kort, lesa, lesandi, recv, scanf, … |
| leita | sléttur, leita, spóla til baka, … |
| skrifa | villa, skrifa, prenta, setja, senda, vara við, skrifa, … |
Í öðru lagi, talning á fjölda bæta sem eru lesin og skrifuð og leitarfjarlægð.
Hver þessara tölfræði er tekin saman fyrir hvern og einn file kerfisfötur stilltar af BREEZE_PROFILE_FÖUUR (sjá að ofan).
Sjálfgefið er „1“ fyrir á.
BREEZE_PROFILE_TÍMABIL
Heiltölugildi sem tilgreinir hversu oft tölfræði er tilkynnt.
Sjálfgefið er að gert er ráð fyrir að tímabil sé gefið upp í millisekúndum, en þú getur beinlínis notað eininguna „okkur“ fyrir míkrósekúndur, „ms“ fyrir millisekúndur eða „s“ fyrir sekúndur.
Sjálfgefið er „1000ms“ (1 sekúnda).
BREEZE_PROFILE_NETWORK_STATS
Boolean, „1“ fyrir kveikt, „0“ fyrir slökkt.
Þegar stillt er á „1“ safnar Breeze TraceOnly fjölda símtala í aðgerðir sem nota netið. Þessar aðgerðir eru settar saman í eftirfarandi hópa:
| samþykkja | samþykkja |
| binda | binda |
| tengja hlusta | tengja |
| hlustaðu | hlustaðu |
| lesa | lesa, endurskoða, … |
| skrifa | skrifa, senda, … |
Þessar tölfræði er safnað saman af hverju fjarvistfangi sem aðgangur er að.
Sjálfgefið er „1“ fyrir á.
BREEZE_PROFILE_BUCKET_LATENCY
Boolean, „1“ fyrir kveikt, „0“ fyrir slökkt.
Þegar stillt er á „1“ mælir Breeze TraceOnly þann tíma sem fallakall sem nota file kerfi.
Þessum aðgerðum er safnað saman í hópana sem lýst er undir BREEZE_PROFILE_BUCKET_STATS hér að ofan (samþykkja, fá aðgang, tengjast, breyta, hnatta, opna, lesa, skrifa).
Breeze safnar hámarks- og lágmarks töfum og fjölda símtala sem falla inn á hvert leyndsvið sem stillt er af
BREEZE_PROFILE_TIME_RANGES (sjá hér að neðan), fyrir hvert af file kerfisfötur stilltar af BREEZE_PROFILE_FÖUUR.
Sjálfgefið er „1“ fyrir á.
BREEZE_PROFILE_NETWORK_LATENCY
Boolean, „1“ fyrir kveikt, „0“ fyrir slökkt.
Þegar stillt er á „1“ mælir Breeze TraceOnly þann tíma sem aðgerðasímtöl taka sem nota netið.
Þessum aðgerðum er safnað saman í hópana sem lýst er undir BREEZE_PROFILE_NETWORKS_STATS hér að ofan (samþykkja, binda, tengja, hlusta, lesa, skrifa).
Breeze safnar hámarks- og lágmarks töfum og fjölda símtala sem falla inn á hvert leyndsvið sem stillt er af
BREEZE_PROFILE_TIME_RANGES (sjá hér að neðan), fyrir hvert fjarvistfang sem opnað er fyrir.
Sjálfgefið er „1“ fyrir á.
BREEZE_PROFILE_TIME_RANGES
Listi yfir tímabilsmörk aðskilinn með kommum.
Þegar BREEZE_PROFILE_BUCKET_LATENCY eða BREEZE_PROFILEKveikt er á _NETWORK_LATENCY, Breeze safnar saman fjölda símtala sem falla undir ákveðin tímabil (talning símtala sem tekur minna en 1us, fjöldi símtala sem tekur 1-10us, …).
Sérhver tímabilsmörk verða að vera tilgreind sem heiltölugildi. Ef ekki er tilgreint er gert ráð fyrir að bilið sé gefið upp í millisekúndum, en þú getur beinlínis notað eininguna „okkur“ fyrir míkrósekúndur, „ms“ fyrir millisekúndur eða „s“ fyrir sekúndur.
Til dæmisample, ef þú stillir:
BREEZE_PROFILE_TIME_RANGES=1us,1ms,1s
Síðan eru fjögur svið skilgreind: ≤1us, 1us-1ms, 1ms-1s og >1s.
Breeze TraceOnly mun samþykkja allt að 15 gildi fyrir þessa stillingu (þar af leiðandi allt að 16 svið).
Defaults to 1us,10us,100us,1ms,10ms,100ms,1s,10s,100s,1000s.
BREEZE_PROFILE_FAILED_IO
Boolean, „1“ fyrir kveikt, „0“ fyrir slökkt.
Þegar stillt er á „1“ safnar Breeze TraceOnly fjölda aðgerðakalla sem mistókust.
Þessum aðgerðum er safnað saman í hópana sem lýst er hér að ofan (samþykkja, fá aðgang, binda, tengja, breyta, hnoða, hlusta, opna, lesa, leita, skrifa).
Hver þessara tölfræði er tekin saman fyrir hvern og einn file kerfisfötur stilltar af BREEZE_PROFILE_FÖUUR (sjá
hér að ofan), og fyrir hvert fjarvistfang (ef um netkerfisaðgerðir er að ræða).
Bilanir eru teknar saman eftir villunúmeri (errno).
Sjálfgefið er „1“ fyrir á.
BREEZE_PROFILE_FS_TRAWL
Boolean, „1“ fyrir kveikt, „0“ fyrir slökkt.
Þegar stillt er á „1“ auðkennir Breeze TraceOnly tilvik þegar forrit „trollar“ file kerfi, prófa marga sem eru ekki til file kerfisleiðir í röð.
File kerfistroll getur gerst þegar umhverfið er illa stillt, tdample, ef PATH hefur marga þætti, og svo forrit verða að leita á mörgum stöðum til að finna files sem þeir þurfa. Á dreift file kerfi sem þetta getur valdið alvarlegri skerðingu á frammistöðu.
Breeze skilgreinir „troll“ sem óslitna röð BREEZE_PROFILE_TRAWL_LENGTH (sjá hér að neðan) eða fleiri misheppnuð símtöl í sömu aðgerðina. Trollið lýkur annaðhvort með vel heppnuðu símtali í þeirri aðgerð eða með því að kalla á aðra aðgerð.
Breeze skráir fjölda misheppnaðra útkalla í trollinu, nafnið á file í tengslum við síðasta misheppnaða símtalið og þann tíma sem öll röð misheppnaðra símtala tekur.
Sjálfgefið er „1“ fyrir á.
BREEZE_PROFILE_TRAWL_LENGTH
Heiltölugildi sem tilgreinir lágmarksfjölda misheppnaðra útkalla sem Breeze telur vera „troll“. Sjá BREEZE_PROFILE_FS_TRAWL
hér að ofan.
Sjálfgefið er „4“.
BREEZE_PROFILE_RESOURCE_USAGE
Boolean, „1“ fyrir kveikt, „0“ fyrir slökkt.
Þegar stillt er á „1“ tilkynnir Breeze um minni og örgjörva sem forritið notar sem atvinnumaðurfiled.
Breeze skráir „heildarforritstærð“ (frátekið sýndarminni) og „staðsetta stærð“ (kortlagt minni) eins og greint er frá af /proc/[pid]/state. Sjá „man proc(5)“ fyrir frekari upplýsingar.
Breeze skráir einnig „notanda CPU tíma“ og „kerfis CPU tíma“ sem fjölda míkrósekúnda frá síðustu mælingu.
Það skráir einnig „sjálfráða samhengisrofa“ og „ósjálfráða samhengisrofa“. Gildin tákna delta til síðustu mælingar.
Sjálfgefið er „1“ fyrir á.
BREEZE_PROFILE_SYMLINK_COUNT
Boolean, „1“ fyrir kveikt, „0“ fyrir slökkt.
Þegar stillt er á „1“ telur Breeze TraceOnly fjölda táknrænna tengla sem þarf að fylgja til að leysa hverja file kerfisslóð sem forritið undir rekja notar.
Breeze safnar saman talningu á file kerfisaðgerðir eftir lengd samkennslukeðjunnar, allt að BREEZE_PROFILE_SYMLINK_DEPTH (sjá hér að neðan).
Sjálfgefið er „1“ fyrir á.
BREEZE_PROFILE_SYMLINK_DEPTH
Heiltölugildi sem tilgreinir hámarkslengd keðju af táknrænum hlekkjum sem Breeze TraceOnly mun fylgja. Sjá BREEZE_PROFILE_SYMLINK_COUNT hér að ofan.
Sjálfgefið er „5“.
3.3 Rekja forrit á ytri vélum
Breeze TraceOnly styður eins og er rekjaforrit á ytri vélum með bsub, batch, run, qsub, rsh, batch, run og ssh.
Upphaflega rekjaforritið. hægt er að senda sh forskriftina til studdra vinnutímaritara eins og undir eða undir beint svo framarlega sem Breeze TraceOnly uppsetningin er tiltæk í gegnum sömu slóð á öllum mögulegum ytri hýsilhnútum.
Þar að auki, ef forritið undir rekja keyrir skipun á nýjan keyrsluhýsil með einni af studdu skipunum, Breeze
Tracey mun reyna að endurskrifa skipunina þannig að þetta verkefni verði einnig rakið. Úttaksskráin sem notuð er fyrir skipunina á ytri hýsilinn verður búin til undir úttaksskránni sem tilgreind er með upphafsvalkostinum -f, sem verður því að vera tiltæk á öllum mögulegum ytri hýsilhnútum, og heitir:
/fjarspor- -
Að auki, ef skipunin var send inn sem hluti af starfsfylki, verður fylkisvísitala starfsins sem er rekjað bætt við sem gefur fulla úttaksskráarforskrift um /fjarspor- - -
3.4 Takmarkanir
Til að rekja samsetta skipun eins og skipun1 && skipun2 eða leiðslu eins og skipun1 | skipun2, þú verður að vitna í skipunina til að koma í veg fyrir að skelin túlki skipun1 sem rök til að rekja forrit. sh og setja úttak þess inn í command2. Til dæmisample:
$ ./trace-program.sh -f „skipun1 | skipun 2"
Hinn valkosturinn er að pakka allri skipuninni inn í skel. Til dæmisample: $ ./trace-program.sh -f ; sh -c \ cd /öpp; ./io_skipun | skipun 2
Það er mikilvægt að hafa í huga að Breeze TraceOnly greinir ekki sjálfkrafa samsettar skipanir þegar endurskrifa vinnuskil til fjarlægra gestgjafa.
Að öðrum kosti geturðu fengið trace-program.sh, framkvæmt skipanirnar sem þú vilt rekja og farið úr skelinni:
$ . ./trace-program.sh -f
$ cd / öpp
$ ./io_skipun | skipun 2
$ hætta
3.5 Rekjaminni-kortlagt files
Þegar rekja forrit sem kort files inn í minni með mmap rekur Breeze upphaflegu kortaaðgerðina ef hún er studd af a file.
Allar síðari aðgerðir á minnissvæðinu sjálfu eru ekki raktar. Til dæmisample, þegar forrit kallar á kort, Breeze mun rekja lestur / skrifa aðgerð fyrir file í spurningu. Ef forritið myndi síðan lesa/skrifa inn á minnissvæðið mun Breeze ekki rekja minni I/O aðgerðirnar.
Ef forrit kallar á kort með MAP_ANONYMOUS fána (þ.e. kortlagning er ekki studd af neinum file), Breeze mun ekki rekja kortaaðgerðina. Breeze rekur heldur ekki munmap-aðgerð, sem eyðir núverandi kortlagningu.
Að fjarlægja trúnaðarupplýsingar úr rekjaúttakinu
Það er mögulegt að þegar þú rekur forrit gæti Breeze TraceOnly hafa náð upplýsingum sem þú vilt ekki deila með teyminu sem mun greina rakningarúttakið eins og trúnaðarmál file nöfnum.
Sjálfgefið Breeze býr TraceOnly til tvöfaldur fileÞar sem þetta er plásshagkvæmara, er hins vegar hægt að umbreyta þessu tvöfalda úttak í venjulegan texta með því að nota afkóða-rekja. sh forskrift sem er að finna í efstu möppu uppsetningar.
Handritið tekur tvær breytur: $ ./decode-trace.sh
The ætti að vera Breeze TraceOnly úttaksmappa. Þetta mun annað hvort vera skráin sem er send sem -f valmöguleikinn í rekjaforrit. sh skipun eða rekja skrá sem er búin til sem afleiðing af því að keyra skipun á ytri hýsil (eins og lýst er í kaflanum Rekja forrit á ytri vélum hér að ofan).
Allir strengir, nöfn og breytur í rekningunni eru skráðar í file kallaðir strengir á efsta stigi afkóðuðu rekjaskráruppbyggingarinnar. Þetta file hægt að breyta með hvaða texta sem er file ritstjóri sem gerir notandanum kleift að breyta trúnaðargildum.
Þegar öll trúnaðargögn hafa verið uppfærð er hægt að senda venjulegu textaútgáfuna af rekningunni til teymisins sem mun greina ummerkin í stað upprunalega tvíundarúttaksins.
Skjöl / auðlindir
 |
breeze HPC tól notað til að leysa dreifingu [pdfNotendahandbók HPC tól notað til að leysa dreifingu |
