pmlogger - Online sa Cloud

PROGRAMA:

NAME

pmlogger - lumikha ng archive log para sa mga sukatan ng pagganap

SINOPSIS

pmlogger [-c configfile] [-h marami] [-K pagsasapalaran] [-l logfile] [-L] [-m nota] [-n pmnsfile]
[-o] [-p pid] [-P] [-r] [-s endsize] [-t agwat] [-T endtime] [-u] [-U username] [-v
volsize] [-V bersyon] [-x fd] [-y] archive

DESCRIPTION

pmlogger lumilikha ng mga archive log ng mga halaga ng sukatan ng pagganap na maaaring ``i-play back''
ng iba pang Performance Co-Pilot (tingnan PCPIntro(1)) mga kasangkapan. Ang mga log na ito ay bumubuo ng batayan ng
VCR paradigm at retrospective performance analysis na mga serbisyo na karaniwan sa PCP toolkit.

Ang ipinag-uutos na argumento archive ay ang batayang pangalan para sa mga pisikal na file na bumubuo ng isang
log ng archive.

Ang -V ang opsyon ay tumutukoy sa bersyon para sa archive na nabuo. Bilang default a
Ang bersyon 2 na archive ay nabuo, at ang tanging halaga na kasalukuyang sinusuportahan bersyon ay 2.

Maliban kung itinuro sa ibang host ng -h opsyon o kapag direktang gumagamit ng mga PMDA sa pamamagitan ng -o
pagpipilian, pmlogger makikipag-ugnayan sa Performance Metrics Collector Daemon (PMCD) sa lokal
host at gamitin iyon bilang pinagmumulan ng mga halaga ng sukatan na ila-log.

Upang suportahan ang kinakailangang flexibility at kontrol sa kung ano ang naka-log at kung kailan, pmlogger
nagpapanatili ng isang independiyenteng dalawang antas ng estado ng pag-log para sa bawat pagkakataon ng bawat pagganap
panukat. Sa unang (mandatory) na antas, pinapayagan ang pag-log on (na may nauugnay
agwat sa pagitan ng mga sample), o off or siguro. Sa huling kaso, ang pangalawa (advisory)
pinahihintulutan ang level logging on (na may nauugnay na pagitan sa pagitan ng mga sample), o off.

Ang mandatoryong antas ay nagbibigay-daan sa pangkalahatang detalye na ang ilang sukatan ay dapat na naka-log, o
dapat hindi ma-log. Ang default na katayuan para sa lahat ng pagkakataon ng lahat ng sukatan kung kailan pmlogger
Ang pagsisimula ay sapilitan siguro at advisory off.

paggamit pmlc(1) upang tanungin at baguhin ang estado ng pag-log nang isang beses pmlogger ay tumatakbo.

Kung ang estado ng isang sukatan ay sapilitan (naka-on o naka-off) at isang kahilingan ay ginawa upang baguhin ito sa
mandatory siguro, mandatory siguro ang bagong state at advisory off. Kung ang estado ng isang sukatan
is already advisory (on or off) and a request is made to change it to mandatory maybe, the
ang kasalukuyang estado ay napanatili.

Hindi pwede para sa pmlogger para mag-log ng mga partikular na instance ng isang sukatan at lahat ng instance ng
ang parehong sukatan nang sabay-sabay. Kung ang mga partikular na pagkakataon ay ni-log at isang kahilingan na mag-log
lahat ng mga pagkakataon ay ginawa, pagkatapos ang lahat ng mga pagkakataon ng sukatan ay mai-log ayon sa
bagong kahilingan, pinapalitan ang anumang naunang kahilingan sa pag-log para sa sukatan. Isang kahilingan na i-log ang lahat
Papalitan ng mga instance ng isang sukatan ang anumang nakaraang kahilingang i-log ang lahat ng instance. Isang kahilingan
upang mag-log ng mga partikular na pagkakataon ng isang sukatan kapag ang lahat ng mga pagkakataon ay naka-log na ay
tumanggi. Upang magawa ito, dapat munang i-off ang pag-log para sa lahat ng pagkakataon ng sukatan. Sa
bawat kaso, ang validity ng kahilingan ay susuriin muna; halimbawa ng kahilingang baguhin a
Ang estado ng pag-log ng panukat sa pagpapayo sa kung kailan ito ay kasalukuyang ipinag-uutos ay hindi kailanman
pinahihintulutan (kailangan na baguhin ang estado sa mandatory siguro muna).

