pmlogger - Online nel Cloud

PROGRAMMA:

NOME

pmlogger - creare un registro di archivio per le metriche delle prestazioni

SINOSSI

pmlogger [-c file di configurazione] [-h host] [-K spec] [-l file di log] [-L] [-m Nota] [-n pmnsfile]
[-o] [-p pid] [-P] [-r] [-s misura finale] [-t intervallo] [-T Tempo scaduto] [-u] [-U nome utente] [-v
volse] [-V versione] [-x fd] [-y] archiviare

DESCRIZIONE

pmlogger crea i log di archivio dei valori delle metriche delle prestazioni che possono essere ``riprodotti''
da altri Performance Co-Pilot (vedi PCPIntro(1)) strumenti. Questi registri costituiscono la base del
Paradigma VCR e servizi di analisi retrospettiva delle prestazioni comuni al toolkit PCP.

L'argomento obbligatorio archiviare è il nome di base per i file fisici che costituiscono un
registro di archivio.

. -V opzione specifica la versione per l'archivio che viene generato. Per impostazione predefinita a
viene generato l'archivio della versione 2 e l'unico valore attualmente supportato per versione è 2.

A meno che non venga indirizzato a un altro host dal -h opzione o quando si utilizzano direttamente i PMDA tramite il -o
opzione, pmlogger contatterà il Performance Metrics Collector Daemon (PMCD) sul locale
host e utilizzarlo come origine dei valori di metrica da registrare.

Per supportare la flessibilità e il controllo richiesti su cosa viene registrato e quando, pmlogger
mantiene uno stato di registrazione a due livelli indipendente per ogni istanza di ogni performance
metrica. Al primo livello (obbligatorio), la registrazione può essere on (con un associato
intervallo tra i campioni), o MENO or può essere. In quest'ultimo caso, il secondo (consultivo)
la registrazione del livello può essere on (con un intervallo associato tra i campioni), o MENO.

Il livello obbligatorio consente la specifica universale che alcune metriche devono essere registrate, oppure
devono obbligatoriamente: non è un essere registrato. Lo stato predefinito per tutte le istanze di tutte le metriche quando pmlogger
gli inizi sono forse obbligatori e la consulenza è disattivata.

Usa il pmlc(1) per interrogare e modificare lo stato di registrazione una volta pmlogger è in esecuzione.

Se lo stato di una metrica è obbligatorio (attivato o disattivato) e viene richiesta la modifica in
obbligatorio forse, il nuovo stato è obbligatorio forse e consultivo spento. Se lo stato di una metrica
è già un avviso (acceso o spento) e viene fatta una richiesta per cambiarlo in obbligatorio forse, il
viene mantenuto lo stato attuale.

Non è possibile per pmlogger per registrare istanze specifiche di una metrica e tutte le istanze di
la stessa metrica contemporaneamente. Se vengono registrate istanze specifiche e viene richiesta la registrazione
tutte le istanze vengono create, tutte le istanze della metrica verranno registrate in base a
nuova richiesta, sostituendo qualsiasi richiesta di registrazione precedente per la metrica. Una richiesta per accedere a tutti
le istanze di una metrica sostituiranno qualsiasi richiesta precedente di registrare tutte le istanze. Una richiesta
registrare istanze specifiche di una metrica quando tutte le istanze sono già state registrate è
rifiutato. Per fare ciò, è necessario disattivare prima la registrazione per tutte le istanze della metrica. In
in ogni caso viene prima verificata la validità della richiesta; per esempio una richiesta di cambiare a
lo stato di registrazione della metrica su avviso attivo quando è attualmente obbligatorio disattivato non è mai
consentito (è necessario cambiare lo stato in obbligatorio forse prima).

