pmdaweblog - Online în cloud

PROGRAM:

NUME

pmdaweblog - agent de domeniu pentru metrici de performanță (PMDA) pentru jurnalele serverului web

REZUMAT

$PCP_PMDAS_DIR/weblog/pmdaweblog [-Cp] [-d domeniu] [-h fişier de ajutor] [-i port] [-l fișier jurnal]
[-n idlesec] [-S o] [-t întârziere] [-u priză] [-U nume de utilizator] configfile

DESCRIERE

pmdaweblog este un agent de domeniu pentru parametrii de performanță (PMDA(3)) care scanează jurnalele serverului web
extrageți valorile care caracterizează activitatea serverului web. Aceste valori de performanță sunt atunci
puse la dispoziție prin infrastructura Copilotului de Performanță (PCP).

configfile specifică ce servere Web vor fi monitorizate, accesul asociat acestora
jurnalele și jurnalele de erori și o schemă bazată pe expresii regulate pentru extragerea detaliilor
informații despre fiecare acces Web. Acest fișier este menținut ca parte a PMDA
instalare și/sau dezinstalare prin scripturi Instalare și Elimină în director
$PCP_PMDAS_DIR/weblog. Pentru mai multe detalii, consultați secțiunea de mai jos care se referă
instalare.

Odată început, pmdaweblog monitorizează un set de fișiere jurnal și ca răspuns la o solicitare de
informații, va procesa orice informație nouă care a fost atașată la fișierele jurnal,
similar cu un coadă(1). Există, de asemenea, periodic „catch up” pentru a procesa informații noi
toate fișierele jurnal și o schemă pentru a detecta rotația fișierelor jurnal.

Ca toate celelalte PMDA, pmdaweblog este lansat de pmcd(1) folosind opțiunile din linia de comandă
specificat în $PCP_PMCDCONF_PATH - pentru Instalare scriptul va solicita valorile adecvate
pentru opțiunile liniei de comandă și actualizați $PCP_PMCDCONF_PATH.

O scurtă descriere a pmdaweblog Următoarele opțiuni ale liniei de comandă:

-C Verificați configurația și ieșiți.

-d domeniu
Se specifică domeniu număr. Este absolut esențial ca valorile de performanță
domeniu numărul specificat aici este unic și consecvent. Acesta este, domeniu ar trebui să fie
diferit pentru fiecare PMDA pe o singură gazdă și la fel domeniu ar trebui folosit numărul
pentru pmdaweblog PMDA pe toate gazdele.

Pentru majoritatea instalărilor, implicit domeniu așa cum este încapsulat în fișier
$PCP_PMDAS_DIR/weblog/domain.h va fi suficient. Pentru valori alternative, verificați
$PCP_PMCDCONF_PATH pentru domeniu valorile deja utilizate pe această gazdă și fișierul
$PCP_VAR_DIR/pmns/stdpmid conține un depozit de „bine cunoscut” domeniu
sarcini care probabil ar trebui evitate.

-h fişier de ajutor
Obțineți textul de ajutor din pachetul furnizat fişier de ajutor mai degrabă decât din locația implicită.

-i port
Comunică cu pmcd(1) pe internetul specificat port (care poate fi un număr sau a
Nume).

-l fișier jurnal
Locația fișierului jurnal. În mod implicit, un fișier jurnal numit weblog.log este scris în
directorul curent al pmcd(1) când pmdaweblog este pornit, adică
$PCP_LOG_DIR/pmcd. Dacă fișierul jurnal nu poate fi creat sau nu poate fi scris, rezultatul este
scris în schimb la eroarea standard.

-n idlesec
Dacă un fișier jurnal de server Web nu a fost modificat pentru idlesec secunde, apoi fișierul
va fi închis și redeschis. Acesta este singurul mod pmdaweblog poate detecta orice
rotația asincronă a jurnalelor de către scripturile administrative ale serverului web. The
perioada implicită este de 20 de secunde. Această valoare poate fi modificată dinamic folosind
pmstore(1) pentru a modifica valoarea metricii de performanță web.config.check.

-p Comunică cu pmcd(1) printr-o conductă.

-S o Specificați numărul maxim de servere Web per sproc. Poate fi de dorit (de la a
perspectiva latenței și echilibrării sarcinii) sau necesar (datorită descriptorului de fișier
limite) pentru a delega responsabilitatea pentru scanarea fișierelor jurnal ale serverului Web către mai multe
sprocs. pmdaweblog se va asigura că fiecare sproc gestionează fișierele jurnal pentru cel mult
o Servere web. Valoarea implicită este de 80 de servere web per sproc.

-t întârziere
Pentru a evita nevoia de a scana o mulțime de informații din jurnalele serverului Web ca răspuns
la o singură solicitare pentru valorile de performanță, toate fișierele jurnal vor fi verificate cel puțin
o data în fiecare întârziere secunde. Valoarea implicită este de 15 secunde. Această valoare poate fi schimbată
folosind dinamic pmstore(1) pentru a modifica valoarea metricii de performanță
web.config.catchup.