Opsyonal, tumatakbo ang bawat system pmcd(1) ay maaari ding i-configure upang magpatakbo ng ``pangunahing''
pmlogger halimbawa. Ito pmlogger instance ay inilunsad ng $PCP_RC_DIR/pmlogger, At ito ay
apektado ng mga file $PCP_SYSCONF_DIR/pmlogger/control,
$PCP_SYSCONF_DIR/pmlogger/control.d (gamitin chkconfig(8) o katulad na partikular sa platform
mga utos para i-activate o i-disable ang primary pmlogger halimbawa),
$PCP_SYSCONFIG_DIR/pmlogger (mga setting ng variable ng kapaligiran para sa primary pmlogger)
$PCP_SYSCONF_DIR/pmlogger/pmlogger.options (mga opsyon sa command line na ipinasa sa primary
pmlogger) At $PCP_VAR_LIB/config/pmlogger/config.default (ang default na inisyal
configuration file para sa primary pmlogger).

primary ang pmlogger halimbawa ay kinilala ng -P opsyon. Maaaring mayroong hindi hihigit sa isa
``pangunahin'' pmlogger halimbawa sa bawat sistema. Ang pangunahin pmlogger halimbawa (kung mayroon man) ay dapat
ay tumatakbo sa parehong host bilang ang pmcd(1) kung saan ito kumokonekta (kung mayroon man), kaya ang -h at -P
ang mga pagpipilian ay kapwa eksklusibo.

Posible ang pag-log ng ilang sukatan kahit na walang lokal pmcd(1), gamit ang
"lokal na konteksto" na mode ng pagpapatakbo. Ito ay isinaaktibo gamit ang -o opsyon, at mga sanhi
pmlogger upang gamitin ang mga lokal na DSO PMDA sa halip na makipag-ugnayan sa pmcd(1). Kailan
gumagana gamit ang lokal na konteksto, ang -K maaaring gamitin ang opsyon para kontrolin ang mga DSO PMDA na
dapat gawing accessible. Ang pagsasapalaran ang argument ay umaayon sa syntax na inilarawan sa
__pmSpecLocalPMDA(3). Higit sa isa -K maaaring gamitin ang opsyon.

Kapag inilunsad bilang hindi pangunahing instance, pmlogger lalabas agad kung ang
configuration file ay nagiging sanhi ng walang panukat na pag-log upang maiiskedyul. Ang -L nilalampasan ito ng opsyon
pag-uugali, at nagiging sanhi ng hindi pangunahin pmlogger instance sa ``linger'', siguro nakabinbin
ilang hinaharap na dynamic na muling pagsasaayos at pagbabago ng estado sa pamamagitan ng pmlcNa (1). pmlogger nasain din
magtagal nang wala ang -L opsyon na ginagamit kung ang lahat ng sukatan na itatala ay naka-log bilang isang beses
mga sukatan lamang. Kapag ang isang beses lamang na mga sukatan ay nai-log, isang mensahe ng babala ay magiging
nabuo na nagsasaad na ang queue ng kaganapan ay walang laman at wala nang mga kaganapan na maiiskedyul.

