Documentation/devtools/maemo5/sp-endurance-postproc - Revision history

amigadave: devtools template

amigadave — Thu, 11 Mar 2010 15:18:54 GMT

devtools template

← Older revision		Revision as of 15:18, 11 March 2010
Line 1:		Line 1:
		+	{{Devtools}}
		+
		+
	== Description ==		== Description ==

Line 67:		Line 70:
	[[Documentation/devtools/maemo5/sp-endurance\|sp-endurance]], [[Documentation/devtools/maemo5/syslog\|syslog]]		[[Documentation/devtools/maemo5/sp-endurance\|sp-endurance]], [[Documentation/devtools/maemo5/syslog\|syslog]]

-	~~[[Category:Devtools]]~~
	[[Category:Fremantle]]		[[Category:Fremantle]]

amigadave: Category:Devtools and Category:Fremantle

amigadave — Fri, 12 Feb 2010 11:19:51 GMT

Category:Devtools and Category:Fremantle

← Older revision		Revision as of 11:19, 12 February 2010
Line 66:		Line 66:

	[[Documentation/devtools/maemo5/sp-endurance\|sp-endurance]], [[Documentation/devtools/maemo5/syslog\|syslog]]		[[Documentation/devtools/maemo5/sp-endurance\|sp-endurance]], [[Documentation/devtools/maemo5/syslog\|syslog]]
		+
		+	[[Category:Devtools]]
		+	[[Category:Fremantle]]

kaltsi: /* Usage Examples */

kaltsi — Wed, 07 Oct 2009 08:41:25 GMT

Usage Examples

← Older revision		Revision as of 08:41, 7 October 2009
Line 22:		Line 22:

	<pre>		<pre>
-	# apt-get install sp-endurance-postproc	+	# fakeroot apt-get install sp-endurance-postproc
	# parse-endurance-measurements test-case-name/[0-9]*		# parse-endurance-measurements test-case-name/[0-9]*
	</pre>		</pre>

kaltsi: /* Usage Examples */

kaltsi — Thu, 01 Oct 2009 06:50:14 GMT

Usage Examples

← Older revision		Revision as of 06:50, 1 October 2009
Line 19:		Line 19:
	== Usage Examples ==		== Usage Examples ==

-	Once you've transferred the endurance data saved by [sp-endurance] to a PC, you can post-process it with the following:	+	Once you've transferred the endurance data saved by [[Documentation/devtools/maemo5/sp-endurance\|sp-endurance]] to a PC, you can post-process it with the following:

	<pre>		<pre>

kaltsi: New page: == Description == ''sp-endurance-postproc'' provides post-processing tools for producing report(s) from the data collected by sp-endurance. ...

kaltsi — Thu, 01 Oct 2009 06:48:50 GMT

New page: == Description == ''sp-endurance-postproc'' provides post-processing tools for producing report(s) from the data collected by sp-endurance. ...

New page

== Description ==

''sp-endurance-postproc'' provides post-processing tools for producing report(s) from the data collected by [[Documentation/devtools/maemo5/sp-endurance|sp-endurance]].

These include:

* a script for producing an overview HTML report of the collected endurance data

* a script for splitting the data into several reports (in case of reboots during automated testing)

* a script for for parsing errors and other significant events from syslogs

== Packages ==

'''source''': sp-endurance

'''binary''': sp-endurance-postproc

== Usage Examples ==

Once you've transferred the endurance data saved by [sp-endurance] to a PC, you can post-process it with the following:

<pre>
# apt-get install sp-endurance-postproc
# parse-endurance-measurements test-case-name/[0-9]*
</pre>

This will produce you a nice (single file) HTML report which you can send in E-mail, attach to Bugzilla etc.

The report lists first the information about the system's intial state (first measurement data), then the system's memory usage change overview, more detailed memory usage of each process whose memory usage changed and last details about all resource usage changes and (recognized) syslogged errors between each of the measurements. Finally there's a summary of the differences between the second and the last measurement.

If you want to get a similar report for a subset of these measurements (e.g. because there was a reboot between them or to see the leaks
better you want to skip some of them), the script offers several options for that too.

=== Other platforms ===

If you want to do the post-processing on platforms like Windows which may have Python, but not Bash, you can call this directly:

<pre>
# endurance_report.py test-case-name/[0-9]* > report.html
</pre>

=== Syslog parsing ===

As a part of endurance data processing the saved syslogs are parsed for errors and other significant events, but you can do that also directly with:

<pre>
# syslog_parse.py syslog.gz
</pre>

The syslog file can be compressed and you can get the lists either in ASCII (default) or in HTML.

== Links ==

Man pages:

[endurance_report.py](/development/documentation/man_pages/endurance_report_py.html)

[parse-endurance-measurements](/development/documentation/man_pages/parse-endurance-measurements.html)

[split-endurance-measurements](/development/documentation/man_pages/split-endurance-measurements.html)

[syslog_parse.py](/development/documentation/man_pages/syslog_parse_py.html)

== See Also ==

[[Documentation/devtools/maemo5/sp-endurance|sp-endurance]], [[Documentation/devtools/maemo5/syslog|syslog]]