{"id":20541201,"url":"https://github.com/netways/check_iftraffic","last_synced_at":"2025-04-14T08:39:22.515Z","repository":{"id":28130946,"uuid":"92949546","full_name":"NETWAYS/check_iftraffic","owner":"NETWAYS","description":"Icinga check plugin for network interface utilization ","archived":false,"fork":false,"pushed_at":"2024-04-10T10:17:00.000Z","size":31,"stargazers_count":4,"open_issues_count":0,"forks_count":9,"subscribers_count":14,"default_branch":"master","last_synced_at":"2025-03-27T22:11:48.207Z","etag":null,"topics":["icinga","monitoring","network","plugin","snmp"],"latest_commit_sha":null,"homepage":"","language":"Perl","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","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":"COPYING","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}},"created_at":"2017-05-31T13:39:00.000Z","updated_at":"2023-05-16T13:23:50.000Z","dependencies_parsed_at":"2024-04-10T11:29:59.867Z","dependency_job_id":"1c742416-b423-4967-9a2f-fe6e8b7ddcb1","html_url":"https://github.com/NETWAYS/check_iftraffic","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NETWAYS%2Fcheck_iftraffic","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NETWAYS%2Fcheck_iftraffic/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NETWAYS%2Fcheck_iftraffic/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NETWAYS%2Fcheck_iftraffic/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/NETWAYS","download_url":"https://codeload.github.com/NETWAYS/check_iftraffic/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248848191,"owners_count":21171323,"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","network","plugin","snmp"],"created_at":"2024-11-16T01:20:11.303Z","updated_at":"2025-04-14T08:39:22.482Z","avatar_url":"https://github.com/NETWAYS.png","language":"Perl","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Icinga Check Plugin for Interface Traffic\n\nChecks the utilization of a given interface name with SNMP.\n\nBased on `check_traffic` from Adrian Wieczorek.\n\n## Requirements\n\n* Perl\n* `Net::SNMP`\n\n## License\n\nThis project is licensed under the terms of the GNU General Public License Version 2.\n\nThis software is Copyright (c) 2004 by NETWAYS GmbH [support@netways.de](mailto:support@netways.de).\n\n## Support\n\nFor bugs and feature requests please head over to our [issue tracker](https://github.com/NETWAYS/check_iftraffic/issues).\n\n## Installation\n\n### RHEL/CentOS EPEL Repository\n\nRHEL/CentOS requires the EPEL repository:\n\n```\nyum -y install epel-release\nyum makecache\n```\n\nIf you are using RHEL you need enable the `optional` repository and then install\nthe [EPEL rpm package](https://fedoraproject.org/wiki/EPEL#How_can_I_use_these_extra_packages.3F).\n\n### Perl Dependencies\n\nDebian/Ubuntu:\n\n```\napt-get -y install libnet-snmp-perl\n```\n\nRHEL/CentOS/Fedora:\n\n```\nyum -y install perl-Net-SNMP\n```\n\n### Plugin Setup\n\nPut this plugin into the Icinga PluginDir location.\n\nDebian/Ubuntu:\n\n```\ninstall -o root -g root -m755 *.pl /usr/lib/nagios/plugins/\n```\n\nRHEL/CentOS/Fedora:\n\n```\ninstall -o root -g root -m755 *.pl /usr/lib64/nagios/plugins/\n```\n\n## Run\n\n```\n$ ./check_iftraffic.pl --help\n    Usage: check_iftraffic.pl -H host -C community -V snmp_version -i if_descr\n    -b if_max_speed -u unit [ -w warn ] [ -c crit ] [ -M max_counter_value ]\n\n    Options:\n\n    -H --host STRING or IPADDRESS\n        Check interface on the indicated host.\n    -C --community STRING\n        SNMP Community.\n    -V --version STRING\n        SNMP version to use (default: 1)\n    -i --interface STRING\n        Interface Name\n    -b --bandwidth INTEGER\n        Interface maximum speed in kilo/mega/giga/bits per second.\n    -u --units STRING\n        gigabits/s,m=megabits/s,k=kilobits/s,b=bits/s.\n    -w --warning INTEGER\n        % of bandwidth usage necessary to result in warning status (default: 85%)\n    -c --critical INTEGER\n        % of bandwidth usage necessary to result in critical status (default: 98%)\n    -M --max INTEGER\n\tMax Counter Value of net devices in kilo/mega/giga/bytes.\n```\n\n### Thresholds\n\nSingle thresholds or range based thresholds are supported according to the\nMonitoring Plugins API specification.\n\n### Examples\n\n```\n$ ./check_iftraffic.pl -H localhost -C public -i en0 -b 100 -u m\nTotal RX Bytes: 859.84 MB, Total TX Bytes: 1566.80 MB\u003cbr\u003eAverage Traffic: 0.00 kB/s (0.0%) in, 0.00 kB/s (0.0%) out| inUsage=0.0,85,98 outUsage=0.0,85,98 inAbsolut=880477 outAbsolut=1604405\n```\n\n## Configuration\n\nThe Icinga 2 CheckCommand is available inside the [ITL](https://icinga.com/docs/icinga2/latest/doc/10-icinga-template-library/#iftraffic).\n\n\n## Contributing\n\nFork this repository on GitHub and send in a PR.\n\nThere's a `.perltidyrc` file in the main repository tree. If you are uncertain about the coding style,\ncreate your patch and then run:\n\n```\n$ perltidy -b *.pl\n```\n\nThis requires the `perltidy` module being installed.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnetways%2Fcheck_iftraffic","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnetways%2Fcheck_iftraffic","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnetways%2Fcheck_iftraffic/lists"}