Add generated metrics

git-svn-id: https://svn.apache.org/repos/asf/hadoop/hbase/trunk@736413 13f79535-47bb-0310-9956-ffa450edef68
This commit is contained in:
Michael Stack 2009-01-21 21:11:19 +00:00
parent 8b53dd0396
commit 618e917bfc
2 changed files with 467 additions and 0 deletions

227
docs/metrics.html Normal file
View File

@ -0,0 +1,227 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta content="Apache Forrest" name="Generator">
<meta name="Forrest-version" content="0.8">
<meta name="Forrest-skin-name" content="pelt">
<title>
HBase Metrics
</title>
<link type="text/css" href="skin/basic.css" rel="stylesheet">
<link media="screen" type="text/css" href="skin/screen.css" rel="stylesheet">
<link media="print" type="text/css" href="skin/print.css" rel="stylesheet">
<link type="text/css" href="skin/profile.css" rel="stylesheet">
<script src="skin/getBlank.js" language="javascript" type="text/javascript"></script><script src="skin/getMenu.js" language="javascript" type="text/javascript"></script><script src="skin/fontsize.js" language="javascript" type="text/javascript"></script>
<link rel="shortcut icon" href="images/favicon.ico">
</head>
<body onload="init()">
<script type="text/javascript">ndeSetTextSize();</script>
<div id="top">
<!--+
|breadtrail
+-->
<div class="breadtrail">
<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://hadoop.apache.org/">Hadoop</a> &gt; <a href="http://hadoop.apache.org/hbase/">HBase</a><script src="skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script>
</div>
<!--+
|header
+-->
<div class="header">
<!--+
|start group logo
+-->
<div class="grouplogo">
<a href="http://hadoop.apache.org/"><img class="logoImage" alt="Hadoop" src="images/hadoop-logo.jpg" title="Apache Hadoop"></a>
</div>
<!--+
|end group logo
+-->
<!--+
|start Project Logo
+-->
<div class="projectlogo">
<a href="http://hadoop.apache.org/hbase/"><img class="logoImage" alt="HBase" src="images/hbase_small.gif" title="The Hadoop database"></a>
</div>
<!--+
|end Project Logo
+-->
<!--+
|start Search
+-->
<div class="searchbox">
<form action="http://www.google.com/search" method="get" class="roundtopsmall">
<input value="hadoop.apache.org" name="sitesearch" type="hidden"><input onFocus="getBlank (this, 'Search the site with google');" size="25" name="q" id="query" type="text" value="Search the site with google">&nbsp;
<input name="Search" value="Search" type="submit">
</form>
</div>
<!--+
|end search
+-->
<!--+
|start Tabs
+-->
<ul id="tabs">
<li>
<a class="unselected" href="http://hadoop.apache.org/hbase/">Project</a>
</li>
<li>
<a class="unselected" href="http://wiki.apache.org/hadoop/Hbase">Wiki</a>
</li>
<li class="current">
<a class="selected" href="index.html">HBase Documentation</a>
</li>
</ul>
<!--+
|end Tabs
+-->
</div>
</div>
<div id="main">
<div id="publishedStrip">
<!--+
|start Subtabs
+-->
<div id="level2tabs"></div>
<!--+
|end Endtabs
+-->
<script type="text/javascript"><!--
document.write("Last Published: " + document.lastModified);
// --></script>
</div>
<!--+
|breadtrail
+-->
<div class="breadtrail">
&nbsp;
</div>
<!--+
|start Menu, mainarea
+-->
<!--+
|start Menu
+-->
<div id="menu">
<div onclick="SwitchMenu('menu_selected_1.1', 'skin/')" id="menu_selected_1.1Title" class="menutitle" style="background-image: url('skin/images/chapter_open.gif');">Documentation</div>
<div id="menu_selected_1.1" class="selectedmenuitemgroup" style="display: block;">
<div class="menuitem">
<a href="index.html">Overview</a>
</div>
<div class="menuitem">
<a href="api/overview-summary.html#overview_description">Getting Started</a>
</div>
<div class="menuitem">
<a href="api/index.html">API Docs</a>
</div>
<div class="menupage">
<div class="menupagetitle">HBase Metrics</div>
</div>
<div class="menuitem">
<a href="http://wiki.apache.org/hadoop/Hbase">Wiki</a>
</div>
<div class="menuitem">
<a href="http://wiki.apache.org/hadoop/Hbase/FAQ">FAQ</a>
</div>
<div class="menuitem">
<a href="http://hadoop.apache.org/hbase/mailing_lists.html">Mailing Lists</a>
</div>
</div>
<div id="credit"></div>
<div id="roundbottom">
<img style="display: none" class="corner" height="15" width="15" alt="" src="skin/images/rc-b-l-15-1body-2menu-3menu.png"></div>
<!--+
|alternative credits
+-->
<div id="credit2"></div>
</div>
<!--+
|end Menu
+-->
<!--+
|start content
+-->
<div id="content">
<div title="Portable Document Format" class="pdflink">
<a class="dida" href="metrics.pdf"><img alt="PDF -icon" src="skin/images/pdfdoc.gif" class="skin"><br>
PDF</a>
</div>
<h1>
HBase Metrics
</h1>
<div id="minitoc-area">
<ul class="minitoc">
<li>
<a href="#Introduction"> Introduction </a>
</li>
<li>
<a href="#HOWTO">HOWTO</a>
</li>
</ul>
</div>
<a name="N1000D"></a><a name="Introduction"></a>
<h2 class="h3"> Introduction </h2>
<div class="section">
<p>
HBase emits Hadoop <a href="http://hadoop.apache.org/core/docs/current/api/org/apache/hadoop/metrics/package-summary.html">metrics</a>.
</p>
</div>
<a name="N1001B"></a><a name="HOWTO"></a>
<h2 class="h3">HOWTO</h2>
<div class="section">
<p>First read up on Hadoop <a href="http://hadoop.apache.org/core/docs/current/api/org/apache/hadoop/metrics/package-summary.html">metrics</a>.
If you are using ganglia, the <a href="http://wiki.apache.org/hadoop/GangliaMetrics">GangliaMetrics</a>
wiki page is useful read.</p>
<p>To have HBase emit metrics, edit <span class="codefrag">$HBASE_HOME/conf/hadoop-metrics.properties</span>
and enable metric 'contexts' per plugin. As of this writing, hadoop supports
<strong>file</strong> and <strong>ganglia</strong> plugins.
Yes, the hbase metrics files is named hadoop-metrics rather than
<em>hbase-metrics</em> because currently at least the hadoop metrics system has the
properties filename hardcoded. Per metrics <em>context</em>,
comment out the NullContext and enable one or more plugins instead.
</p>
<p>
If you enable the <em>hbase</em> context, on regionservers you'll see total requests since last
metric emission, count of regions and storefiles as well as a count of memcache size.
On the master, you'll see a count of the cluster's requests.
</p>
<p>
Enabling the <em>rpc</em> context is good if you are interested in seeing
metrics on each hbase rpc method invocation (counts and time taken).
</p>
<p>
The <em>jvm</em> context is
useful for long-term stats on running hbase jvms -- memory used, thread counts, etc.
As of this writing, if more than one jvm is running emitting metrics, at least
in ganglia, the stats are aggregated rather than reported per instance.
</p>
</div>
</div>
<!--+
|end content
+-->
<div class="clearboth">&nbsp;</div>
</div>
<div id="footer">
<!--+
|start bottomstrip
+-->
<div class="lastmodified">
<script type="text/javascript"><!--
document.write("Last Published: " + document.lastModified);
// --></script>
</div>
<div class="copyright">
Copyright &copy;
2008 <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
</div>
<!--+
|end bottomstrip
+-->
</div>
</body>
</html>