Bilang default, mula sa lahat ng diagnostic at error pmlogger ay nakasulat sa file pmlogger.log
sa direktoryo kung saan pmlogger ay inilunsad. Ang -l maaaring gamitin ang opsyon para i-override ang
default na pag-uugali. Kung ang log file ay hindi malikha o hindi maisusulat, ang output ay nakasulat
sa karaniwang error sa halip.

Kung tinukoy, ang -s opsyon na nagtuturo pmlogger upang wakasan pagkatapos ng isang tiyak na laki sa
record, byte o time unit ay naipon. Kung endsize ay isang integer kung gayon endsize
ang mga tala ay isusulat sa talaan. Kung endsize ay isang integer na nilagyan ng b or bytes pagkatapos
endsize ang mga byte ng data ng archive ay isusulat (gayunpaman, tandaan na ang archive log
hindi masisira ang mga hangganan ng rekord at sa gayon ay maaaring bahagyang malampasan ang limitasyong ito). Iba pa
Ang mga mabubuhay na unit ng laki ng file ay kinabibilangan ng: K, Kb, kbyte, kilobyte para sa kilobytes at M, Mb, Mbyte,
Megabyte para sa megabytes at G, Gb, Gbyte, Gigabyte para sa gigabytes. Ang mga yunit na ito ay maaaring
opsyonal na nilagyan ng an s at maaaring may halo-halong kaso. Bilang kahalili endsize maaaring isang
integer o isang floating point na numero na nilagyan ng suffix gamit ang isang time unit gaya ng inilalarawan sa PCPIntro(1)
para sa agwat argumento (sa karaniwang PCP -t opsyon sa command line).
Ilang halimbawa ng iba't ibang format:
-s 100
-s 100 bytes
-s 100K
-s 100Mb
-s 10Gbyte
-s 10mins
-s 1.5hours
Ang default ay para sa pmlogger upang tumakbo magpakailanman.

Ang -r ang opsyon ay nagiging sanhi ng laki ng (mga) pisikal na talaan para sa bawat pangkat ng mga sukatan at ang
inaasahang kontribusyon ng grupo sa laki ng archive ng PCP para sa isang buong araw ng
koleksyon na iuulat sa log file. Ang impormasyong ito ay iniulat sa unang pagkakataon
ang bawat pangkat ay matagumpay na naisulat sa archive.

Ang -U ang opsyon ay tumutukoy sa user account kung saan tatakbo pmlogger. Ang default ay ang
kasalukuyang user account para sa interactive na paggamit. Kapag tumakbo bilang isang daemon, ang unprivileged "pcp"
account ay ginagamit sa mga kasalukuyang bersyon ng PCP, ngunit sa mga mas lumang bersyon ang superuser account
("root") ay ginamit bilang default.

Ang log file ay posibleng isang multi-volume na set ng data, at ang -v mga sanhi ng opsyon pmlogger sa
magsimula ng bagong volume pagkatapos ng isang partikular na laki sa mga talaan, byte, o mga yunit ng oras
naipon para sa kasalukuyang dami. Ang format ng detalye ng laki na ito ay magkapareho sa
iyon ng -s opsyon (tingnan sa itaas). Ang default ay para sa pmlogger upang lumikha ng isang volume
log. Ang mga karagdagang switch ng volume ay maaari ding pilitin nang asynchronously sa pamamagitan ng alinman sa paggamit pmlc(1)
o pagpapadala pmlogger isang SIGHUP signal (tingnan sa ibaba). Tandaan, kung naka-iskedyul ang switch ng volume
operasyon dahil sa -v opsyon, pagkatapos ay ire-reset ang mga counter nito pagkatapos ng asynchronous
Lumipat.

Independent sa alinman -v opsyon, ang bawat volume ng isang archive ay limitado sa hindi hihigit sa 2^31
bytes, kaya pmlogger ay awtomatikong lilikha ng bagong volume para sa archive bago ito
naabot na ang limitasyon

