summaryrefslogtreecommitdiffstats
path: root/documentation/sensor_monitoring.html
blob: 13e68968922f7e64464e214ef7f5a5ad188b8e20 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<Title>Phoronix Test Suite - System Sensor Monitoring</Title>
<link href="includes/pts-documentation.css" rel="stylesheet" type="text/css" />
</head>
<body>
<div id="pts_doc_header"><div class="pts_doc_fixed"><a href="http://www.phoronix-test-suite.com/"><div id="pts_doc_logo"></div></a></div></div>
<div class="pts_doc_fixed">
<div class="pts_doc_notice"><div style="float: left"><a href="index.html">&lt;&lt; Documentation Home</a></div><div style="float: right;">System Sensor Monitoring</div></div>
<div class="pts_doc_main">
<!-- PTS AREA -->
<h1>System Sensor Monitoring</h1>
<p>The Phoronix Test Suite supports monitoring system sensors to look at trends 
and provide other benefits. The Phoronix Test Suite will automatically monitor 
the selected sensors while each test is running and at the end will then provide 
the low and high thresholds for each sensor as well as the average. In addition, 
the sensor results are then plotted on line graphs and can be viewed through the 
PTS Results Viewer. This sensor detection and monitoring is done through <a href="http://www.lm-sensors.org/">LM_Sensors</a> 
and ACPI interfaces. The GPU sensor monitoring is done through proprietary ATI 
and NVIDIA extensions.</p>
<p>The Phoronix Test Suite is capable of measuring the GPU temperature, CPU temperature, 
system temperature, battery power consumption, CPU voltage, +3.33V line voltage, 
+5.00V line voltage, and +12.00V line voltage. Additional sensors will be supported 
in the future.</p>
<p>The full list of supported sensor options can be found by running <em>phoronix-test-suite 
module-info system_monitor</em>. The sensors actually detected on the current system and their 
values can be read by running <em>MONITOR=all phoronix-test-suite test-module system_monitor</em>. Selecting 
sensors to monitor is performed through the <em>MONITOR</em> environmental variable. 
As examples, to monitor just the CPU temperature while running the universe suite, 
one would run <em>MONITOR=cpu.temp phoronix-test-suite benchmark universe</em>. 
To monitor all sensors while running the Nexuiz game, one would run <em>MONITOR=all 
phoronix-test-suite benchmark nexuiz</em>. To monitor the temperature and voltage 
of the CPU, run <em>MONITOR=cpu.temp,cpu.voltage phoronix-test-suite benchmark 
universe</em>. This feature works no matter the suite or test being run.</p>
<p>ACPI will automatically be used if it's supported on the system and LM_Sensors 
will be used if it has previously been installed and configured (by running <em>sensors-detect</em> 
as root).</p>
<p>Once the test(s) are completed, the sensor statistics are printed to the standard 
output and the user is prompted to view the results with the PTS Results Viewer 
in their web browser. The sensor graphs are saved to their default location of 
<em>~/.phoronix-test-suite/system-monitor/</em>. At this time, sensor results 
cannot be uploaded to Phoronix Global.</p>
<!-- END OF PTS AREA -->
</div></div><div class="pts_doc_fixed"><div class="pts_doc_bottom"><div style="float: left;"><a href="http://www.phoronix-test-suite.com/">Phoronix-Test-Suite.com</a></div><div style="float: right;">Copyright &copy; 2008 by <a href="http://www.phoronixmedia.com/">Phoronix Media</a>.</div></div></div>
</body>
</html>