pmlogger - Online in de Cloud

PROGRAMMA:

NAAM

pmlogger - maak een archieflogboek voor prestatiestatistieken

KORTE INHOUD

pmlogger [-c configuratiebestand] [-h gastheer] [-K spec] [-l logfile] [-L] [-m nota] [-n pmns-bestand]
[-o] [-p pid] [-P] [-r] [-s eindmaat] [-t interval] [-T eindtijd] [-u] [-U gebruikersnaam] [-v
volformaat] [-V versie] [-x fd] [-y] archief

PRODUCTBESCHRIJVING

pmlogger maakt de archieflogboeken van prestatiestatistieken die kunnen worden ``afgespeeld''
door een andere Performance Co-Pilot (zie PCPIIntro(1)) gereedschap. Deze logs vormen de basis van de
VCR-paradigma en retrospectieve prestatieanalysediensten die de PCP-toolkit gemeen hebben.

Het verplichte argument archief is de basisnaam voor de fysieke bestanden waaruit een
archief logboek.

De -V optie specificeert de versie voor het archief dat wordt gegenereerd. Standaard een
versie 2-archief wordt gegenereerd en de enige waarde die momenteel wordt ondersteund versie is 2.

Tenzij door de . naar een andere host gestuurd -h optie of bij direct gebruik van PMDA's via de -o
keuze, pmlogger zal contact opnemen met de Performance Metrics Collector Daemon (PMCD) op de lokale
host en gebruik dat als de bron van de metrische waarden die moeten worden vastgelegd.

Ter ondersteuning van de vereiste flexibiliteit en controle over wat er wanneer wordt gelogd, pmlogger
handhaaft een onafhankelijke logboekstatus op twee niveaus voor elk exemplaar van elke prestatie
metriek. Op het eerste (verplichte) niveau mag worden gelogd on (met een bijbehorende
interval tussen monsters), of korting or kan zijn. In het laatste geval, de tweede (adviserende)
loggen op niveau is toegestaan on (met een bijbehorend interval tussen monsters), of korting.

Het verplichte niveau staat universele specificatie toe dat sommige statistieken moeten worden gelogd, of
Dan moet je niet ingelogd zijn. De standaardstatus voor alle instanties van alle statistieken when pmlogger
starten is verplicht misschien en advies uit.

Gebruik pml(1) om de logstatus één keer te ondervragen en te wijzigen pmlogger is aan het rennen.

Als de status van een metriek verplicht is (aan of uit) en er wordt gevraagd om deze te wijzigen
verplicht misschien, de nieuwe staat is misschien verplicht en afradend. Als de status van een statistiek
is al adviserend (aan of uit) en er wordt gevraagd om dit te veranderen in verplicht misschien, de
huidige staat blijft behouden.

Het is niet mogelijk voor pmlogger om specifieke instanties van een metriek en alle instanties van te loggen
tegelijkertijd dezelfde maatstaf. Als specifieke instanties worden gelogd en een verzoek om te loggen
alle exemplaren is gemaakt, dan worden alle exemplaren van de metriek geregistreerd volgens de
nieuw verzoek, vervangt elk eerder logboekverzoek voor de metriek. Een verzoek om alles te loggen
instanties van een metriek vervangen alle eerdere verzoeken om alle instanties te loggen. Een verzoek
om specifieke instanties van een metriek te loggen wanneer alle instanties al worden gelogd is
geweigerd. Om dit te doen, moet men eerst het loggen voor alle instanties van de metriek uitschakelen. In
in elk geval wordt eerst de geldigheid van het verzoek gecontroleerd; bijvoorbeeld een verzoek tot wijziging van een
metric's logging status om advies te geven over wanneer het momenteel verplicht is uit is nooit
toegestaan ​​(misschien eerst de status wijzigen in verplicht).

