{"id":23757094,"url":"https://github.com/mmitch/rrd","last_synced_at":"2025-10-19T11:13:29.966Z","repository":{"id":138319070,"uuid":"956859","full_name":"mmitch/rrd","owner":"mmitch","description":"my rrd statistic scripts","archived":false,"fork":false,"pushed_at":"2023-12-17T19:44:11.000Z","size":170,"stargazers_count":16,"open_issues_count":0,"forks_count":6,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-04-05T22:32:07.597Z","etag":null,"topics":["monitoring","rrd","visualisation","visualization"],"latest_commit_sha":null,"homepage":"","language":"Perl","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mmitch.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}},"created_at":"2010-10-02T17:14:26.000Z","updated_at":"2023-11-24T05:29:36.000Z","dependencies_parsed_at":"2023-12-16T10:50:20.385Z","dependency_job_id":null,"html_url":"https://github.com/mmitch/rrd","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/mmitch/rrd","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mmitch%2Frrd","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mmitch%2Frrd/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mmitch%2Frrd/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mmitch%2Frrd/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mmitch","download_url":"https://codeload.github.com/mmitch/rrd/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mmitch%2Frrd/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273713257,"owners_count":25154606,"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-05T02:00:09.113Z","response_time":402,"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":["monitoring","rrd","visualisation","visualization"],"created_at":"2024-12-31T19:37:46.921Z","updated_at":"2025-10-19T11:13:29.877Z","avatar_url":"https://github.com/mmitch.png","language":"Perl","readme":"my rrd statistic scripts\n========================\n\n[![Build status](https://github.com/mmitch/rrd/workflows/tests/badge.svg)](https://github.com/mmitch/rrd/actions?query=workflow%3Atests)\n[![GPL 3+](https://img.shields.io/badge/license-GPL%203%2B-blue.svg)](http://www.gnu.org/licenses/gpl-3.0-standalone.html)\n\nThis is a collection of scripts that draw some nice graphs with\ninformation about your system: cpu load, network load, free disk space\nand so on.\n\nVarious scripts are included.  Most will be useful for everyone, but\nsome are very special for my personal needs.  You probably won't find\nthem useful.\n\nThe scripts are not designed to be deployed on a server farm with\nhundreds of systems nor do they provide alerts if something goes\nwrong - they are completely passive.  There are various other tools\nfor these kind of scenarios (but if you do look for a small and simple\nsolution for some local nomitoring and alerting, have a look at\nhttps://github.com/mmitch/nomd).\n\ndependencies\n------------\n\nFor starters, you will need the `rrdtool` package, `bash` (any\n`sh`-style shell might work, but currently it says `#!/usr/bin/bash`),\nthe `lockfile` program, `Perl` and the `RRDs` Perl module (not\navailable separately on CPAN, comes with the `rrdtool` package;\navailable as `librrds-perl` on Debian/Ubuntu).\n\nSome modules will need other things as well.  You'll see it when\nsomething breaks :-)\n\nsetup\n-----\n\nThere is a bit of guesswork here, as most of my systems run these\nscripts for over 10 years, so I have no recent experience with a fresh\nsetup :-/\n\n1. copy `sample.conf` to `~/.rrd-conf.pl` and edit it to your needs\n   - just ignore stuff for modules that you don't want to use\n   - don't miss `$conf{MAKEHTML_MODULES}` at the end where you can\n     include your selected modules into the generated HTML pages\n\n2. edit `runall.sh` to only include the modules you need\n   - the total script runtime should not exceed 5 minutes, so adjust\n     `$RRD_WAIT` accordingly (Rationale: the script runtime should be\n     somewhat stretched out over the 5 minute intervall in order not\n     to cause big load spikes every 5 minutes.  If you don't mind\n     that, just set `$RRD_WAIT` to `0`.)\n   - don't get too near to 5 minutes or slightly higher system load\n     will cause you to run into lockfile problems (see commit\n     eb8e20052a for what the lockfile is about - you could also just\n     remove it)\n   - By default, `$DRAW_DETAILS` is set to `0` to decrease the load.\n     Values will be logged every 5 minutes, but graphs will only be\n     rendered every 30 minutes.  If you need more up-to-date graphs,\n     set `$DRAW_DETAILS` to `1`.\n\n3. run `make` once to generate your HTML pages\n\n4. set up a cronjob that runs the `runall.sh` script every 5 minutes\n   - all scripts run on a 5 minute interval base\n   - all scripts autogenerate their RRD databases if they are missing\n\n5. system load is the only thing that is tracked every minute, so you\n   manually to set up a cronjob that runs every minute and executes\n   this:\n\n``` shell\nrrdtool update PATH/TO/YOUR/load.rrd N:$( PROCS=`echo /proc/[0-9]*|wc -w|tr -d ' '`; read L1 L2 L3 DUMMY \u003c /proc/loadavg ; echo ${L1}:${L2}:${L3}:${PROCS} )\n```\n\nNow wait for some time until some data has been gathered, then open\nthe generated HTML pages and enjoy your graphs.\n\nlicense\n-------\n\nCopyright (C) 2003-2009, 2011, 2013, 2015-2018  Christian Garbs \u003cmitch@cgarbs.de\u003e  \nLicensed under GNU GPL v3 or later.\n\nThis program is free software: you can redistribute it and/or modify\nit under the terms of the GNU General Public License as published by\nthe Free Software Foundation, either version 3 of the License, or\n(at your option) any later version.\n\nThis program is distributed in the hope that it will be useful,\nbut WITHOUT ANY WARRANTY; without even the implied warranty of\nMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\nGNU General Public License for more details.\n\nYou should have received a copy of the GNU General Public License\nalong with this program.  If not, see \u003chttp://www.gnu.org/licenses/\u003e.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmmitch%2Frrd","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmmitch%2Frrd","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmmitch%2Frrd/lists"}