<html xmlns:v="urn:schemas-microsoft-com:vml" xmlns:o="urn:schemas-microsoft-com:office:office" xmlns:w="urn:schemas-microsoft-com:office:word" xmlns:m="http://schemas.microsoft.com/office/2004/12/omml" xmlns="http://www.w3.org/TR/REC-html40">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
<meta name="Generator" content="Microsoft Word 15 (filtered medium)">
<!--[if !mso]><style>v\:* {behavior:url(#default#VML);}
o\:* {behavior:url(#default#VML);}
w\:* {behavior:url(#default#VML);}
.shape {behavior:url(#default#VML);}
</style><![endif]--><style><!--
/* Font Definitions */
@font-face
{font-family:"Cambria Math";
panose-1:2 4 5 3 5 4 6 3 2 4;}
@font-face
{font-family:Calibri;
panose-1:2 15 5 2 2 2 4 3 2 4;}
/* Style Definitions */
p.MsoNormal, li.MsoNormal, div.MsoNormal
{margin:0cm;
margin-bottom:.0001pt;
font-size:11.0pt;
font-family:"Calibri","sans-serif";
mso-fareast-language:EN-US;}
a:link, span.MsoHyperlink
{mso-style-priority:99;
color:#0563C1;
text-decoration:underline;}
a:visited, span.MsoHyperlinkFollowed
{mso-style-priority:99;
color:#954F72;
text-decoration:underline;}
span.EmailStyle17
{mso-style-type:personal-compose;
font-family:"Calibri","sans-serif";
color:windowtext;}
.MsoChpDefault
{mso-style-type:export-only;
font-family:"Calibri","sans-serif";
mso-fareast-language:EN-US;}
@page WordSection1
{size:612.0pt 792.0pt;
margin:72.0pt 72.0pt 72.0pt 72.0pt;}
div.WordSection1
{page:WordSection1;}
--></style><!--[if gte mso 9]><xml>
<o:shapedefaults v:ext="edit" spidmax="1026" />
</xml><![endif]--><!--[if gte mso 9]><xml>
<o:shapelayout v:ext="edit">
<o:idmap v:ext="edit" data="1" />
</o:shapelayout></xml><![endif]-->
</head>
<body lang="EN-GB" link="#0563C1" vlink="#954F72">
<div class="WordSection1">
<p class="MsoNormal">I’m trying to find the ceilometer CLI docs which would explain the various options for the options on the statistics subcommand. The help on the CLI is not very verbose.<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">The key[op]value parameters for the –query do not seem to be documented anywhere I could find.<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">Reverse engineering shows that you can have –q project=<projecteid> and –q resource=<resourceid> along with lots of other start/stop etc. parameters.<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">Is there a place where this is documented ? If not, which guide should have this in ? I also think the code should report better than key[op]value, at minimum giving some of the keys and the format of the value.<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">OK to start raising bugs/patches/reviews but I want to check I’ve not missed something.<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">Tim<o:p></o:p></p>
<p class="MsoNormal">-------<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">$ ceilometer help statistics<o:p></o:p></p>
<p class="MsoNormal">usage: ceilometer statistics [-q <QUERY>] -m <NAME> [-p <PERIOD>]<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">List the statistics for this meter.<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">Optional arguments:<o:p></o:p></p>
<p class="MsoNormal"> -q <QUERY>, --query <QUERY><o:p></o:p></p>
<p class="MsoNormal"> key[op]value; list.<o:p></o:p></p>
<p class="MsoNormal"> -m <NAME>, --meter <NAME><o:p></o:p></p>
<p class="MsoNormal"> Name of meter to show samples for. Required.<o:p></o:p></p>
<p class="MsoNormal"> -p <PERIOD>, --period <PERIOD><o:p></o:p></p>
<p class="MsoNormal"> Period in seconds over which to group samples.<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">ceilometer --debug statistics -m cpu_util -q marvin=android<o:p></o:p></p>
<p class="MsoNormal">INFO (connectionpool:535) Starting new HTTPS connection (1): openstack.cern.ch<o:p></o:p></p>
<p class="MsoNormal">DEBUG (connectionpool:295) "POST /v2.0/tokens HTTP/1.1" 200 2546<o:p></o:p></p>
<p class="MsoNormal">DEBUG (iso8601:166) Parsed 2014-01-23T19:19:18Z into {'tz_sign': None, 'second_fraction': None, 'hour': u'19', 'tz_hour': None, 'month': u'01', 'timezone': u'Z', 'second': u'18', 'tz_minute': None, 'year': u'2014', 'separator': u'T', 'day':
u'23', 'minute': u'19'} with default timezone <iso8601.iso8601.Utc object at 0x1a3b750><o:p></o:p></p>
<p class="MsoNormal">DEBUG (iso8601:124) Got u'2014' for 'year' with default None<o:p></o:p></p>
<p class="MsoNormal">DEBUG (iso8601:124) Got u'01' for 'month' with default None<o:p></o:p></p>
<p class="MsoNormal">DEBUG (iso8601:124) Got u'23' for 'day' with default None<o:p></o:p></p>
<p class="MsoNormal">DEBUG (iso8601:124) Got u'19' for 'hour' with default None<o:p></o:p></p>
<p class="MsoNormal">DEBUG (iso8601:124) Got u'19' for 'minute' with default None<o:p></o:p></p>
<p class="MsoNormal">DEBUG (iso8601:124) Got u'18' for 'second' with default None<o:p></o:p></p>
<p class="MsoNormal">DEBUG (http:111) curl -i -X GET -H 'X-Auth-Token: 990c37d74d2244f79b95104682766bdf' -H 'Content-Type: application/json' -H 'Accept: application/json' -H 'User-Agent: python-ceilometerclient' http://openstack.cern.ch:8777/v2/meters/cpu_util/statistics?q.field=marvin&q.op=eq&q.value=android<o:p></o:p></p>
<p class="MsoNormal">DEBUG (http:121)<o:p></o:p></p>
<p class="MsoNormal">HTTP/1.0 400 Bad Request<o:p></o:p></p>
<p class="MsoNormal">date: Wed, 22 Jan 2014 19:19:18 GMT<o:p></o:p></p>
<p class="MsoNormal">content-length: 318<o:p></o:p></p>
<p class="MsoNormal">content-type: application/json<o:p></o:p></p>
<p class="MsoNormal">connection: keep-alive<o:p></o:p></p>
<p class="MsoNormal">server: WSGIServer/0.1 Python/2.6.6<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">{"error_message": {"debuginfo": null, "faultcode": "Client", "faultstring": "Unknown argument: \"marvin\": unrecognized field in query: [<Query u'marvin' eq u'android' Unset>], valid keys: set(['end', 'start', 'metaquery', 'meter', 'project',
'source', 'user', 'start_timestamp_op', 'resource', 'end_timestamp_op'])"}}<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">WARNING (http:172) Request returned failure status.<o:p></o:p></p>
<p class="MsoNormal">HTTPBadRequest (HTTP 400)<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">From this, the eventual syntax needed seems to be<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">ceilometer statistics -m cpu_util -q resource=0e171bd4-d006-4411-b152-a45161190e47<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">Tim<o:p></o:p></p>
<p class="MsoNormal" style="margin-bottom:8.0pt;line-height:106%"><span lang="EN-US" style="font-size:10.0pt;line-height:106%;font-family:"Arial","sans-serif";mso-fareast-language:EN-GB">--<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:10.0pt;font-family:"Arial","sans-serif";mso-fareast-language:EN-GB"><img width="250" height="150" id="Picture_x0020_1" src="cid:image001.png@01CF17AD.C0BD5B90"></span><o:p></o:p></p>
</div>
</body>
</html>