Optioneel kan elk systeem draaien pmcd(1) kan ook worden geconfigureerd om een ​​``primaire''
pmlogger voorbeeld. Dit pmlogger instantie wordt gestart door $PCP_RC_DIR/pmlogger, en is
beïnvloed door de bestanden $PCP_SYSCONF_DIR/pmlogger/controle,
$PCP_SYSCONF_DIR/pmlogger/controle.d (gebruik chkconfig(8) of vergelijkbaar platformspecifiek
commando's om de primaire te activeren of deactiveren pmlogger voorbeeld),
$PCP_SYSCONFIG_DIR/pmlogger (instellingen voor omgevingsvariabelen voor het primaire pmlogger)
$PCP_SYSCONF_DIR/pmlogger/pmlogger.options (opdrachtregelopties doorgegeven aan het primaire
pmlogger) en $PCP_VAR_LIB/config/pmlogger/config.default (de standaard initiaal
configuratiebestand voor de primaire pmlogger).

de primaire pmlogger instantie wordt geïdentificeerd door de -P keuze. Dat kan er hoogstens één zijn
``primair'' pmlogger bijvoorbeeld op elk systeem. De primaire pmlogger instantie (indien aanwezig) moet
draaien op dezelfde host als de pmcd(1) waarmee het verbinding maakt (indien aanwezig), dus de -h en -P
opties sluiten elkaar uit.

Het loggen van sommige statistieken is mogelijk, zelfs als er geen local is pmcd(1), met behulp van de
"lokale context" werkwijze. Deze wordt geactiveerd met behulp van de -o optie en oorzaken
pmlogger gebruik te maken van lokale DSO PMDA's in plaats van ermee te communiceren pmcd(1). Wanneer
opererend vanuit een lokale context, de -K optie kan worden gebruikt om de DSO PMDA's die
toegankelijk gemaakt moeten worden. De spec argument voldoet aan de syntaxis beschreven in
__pmSpecLokaalPMDA(3). Meer dan een -K optie kan worden gebruikt.

Wanneer gelanceerd als een niet-primaire instantie, pmlogger wordt onmiddellijk afgesloten als de
configuratiebestand zorgt ervoor dat er geen metrische registratie wordt gepland. De -L optie heft dit op
gedrag, en veroorzaakt een niet-primair pmlogger instantie om te ``blijven hangen'', vermoedelijk in behandeling
enige toekomstige dynamische herconfiguratie en statusverandering via pml(1). pmlogger zal ook
blijven hangen zonder de -L optie die wordt gebruikt als alle meetgegevens die moeten worden geregistreerd, als één keer worden geregistreerd
alleen metrische gegevens. Wanneer de eenmalige statistieken zijn gelogd, wordt een waarschuwingsbericht weergegeven
gegenereerd met de melding dat de gebeurteniswachtrij leeg is en dat er geen evenementen meer worden gepland.

Standaard worden alle diagnoses en fouten van pmlogger worden naar het bestand geschreven pmlogger.log
in de directory waar pmlogger wordt gelanceerd. De -l optie kan worden gebruikt om de
standaard gedrag. Als het logbestand niet kan worden gemaakt of niet beschrijfbaar is, wordt de uitvoer geschreven
in plaats daarvan naar standaardfout.

Indien gespecificeerd, de -s optie instrueert pmlogger eindigen na een bepaalde grootte in
records, bytes of tijdseenheden is verzameld. Als eindmaat is dan een geheel getal eindmaat
records worden naar het logboek geschreven. Als eindmaat is een geheel getal gevolgd door b or bytes harte
eindmaat bytes van de archiefgegevens worden weggeschreven (houd er echter rekening mee dat archive log
recordgrenzen worden niet verbroken en dus kan deze limiet iets worden overschreden). Ander
levensvatbare bestandsgrootte-eenheden zijn onder meer: K, Kb, kbyte, kilobyte voor kilobytes en M, Mb, MByte,
megabyte voor megabytes en G, Gb, GByte, Gigabyte voor gigabytes. Deze eenheden kunnen zijn
eventueel aangevuld met een s en kan van gemengd geval zijn. alternatief eindmaat kan een
geheel getal of een getal met drijvende komma gevolgd door een tijdseenheid zoals beschreven in PCPIIntro(1)
voor de interval argument (naar de standaard PCP -t opdrachtregel optie).
Enkele voorbeelden van verschillende formaten:
-s 100
-s 100 bytes
-s 100K
-s 100Mb
-s 10 GB
-s 10mins
-s 1.5hours
De standaard is voor pmlogger voor altijd rennen.

De -r optie zorgt ervoor dat de grootte van de fysieke record(s) voor elke groep metrieken en de
verwachte bijdrage van de groep aan de grootte van het PCP-archief voor een volledige dag
collectie te rapporteren in het logbestand. Deze informatie wordt de eerste keer gerapporteerd
elke groep is met succes naar het archief geschreven.

De -U optie specificeert het gebruikersaccount waaronder moet worden uitgevoerd pmlogger. De standaard is de
huidig ​​gebruikersaccount voor interactief gebruik. Wanneer uitgevoerd als een daemon, de onbevoegde "pcp"
account wordt gebruikt in de huidige versies van PCP, maar in oudere versies het superuser-account
("root") werd standaard gebruikt.

Het logbestand is mogelijk een dataset met meerdere volumes, en de -v optie oorzaken pmlogger naar
start een nieuw volume nadat een bepaalde grootte in records, bytes of tijdseenheden is geweest
verzameld voor het huidige volume. Het formaat van deze maatspecificatie is identiek aan
dat van de -s optie (zie hierboven). De standaard is voor pmlogger om één volume te creëren
loggen. Extra volumeschakelaars kunnen ook asynchroon worden geforceerd door een van beide te gebruiken pml(1)
of verzenden pmlogger een SIGHUP-signaal (zie hieronder). Let op, als er een geplande volumeschakelaar is
operatie vanwege de -v optie, dan worden de tellers gereset na een asynchroon
schakelaar.

Onafhankelijk van welke dan ook -v optie, is elk volume van een archief beperkt tot niet meer dan 2^31
bytes, dus pmlogger maakt hiervoor automatisch een nieuw volume voor het archief
limiet is bereikt.

Normaal pmlogger werkt op de gedistribueerde Performance Metrics Name Space (PMNS),
echter als de -n optie wordt opgegeven, wordt een alternatieve lokale PMNS uit het bestand geladen
pmns-bestand.

Onder normale omstandigheden, pmlogger zal voor altijd lopen (behalve a -s optie of een
beëindigingssignaal). De -T optie kan worden gebruikt om de uitvoeringstijd te beperken met behulp van de
tijdsindeling zoals voorgeschreven door PCPIIntro(1). De tijd wordt geïnterpreteerd binnen de tijdzone
van de PMCD-server, tenzij de -y optie wordt gegeven, in welk geval de tijdzone op dit
loggerhost wordt gebruikt.
Enkele voorbeelden van verschillende formaten:
-T 10mins
-T '@ 11:30'
Hieruit kan worden afgeleid dat -T 10mins en -s 10mins identieke acties uitvoeren.

Als alternatief, pmlogger runtime kan worden beperkt tot de levensduur van een ander proces door gebruik te maken van
the -p or --PID optie om de PID van het betreffende proces te nomineren. In dit geval de
pmlogger wordt afgesloten wanneer het andere proces niet meer bestaat.

. pmlogger ontvangt een SIGHUP-signaal, het huidige volume van het logboek wordt gesloten en een nieuw
volume wordt geopend. Dit mechanisme (of het alternatieve mechanisme via pml(1)) kan worden gebruikt
om de groei van de logbestanden te beheren - zodra een logvolume is gesloten, kan dat bestand worden gesloten
gearchiveerd zonder nadelige gevolgen voor de voortzetting van de werking van pmlogger. Zie ook de -v
optie hierboven.

Historisch gezien kunnen de buffers voor het huidige logboek naar schijf worden leeggemaakt met behulp van de doorspoelen
bevel van pml(1), of door te verzenden pmlogger een SIGUSR1-signaal of met behulp van de -u optie.
De huidige versie van pmlogger en libpcp routines die eraan ten grondslag liggen pmlogger
gebruik onvoorwaardelijk niet-gebufferde schrijfbewerkingen en een single schrijven(3) voor elk logisch record
geschreven, en dus dwingt ``flushing'' geen extra gegevens om naar het bestand te schrijven
systeem. De -u optie, de SIGUSR1-behandeling en de pml(1) doorspoelen bevel behouden
voor achterwaartse compatibiliteit.

Bij lancering met de -x optie accepteert pmlogger asynchrone controleverzoeken op
de bestandsbeschrijving fd. Deze optie zal naar verwachting alleen intern door PCP worden gebruikt
toepassingen die de ``live opnamemodus'' ondersteunen.

De -m optie staat de tekenreeks toe nota toe te voegen aan het kaartbestand voor deze instantie van
pmlogger in de $PCP_TMP_DIR/pmlogger map. Dit wordt momenteel intern gebruikt om
documenteer de bestandsbeschrijving (fd) wanneer de -x optie wordt gebruikt, of om aan te geven dat dit
pmlogger instantie is gestart onder de controle van pmlogger_check(1).

CONFIGURATIE FILE SYNTAXIS

Het configuratiebestand kan worden gespecificeerd met de -c keuze. Als dit niet het geval is, configuratie
specificaties worden gelezen uit de standaardinvoer.

If configuratiebestand bestaat niet, dan wordt er gezocht in de directory
$PCP_VAR_LIB/config/pmlogger voor een bestand met dezelfde naam, en indien gevonden dat dat bestand wordt gebruikt,
bijv. als config.mumble bestaat niet in de huidige map en het bestand
$PCP_VAR_LIB/config/pmlogger/config.mumble bestaat, dan -c config.mumble en -c
$PCP_VAR_LIB/config/pmlogger/config.mumble zijn gelijkwaardig.

De syntaxis voor het configuratiebestand is als volgt.

1. Woorden worden gescheiden door witruimte (spatie, tab of nieuwe regel).

2. Het symbool ``#'' (hash) introduceert een opmerking en alle tekst tot aan de volgende nieuwe regel wordt
buiten beschouwing gelaten.

3. Trefwoorden (getoond in pin hieronder) moet letterlijk worden weergegeven (dwz in kleine letters).

4. Elke specificatie begint met het optionele trefwoord inloggen, gevolgd door een van de
staten verplicht on, verplicht korting, verplicht kan zijn, adviserend on or adviserend korting.

5. Voor de on staten, moet een logboekinterval volgen met behulp van de syntaxis ``eens'', of
``verzuim'', of ``elk N tijdseenheden'', of gewoon ''N tijdseenheden'' - N is een niet-ondertekende
geheel getal, en tijdseenheden is een van de sleutelwoorden msec, milliseconde, sec, tweede, Min,
minuut, uur of de meervoudsvorm van een van de bovenstaande.
Interne beperkingen vereisen dat het interval kleiner is dan (ongeveer) 74
uur. Een intervalwaarde van nul is een synoniem voor eens. Een interval van verzuim
betekent om het standaard registratie-interval van 60 seconden te gebruiken; deze standaardwaarde kan zijn
veranderd naar interval met de -t opdrachtregeloptie.

De interval argument volgt de syntaxis beschreven in PCPIIntro(1), en in de
eenvoudigste vorm kan een geheel getal zonder teken zijn (de geïmpliceerde eenheden zijn in dit geval
seconden).

6. Na de status en mogelijke intervalspecificaties komt een ``{'', gevolgd door een
lijst met een of meer metrische specificaties en een afsluitende ``}''. De lijst is wit
spatie (of komma) gescheiden. Als er slechts één metrische specificatie in de lijst staat,
de beugels zijn optioneel.

7. Een metriekspecificatie bestaat uit een metrieknaam, optioneel gevolgd door een set van
namen van instanties. De metrische naam volgt de standaard PCP-naamgevingsconventies, zie
pmns(5), en als de metrieknaam een ​​niet-bladknooppunt is in het PMNS (zie pmns(5)), dan
pmlogger zal recursief de PMNS afdalen en de logboekspecificatie op iedereen toepassen
metrische namen van afstammelingen die bladknooppunten zijn in het PMNS. De set instantienamen
is een ``['', gevolgd door een lijst met een of meer door spaties (of komma's) gescheiden namen,
getallen of strings, en een afsluitende ``]''. Elementen in de lijst die nummers zijn
aangenomen dat het interne instantie-ID's zijn, wordt aangenomen dat andere elementen dat zijn
externe exemplaar-ID's - zie pmGetInDom(3) voor meer informatie.

Als er geen instanties worden opgegeven, wordt de logboekspecificatie toegepast op alle instanties
van de bijbehorende maatstaf.

8. Er kan een willekeurig aantal logboekspecificaties zijn.

9. Volgens alle logboekspecificaties kan er een optionele toegangscontrole zijn
sectie, geïntroduceerd door het letterlijke token [toegang]. Daarna komt toegangscontrole
regels die bewerkingen van bepaalde hosts of groepen hosts toestaan ​​of verbieden.

De bewerkingen kunnen worden gebruikt om een ​​run te ondervragen of te besturen pmlogger gebruik pml(1)
en vallen in de volgende klassen:

informeren vraag de status van pmlogger en de statistieken die het registreert
adviserend Adviesregistratie wijzigen.
verplicht Verander verplichte logging.
allen Alle bovenstaande.

Toegangscontroleregels hebben de vorm ``toelaten hostlijst : operatielijst ;'' en
``weigeren hostlijst : operatielijst ;''.

De hostlijst volgt de syntaxis en semantiek voor de gebruikte toegangscontrolemechanismen
door PMCD en zijn volledig gedocumenteerd in pmcd(1). Een operatielijst is een komma gescheiden
lijst van de operaties adviserend, verplicht, informeren en allen.

een vermiste [toegang] sectie staat alle toegang toe en is gelijk aan toelaten * : alle;.

De configuratie (van standaard invoer of configuratiebestand) wordt aanvankelijk gescand door
pmcpp(1) met de opties -rs en -I $PCP_VAR_LIB/config/pmlogger. Dit verlengt de
configuratiebestandssyntaxis met inclusief bestandsverwerking (%erbij betrekken), een gemeenschappelijke locatie
zoek naar include-bestanden ($PCP_VAR_LIB/config/pmlogger), macrodefinities (%definiëren),
macro-uitbreiding (%naam en %{naam}) en voorwaardelijke opname van regels (%ifdef naam ...
%anders ... %stop als en %ifndef naam ... %anders ... %stop als).

Voorbeelden

Voor elk PCP-hulpprogramma is er een voorbeeld pmlogger configuratiebestand dat gebruikt zou kunnen worden
maak een archieflog aan dat geschikt is om met die tool opnieuw af te spelen (dwz bevat alle
prestatiestatistieken die door de tool worden gebruikt). Voor een tool met de naam foo dit configuratiebestand is
in $PCP_VAR_LIB/config/pmlogger/config.foo.

Het volgende is een eenvoudig standaardconfiguratiebestand voor een primair pmlogger bijvoorbeeld, en
demonstreert de meeste mogelijkheden van de configuratiespecificatietaal.

eenmalig inloggen verplicht { hinv.ncpu hinv.ndisk }
inloggen verplicht elke 10 minuten {
schijf.allemaal.schrijven
schijf.alles.lezen
netwerk.interface.in.pakketten [ "et0" ]
netwerk.interface.uit.pakketten [ "et0" ]
nfs.server.reqs [ "opzoeken" "getattr" "lezen" "schrijven" ]
}

log advies op elke 30 minuten {
omgeving.temp
pmcd.pdu_in.total
pmcd.pdu_out.total
}

%include "macro's.default"

%ifdef %schijf_detail
inloggen verplicht op %disk_detail_freq {
schijf.dev
}
%stop als

[toegang]
disallow * : alles behalve informeren;
localhost toestaan ​​: verplicht, adviserend;

Gebruik pmlogger online met behulp van onworks.net-services