Karaniwan pmlogger gumagana sa ipinamahagi na Performance Metrics Name Space (PMNS),
gayunpaman kung ang -n ang opsyon ay tinukoy na isang alternatibong lokal na PMNS ay na-load mula sa file
pmnsfile.

Sa ilalim ng normal na pangyayari, pmlogger ay tatakbo magpakailanman (maliban sa a -s opsyon o a
signal ng pagwawakas). Ang -T ang opsyon ay maaaring gamitin upang limitahan ang oras ng pagpapatupad gamit ang
format ng oras gaya ng itinakda ng PCPIntro(1). Ang oras ay binibigyang kahulugan sa loob ng time zone
ng PMCD server, maliban kung ang -y ibinibigay ang opsyon, sa loob kung saan ang time zone dito
logger host ang ginagamit.
Ilang halimbawa ng iba't ibang format:
-T 10mins
-T '@ 11:30'
Mula dito makikita na -T 10mins at -s 10mins magsagawa ng magkatulad na mga aksyon.

Bilang kahalili, pmlogger Ang runtime ay maaaring limitado sa buhay ng isa pang proseso sa pamamagitan ng paggamit
ang -p or --PID opsyon na imungkahi ang PID ng proseso ng interes. Sa kasong ito ang
pmlogger lalabas kapag wala na ang ibang proseso.

Kailan pmlogger tumatanggap ng SIGHUP signal, ang kasalukuyang volume ng log ay sarado, at isang bago
Binuksan ang volume. Ang mekanismong ito (o ang alternatibong mekanismo sa pamamagitan ng pmlc(1)) ay maaaring gamitin
upang pamahalaan ang paglaki ng mga log file - kapag ang dami ng log ay sarado, ang file na iyon ay maaaring
naka-archive nang walang masamang epekto sa patuloy na operasyon ng pmlogger. Tingnan din ang -v
pagpipilian sa itaas.

Sa kasaysayan, ang mga buffer para sa kasalukuyang log ay maaaring i-flush sa disk gamit ang Kapantay
utos ng pmlc(1), o sa pamamagitan ng pagpapadala pmlogger isang signal ng SIGUSR1 o sa pamamagitan ng paggamit ng -u pagpipilian.
Ang kasalukuyang bersyon ng pmlogger at ang libpcp nakagawian na pinagbabatayan pmlogger
walang kondisyong gumamit ng mga unbuffered na pagsusulat at isang solong fwrite(3) para sa bawat lohikal na tala
nakasulat, at kaya hindi pinipilit ng ``flushing'' ang anumang karagdagang data na maisulat sa file
sistema. Ang -u opsyon, ang paghawak ng SIGUSR1 at ang pmlc(1) Kapantay ang utos ay pinananatili
para sa pabalik na pagkakatugma.

Kapag inilunsad kasama ang -x opsyon, tatanggapin ng pmlogger ang mga asynchronous na kahilingan sa kontrol sa
ang file descriptor fd. Ang opsyong ito ay inaasahan lamang na internal na gagamitin ng PCP
mga application na sumusuporta sa ``live record mode''.

Ang -m pinapayagan ng pagpipilian ang string nota na idaragdag sa file ng mapa para sa pagkakataong ito ng
pmlogger nasa $PCP_TMP_DIR/pmlogger direktoryo. Ito ay kasalukuyang ginagamit sa loob ng
idokumento ang deskriptor ng file (fd) kapag ang -x ang opsyon ay ginagamit, o upang ipahiwatig na ito
pmlogger halimbawa ay nagsimula sa ilalim ng kontrol ng pmlogger_checkNa (1).

Configuration FILE SINTAX

Maaaring tukuyin ang configuration file kasama ang -c opsyon. Kung hindi, configuration
ang mga pagtutukoy ay binabasa mula sa karaniwang input.