-u priză
Comunică cu pmcd(1) prin domeniul Unix dat priză.

-U Cont de utilizator sub care să rulați agentul. Valoarea implicită este „pcp” fără privilegii
cont în versiunile curente de PCP, dar în versiunile mai vechi contul de superutilizator
(„rădăcină”) a fost folosită implicit.

INSTALARE

Cadrul PCP permite colectarea de metrici pe o gazdă și monitorizarea de la alta.
Aceste gazde sunt denumite colector și monitorizează gazde, respectiv. O gazdă poate fi
atât un colecționar cât și un monitor.

Gazdele colectoare necesită instalarea agentului, în timp ce gazdele de monitorizare necesită nr
instalarea agentului deloc.

Pentru gazdele colectoare, faceți următoarele ca root:

# cd $PCP_PMDAS_DIR/weblog
# ./Instalare

Procedura de instalare solicită o instalare implicită sau non-implicit. Un implicit
instalarea va căuta configurații cunoscute de server și va configura automat
PMDA pentru orice fișiere jurnal de server găsite. O instalare care nu este implicită se va face
prin fiecare server, solicitând utilizatorului alte configurații de server și argumente pentru
pmdaweblog. Rezultatul final al unei instalări de colector este de a construi un fișier de configurare
care se transmite la pmdaweblog prin intermediul configfile a susținut.

Dacă doriți să anulați instalarea, faceți următoarele ca root:

# cd $PCP_PMDAS_DIR/weblog
# ./Elimina

pmdaweblog este lansat de pmcd(1) și nu ar trebui niciodată executat direct. The Instalare și
Elimină scripturile notifică pmcd(1) când agentul este instalat sau eliminat.

CONFIGURARE

Fișierul de configurare pentru weblog PMDA este un fișier ASCII care poate fi ușor modificat.
Linii goale și linii care încep cu „#' sunt ignorate. Toate celelalte linii trebuie să fie fie a
expresia regulată sau specificația serverului.

Expresiile regulate, care sunt utilizate atât în ​​fișierele jurnal de acces, cât și în fișierele de jurnal de erori, trebuie să fie ale
formă:

regex regexName expresie regulată
or

regex_posix regexName comanda regexp_posix

regexName este un cuvânt care identifică în mod unic expresia regulată. Acesta este
referință utilizată în specificația serverului. The expresie regulată pentru jurnalele de acces este în format
descris pentru regcmp(3). regexp_posix pentru jurnalele de acces este în formatul descris pentru
regcomp(3). Argumentul comanda este explicat mai jos. The POSIX formularul ar trebui să fie disponibil
pe toate platformele.

Expresia regulată necesită specificarea a până la patru argumente pentru a fi extrase
din fiecare linie a unui jurnal de acces la server Web, în ​​funcție de tipul de server. În cele mai multe
caz obișnuit există două argumente reprezentând metoda și dimensiunea.

Pentru cei non- POSIX versiune, argument $0 ar trebui să conțină metoda: GET, HEAD , POST or
PUT. Metoda PUT este tratat ca un sinonim pentru POST, și orice altceva este clasificat ca
ALTE.

Al doilea argument, $1, ar trebui să conțină dimensiunea cererii. O dimensiune de ``-'' sau `` ''
este tratat ca necunoscut.

Argument $3 ar trebui să conțină codul de stare returnat browserului client și argument $4
ar trebui să conțină codul de stare returnat serverului de la o gazdă la distanță. Acestea din urma
două argumente sunt utilizate pentru serverele de cache și trebuie specificate ca o pereche (sau $3 va fi
ignorat). Pentru mai multe informații despre codurile de stare, consultați site-ul web
http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html

Unele non-legale POSIX Specificațiile expresiilor regex pentru monitorizarea unui jurnal de acces sunt:

# model pentru Jurnalele de acces CERN, NCSA, Netscape etc
regex CERN ] „([A-Za-z][-A-Za-z]+)$0 .*” [-0-9]+ ([-0-9]+)$1

# model pentru jurnalele de acces la serverul FTP (în mod normal în SYSLOG)
regex SYSLOG_FTP ftpd[.*]: ([gp][-A-Za-z]+)$0( )$1

Există 1 tipuri speciale de jurnale de acces cu RegexName CALAMAR. Acest format formatează extragerea 4
parametrii dar din moment ce Calamar fișierul jurnal utilizează coduri de stare bazate pe text, este tratat ca a
caz special.

În exemplele de mai jos, NS_PROXY analizează Netscape/W3C Comun Extins Log Format și
CALAMAR analizează fișierul jurnal în format implicit Squid Object Cache.

# model pentru jurnalele extinse Netscape Proxy Server
regex NS_PROXY ] „([A-Za-z][-A-Za-z]+)$0 .*” ([-0-9]+)$2 \
([-0-9]+)$1 ([-0-9]+)$3

