Lightweight Linux System Monitoring Library

Features:

The library consists of STL and c++17 only! no thirdparty library is used (except for the websocket example and Unittests).

CPU Usage:
- total CPU Usage
- CPU Usage per Core
- CPU Information
Network Interface load:
- Bytes/Bits per Second - per Network Device
- Total Received or Transmitted Bytes - per Network Device
Memory Usage:
- System Memory Usage
- Total Memory
- Memory Usage per Process
Linux Utils and Features:
- is remote Device Online - (parse Ping response)
- getPID by Process Name
- getOSVersion
- SysUptime
- Number of Threads used by PID
- start Application as Daemon

How to build:

Clone the project: git clone git@github.com:fuxey/Lightweight_LinuxSystemMonitor.git

build the library:

mkdir build
cd build
cmake ..
cmake --build . --target linuxmonitoring

find the library in the folder lib of the build folder

build simple linux load monitor (No thirdparty dependencies):

mkdir build
cd build
cmake ..
cmake --build . --target simple_linuxsystemMonitor

find the executable in the folder bin of the build folder

build linuxsystem websocket service (thirdparty dependencies needed):

git submodule update --init --recursive
mkdir build
cd build
cmake ..
cmake --build . --target linuxsystemMonitor

find the executable in the folder bin of the build folder

Examples:

Monitoring Websocket Server:

This app starts a websocket Server which offers the linuxsystem monitor values as a Json object.

Monitoring Data are presented in JSON:

therefore the most popular C++ JSON lib is used + the very cool Json to C++ code generator tool.

{
  "Linuxsystemmonitoring": {
    "linuxethernet": [
      {
        "iFace": "eth0",
        "BitsRXSecond": "undef",
        "BytesRXSecond": "89Byte/s",
        "BytesRXTotal": 92824691,
        "BytesTXSecond": "22Byte/s",
        "BytesTXTotal": 5783311275,
        "BytesTotal": 5876135966,
        "BytesTotalPerSecond": "97Byte/s"
      }
    ],
    "MemoryUsage:": {
      "MemoryUsage_KIB": 11195216,
      "MemoryUsage_perc": 34.0,
      "MemoryUsage_totalKIB": 32893064,
      "MemoryUsage_of_process:": 349822
    },
    "CPU": {
      "CPUUsage": 7.99,
      "CPU_Type": "Intel I7",
      "num_of_cores": 12,
      "MultiCore": [
        "CPU0:4.85%",
        "CPU1:7.77%",
        "CPU2:11.76%",
        "CPU3:9.52%",
        "CPU4:4.04%",
        "CPU5:1.98%",
        "CPU6:6.86%",
        "CPU7:4.90%",
        "CPU8:15.69%",
        "CPU9:5.05%",
        "CPU10:17.48%",
        "CPU11:7.92%",
        "CPU12:9.90%",
        "CPU13:9.52%",
        "CPU14:7.92%",
        "CPU15:9.71%"
      ],
      "MultiUsage": [
        4.85,
        7.77,
        11.76,
        9.52,
        4.04,
        1.98,
        6.86,
        4.9,
        15.69,
        5.05,
        17.48,
        7.92,
        9.9,
        9.52,
        7.92,
        9.71
      ]
    },
    "system": {
      "SysUptime": 37008,
      "SysUptime_days": 0,
      "SysUptime_hours": 10,
      "SysUptime_min": 16,
      "SysUptime_sec": 48
    }
  },
  "type": "system"
}

for detailed Information

Simple Monitor:

Main aim of this example, is to show how to interact with the library. The app loops through the results of linux monitor lib and prints out memory load, cpu load, network load as the following print shows :

example print:

----------------------------------------------
current CPULoad:5.09119
average CPULoad 10.0671
Max     CPULoad 10.0822
Min     CPULoad 1.74111
CPU: : Intel(R) Core(TM) i7-10750H CPU @ 2.60GHz
----------------------------------------------
network load: wlp0s20f3 : 1.9kBit/s : 920Bit/s : 1.0kBit/s :  RX Bytes Startup: 15.8mByte TX Bytes Startup: 833.5mByte
----------------------------------------------
memory load: 28.4% maxmemory: 16133792 Kb used: 4581564 Kb  Memload of this Process 170408 KB
----------------------------------------------

for detailed Information

Todo:

CPU Usage per Process
example -> monitoring and creating graph with grafana
Testing: more Catch2 tests
Data Export in ~~JSON~~, BSON, MSGPack, XML
Documentation
~~logging and average of 30min, 2h, 6h, 24h , 2d, 7d.~~ -> record value
~~ethernetparser optimization~~
~~memoryparser optimization~~

Get in Contact:

If there are any Bugs or Requests for extensions or features, feel free to email me 🇦🇹 .

antgr / Linux-System-Monitoring-Library