If configfile ay hindi umiiral, pagkatapos ay isang paghahanap ay ginawa sa direktoryo
$PCP_VAR_LIB/config/pmlogger para sa isang file na may parehong pangalan, at kung natagpuan na ang file ay ginagamit,
hal kung config.mumble ay hindi umiiral sa kasalukuyang direktoryo at sa file
$PCP_VAR_LIB/config/pmlogger/config.mumble ay umiiral, kung gayon -c config.mumble at -c
$PCP_VAR_LIB/config/pmlogger/config.mumble katumbas.

Ang syntax para sa configuration file ay ang mga sumusunod.

1. Ang mga salita ay pinaghihiwalay ng puting espasyo (espasyo, tab o bagong linya).

2. Ang simbolo na ``#'' (hash) ay nagpapakilala ng komento, at lahat ng teksto hanggang sa susunod na bagong linya ay
hindi pinansin

3. Mga Keyword (ipinapakita sa matapang sa ibaba) ay dapat na literal na lumitaw (ibig sabihin, sa maliit na titik).

4. Ang bawat detalye ay nagsisimula sa opsyonal na keyword mag-log, na sinundan ng isa sa
estado sapilitan on, sapilitan off, sapilitan siguro, pagpapayo on or pagpapayo off.

5. Para sa on nakasaad, dapat sumunod ang isang logging interval gamit ang syntax ``minsan'', o
``default'', o ``bawat N mga timeunit'', o simpleng ``N mga timeunit'' - N ay isang unsigned
integer, at mga timeunit ay isa sa mga keyword msec, millisecond, tuyo, pangalawa, minuto,
minuto, oras o ang pangmaramihang anyo ng isa sa itaas.
Ang mga panloob na limitasyon ay nangangailangan ng pagitan na mas maliit kaysa sa (humigit-kumulang) 74
oras. Ang halaga ng pagitan ng zero ay kasingkahulugan ng minsan. Isang pagitan ng default
nangangahulugang gamitin ang default na pagitan ng pag-log na 60 segundo; maaaring ito ang default na halaga
binago sa agwat sa -t opsyon na command line.

Ang agwat Ang argumento ay sumusunod sa syntax na inilarawan sa PCPIntro(1), at sa
ang pinakasimpleng anyo ay maaaring isang unsigned integer (ang ipinahiwatig na mga yunit sa kasong ito ay
segundo).

6. Ang pagsunod sa estado at posibleng mga pagtutukoy ng agwat ay may ``{'', na sinusundan ng a
listahan ng isa o higit pang mga pagtutukoy ng sukatan at isang pangwakas na ``}''. Ang listahan ay puti
pinaghiwalay ang espasyo (o kuwit). Kung mayroon lamang isang panukat na detalye sa listahan,
ang mga braces ay opsyonal.

7. Ang isang panukat na detalye ay binubuo ng isang sukatan na pangalan na opsyonal na sinusundan ng isang hanay ng
mga pangalan ng halimbawa. Ang pangalan ng sukatan ay sumusunod sa karaniwang mga convention sa pagpapangalan ng PCP, tingnan
pmns(5), at kung ang metric name ay isang non-leaf node sa PMNS (tingnan ang pmns(5)), pagkatapos
pmlogger ay recursively bababa sa PMNS at ilapat ang logging specification sa lahat
descendent metric names na mga leaf node sa PMNS. Ang hanay ng mga pangalan ng halimbawa
ay isang ``['', na sinusundan ng isang listahan ng isa o higit pang espasyo (o kuwit) na pinaghihiwalay na mga pangalan,
mga numero o string, at isang pangwakas na ``]''. Ang mga elemento sa listahan na mga numero ay
ipinapalagay na mga panloob na instance identifier, ang iba pang mga elemento ay ipinapalagay na
mga panlabas na instance identifier - tingnan pmGetInDom(3) para sa karagdagang impormasyon.

Kung walang ibinigay na mga pagkakataon, ang pagtutukoy sa pag-log ay ilalapat sa lahat ng mga pagkakataon
ng nauugnay na sukatan.

