{"id":20541213,"url":"https://github.com/netways/check-sar-perf","last_synced_at":"2025-09-05T23:55:21.417Z","repository":{"id":148513120,"uuid":"302689705","full_name":"NETWAYS/check-sar-perf","owner":"NETWAYS","description":"Icinga plugin to get performance data from sar/sysstat","archived":false,"fork":false,"pushed_at":"2023-12-06T09:46:53.000Z","size":38,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-01-16T15:13:04.678Z","etag":null,"topics":["icinga","monitoring","plugin","sar"],"latest_commit_sha":null,"homepage":"https://netways.de/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"nickanderson/check-sar-perf","license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/NETWAYS.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":"2020-10-09T16:01:36.000Z","updated_at":"2024-01-19T22:45:18.000Z","dependencies_parsed_at":null,"dependency_job_id":"c5fb315d-aaff-4b1d-8f77-e73f652e7bb7","html_url":"https://github.com/NETWAYS/check-sar-perf","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NETWAYS%2Fcheck-sar-perf","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NETWAYS%2Fcheck-sar-perf/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NETWAYS%2Fcheck-sar-perf/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NETWAYS%2Fcheck-sar-perf/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/NETWAYS","download_url":"https://codeload.github.com/NETWAYS/check-sar-perf/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":242145500,"owners_count":20079136,"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":["icinga","monitoring","plugin","sar"],"created_at":"2024-11-16T01:20:25.433Z","updated_at":"2025-03-06T04:20:53.836Z","avatar_url":"https://github.com/NETWAYS.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"check_sar_perf\n==============\n\nThis is a fork of [nickanderson/check-sar-perf](https://github.com/nickanderson/check-sar-perf)\nwith some improvements and updates.\n\nThis plug-in was written to get performance data from sar.\nCan be integrated into Icinga with using the agent. v2.11\nprovides a CheckCommand definition inside the [ITL](https://icinga.com/docs/icinga2/latest/doc/10-icinga-template-library/).\n\n## Requirements\n\n* `sysstat` tool\n\n## Usage\n\n```bash\nusage: check_sar_perf.py [-h] [-V] [-d DEVICE]\n                         {pagestat,cpu,memory_util,io_transfer,queueln_load,swap_util,swap_stat,task,kernel,disk}\n\nThis plugin reads output from sar (sysstat), checks it against thresholds and reports the results\n(including perfdata)\n\npositional arguments:\n  {pagestat,cpu,memory_util,io_transfer,queueln_load,swap_util,swap_stat,task,kernel,disk}\n                        sar Profile to execute for the check.\n\noptions:\n  -h, --help            show this help message and exit\n  -V, --version         show program's version number and exit\n  -d DEVICE, --device DEVICE\n                        Name of the device if the disk profile is selected.\n  -c CMD, --cmd CMD     Custom sar command to execude. Use as own risk.\n```\n\n## Examples\n\n```bash\n# CPU Perfdata\ncheck_sar_perf.py cpu\nOK: sar | CPU=all user=59.90 nice=0.00 system=4.46 iowait=0.00 steal=0.00 idle=35.64\n\n# Disk 'sda' Perfdata\ncheck_sar_perf.py disk --device sda\nOK: sar | DEV=sda tps=0.00 rd_secs=0.00 wr_secs=0.00 avgrq-sz=0.00 avgqu-sz=0.00 await=0.00\n\n# Custom Perdata\ncheck_sar_perf.py custom --cmd \"sar -P 1 1 1\"\nOK: sar | DEV=sda tps=0.00 rd_secs=0.00 wr_secs=0.00 avgrq-sz=0.00 avgqu-sz=0.00 await=0.00\n\n# Custom Perdata with Error\ncheck_sar_perf.py custom --cmd \"uptime\"\nUNKNOWN: Could not determine sar perfdata.\n\n# Invalid input\ncheck_sar_perf.py foo\nERROR: check_sar_perf.py: error: argument profile: invalid choice\n```\n\n## Profiles\n\nThese profiles are available out-of-the-box:\n\n* pagestat\n* cpu\n* memory_util\n* io_transfer\n* queueln_load\n* swap_util\n* swap_stat\n* task\n* kernel\n* disk\n\nA custom `sar` command can be specified with the `custom` profile and the `--cmd` flag.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnetways%2Fcheck-sar-perf","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnetways%2Fcheck-sar-perf","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnetways%2Fcheck-sar-perf/lists"}