Facoltativamente, ogni sistema in esecuzione pmc(1) può anche essere configurato per eseguire un ``primario''
pmlogger esempio. Questo pmlogger l'istanza è lanciata da $PCP_RC_DIR/pmlogger, ed è
influenzato dai file $PCP_SYSCONF_DIR/pmlogger/controllo,
$PCP_SYSCONF_DIR/pmlogger/controllo.d (usa chkconfig(8) o simili specifici per piattaforma
comandi per attivare o disattivare il primario pmlogger esempio),
$PCP_SYSCONFIG_DIR/pmlogger (impostazioni delle variabili d'ambiente per il primario pmlogger)
$PCP_SYSCONF_DIR/pmlogger/pmlogger.opzioni (opzioni della riga di comando passate al primario
pmlogger) e $PCP_VAR_LIB/config/pmlogger/config.default (l'iniziale predefinita
file di configurazione per il primario pmlogger).

Il primario pmlogger istanza è identificata dal -P opzione. Potrebbe essercene al massimo uno
``primario'' pmlogger istanza su ciascun sistema. Il primario pmlogger istanza (se presente) deve
essere in esecuzione sullo stesso host del pmc(1) a cui si collega (se presente), quindi il -h e -P
le opzioni si escludono a vicenda.

La registrazione di alcune metriche è possibile anche in assenza di un locale pmc(1), usando il
modalità di funzionamento del "contesto locale". Si attiva usando il -o opzione e cause
pmlogger utilizzare i DSO PMDA locali invece di comunicare con pmc(1). quando
operando utilizzando un contesto locale, il -K l'opzione può essere utilizzata per controllare i DSO PMDA che
dovrebbe essere reso accessibile. Il spec argomento è conforme alla sintassi descritta in
__pmSpecLocalPMDA(3). Più di una -K l'opzione può essere utilizzata.

Quando viene avviato come istanza non primaria, pmlogger uscirà immediatamente se il
file di configurazione non fa in modo che la registrazione della metrica venga pianificata. Il -L l'opzione lo sovrascrive
comportamento, e provoca un non-primario pmlogger istanza a ``indugiare'', presumibilmente in sospeso
qualche futura riconfigurazione dinamica e cambiamento di stato tramite pmlc(1). pmlogger sarà anche
indugiare senza -L opzione utilizzata se tutte le metriche da registrare vengono registrate come una volta
solo metriche. Quando le uniche metriche sono state registrate, verrà visualizzato un messaggio di avviso
generato indicando che la coda degli eventi è vuota e non verranno pianificati altri eventi.

Per impostazione predefinita, tutte le diagnostiche e gli errori da pmlogger sono scritti nel file pmlogger.log
nella directory dove pmlogger viene lanciato. Il -l l'opzione può essere utilizzata per sovrascrivere il
comportamento predefinito. Se il file di registro non può essere creato o non è scrivibile, l'output viene scritto
all'errore standard invece.

Se specificato, il -s opzione istruisce pmlogger terminare dopo una certa dimensione in
record, byte o unità di tempo sono stati accumulati. Se misura finale è un intero allora misura finale
i record verranno scritti nel registro. Se misura finale è un numero intero con suffisso b or bytes poi
misura finale i byte dei dati dell'archivio verranno scritti (nota, tuttavia, che il registro dell'archivio
i limiti dei record non verranno infranti e quindi questo limite potrebbe essere leggermente superato). Altro
le unità di dimensione del file praticabili includono: K, Kb, kbyte, kilobyte per kilobyte e M, Mb, MB,
megabyte per megabyte e G, Gb, GB, Gigabyte per gigabyte. Queste unità possono essere
facoltativamente suffisso da an s e può essere di caso misto. In alternativa misura finale può essere un file
intero o un numero in virgola mobile con suffisso utilizzando un'unità di tempo come descritto in PCPIntro(1)
per l' intervallo argomento (al PCP standard -t opzione della riga di comando).
Alcuni esempi di formati diversi:
-s 100
-s 100 byte
-s 100K
-s 100Mb
-s 10 Gbyte
-s 10mins
-s 1.5hours
L'impostazione predefinita è per pmlogger correre per sempre.

. -r l'opzione determina la dimensione dei record fisici per ciascun gruppo di metriche e il
contributo previsto del gruppo alla dimensione dell'archivio PCP per un'intera giornata di
raccolta da riportare nel file di log. Questa informazione viene riportata la prima volta
ogni gruppo viene scritto con successo nell'archivio.

. -U opzione specifica l'account utente con cui eseguire pmlogger. L'impostazione predefinita è
account utente corrente per l'uso interattivo. Quando viene eseguito come demone, il "pcp" non privilegiato
l'account viene utilizzato nelle versioni attuali di PCP, ma nelle versioni precedenti l'account di superutente
("root") è stato utilizzato per impostazione predefinita.

Il file di registro è potenzialmente un set di dati multi-volume e il -v cause di opzione pmlogger a
avviare un nuovo volume dopo che è stata raggiunta una certa dimensione in record, byte o unità di tempo
accumulato per il volume corrente. Il formato di questa specifica di dimensione è identico a
quello del -s opzione (vedi sopra). L'impostazione predefinita è per pmlogger per creare un volume unico
tronco d'albero. È inoltre possibile forzare in modo asincrono ulteriori interruttori del volume utilizzando pmlc(1)
o inviando pmlogger un segnale SIGHUP (vedi sotto). Nota, se è attivo un interruttore del volume programmato
operazione a causa del -v opzione, quindi i suoi contatori verranno ripristinati dopo un asincrono
interruttore.

Indipendente da qualsiasi -v opzione, ogni volume di un archivio è limitato a non più di 2^31
byte, quindi pmlogger creerà automaticamente un nuovo volume per l'archivio prima di questo
è stato raggiunto il limite.

