Sysmon is a C/S mode system monitor for Linux distribution. With server side daemon, you can remotely watch usage of your system resources via web browser or clients.
The server side supports common architecture and distribution. In addition to the browser, we also provide client applications for many system such as android/ios/windows/linux/mac os.
The server is a daemon service, you can access it via IP:PORT by browser or clients.
The following are the systems that have been tested. In addition, sysmon should be able to run on most distribution:
The prebuilt package includes the following architecture:
The basic step is to download/compile the application installation package sysmon-server-$arch-$version.tar.xz. Unzip it into any directory, go to the extracted directory, execute sysmon, and then access the running service via browser.
Downloading sysmon-server-$arch-$version.tar.xz to your server and then unpack it and run sysmon
tar Jxvf sysmon-server-$arch-$version.tar.xz cd sysmon sudo nohup ./sysmon &
After running, access the service by accessing localhost:2048 via a browser.
Note: You need to manually re-execute the sysmon after restarting the system. If you want to start sysmon when booting, please check start onboot section.
Note: The container version is not ready yet, the following steps is just for testing.
Once you get container version of sysmon, run it by this way:
sudo docker run --name sysmon --restart=always -d -p 4096:2048 -v /proc:/hproc --privileged -it sysmon
After running，access the service by accessing localhost:4096 via a browser.
The sysmon server support upstart/systemd framworks to start onboot.If you want to start sysmon on boot, please run install.sh scripts in the extracted directory.
The server side of sysmon is based on beego framework，you can edit conf/app.conf to enable https (CertFile and KeyFile is your own cert and key)：
EnableHTTPS = true HTTPSPort = 2049 HTTPSCertFile = xxx.cert HTTPSKeyFile = xxx.key
For more details： https://beego.me/docs/mvc/controller/config.md
sysmon depends on procfs to get system info and default path of procfs is /proc. If your procfs path is not /proc, you can configure your procfs path in conf/app.conf:
procfs = /myProcPath
sudo apt-get install musl-tools
Once the development environment is ready, run command in the project's directory.
bee run -gendoc=true
You can access the backend API by visiting localhost:2048/swagger.
If you want to debug the front end, you need to start front-end service by referring to the following instructions, and then access localhost:2047 for debugging through the browser.
See README.md in web directory.
Firstly you need to setup a develop environment for sysmon.
For the first build, you need to go to the web directory and execute
npm run install
And then run command in the repository code directory:
This command will generate Native Application sysmon-server-$arch-$version.tar.gz.
We can only build all supported arch on x64 server, and you need to install musl-tools and docker before building:
It will generate built package in current directory.
Note: It build amd64/i386/arm64/mips64 by local go compiler, but build arm/mips by docker image lightimehpq/golang-386
Run command in the root path of repository:
mv sysmon-xxx.tar.xz sysmon-latest.tar.xz sudo ./build-docker-image.sh
This command require docker and alpine:3.7 image. It will generate a docker image sysmon:latest.
check client/mobile/README.md for details.
check client/desktop/README.md for details.