Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
projects:panel-plugins:xfce4-hardware-monitor-plugin [2018/01/14 18:39] – [Network Tab] omegaphil | projects:panel-plugins:xfce4-hardware-monitor-plugin [2019/10/30 20:23] (current) – omegaphil | ||
---|---|---|---|
Line 1: | Line 1: | ||
+ | <note warning> | ||
+ | |||
====== Features And Basic Details ====== | ====== Features And Basic Details ====== | ||
This plugin is a port of the venerable GNOME 2 Hardware Monitor to XFCE4 (originally written by Ole Laursen), so that I could get at a network bandwidth graph. It can display various system stats (CPU, filesystem and network usage among others) in graphs, visualisations or with text. | This plugin is a port of the venerable GNOME 2 Hardware Monitor to XFCE4 (originally written by Ole Laursen), so that I could get at a network bandwidth graph. It can display various system stats (CPU, filesystem and network usage among others) in graphs, visualisations or with text. | ||
- | [[https:// | + | [[https:// |
- | [[https:// | + | [[https:// |
- | [[https:// | + | [[https:// |
- | [[https:// | + | [[https:// |
**Officially packaged in distros** (note my own Debian packages above, email me (OmegaPhil@startmail.com) if you know of more): Arch, Fedora | **Officially packaged in distros** (note my own Debian packages above, email me (OmegaPhil@startmail.com) if you know of more): Arch, Fedora | ||
Line 15: | Line 17: | ||
**3rd party packages:** | **3rd party packages:** | ||
CentOS7 (courtesy of Sal Tepedino): | CentOS7 (courtesy of Sal Tepedino): | ||
- | [[https:// | + | [[http:// |
For those interested, here are build instructions from Sal: | For those interested, here are build instructions from Sal: | ||
Line 24: | Line 26: | ||
(and of course make/make install)' | (and of course make/make install)' | ||
- | **[[https:// | + | **[[https:// |
<note important> | <note important> | ||
Line 86: | Line 88: | ||
{{ : | {{ : | ||
- | __**CPU Usage**__ | + | === CPU Usage === |
Here you see the System tab, showing the default 'All CPUs' CPU usage monitor to add. You can also pick an individual CPU here, then add more and more ' | Here you see the System tab, showing the default 'All CPUs' CPU usage monitor to add. You can also pick an individual CPU here, then add more and more ' | ||
Line 100: | Line 102: | ||
' | ' | ||
- | __**Load Average**__ | + | === Load Average |
Load average is the current [[https:// | Load average is the current [[https:// | ||
Line 111: | Line 113: | ||
{{ : | {{ : | ||
- | __**Disk Usage**__ | + | === Disk Usage === |
With the Disk usage monitor, paste/type the path of a directory on the filesystem you want to see the used space for, using the 'Show free space' checkbox to report on free space instead. | With the Disk usage monitor, paste/type the path of a directory on the filesystem you want to see the used space for, using the 'Show free space' checkbox to report on free space instead. | ||
Line 117: | Line 119: | ||
For a general discussion of the Advanced section, please see the CPU Usage monitor above. For this monitor, 'fixed max' only refers to time-based visualisations (Curves, Columns etc), for others the size of the relevant volume is always used. | For a general discussion of the Advanced section, please see the CPU Usage monitor above. For this monitor, 'fixed max' only refers to time-based visualisations (Curves, Columns etc), for others the size of the relevant volume is always used. | ||
- | __**Disk Statistics**__ | + | === Disk Statistics |
{{ : | {{ : | ||
Line 127: | Line 129: | ||
For a general discussion of the Advanced section, please see the CPU Usage monitor above. For this monitor, without a fixed max, in time-based visualisations (Curves, Columns etc) the displayed data max is used as the max, in other visualisations (e.g. Bars) the max value the monitor has observed since it has started is stored and slowly decays over time (10% reduction over 105 measurements according to an old comment). | For a general discussion of the Advanced section, please see the CPU Usage monitor above. For this monitor, without a fixed max, in time-based visualisations (Curves, Columns etc) the displayed data max is used as the max, in other visualisations (e.g. Bars) the max value the monitor has observed since it has started is stored and slowly decays over time (10% reduction over 105 measurements according to an old comment). | ||
- | __**Swap Usage**__ | + | === Swap Usage === |
Swap usage reports on the amount of [[https:// | Swap usage reports on the amount of [[https:// | ||
Line 133: | Line 135: | ||
For a general discussion of the Advanced section, please see the CPU Usage monitor above. For this monitor, 'fixed max' only refers to time-based visualisations (Curves, Columns etc), for others the size of total available swap is always used. | For a general discussion of the Advanced section, please see the CPU Usage monitor above. For this monitor, 'fixed max' only refers to time-based visualisations (Curves, Columns etc), for others the size of total available swap is always used. | ||
- | __**Memory Usage**__ | + | === Memory Usage === |
Memory usage reports on the amount of RAM used (minus buffers). | Memory usage reports on the amount of RAM used (minus buffers). | ||
Line 171: | Line 173: | ||
{{ : | {{ : | ||
- | The Generic Monitor is an advanced monitor to allow power users to effectively visualise/ | + | The Generic Monitor is an advanced monitor to allow power users to effectively visualise/ |
Keep in mind that: | Keep in mind that: | ||
Line 177: | Line 179: | ||
* The visualisation/ | * The visualisation/ | ||
* Positive axes available only | * Positive axes available only | ||
- | * The y axis is a complete scale - so plotting very large numbers that change little will be a bit pointless as the line will be stuck at the top of the graphing area and will apparently not change | + | * The y axis is a complete scale (aside from the 'fixed max at' setting near the bottom) |
If enough people are interested, I can extend how the values are processed (e.g. values passed through a basic calculation like '* 10', '/ 1000' etc) to make it a bit more flexible, please make a [[https:// | If enough people are interested, I can extend how the values are processed (e.g. values passed through a basic calculation like '* 10', '/ 1000' etc) to make it a bit more flexible, please make a [[https:// | ||
Line 183: | Line 185: | ||
For basic usage, you would specify a file which contains a single line with just a number (including the the usual newline at the end) - this is ' | For basic usage, you would specify a file which contains a single line with just a number (including the the usual newline at the end) - this is ' | ||
- | When the source file isn't tailored for the monitor, superfluous text will be present, so you'll need to use a regex to extract the number with a capture group ([[http:// | + | When the source file isn't tailored for the monitor, superfluous text will be present, so you'll need to use a regex to extract the number with a capture group ([[https:// |
Select the ' | Select the ' | ||
Line 209: | Line 211: | ||
'Data source name (long)' | 'Data source name (long)' | ||
- | Units are optional and are appended to the reported value in the usual places, and the Tag works as described for earlier monitors. | + | Units are optional and are appended to the reported value in the usual places. |
+ | For a general discussion of the remaining advanced settings, please see the CPU Usage monitor above. For this monitor, without a fixed max, in time-based visualisations (Curves, Columns etc) the displayed data max is used as the max, in other visualisations (e.g. Bars) the max value the monitor has observed since it has started is stored and slowly decays over time (10% reduction over 105 measurements according to an old comment). | ||
===== Changing A Monitor ===== | ===== Changing A Monitor ===== | ||
Line 223: | Line 226: | ||
==== Curve View ==== | ==== Curve View ==== | ||
- | The following shows an example of the most featureful visualisation (as of v1.4.7), | + | The following shows an example of the Curve view (selected under Viewer): |
{{: | {{: | ||
Line 230: | Line 233: | ||
The example displays two curves, incoming and outgoing data on my main ethernet interface, along with a text overlay reporting the graph maximum and the actual values from the monitors. | The example displays two curves, incoming and outgoing data on my main ethernet interface, along with a text overlay reporting the graph maximum and the actual values from the monitors. | ||
- | The curve visualisation/ | + | The curve visualisation/ |
+ | |||
+ | **One monitor with fixed max:** | ||
+ | Scale is fixed with the top of the view representing the monitor' | ||
+ | |||
+ | **One monitor with non-fixed max:** | ||
+ | Scale changes | ||
+ | |||
+ | By default ' | ||
+ | |||
+ | If you would rather all monitors share the same scale (even if the units are incompatible), | ||
+ | |||
+ | **Note user-customisable monitor update rates** in the Advanced sections of individual monitor configuration - by default different monitor types update once a second, 10 seconds, 20, 1 minute etc - but can be configured to update at any rate (fastest is 1 second), which **can be used to keep monitors of different types in sync**, or include ' | ||
The size control allows you to shorten or lengthen the width of the visualisation. | The size control allows you to shorten or lengthen the width of the visualisation. | ||
Line 241: | Line 256: | ||
%a: Graph max (compact - no spaces, shorter units)'' | %a: Graph max (compact - no spaces, shorter units)'' | ||
- | The idea is to include | + | If the visualisation contains |
+ | |||
+ | In individual monitor Advanced configuration, | ||
It isn't obvious, but the configured monitor value separator is a single space - in the full mode, this string is used to separate values from tags, and between separate monitor outputs, and in the compact mode tags are right up against values so it just affects the output between monitors. | It isn't obvious, but the configured monitor value separator is a single space - in the full mode, this string is used to separate values from tags, and between separate monitor outputs, and in the compact mode tags are right up against values so it just affects the output between monitors. | ||
Line 251: | Line 268: | ||
{{ : | {{ : | ||
- | I use the ' | + | The example uses the ' |
==== Horizontal Bars View ==== | ==== Horizontal Bars View ==== | ||
{{ : | {{ : | ||
- | The only thing configurable here is the visualisation size (width) - works the same as before. | + | Configuration |
==== Flames View ==== | ==== Flames View ==== | ||
Line 263: | Line 279: | ||
{{ : | {{ : | ||
+ | Configuration works in the same way as the Curve View. | ||
==== Columns View ==== | ==== Columns View ==== | ||
{{ : | {{ : | ||
+ | Configuration works in the same way as the Curve View. | ||
==== Vertical Bars View ==== | ==== Vertical Bars View ==== | ||
{{ : | {{ : | ||
+ | Configuration works in the same way as the Curve View. | ||
==== Text View ==== | ==== Text View ==== | ||
{{ : | {{ : | ||
- | In this view you can configure the font via a GTK font picker in the usual manner. | + | In this view you can configure the font via a GTK font picker in the usual manner, see Curve View for discussion of the Advanced section. |
===== Background ===== | ===== Background ===== | ||
Line 287: | Line 306: | ||
====== Screenshots ====== | ====== Screenshots ====== | ||
- | The following is reproduced from the [[http:// | + | The following is reproduced from the [[https:// |
A screenshot of all views monitoring CPU and network usage: | A screenshot of all views monitoring CPU and network usage: |