Normalmente pmlogger opera sul Performance Metrics Name Space distribuito (PMNS),
tuttavia se il -n viene specificata l'opzione un PMNS locale alternativo viene caricato dal file
pmnsfile.

In circostanze normali, pmlogger durerà per sempre (tranne a -s opzione o a
segnale di terminazione). Il -T l'opzione può essere utilizzata per limitare il tempo di esecuzione utilizzando il
formato dell'ora come prescritto da PCPIntro(1). L'ora viene interpretata all'interno del fuso orario
del server PMCD, a meno che il -y viene data l'opzione, nel qual caso il fuso orario in questo
viene utilizzato l'host del logger.
Alcuni esempi di formati diversi:
-T 10mins
-T '@ 11:30 '
Da questo si vede che -T 10mins e -s 10mins eseguire azioni identiche.

Alternativamente, pmlogger il runtime può essere limitato alla durata di un altro processo utilizzando
, il -p or --PID possibilità di nominare il PID del processo di interesse. In questo caso il
pmlogger uscirà quando l'altro processo non esiste più.

Quando pmlogger riceve un segnale SIGHUP, il volume corrente del registro viene chiuso e un nuovo
volume è aperto. Questo meccanismo (o il meccanismo alternativo tramite pmlc(1)) può essere utilizzato
per gestire la crescita dei file di registro - una volta chiuso un volume di registro, quel file potrebbe essere
archiviato senza alcun effetto negativo sul funzionamento continuato di pmlogger. Vedi anche il -v
opzione sopra.

Storicamente i buffer per il registro corrente possono essere scaricati su disco utilizzando il lavare
comando di pmlc(1), o inviando pmlogger un segnale SIGUSR1 o utilizzando il -u opzione.
La versione corrente di pmlogger e la libpcp routine che stanno alla base pmlogger
usa incondizionatamente scritture senza buffer e un singolo fscrivi(3) per ogni record logico
scritto, e quindi ``flushing'' non forza la scrittura di dati aggiuntivi nel file
sistema. Il -u opzionale, la gestione SIGUSR1 e il pmlc(1) lavare il comando viene mantenuto
per retrocompatibilità.

Quando viene lanciato con il -x opzione, pmlogger accetterà richieste di controllo asincrone su
il descrittore di file fd. Questa opzione dovrebbe essere utilizzata solo internamente da PCP
applicazioni che supportano la ``modalità di registrazione dal vivo''.

. -m opzione consente la stringa Nota da aggiungere al map file per questa istanza di
pmlogger nella $PCP_TMP_DIR/pmlogger directory. Questo è attualmente utilizzato internamente per
documentare il descrittore di file (fd) quando il -x viene utilizzata l'opzione, o per indicare che questo
pmlogger istanza è stata avviata sotto il controllo di pmlogger_check(1).

CONFIGURAZIONE RISORSE SINTASSI

Il file di configurazione può essere specificato con il -c opzione. In caso contrario, configurazione
le specifiche vengono lette dallo standard input.

If file di configurazione non esiste, viene effettuata una ricerca nella directory
$PCP_VAR_LIB/config/pmlogger per un file con lo stesso nome e, se trovato, quel file viene utilizzato,
ad esempio se config.mumble non esiste nella directory corrente e nel file
$PCP_VAR_LIB/config/pmlogger/config.mumble esiste, allora -c config.mumble e -c
$PCP_VAR_LIB/config/pmlogger/config.mumble sono equivalenti.

La sintassi per il file di configurazione è la seguente.

1. Le parole sono separate da uno spazio bianco (spazio, tabulazione o nuova riga).

2. Il simbolo ``#'' (cancelletto) introduce un commento e tutto il testo fino alla nuova riga successiva è
ignorato.

3. Parole chiave (mostrate in sotto) deve apparire letteralmente (cioè in minuscolo).

4. Ogni specifica inizia con la parola chiave opzionale ceppo, seguito da uno dei
stati obbligatorio on, obbligatorio MENO, obbligatorio può essere, consultivo on or consultivo MENO.

5. Per il on afferma, deve seguire un intervallo di registrazione utilizzando la sintassi ``una volta'', o
``difetto'', o ``ogni N unità di tempo'', o semplicemente ``N unità di tempo'' - N è un non firmato
intero, e unità di tempo è una delle parole chiave msec, millisecondo, asciutto, secondo, verbale,
minuto, ora o il plurale di uno dei precedenti.
Le limitazioni interne richiedono che l'intervallo sia inferiore a (approssimativamente) 74
ore. Un valore di intervallo pari a zero è sinonimo di una volta. Un intervallo di difetto
significa utilizzare l'intervallo di registrazione predefinito di 60 secondi; questo valore predefinito potrebbe essere
cambiato in intervallo con la -t opzione da linea di comando.

