polygraph-lx --objects

[Dmitry Kurochkin]

Hi Dane.

On Wed, 30 Mar 2011 21:33:04 +0100, Dane Elwell <dane.elwell at gmail.com> wrote:
> Hello,
> 
> I'm rather embarrassed to be asking this question, but my Google-fu
> has reached its limit.
> 
> Is there a list of the objects I am able to extract with the --objects
> command line option, along with a description of that object,
> available anywhere?
> 

To get the list of supported objects run lx with no --objects option.
You get a lengthy output that contains all available objects.
E.g. FTP-related objects:

  ftp.rptm.count:  	 0
  ftp.active.rptm.sum:    	 0.00
  ...
  ftp.size.count:  	 0
  ...
  ftp.active.rptm.count:  	 0
  ...

Now you can limit the lx output to FTP-related objects only using
"--objects ftp". Or further limit it to active FTP transactions with
"--objects ftp.active" or to active FTP transactions size stats with
"--objects ftp.active.size". And so on.

As for the description of each object, I am afraid it is not
documented. There is outdated documentation about lx output [1] and
options [2]. But it is of limited usage now.

> It seems I am unable to decipher the meaning of 'rep.rptm.mean',
> amongst others. I cannot find a description of these objects anywhere.
> 

Rptm is response time stats. Most important rptm.* values are:

rptm.count - number of messages
rptm.min/max/mean - min/max/mean response time
rptm.sum - sum of all response times

Many rptm stats also have a histogram.

Another common stats object is *.size.*. It collects information about
size of particular messages. It has same count, min/max/mean and sum
stats as rptm.

Polygraph collects stats for many different kind of transactions. The
'rep.' category is the most general one and collects stats for all
replies. So 'rep.rptm.mean' is the mean response time for all
transactions. There are many more transaction categories, e.g. basic.*
(basic transactions), head.* (HTTP HEAD transactions), ssl.* (HTTPS
transactions).

Note that lx output is intended mostly for automated processing and
quick checks by humans. Consider using the reporter tool for generating
a human-friendly test report.

Regards,
  Dmitry

[1] http://polygraph.ircache.net/doc/lxoutput.html
[2] http://polygraph.ircache.net/doc/lxopts.html

> Thanks
> 
> Dane
> _______________________________________________
> Users mailing list
> Users at web-polygraph.org
> http://www.web-polygraph.org/mailman/listinfo/users