{"id":16118176,"url":"https://github.com/aandergr/serverstat-linux","last_synced_at":"2025-09-14T05:08:45.738Z","repository":{"id":216168536,"uuid":"51400594","full_name":"aandergr/serverstat-linux","owner":"aandergr","description":"Collect and Plot Linux System Usage Statistics using RRDtool.","archived":false,"fork":false,"pushed_at":"2018-09-23T14:27:33.000Z","size":23,"stargazers_count":17,"open_issues_count":0,"forks_count":1,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-04-02T15:04:42.044Z","etag":null,"topics":["cgi","cgi-script","lightweight","linux","monitoring","rrd","rrdtool","server-monitoring","statistics","stats","system-monitor","system-monitoring","usage"],"latest_commit_sha":null,"homepage":"","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/aandergr.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2016-02-09T21:18:08.000Z","updated_at":"2024-12-08T16:43:06.000Z","dependencies_parsed_at":null,"dependency_job_id":"e43bc40c-26c5-49f0-8131-f08c63b7040b","html_url":"https://github.com/aandergr/serverstat-linux","commit_stats":null,"previous_names":["aandergr/serverstat-linux"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/aandergr/serverstat-linux","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aandergr%2Fserverstat-linux","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aandergr%2Fserverstat-linux/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aandergr%2Fserverstat-linux/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aandergr%2Fserverstat-linux/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aandergr","download_url":"https://codeload.github.com/aandergr/serverstat-linux/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aandergr%2Fserverstat-linux/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":275062966,"owners_count":25398888,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-14T02:00:10.474Z","response_time":75,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cgi","cgi-script","lightweight","linux","monitoring","rrd","rrdtool","server-monitoring","statistics","stats","system-monitor","system-monitoring","usage"],"created_at":"2024-10-09T20:48:51.035Z","updated_at":"2025-09-14T05:08:45.715Z","avatar_url":"https://github.com/aandergr.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Overview\n\nThis is a tool providing a CGI page **plotting system usage statistics** using\n[rrdtool](http://oss.oetiker.ch/rrdtool/).  With only about 400 lines of code,\nit is very **simple** and therefore **easy to understand and extend**.  \n\nCurrently it collects **Load Average**, **CPU usage**, **Temperature**,\n**Disk I/O**, **Network Traffic** and **Memory and Swap Usage**, which are plotted over a\nperiod chosen by the user at runtime.\n\nIt is build up of two parts:\n- stat.pl - **Perl CGI script** to be called by a webserver.\n- rrdupd.c - **lightweight** daemon collecting system usage information.\n\n# Installation\n\nYou need to have [rrdtool](http://oss.oetiker.ch/rrdtool/) with plotting\ncapability installed, as well as the common tools for building C programs (i.e.\nmake and gcc). This program should be installed in a path where your webserver\nis able to execute the stat.pl script via its CGI.\n\nWhen these prerequisites are met, installation is done with following steps:\n\n1. Download serverstat-linux, e.g. by doing `git clone https://github.com/aandergr/serverstat-linux`\n2. You might adjust the files to fit your needs\n3. Build rrdupd using `make`\n4. Run `./mkrrd.sh` to initalize RRD databases\n5. Adjust permissions such that your webserver is able to execute stat.pl as \n   CGI script, able to read .rrd files and able to write/create .png files in\n   that directory\n6. Run `./rrdupd`\n\n`./rrdupd` should be started automatically on system startup. On\ndebian-alike systems, this can be achieved using:\n\n```\necho \"start-stop-daemon -S -x /var/www/html/stat/rrdupd -c stat -b\" \u003e\u003e /etc/rc.local\nchmod +x /etc/rc.local\n```\n\n(Where stat is the name of the user and /var/www/html/stat the path of this\nsoftware)\n\nAlso, there is a `serverstat-linux.service` systemctl script template in this repository.\n\nConsult the documentation of your operating system for more information.\n\nNow you can point your browser to the direction of your stat.pl and (hopefully)\neverything works. Of course it will take a few minutes until you see some data.\n\n# Screenshots\n\nIt might look like this:\n![Screenshot of stat.pl page](https://raw.github.com/wiki/aandergr/serverstat-linux/screenshot-odroid.png)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faandergr%2Fserverstat-linux","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faandergr%2Fserverstat-linux","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faandergr%2Fserverstat-linux/lists"}