perfmetrics

perfmetrics suteikia paprastą būdą pridėti programinės įrangos našumo metrikos Python bibliotekų ir programų. & Nbsp; Naudokite perfmetrics rasti tikruosius kliūtis gamybos taikymo.
Perfmetrics paketas yra iš Statsd demonas pagal Etsy, kuris, savo ruožtu, grafito klientas (konkrečiau, Anglies demonas) klientas. Kadangi perfmetrics paketą siunčia UDP paketus Statsd, perfmetrics prideda jokių I / O vėlavimų į programų ir mažai procesoriaus važtaraščius. Jis gali dirbti vienodai gerai sriegine (sinchroninio) arba įvykiu pagrįsti (asinchroninis) programinę įrangą.
Naudojimas
Naudokitemetric irmetricmethod dekoratoriai wrap funkcijas ir metodus, kurie turėtų siųsti laiką ir skambučių statistiką Statsd. Pridėti dekoratoriai bet funkcijos ar metodo, kuris galėtų būti trukdžių, įskaitant bibliotekos funkcijas.
Pavyzdys:
nuo perfmetrics importuoti metrika
nuo perfmetrics importo metricmethod
metric
Def myFunction ():
& Nbsp; "" "Ar kažkas, kad gali būti brangus" ""
klasė MyClass (objektas):
& Nbsp;metricmethod
& Nbsp; def mymethod (si):
& Nbsp; "" "Ar kokį kitą galbūt brangaus dalykas" ""
Kitas, pasakykite perfmetrics kaip prisijungti prie Statsd. (Kol padaryti, kad dekoratorių neturės jokio poveikio.) Geriausia, jei jūsų prašymas turėtų perskaityti Statsd URI iš konfigūracijos faile paleisties metu, bet toliau pavyzdys naudoja sunkiai koduojami URI paprastumo:
nuo perfmetrics importo set_statsd_client
set_statsd_client (statsd: // localhost: 8125)
už I xrange (1000):
& Nbsp; myFunction ()
& Nbsp;. MyClass () mymethod ()
Jei paleisti tą kodą, jis bus ugnies 2000 UDP paketus uoste 8125. Tačiau, jei jūs jau įdiegta grafitas ir Statsd, visus tuos paketus bus ignoruojami ir nukrito. Nuleisti yra geras dalykas: Jūs nenorite, kad jūsų produkcijos taikymas nepavyksta arba sulėtinti tik todėl, kad jūsų veiklos stebėsenos sistema yra sustabdytas arba neveikia.
Įdiekite grafitas ir Statsd gauti ir graph metriką. Vienas geras būdas juos įdiegti yra graphite_buildout pavyzdys ne GitHub, kuris įdiegia grafitas ir Statsd į savo vietą be root prieigą.
Sriegio
Nors dauguma programų siųsti metrikas bet siūlai vieną pasaulio Statsd serverio, kai kurios programos reikia naudoti kitą Statsd serverį kiekvieno pokalbio. Jei jums reikia tik pasaulinę Statsd serverį, naudokite funkciją set_statsd_client paraiškoje paleidimo. Jei jums reikia naudoti kitą Statsd serverį kiekvienam siūlai, naudokite statsd_client_stack objektą kiekvienoje temoje. Naudokite push, pop, ir aiškius metodus.
Grafito Patarimai
Grafito parduotuvės kiekvienas metrika kaip laiko eilučių su daug rezoliucijų. Mėginio graphite_buildout parduotuvės 10 sekundžių rezoliucija 48 valandas, 1 valandą rezoliucijos 31 dienų, ir 1 diena rezoliucijos 5 metus. Norėdami gaminti šiurkščiavilnių grūdėtas vertę iš Smulkaus vertės, grafitas apskaičiuoja vidutinę vertę (vidurkį) už kiekvieną laiko tarpą.
Kadangi grafitas apskaičiuoja vidutines vertes ir netiesiogiai, protingiausias būdas gydyti skaitikliai grafitas kaip "hitai per sekundę" vertę. Tokiu būdu, grafikas gali gaminti teisingus rezultatus, nesvarbu, kuri rezoliucija lygio ji naudoja.
Gydymas skaitikliai taip hitai per sekundę turi gaila pasekmes, tačiau. Jei kai kurie metrinės mato 1000 hit smaigalys per vieną sekundę, tada patenka į nulinę mažiausiai 9 sekundes, grafitas diagramos tos metrikos parodys 100 smaigalys, o ne 1000, nes grafitas gauna metrikos kas 10 sekundžių ir smaigalys atrodo Grafito kaip 100 lankytojų per sekundę per 10 sekundžių laikotarpį.
Jei norite, kad jūsų Diagrama rodanti 1000 hitai, o ne 100 hitai per sekundę, taikyti Grafitas hitcount () funkciją, naudojant 10 ar daugiau sekundžių rezoliuciją. Hitcount funkcija paverčia per sekundę vertybes suderinti žaliavų hit skaičius. Būtinai pateikti gebos vertę pakankamai didelis, kad būtų atstovaujama ne mažiau kaip vienerius pikselių pločio dėl atsiradusios diagramoje, kitaip grafitas bus apskaičiuoti vidurkiai hit skaičius ir gaminti paini grafiką.
Ji paprastai turi prasmę gydyti neapibrėžtų reikšmių grafito kaip nulis, nors tai nėra numatytoji; pagal nutylėjimą, grafitas atkreipia nieko neapibrėžtų reikšmių. Jūs galite įjungti šią galimybę kiekvienam diagramoje.
Nuoroda Dokumentacija
Dekoratoriai
metric
& Nbsp; praneša Statsd naudojant UDP kaskart funkcija yra vadinama. Siunčia tiek skambučių skaičių ir laiko informaciją. Iš metrikos išsiųstas Statsd vardas . .
metricmethod
& Nbsp; Kaipmetric, bet iš Statsd metrikos vardas ...
Metric (stat = Nėra, tarifas = 1, metodas = false, count = Tiesa, laikas = True)
& Nbsp; dekoratorius arba kontekstas vadybininkas variantų.
& Nbsp; termostatas yra metrika siųsti pavadinimas; nustatykite ją Nėra pasinaudoti funkcijos ar metodo pavadinimą. kursas leidžia jums sumažinti paketus siunčiamų Statsd pasirinkdami atsitiktinį mėginį, skaičius; pavyzdžiui, nustatyti, kad jis 0,1 nusiųsti vieną dešimtąją paketus. Jei metodas parametras yra tiesa, pagal nutylėjimą metrika pavadinimas remiasi metodo anketa klasės pavadinimas, o ne modulio pavadinimą. Nustatymas skaičius False išjungia counter siunčiami Statsd. Nustatymas laiko, kad Neteisingų išjungia sinchronizavimo statistiką siunčiami Statsd.
& Nbsp; Imties naudoti kaip apdailininko:
& Nbsp;Metric (frequent_func "tarifas = 0,1, laikas = false)
& Nbsp; def frequent_func ():
& Nbsp; "" "Ar ką nors greitai ir dažnai" ""
& Nbsp; Imties naudoti kaip kontekstinio vadybininkas:
& Nbsp; def do_something ():
& Nbsp; su metriniu (doing_something):
& Nbsp; perdavimas
& Nbsp; Jei perfmetrics siunčia paketus per dažnai, UDP paketai gali būti prarasta ir gali turėti įtakos sistemos našumas. Jūs galite sumažinti paketus, skaičių ir procesoriaus važtaraščius, naudojant metrinės dekoratorius su variantų vietoj metrinė ar metricmethod. Apdailininko pavyzdys aukščiau naudoja imties dažnį ir statinio metrinis vardą. Ji taip pat išjungia laiko informaciją kolekciją.
& Nbsp; Kai kuriose naudojami metriniai kaip kontekstinio vadybininkas, turite pateikti stat parametrą arba nieko nebus registruojami.
Funkcijos
statsd_client ()
& Nbsp; Grąžinkite metu neužpildė StatsdClient. Grąžina giją-vietos klientui, jei toks yra, arba pasaulinė klientas, jei toks yra, arba nėra.
set_statsd_client (client_or_uri)
& Nbsp; Nustatyti pasaulio StatsdClient. Client_or_uri gali būti StatsdClient, statsd: // URI arba Nėra.
statsd_client_from_uri (URI)
& Nbsp; Sukurti iš URI StatsdClient. Tipiškas URI statsd: // localhost: 8125. Palaikomi neprivaloma užklausos parametrai yra priešdėlis ir gauge_suffix. Numatytasis prefiksas yra tuščias ir numatytąjį gauge_suffix yra .. Žr StatsdClient dokumentus gauti daugiau informacijos apie gauge_suffix.
StatsdClient būdai
Python kodas gali siųsti užsakymą rodiklius pirmiausia gauti esamą StatsdClient naudodami statsd_client () metodą. Atkreipkite dėmesį, kad statsd_client () grąžina None jei klientas buvo sukonfigūruotas.
Dauguma žemiau metodams alternatyvius normų ir buf parametrus. Rodiklis rodiklis, kai nustatyta vertė mažesnė nei 1, sukelia StatsdClient siųsti atsitiktinį mėginį pakelių, o ne kiekvieną paketą. Jei buf parametras yra sąrašas, StatsdClient prideda maišelio turinį į buf sąrašą, o ne siųsti paketą, kad būtų galima siųsti kelis naujinimus vieną paketą. Turėkite omenyje, kad UDP paketus dydis yra ribotas (riba kinta tinklo, tačiau 1000 baitų paprastai yra geras spėjimas), ir visus extra baitai bus ignoruojami tyliai.
laikas (stat, vertė, tarifas = 1, buf = Nebuvimas)
& Nbsp; Įrašų laiko informacija. stat yra metrika vardas įrašyti ir vertė yra laiko matavimo milisekundėmis. Atkreipkite dėmesį, kad Statsd palaiko keletą duomenų taškų už kiekvieną laiko nustatymo formulę taip Timing metrikos gali užtrukti daugiau vietos diske nei skaitikliai ar matuokliai.
matuoklis (stat, vertę, priesaga = Nėra, tarifas = 1, buf = Nebuvimas)
& Nbsp; Atnaujinkite matuoklis vertę. stat yra metrika vardas įrašyti ir vertė yra naujos vėžės vertė. Manometras rodo išliekamąją vertę, pavyzdžiui, baseino dydžio. Kadangi matuokliai iš įvairių mašinų dažnai konflikto, priesaga dažniausiai taikomas įvertinti pavadinimus. Jei priesaga parametras yra eilutė (įskaitant tuščią eilutę), jis yra viršesnis už numatytąjį matuoklis priesaga.
inch (stat, count = 1, tarifas = 1, buf = Nebuvimas)
& Nbsp; prieaugis yra pagal skaičių skaitiklį. Atkreipkite dėmesį, kad Statsd išvalo visus kontrargumentus vertybes kaskart jis siunčia metrikas grafitas, kuris paprastai vyksta kas 10 sekundžių. Jei reikia išliekamąją vertę, ji gali būti tikslingiau vietoj naudoti matuoklį iš skaitiklis.
mažėjanti tvarka (stat, count = 1, tarifas = 1, buf = Nebuvimas)
& Nbsp; Silpimas pagal skaičių skaitiklis.
sendbuf (buf)
& Nbsp; išsiunčia BUF sąrašo turinį Statsd

Kas naujo , šioje laidoje:

• Pridėta neprivaloma piramidės. Tween ir panašūs WSGI filtras programa, kuri įkuria Statsd klientas už kiekvieną prašymą.

Kas naujo versijos 0.9.4:.

• Optimizuotas lengvatinių imties dydžių naudojimą

Kas naujo versijos 0.9.2:

• Metrinė dabar gali būti naudojami arba kaip apdailininko arba kontekstas vadybininkas.
• Pagamintas iš StatsdClient parašą daugiau kaip James Socol anketa StatsClient.

Reikalavimai :

• Python