240
docs/metrics.pdf Normal file
View File

@ -0,0 +1,240 @@
%PDF-1.3
%ª«¬­
4 0 obj
<< /Type /Info
/Producer (FOP 0.20.5) >>
endobj
5 0 obj
<< /Length 397 /Filter [ /ASCII85Decode /FlateDecode ]
>>
stream
Gaua9]hZI!'SU`q`?!EYMgod-FJO_m+JB-NM#eG[lElgK;A'eagCpJbmBUi81H<Fh55&W]M.,"7"YrLVVIJ>)-0)4?!dO_O)#LQhjf#I)bU:%MZUrQt&R7nupJ]2/FmZd,7dpoMTm+s.%W3X0U^;atp(jP#fF/PVVimnas(,+j>J&f`+S_q.i6iR-^f9e$6sM>D<=d:5lMK;Cc!jbcF]4'TnM7425d!rZQ9c_@@k39(!$]a!8(FsAMj]XaP-@Geb4`n3+Q"(12'd*rMr5L25ruXf7nM'2W7VcQpr(>8j`&G?:+6OO+Mr+f0NL^Lo%RdRgTHkn(K1,W8H^>"c\"!R.,Ho;U5\bd;n8NpNCKeiY$Mf+9GfA9Ck<MtmNQL0gO@l\#4t,VcG&'~>
endstream
endobj
6 0 obj
<< /Type /Page
/Parent 1 0 R
/MediaBox [ 0 0 612 792 ]
/Resources 3 0 R
/Contents 5 0 R
/Annots 7 0 R
>>
endobj
7 0 obj
[
8 0 R
10 0 R
]
endobj
8 0 obj
<< /Type /Annot
/Subtype /Link
/Rect [ 102.0 559.666 169.328 547.666 ]
/C [ 0 0 0 ]
/Border [ 0 0 0 ]
/A 9 0 R
/H /I
>>
endobj
10 0 obj
<< /Type /Annot
/Subtype /Link
/Rect [ 102.0 541.466 154.652 529.466 ]
/C [ 0 0 0 ]
/Border [ 0 0 0 ]
/A 11 0 R
/H /I
>>
endobj
12 0 obj
<< /Length 1720 /Filter [ /ASCII85Decode /FlateDecode ]
>>
stream
Gatm<>Ap;q'RlZ]iJ1%I8f7jQbiLQ^jjHcUCn$QeW`rJVnIW8?bhA.8rUi<YIE]J`Q)^*M0uLPMhmo0@c0FjX+O$Sjg$D`L8QUj1n;i^QJS2^[;WdgdZR<MY1\u[(\S.S,IpZ0Tgt#&^Q,O"!45'P9]%O1!JTR[GDUh=j*Y!OiGcf2Y1WkQ;jD";9lFJ]$#ihIagF0_u"eEp8lW?ei<pm:dS)\q0/^"7)hl.b`hiSY34;rnsW,j?taI[A&Te>ql#<?d;-j&s3*]o.'=d>/t+/?``[$R'#'&?d2O;S/_D;)a[@CDmFn:0ZkmVRt,^45oho<=%Q#WWVP+0cRL"BYA\@IuHV\hY%dN47qK+3`UOamT;%3t_,h#;ZC?^^Qn(2%YcYhLiC:Jp]]^qd9H<NDjt4rdHA5F,1RRXBK7*C6!"5Uj3__Qm^Fj>_q&B6gE]n4l:qrj8URj;$dThY&iUO@cX-LpP+dZC\BVADBIjP7@=Tgm$nW]os5C:[G9<CSJ60H$E?0)Uc,'3G`H-madEJoVk-ijZeRIRpE^J)j=o)M(bC/\Isq!7o>ggIVjkl*/9[B+D18X7eb#NWK2bhtor.So1u(Vucdj$OW"rnU5NQqN[lL(3j\#MPl*FNgS<1=7?>p+RPLjMLTOb`&h6#Jkm*!a/Y:?Rq>q[no>u;)E>osQQW\j--e!O9'>oq_VmBTug_TDI:`j95[UmB72^FNnId[/QW7XQ+CrWKhK/rfAs<U+:XNfZB2M0DXK#@npcPsMK;5hd#0r*@6f\Xd3D516*5n3^WfiaRkrT>;5]&^2*8Xk*<Uh=Kc:nf3G]c:%G!-?5$'/ub,!7?tW]k(frjQSBN`VUO5&L!4XqBtbU=T\ji;pD>Hp^_8=s9L=@iQ<2h:gr_2ms"d,iMUaH.Sej]ng^^,5gf"c>/eng[=:?K];XX8ZmOVmtBNeqL:GEn#5Lt,ZEU[H`kZ%R2$[f`<P^'/"on'K[!*0m3\`X-nq^i<&W@'#qjre;f9;B;3FlU?/".VG,cXEhV69S*\(]umr;HQ>p<%h-`bO`%[bq^lUk@GB4F7*6a2;Tro,=p2Y\Q'om"IR";k2P$u@,,H*Y$(Qu(J#/+npM>_8Y@RVGLE(%<P;!E/,giDQhA&I-ZO_O;eLSQ<,W;dK_J=VTTSMK((HY1@q.RAa8;C6lm@#6(d?Eh1sVu.)b$WWDjjA.QG.jjA`:'2a\niCab`]'!='3SM^6bDa!2o_9>l)KY15B3I0sH'ZRICUPcZX#H8ViN#oR\=6Uu)+ZPi4d^1hY]rRm(%GU\id]-e*7^2sc:-$kj8c<nOtAb"m"4JBJC/Ridi5/o#+74j?\?hUDMF'3kcZU@Qo2r1$K\2EG\Ofj6a1_b'I<sq-h\gT,\-<,N]892DPb.(DhQ;_"'8*[7&1LLQ-)HTE??HfJ2J(R\>7bb8LgQH.R>YENchFA\G[u4uRfoZXi2P7(<`Pk9TX+cJj!i&ee`b>bh5.9`uITJANXBFQQqpt/.RH?6J..`FLP7[.:PNBdR)$u[')36*d<J$m3cCCEZ=3UYqRs&-WQkRh3oH+uZ<>EbkL>D?eJP@^'YiLNkM*)[\]tr%n-$6N7OiP]1aq!j\4R`KbhQl9Ml3e5Ni&g7(I4PnI.SHC<eq1-n-<r6Gif4\@e#"@f4'We\n^a6Qb?aep;q*t@Krj1?c&*^MDIdmFf!\%\fkqhj8d3lG"5qjhrr~>
endstream
endobj
13 0 obj
<< /Type /Page
/Parent 1 0 R
/MediaBox [ 0 0 612 792 ]
/Resources 3 0 R
/Contents 12 0 R
/Annots 14 0 R
>>
endobj
14 0 obj
[
15 0 R
16 0 R
17 0 R
]
endobj
15 0 obj
<< /Type /Annot
/Subtype /Link
/Rect [ 194.988 629.666 230.316 617.666 ]
/C [ 0 0 0 ]
/Border [ 0 0 0 ]
/A << /URI (http://hadoop.apache.org/core/docs/current/api/org/apache/hadoop/metrics/package-summary.html)
/S /URI >>
/H /I
>>
endobj
16 0 obj
<< /Type /Annot
/Subtype /Link
/Rect [ 209.652 577.332 244.98 565.332 ]
/C [ 0 0 0 ]
/Border [ 0 0 0 ]
/A << /URI (http://hadoop.apache.org/core/docs/current/api/org/apache/hadoop/metrics/package-summary.html)
/S /URI >>
/H /I
>>
endobj
17 0 obj
<< /Type /Annot
/Subtype /Link
/Rect [ 388.62 577.332 463.272 565.332 ]
/C [ 0 0 0 ]
/Border [ 0 0 0 ]
/A << /URI (http://wiki.apache.org/hadoop/GangliaMetrics)
/S /URI >>
/H /I
>>
endobj
19 0 obj
<<
/Title (\376\377\0\61\0\40\0\111\0\156\0\164\0\162\0\157\0\144\0\165\0\143\0\164\0\151\0\157\0\156)
/Parent 18 0 R
/Next 20 0 R
/A 9 0 R
>> endobj
20 0 obj
<<
/Title (\376\377\0\62\0\40\0\110\0\117\0\127\0\124\0\117)
/Parent 18 0 R
/Prev 19 0 R
/A 11 0 R
>> endobj
21 0 obj
<< /Type /Font
/Subtype /Type1
/Name /F3
/BaseFont /Helvetica-Bold
/Encoding /WinAnsiEncoding >>
endobj
22 0 obj
<< /Type /Font
/Subtype /Type1
/Name /F5
/BaseFont /Times-Roman
/Encoding /WinAnsiEncoding >>
endobj
23 0 obj
<< /Type /Font
/Subtype /Type1
/Name /F6
/BaseFont /Times-Italic
/Encoding /WinAnsiEncoding >>
endobj
24 0 obj
<< /Type /Font
/Subtype /Type1
/Name /F1
/BaseFont /Helvetica
/Encoding /WinAnsiEncoding >>
endobj
25 0 obj
<< /Type /Font
/Subtype /Type1
/Name /F9
/BaseFont /Courier
/Encoding /WinAnsiEncoding >>
endobj
26 0 obj
<< /Type /Font
/Subtype /Type1
/Name /F2
/BaseFont /Helvetica-Oblique
/Encoding /WinAnsiEncoding >>
endobj
27 0 obj
<< /Type /Font
/Subtype /Type1
/Name /F7
/BaseFont /Times-Bold
/Encoding /WinAnsiEncoding >>
endobj
1 0 obj
<< /Type /Pages
/Count 2
/Kids [6 0 R 13 0 R ] >>
endobj
2 0 obj
<< /Type /Catalog
/Pages 1 0 R
/Outlines 18 0 R
/PageMode /UseOutlines
>>
endobj
3 0 obj
<<
/Font << /F3 21 0 R /F5 22 0 R /F1 24 0 R /F6 23 0 R /F9 25 0 R /F2 26 0 R /F7 27 0 R >>
/ProcSet [ /PDF /ImageC /Text ] >>
endobj
9 0 obj
<<
/S /GoTo
/D [13 0 R /XYZ 85.0 659.0 null]
>>
endobj
11 0 obj
<<
/S /GoTo
/D [13 0 R /XYZ 85.0 606.666 null]
>>
endobj
18 0 obj
<<
/First 19 0 R
/Last 20 0 R
>> endobj
xref
0 28
0000000000 65535 f
0000004708 00000 n
0000004773 00000 n
0000004865 00000 n
0000000015 00000 n
0000000071 00000 n
0000000559 00000 n
0000000679 00000 n
0000000711 00000 n
0000005010 00000 n
0000000846 00000 n
0000005073 00000 n
0000000983 00000 n
0000002796 00000 n
0000002919 00000 n
0000002960 00000 n
0000003207 00000 n
0000003453 00000 n
0000005139 00000 n
0000003650 00000 n
0000003813 00000 n
0000003935 00000 n
0000004048 00000 n
0000004158 00000 n
0000004269 00000 n
0000004377 00000 n
0000004483 00000 n
0000004599 00000 n
trailer
<<
/Size 28
/Root 2 0 R
/Info 4 0 R
>>
startxref
5190
%%EOF