. intervallo argomento segue la sintassi descritta in PCPIntro(1), e in
la forma più semplice può essere un intero senza segno (le unità implicite in questo caso sono
secondi).

6. Dopo le specifiche dello stato e dell'eventuale intervallo viene visualizzato un ``{'', seguito da a
elenco di una o più specifiche metriche e un ``}'' di chiusura. La lista è bianca
spazio (o virgola) separati. Se nell'elenco è presente solo una specifica metrica,
le parentesi graffe sono facoltative.

7. Una specifica di metrica consiste in un nome di metrica seguito facoltativamente da un insieme di
nomi di istanze. Il nome della metrica segue le convenzioni di denominazione PCP standard, vedere
pmns(5), e se il nome della metrica è un nodo non foglia nel PMNS (vedi pmns(5)), quindi
pmlogger scenderà ricorsivamente il PMNS e applicherà la specifica di registrazione a tutti
nomi di metriche discendenti che sono nodi foglia nel PMNS. L'insieme dei nomi delle istanze
è un ``['', seguito da un elenco di uno o più nomi separati da spazi (o virgole),
numeri o stringhe e un ``]'' di chiusura. Gli elementi nell'elenco che sono numeri sono
si presume che siano identificatori di istanza interni, si presume che altri elementi siano
identificatori di istanze esterne - vedi pmGetInDom(3) per maggiori informazioni.

Se non vengono fornite istanze, la specifica di registrazione viene applicata a tutte le istanze
della metrica associata.

8. Potrebbe esserci un numero arbitrario di specifiche di registrazione.

9. Seguendo tutte le specifiche di registrazione, potrebbe esserci un controllo di accesso opzionale
sezione, introdotta dal token letterale [accesso]. Successivamente viene il controllo degli accessi
regole che consentono o vietano le operazioni da particolari host o gruppi di host.

Le operazioni possono essere utilizzate per interrogare o controllare una corsa pmlogger utilizzando pmlc(1)
e rientrano nelle seguenti classi:

chiedere informazioni interrogare lo stato di pmlogger e le metriche che sta registrando
consultivo Modifica registrazione avvisi.
obbligatorio Modifica registrazione obbligatoria.
contro tutti i Tutti i precedenti.

Le regole di controllo dell'accesso sono nella forma ``consentire lista host : lista delle operazioni ;'' e
``rifiutare lista host : lista delle operazioni ;''.

. lista host segue la sintassi e la semantica per i meccanismi di controllo degli accessi utilizzati
da PMCD e sono completamente documentati in pmc(1). Un lista operazioni è una virgola separata
elenco delle operazioni consultivo, obbligatorio, chiedere informazioni e contro tutti i.

Un mancante [accesso] sezione consente tutti gli accessi ed è equivalente a consentire * : tutti;.

La configurazione (da input standard o file di configurazione) viene inizialmente scansionato da
pmcpp(1) con le opzioni -r e -I $PCP_VAR_LIB/config/pmlogger. Questo estende il
sintassi del file di configurazione con elaborazione del file include (%includere), un luogo comune a
cerca i file di inclusione ($PCP_VAR_LIB/config/pmlogger), definizioni macro (%definire),
espansione macro (%Nome e %{Nome}) e inclusione condizionale di righe (%ifdef Nome ...
%altro ... %finisci se e %ifnd Nome ... %altro ... %finisci se).

ESEMPI

Per ogni utility PCP, c'è un campione pmlogger file di configurazione che potrebbe essere utilizzato per
creare un registro di archivio adatto per la riproduzione con quello strumento (cioè include tutti i
metriche di performance utilizzate dallo strumento). Per uno strumento chiamato foo questo file di configurazione è
situato in $PCP_VAR_LIB/config/pmlogger/config.foo.

Quello che segue è un semplice file di configurazione predefinito per un primario pmlogger esempio, e
dimostra la maggior parte delle capacità del linguaggio di specifica della configurazione.

log obbligatorio una volta { hinv.ncpu hinv.ndisk }
accesso obbligatorio ogni 10 minuti {
disk.all.write
disco.tutto.letto
network.interface.in.packets [ "et0" ]
network.interface.out.packets [ "et0" ]
nfs.server.reqs [ "ricerca" "getattr" "lettura" "scrittura" ]
}

avviso di registro ogni 30 minuti {
ambiente.temp
pmcd.pdu_in.totale
pmcd.pdu_out.totale
}

%include "macros.default"

%ifdef %dettaglio_disco
log obbligatorio su %disk_detail_freq {
disco.dev
}
%finisci se

[accesso]
disallow * : tutto tranne enquire;
allow localhost : obbligatorio, consultivo;

Usa pmlogger online utilizzando i servizi onworks.net