# model pentru jurnalele Squid Cache
regex SQUID [0-9]+.[0-9]+[ ]+[0-9]+ [a-zA-Z0-9.]+ \
([_A-Z]+)$3([0-9]+)$2 ([0-9]+)$1 ([A-Z]+)$0

expresie regulată pentru jurnalele de erori nu necesită niciun argument, doar o potrivire. Unele legale
expresiile sunt:

# model pentru Jurnalele de erori CERN, NCSA, Netscape etc
regex CERN_err .

# model pentru jurnalele de erori ale serverului FTP (în mod normal în SYSLOG)
regex SYSLOG_FTP_err CONECTAREA FTP A ESCUT

If POSIX sunt utilizate expresii regulate conforme, sunt necesare informații suplimentare deoarece
ordinea parametrilor nu poate fi specificată în expresia regulată. Pentru înapoi
compatibilitate, cazul obișnuit al doi parametri în care poate fi specificată comanda metoda, dimensiunea
or dimensiune, metoda În cazul general, ordinea este specificată de unul dintre următoarele
metode:

n1,n2,n3,n4
unde nX este o cifră între 1 și 4. Fiecare câmp separat prin virgulă reprezintă (în ordine)
numărul argumentului pentru metoda, dimensiunea, starea_clientului, starea_serverului

- Folosit pentru cazuri precum jurnalele de erori în care conținutul este ignorat.

Cât despre non- POSIX format, CALAMAR RegexName este tratat ca un caz special de potrivire
codurile de stare nenumerice.

Unele legale POSIX Specificațiile expresiilor regex pentru monitorizarea unui jurnal de acces sunt:

# model pentru Jurnalele de acces CERN, NCSA, Netscape, Apache etc
regex_posix metoda CERN, dimensiune ][ \]+"([A-Za-z][-A-Za-z]+) \
[^"]*" [-0-9]+ ([-0-9]+)

# model pentru Jurnalele de acces CERN, NCSA, Netscape, Apache etc
regex_posix CERN 1,2 ][ \]+"([A-Za-z][-A-Za-z]+) \
[^"]*" [-0-9]+ ([-0-9]+)

# model pentru jurnalele de acces la serverul FTP (în mod normal în SYSLOG)
regex_posix metoda SYSLOG_FTP, dimensiune ftpd[.*]: \
([gp][-A-Za-z]+)( )

# model pentru jurnalele extinse Netscape Proxy Server
regex_posix NS_PROXY 1,3,2,4 ][ ]+"([A-Za-z][-A-Za-z]+) \
[^"]*" ([-0-9]+) ([-0-9]+) ([-0-9]+)

# model pentru jurnalele Squid Cache
regex_posix SQUID 4,3,2,1 [0-9]+.[0-9]+[ ]+[0-9]+ \
[a-zA-Z0-9.]+ ([_A-Z]+)([0-9]+) ([0-9]+) ([AZ]+)

# model pentru Jurnalele de erori CERN, NCSA, Netscape etc
regex_posix CERN_err - .

# model pentru jurnalele de erori ale serverului FTP (în mod normal în SYSLOG)
regex_posix SYSLOG_FTP_err - CONECTAREA FTP A ESCUT

Un server Web poate fi specificat folosind această sintaxă:

serverul numele serverului on|de pe accessRegex accessFile errorRegex errorFile

numele serverului trebuie să fie unic pentru fiecare server și este numele dat instanței pentru
metricile de performanță asociate. Vedea PMAPI(3) pentru o discuție despre instanța PCP
domenii. The on or de pe flag indică dacă serverul urmează să fie monitorizat atunci când PMDA
este instalat. Acest lucru poate fi modificat dinamic folosind pmstore(1) pentru metrica
web.perserver.vizionat, care are o instanță pentru fiecare server Web numit în configfile.

Sunt monitorizate două fișiere pentru fiecare server Web, accesul și jurnalul de erori. Fiecare dosar
necesită numele unei expresii regulate declarate anterior și un nume de fișier. Buturuga
fișierele specificate pentru fiecare server nu trebuie să existe atunci când weblog-ul PMDA este instalat.
PMDA va continua să verifice dacă există fișiere jurnal inexistente și să le deschidă atunci când este posibil.
Unele specificații legale ale serverului sunt:

# Server Netscape pe portul 80 la adresa IP 127.55.555.555
server 127.55.555.555:80 pe CERN /logs/access CERN_err /logs/errors

# Server FTP.
server ftpd pe SYSLOG_FTP /var/log/messages SYSLOG_FTP_err /var/log/messages

Avertismente

Specificarea expresiilor regulate cu un număr incorect de argumente, altceva decât
2 pentru jurnalele de acces și niciunul pentru jurnalele de eroare, poate cauza PMDA să se comporte incorect și
chiar prăbușire. Acest lucru se datorează limitărilor din interfața regex(3).

Utilizați pmdaweblog online folosind serviciile onworks.net