~~NOTOC~~
{{ :panel-plugins:xfce4-cpugraph-plugin-logo.png?48nolink|}}
====== xfce4-cpugraph-plugin - CPU Load Indicator Graph Plugin ======

This panel plugin offers multiple display modes (LED, gradient, fire, etc...) to show the current CPU load of the system. Various appearance options, like colors or size, are customizable.

On multi core or multi CPU systems, CPU Graph can either track and display all of them at once, or at the user's option only a specific core or CPU.

  * **[[#Screenshots|Screenshots]]**
  * **[[#Highlighting of suboptimal thread placements|Highlighting of suboptimal thread placements]]**
  * **[[#Latest Release|Latest Release]]**
  * **[[#Source Code Repository|Source Code Repository]]**
  * **[[#Reporting Bugs|Reporting Bugs]]**

----

===== Usage =====

  - [[:xfce:xfce4-panel:add-new-items|Add the plugin to the panel]].
  - Right-click on the added plugin, select **Properties** to open the settings window. 

===== Screenshots =====

<figure "Examples of CPU Graph Panel Display Modes">
{{:panel-plugins:cpugrah-1_0_0.png|CPU Graph Plugin: Normal Display Mode}}
{{:panel-plugins:cpugraph-fire-nobar.png|CPU Graph Plugin: Fire/No Bar Display Mode}}
{{:panel-plugins:cpugraph-grid.png|CPU Graph Plugin: Grid Display Mode}}
{{:panel-plugins:cpugraph-grid-nobar.png|CPU Graph Plugin: Grid/No Bar Display Mode}}
{{:panel-plugins:cpugraph-led-nobar.png|CPU Graph Plugin: LED/No Bar Display Mode}}
{{:panel-plugins:cpugraph-fire-long.png|CPU Graph Plugin: Fire/Long Display Mode}}
</figure>

[[|Back to Top]]

----

===== Highlighting of suboptimal thread placements =====

Starting with CPU Graph 1.2.0, it's possible to optionally highlight CPU usage bars corresponding to potentially suboptimal allocation of CPU cores to tasks on CPUs with SMT. The highlighting can be enabled via the "Highlight suboptimal SMT scheduling" checkbox.

On CPUs with SMT, CPU Graph automatically counts the number of SMT scheduling events (SMT scheduling incidents) that could have resulted in reduced performance of tasks running on the CPU. Detecting these events has a very low overhead and thus is enabled even if the "Highlight suboptimal SMT scheduling" checkbox is disabled. The number of SMT scheduling incidents and an estimate of how much they might have impacted performance is printed in the Stats tab in CPU Graph's Properties window.

In order to test this feature, run the following command-lines in a terminal window (adjusting numactl's CPU list according to your CPU topology if necessary):

<code>
$ numactl -C 0,1             perf stat stress-ng --cpu 2   # Optimal performance (IPC=1.6)
$ numactl -C 0,$[$(nproc)/2] perf stat stress-ng --cpu 2   # Suboptimal performance (IPC=1.21)
</code>

<figure "CPU Graph Properties: Advanced Tab with Highlight suboptimal SMT scheduling checkbox enabled">
{{:panel-plugins:cpugraph-smt-highlight-1.png|CPU Graph Properties: Advanced Tab with 'Highlight suboptimal SMT scheduling' checkbox enabled}}
</figure> 

<figure "CPU Graph Properties: Stats View Tab">
{{:panel-plugins:cpugraph-smt-highlight-2.png|CPU Graph Properties: Stats View Tab}}
</figure>

[[|Back to Top]]

----

===== Latest Release =====

{{rss>https://archive.xfce.org/feeds/project/xfce4-cpugraph-plugin 1 date 2h}}

[[https://gitlab.xfce.org/panel-plugins/xfce4-cpugraph-plugin/-/blob/master/NEWS|Read the CHANGELOG]]

  * **[[https://archive.xfce.org/src/panel-plugins/xfce4-cpugraph-plugin/|Download current release]]** (older versions of this component are also available here)

[[|Back to Top]]

----

===== Source code repository =====

[[https://gitlab.xfce.org/panel-plugins/xfce4-cpugraph-plugin]]

----

===== Reporting Bugs =====

  * **[[:panel-plugins:xfce4-cpugraph-plugin:bugs|Reporting Bugs]]** -- List of currently open bugs and instructions on how to submit new bug reports
[[|Back To Top]]

----
[[ :xfce:xfce4-panel:start:|Return to xfce4-panel Main Documentation Page]]