8. Maaaring mayroong arbitrary na bilang ng mga pagtutukoy sa pag-log.

9. Kasunod ng lahat ng mga pagtutukoy sa pag-log, maaaring mayroong opsyonal na kontrol sa pag-access
seksyon, ipinakilala ng literal na token [access]. Pagkatapos ay dumating ang kontrol sa pag-access
mga panuntunan na nagpapahintulot o hindi pinapayagan ang mga operasyon mula sa mga partikular na host o grupo ng mga host.

Ang mga operasyon ay maaaring gamitin upang mag-interrogate o kontrolin ang isang tumatakbo pmlogger paggamit pmlc(1)
at nabibilang sa mga sumusunod na klase:

magtanong tanungin ang katayuan ng pmlogger at ang mga sukatan na ini-log
pagpapayo Baguhin ang advisory logging.
sapilitan Baguhin ang mandatoryong pag-log.
lahat Lahat ng nabanggit.

Ang mga panuntunan sa kontrol sa pag-access ay nasa anyong ``pumayag hostlist : operationlist ;'' at
``hindi pinapayag hostlist : operationlist ;"

Ang hostlist sumusunod sa syntax at semantics para sa mga mekanismo ng kontrol sa pag-access na ginamit
ng PMCD at ganap na nakadokumento sa pmcd(1). Isang listahan ng pagpapatakbo ay pinaghihiwalay ng kuwit
listahan ng mga operasyon pagpapayo, sapilitan, magtanong at lahat.

Isang nawawala [access] Ang seksyon ay nagbibigay-daan sa lahat ng pag-access at katumbas ng pumayag * : lahat;.

Ang pagsasaayos (alinman sa karaniwang input o configfile) ay unang ini-scan ni
pmcpp(1) kasama ang mga pagpipilian -rs at -I $PCP_VAR_LIB/config/pmlogger. Pinapalawak nito ang
configuration file syntax na may kasamang pagpoproseso ng file (%isama), isang karaniwang lokasyon sa
maghanap para sa isama ang mga file ($PCP_VAR_LIB/config/pmlogger), macro definitions (%define),
macro expansion (%pangalan at %{pangalan}) at may kondisyong pagsasama ng mga linya (%ifdef pangalan ...
%iba pa ... %tapusin kung at %ifndef pangalan ... %iba pa ... %tapusin kung).

HALIMBAWA

Para sa bawat PCP utility, mayroong isang sample pmlogger configuration file na maaaring magamit sa
lumikha ng archive log na angkop para sa pag-replay gamit ang tool na iyon (ibig sabihin, kasama ang lahat ng
mga sukatan ng pagganap na ginagamit ng tool). Para sa isang tool na pinangalanang foo ang configuration file na ito ay
na matatagpuan sa $PCP_VAR_LIB/config/pmlogger/config.foo.

Ang sumusunod ay isang simpleng default na configuration file para sa isang primary pmlogger halimbawa, at
ipinapakita ang karamihan sa mga kakayahan ng wika ng detalye ng pagsasaayos.

mandatory ang log sa isang beses { hinv.ncpu hinv.ndisk }
mandatory ang log sa bawat 10 minuto {
disk.all.write
disk.all.read
network.interface.in.packets [ "et0" ]
network.interface.out.packets [ "et0" ]
nfs.server.reqs [ "lookup" "getattr" "read" "write" ]
}

mag-log advisory sa bawat 30 minuto {
kapaligiran.temp
pmcd.pdu_in.total
pmcd.pdu_out.total
}

%include "macros.default"

%ifdef %disk_detail
mandatory ang log sa %disk_detail_freq {
disk.dev
}
%tapusin kung

[access]
hindi payagan * : lahat maliban sa magtanong;
payagan ang localhost : mandatory, advisory;

Gamitin ang pmlogger online gamit ang mga serbisyo ng onworks.net