{"id":19550672,"url":"https://github.com/stenioaraujo/sys-performance","last_synced_at":"2025-04-26T20:31:05.729Z","repository":{"id":36856857,"uuid":"41163815","full_name":"stenioaraujo/sys-performance","owner":"stenioaraujo","description":"Simple system monitor for Ubuntu and Nginx. It uses Node.js and internal commands to retrieve the information.","archived":false,"fork":false,"pushed_at":"2015-09-24T15:26:15.000Z","size":117,"stargazers_count":10,"open_issues_count":0,"forks_count":4,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-04-04T17:51:41.666Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","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/stenioaraujo.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}},"created_at":"2015-08-21T15:39:05.000Z","updated_at":"2020-12-28T11:47:42.000Z","dependencies_parsed_at":"2022-09-11T10:21:52.111Z","dependency_job_id":null,"html_url":"https://github.com/stenioaraujo/sys-performance","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stenioaraujo%2Fsys-performance","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stenioaraujo%2Fsys-performance/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stenioaraujo%2Fsys-performance/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stenioaraujo%2Fsys-performance/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/stenioaraujo","download_url":"https://codeload.github.com/stenioaraujo/sys-performance/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251051305,"owners_count":21528786,"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","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":[],"created_at":"2024-11-11T04:07:40.420Z","updated_at":"2025-04-26T20:31:05.306Z","avatar_url":"https://github.com/stenioaraujo.png","language":"JavaScript","readme":"Sys-Performance\n===============\nSys-Performance is a simple system monitor for Ubuntu and Nginx. It uses Node.js and shell commands to retrieve CPU, ram, bandwidth and Nginx information.  The app works as an API and as a Socket.io server. For accessing the API one only needs to access the server at the chosen port. For using the Socket.io implementation one needs to set up the client folder in a webserver and/or locale. Although the API shows more information than the client page, the client page keeps you updated with real-time information about your server. Please let me know any issue.\n\nClient's interface\n------------------\n\n![Client's interface](https://lh3.googleusercontent.com/l1g34wmHJuV2sYJHtB2k1YCW9VkGfzmVauDzbv_5ibI=w1202-h609-no)\n\nInstallation\n------------\n\nFirst of all, the app relies upon some CLI commands. Although a basic Ubuntu installation has the ***free*** command, it is still necessary to install ***vnstat***. The app also uses a third developed software ***cpu_usage*** that should go together with the ***server.js***. That cpu_usage was created by [Paul Colby](http://colby.id.au).\n\n - Dependencies\n\t - vnstat\n\t - Node.js\n\t - npm\n\nMake sure to install all the dependencies before continuing.\n\n    sudo apt-get install nodejs npm vnstat\n\nThe app also relies upon the Nginx module ***stub_status*** to work fully. If you don`t have a Nginx webserver and/or the ***stub_status*** module on, The Nginx option will not show a valid information.\nFor default the app retrieves the ***stub_status*** information from the path ***/status*** (if it is another one, change the variable ***NGINX.path*** in the ***server.js***) from ***127.0.0.1*** (the server where the app is).\n\n\u003e If you wanna turn on the ***stub_status*** module on your Nginx server, follow [this link](http://nginx.org/en/docs/http/ngx_http_stub_status_module.html).\n\nServer\n------\nClone this repository in your server and open the folder ***server***. Then install the dependencies that are described within the ***package.json*** file. For that you only need to run:\n\n    npm install\n\nNow it is ready to be executed:\n\n    npm start\n\nIf you don`t change any default value, the API is visible at http://your_server:8081\n\nClient\n------\nThe client folder can localized in any webserver, or you may put it in your local computer. It is necessary to updated your server address in the ***index.html***. Where there are ***THE_SERVER_IP/HOSTNAME_HERE***, put your server address.\nWell done, the client is ready to connect to the socket.io server.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstenioaraujo%2Fsys-performance","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstenioaraujo%2Fsys-performance","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstenioaraujo%2Fsys-performance/lists"}