{"id":38817397,"url":"https://github.com/ericr/sys.json","last_synced_at":"2026-01-17T13:01:00.255Z","repository":{"id":27986344,"uuid":"31480233","full_name":"EricR/sys.json","owner":"EricR","description":"Expose server performance stats as a JSON API. Mostly just a toy project at this point.","archived":false,"fork":false,"pushed_at":"2016-10-09T02:02:26.000Z","size":16020,"stargazers_count":165,"open_issues_count":3,"forks_count":13,"subscribers_count":7,"default_branch":"master","last_synced_at":"2023-11-07T17:14:47.646Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/EricR.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-02-28T23:16:52.000Z","updated_at":"2023-07-30T06:09:56.000Z","dependencies_parsed_at":"2022-08-26T11:20:12.034Z","dependency_job_id":null,"html_url":"https://github.com/EricR/sys.json","commit_stats":null,"previous_names":[],"tags_count":0,"template":null,"template_full_name":null,"purl":"pkg:github/EricR/sys.json","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EricR%2Fsys.json","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EricR%2Fsys.json/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EricR%2Fsys.json/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EricR%2Fsys.json/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/EricR","download_url":"https://codeload.github.com/EricR/sys.json/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EricR%2Fsys.json/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28508943,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-17T11:50:55.898Z","status":"ssl_error","status_checked_at":"2026-01-17T11:50:55.569Z","response_time":85,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":[],"created_at":"2026-01-17T13:00:57.277Z","updated_at":"2026-01-17T13:01:00.219Z","avatar_url":"https://github.com/EricR.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# sys.json\n\nExposes server performance stats as an API.\n\nIt works, but it's a work in progress. Things are subject to change without notice, so please use\ncaution if you decide to use this in production. Assume there are bugs.\n\n## Why?\n\nThere are plenty of other tools out there that can give you stats. There's SNMP, dozens of monitoring\nsolutions and stat collection agents, and more. So why this?\n\nMany of these solutions are complicated to setup and get data from. The goal of sys.json is to\nprovide a simple API for querying a server about the stats you're interested in. No more, no less.\nWhat you do with that data is up to you.\n\n## Running It\n\n```bash\ngo get\ngo build\n./sysjson --listen 127.0.0.1:5374\n```\n\n**Important**: Note the bind to the loopback interface and *not* 0.0.0.0. This is not a service you'll want to expose to the Internet.\n\n## Example Requests\n\n```bash\ncurl http://localhost:5374/\n```\n\n```js\n{\n  \"modules_available\": {\n    \"conntrack\": {\n      \"name\": \"conntrack\",\n      \"description\": \"Provides stats on current network connections (requires conntrack-tools)\"\n    },\n    \"disk\": {\n      \"name\": \"disk\",\n      \"description\": \"Provides stats on each disk\"\n    },\n    \"host\": {\n      \"name\": \"host\",\n      \"description\": \"Provides basic host info\"\n    },\n    \"load\": {\n      \"name\": \"load\",\n      \"description\": \"Provides load averages\"\n    },\n    \"mem\": {\n      \"name\": \"mem\",\n      \"description\": \"Provides system-wide memory stats\"\n    },\n    \"net\": {\n      \"name\": \"net\",\n      \"description\": \"Provides stats on each network interface\"\n    },\n    \"process\": {\n      \"name\": \"process\",\n      \"description\": \"Provides a process tree\"\n    },\n    \"uptime\": {\n      \"name\": \"uptime\",\n      \"description\": \"Provides time since startup\"\n    }\n  }\n}\n```\n\n```bash\ncurl http://localhost:5374/?modules=disk,load\n```\n\n```js\n{\n  \"disk\": {\n    \"vda\": {\n      \"reads\": {\n        \"completed\": 21955,\n        \"sectors\": 1258186,\n        \"merged\": 11170,\n        \"total_ms\": 8302\n      },\n      \"writes\": {\n        \"completed\": 170359,\n        \"sectors\": 8927472,\n        \"merged\": 940398,\n        \"total_ms\": 893929\n      },\n      \"io\": {\n        \"in_progress\": 0,\n        \"total_ms\": 0,\n        \"total_weighted\": 97388\n      }\n    },\n    \"vda1\": {\n      \"reads\": {\n        \"completed\": 21781,\n        \"sectors\": 1256794,\n        \"merged\": 11170,\n        \"total_ms\": 8295\n      },\n      \"writes\": {\n        \"completed\": 170359,\n        \"sectors\": 8927472,\n        \"merged\": 940398,\n        \"total_ms\": 893929\n      },\n      \"io\": {\n        \"in_progress\": 0,\n        \"total_ms\": 0,\n        \"total_weighted\": 97382\n      }\n    }\n  },\n  \"load\": {\n    \"15m\": 0,\n    \"1m\": 0,\n    \"5m\": 0.02\n  }\n}\n```\n\n## Todo\n\n* Write tests\n* Standardize and document API\n* More in-depth networking and disk stats\n* Plugin engine for reading, parsing, and presenting data\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fericr%2Fsys.json","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fericr%2Fsys.json","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fericr%2Fsys.json/lists"}