{"id":13584779,"url":"https://github.com/mikaku/Monitorix","last_synced_at":"2025-04-07T05:35:38.041Z","repository":{"id":5165236,"uuid":"6335657","full_name":"mikaku/Monitorix","owner":"mikaku","description":"Monitorix is a free, open source, lightweight system monitoring tool.","archived":false,"fork":false,"pushed_at":"2024-11-27T10:19:57.000Z","size":4389,"stargazers_count":1144,"open_issues_count":42,"forks_count":169,"subscribers_count":45,"default_branch":"master","last_synced_at":"2025-04-04T23:05:23.255Z","etag":null,"topics":["linux","monitoring","monitoring-tool","monitorix","perl","server","server-monitoring","system-monitoring","unix"],"latest_commit_sha":null,"homepage":"https://www.monitorix.org","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/mikaku.png","metadata":{"files":{"readme":"README","changelog":"Changes","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,"publiccode":null,"codemeta":null}},"created_at":"2012-10-22T13:41:51.000Z","updated_at":"2025-04-03T13:01:26.000Z","dependencies_parsed_at":"2024-02-23T09:29:25.969Z","dependency_job_id":"872287a6-ebab-4278-b739-5b2c6fec11e1","html_url":"https://github.com/mikaku/Monitorix","commit_stats":{"total_commits":2000,"total_committers":32,"mean_commits":62.5,"dds":0.12,"last_synced_commit":"5f8a32e5a62161903251d9ffe559475e6106c5ef"},"previous_names":[],"tags_count":15,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mikaku%2FMonitorix","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mikaku%2FMonitorix/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mikaku%2FMonitorix/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mikaku%2FMonitorix/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mikaku","download_url":"https://codeload.github.com/mikaku/Monitorix/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247517893,"owners_count":20951718,"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":["linux","monitoring","monitoring-tool","monitorix","perl","server","server-monitoring","system-monitoring","unix"],"created_at":"2024-08-01T15:04:31.082Z","updated_at":"2025-04-07T05:35:38.029Z","avatar_url":"https://github.com/mikaku.png","language":"Perl","readme":"INTRODUCTION\n===============================================================================\nMonitorix is a free, open source, lightweight system monitoring tool designed\nto monitor as many services and system resources as possible. It has been\ncreated to be used under production Linux/UNIX servers, but due to its\nsimplicity and small size may also be used to monitor embedded devices as\nwell.\n\nIt consists mainly of two programs: a collector, called monitorix, which\nis a Perl daemon that is started automatically like any other system service,\nand a CGI script called monitorix.cgi. Since 3.0 version Monitorix includes its\nown HTTP server built in, so you don't need to install any web server to use it.\n\nEvery time 'monitorix' is started it reads the configuration file from the path\nspecified in the command line (using the -c option), and once checked, it\ncreates the 'index.html' file that will act as the Monitorix main page.\n\nIt also creates a file called '\u003cbase_dir\u003e/cgi/monitorix.conf.path' that\nincludes the absolute path of the configuration file. This file will be read\nby 'monitorix.cgi' to determine the exact location of the configuration file.\n\nPlease, see the monitorix.conf(5) and monitorix(8) man pages.\n\n\nHISTORY\n===============================================================================\nAll of its development was initially created for monitoring Red Hat, Fedora and\nCentOS Linux systems, so this project was made keeping in mind these type of\ndistributions. Today it runs on different GNU/Linux distributions and even in\nother UNIX systems, like FreeBSD, OpenBSD and NetBSD.\n\nOn March 2006, Monitorix included minimal support to run on FreeBSD systems. My\nspecial thanks to twenty4help Knowledge Service and to Roger \"Rocky\" Vetterberg\nfor their support and help, and for being good friends during the porting\nprocess. \n\nSince the release of 1.3.2 though, Monitorix has almost full support for\nFreeBSD. My special thanks to Pavlin Vatev who generously offered his support\nduring all of the process.\n\nWith the release 2.0.0 Monitorix suffered a complete rewrite, including new\nfeatures and graphs, cleaned up all the code, updated and enhanced a number of\naspects in some graphs, and fixed a lot of bugs. The most important change was\nthat it no longer required 'crond' to work, instead Monitorix became a complete\nstandalone Perl daemon being started and stopped like any other system service.\n\nSince the release 2.2.0 Monitorix includes support for OpenBSD systems. My\nspecial thanks to Devio.us team for giving me a free shell account where to put\nhands to work.\n\nSince the release 2.6.0 Monitorix includes support for NetBSD systems.\n\nWith the release of the 3.0.0 version, Monitorix suffered another large rewrite\nwhich became into a complete modular code structure reducing in some cases\nits memory footprint. That new version also included a number of new features,\ncleaned up all the code, fixed a lot of bugs and had a safer code as it used\n'strict' and 'warnings' in all its modules.\n\nWith this new modular structure, Monitorix can now be packaged either into a\nsingle one package requiring all its dependences to be satisfied during the\ninstallation, or into several small packages one for each graph which should\nreduce notably its memory footprint.\n\nAnother interesting new feature in 3.0.0 version is that Monitorix comes with\nits own HTTP server built in. This should satisfy all the people that don't want\nto install an HTTP server (Apache, Nginx, lighttpd, etc.) to see the Monitorix\ngraphs.\n\n\nREQUIREMENTS\n===============================================================================\nMonitorix requires some others packages to be installed that your GNU/Linux\ndistribution may or may not have:\n\n- Perl\n- Perl-CGI\n- Perl-libwww\n- Perl-MailTools\n- Perl-MIME-Lite\n- Perl-DBI\n- Perl-XML-Simple\n- Perl-XML-LibXML\n- Perl-Config-General\n- Perl-HTTP-Server-Simple\n- perl-IO-Socket-SSL\n- RRDtool and its Perl bindings (perl-rrdtool or rrdtool-perl)\n- (Optional) a CGI capable Web server (Apache, Nginx, lighttpd, etc.)\n\n\nINSTALLATION\n===============================================================================\nRunning a `make install-xxx` as root will distribute the files to the file \nsystem. Most users will want to select from three options depending on target \ninit system (do not run all four)!\n\n\t# make install-systemd-all\n\t# make install-upstart-all\n\t# make install-debian-all\n\t# make install-redhat-all\n\nAlternatively, users may override any of the in make targets.  For example:\n\n\t$ make DESTDIR=~/pub BASEDIR=/srv/http/monitorix install-systemd-all\n\nThe file tree for the Monitorix application is:\n\nFile                        Recommended location\t\tDescription\n-------------------------------------------------------------------------------\nmonitorix                     /usr/bin/\t\t\tmain program (daemon)\nmonitorix.cgi                 \u003cbase_dir\u003e/cgi/\t\tCGI (viewer)\nmonitorix.conf                /etc/monitorix/\t\tconfiguration file\ndocs/debian.conf              /etc/monitorix/conf.d/00-debian.conf\textra configuration file\nlib/*.pm                      /usr/lib/monitorix/\tmodules\nChanges                       /usr/share/doc/monitorix/\tchanges log file\nCOPYING                       /usr/share/doc/monitorix/\tlicense\nlogo_bot.png                  \u003cbase_dir\u003e\t\tbottom logo\nlogo_top.png                  \u003cbase_dir\u003e\t\ttop logo\nmonitorixico.png              \u003cbase_dir\u003e\t\tfavicon\n/docs/monitorix-alert.sh      /usr/share/doc/monitorix/\talert example script\n/docs/monitorix-apache.conf   /etc/httpd/conf.d/\tapache configuration\n/docs/monitorix.service       /usr/lib/systemd/system/\tsystemd service template\n/docs/monitorix.init          /etc/init.d/\t\tRedhat SysV init script\n/docs/monitorix-deb.init      /etc/init.d/\t\tDebian SysV init script\n/docs/monitorix.logrotate     /etc/logrotate.d/\t\tlogrotate script\n/docs/monitorix.spec          /usr/share/doc/monitorix/\tRPM spec file\n/docs/monitorix.sysconfig     /etc/sysconfig/\t\tpre-run config file\n/docs/monitorix.lighttpd.conf /etc/lighttpd/\t\tlighttpd configuration\n/docs/htpasswd.pl             /usr/share/doc/monitorix/\tdocumentation\nREADME                        /usr/share/doc/monitorix/\tdocumentation\nREADME.BSD                    /usr/share/doc/monitorix/\tdocumentation\nREADME.nginx                  /usr/share/doc/monitorix/\tdocumentation\nman/man5/monitorix.conf.5     /usr/share/man/man5/\tmonitorix.conf manpage\nman/man8/monitorix.8          /usr/share/man/man8/\tmonitorix manpage\nreports/*.html                \u003cbase_lib\u003e/reports/\ttraffacct reports i18n\ncss/*.css                     \u003cbase_dir\u003e/css/\t\tCSS theme files\nusage/                        \u003cbase_lib\u003e/usage/\t\ttraffacct usage data\n\nOnce succesfully installed, please take a look into the configuration file to\nsetup the options according your system and enable or disable graphs.\n\nFinally start Monitorix using the system init script:\n\n# service monitorix start\n\nor with:\n\n# /etc/init.d/monitorix start\n\nAt this point, Monitorix will start gathering the system information based on\nthe configuration setup in 'monitorix.conf', and after some minutes, you should\nbe able to see the results from your favorite browser pointing at:\n\nhttp://localhost:8080/monitorix/\n\n\nAUTHORS\n===============================================================================\nMonitorix is written and actively maintained by Jordi Sanfeliu.\n\nMany people further contributed by reporting problems, suggesting various\nimprovements, sharing ideas or submitting actual code. Since the list might be\nincomplete, please see the 'Changes' file for a detailed description of all the\ncontributions.\n\nMy special thanks to all of them!\n\n\nCONTACT\n===============================================================================\nIn case of help, bugs, ideas or suggestions please contact using any of the\nfollowing ways:\n\n- IRC at Libera.Chat: #monitorix\n- Mailing List: https://lists.sourceforge.net/lists/listinfo/monitorix-general\n- Direct Email: Jordi Sanfeliu \u003cjordi@fibranet.cat\u003e\n\n\nDONATIONS\n===============================================================================\nIf you or your company make regular use of this software, please consider\nmaking a donation to the author to support open source effort.\nAny donation is greatly appreciated!\n\n\nLICENSE AND COPYRIGHT\n===============================================================================\nMonitorix is distributed under the terms of the GNU General Public License.\nSee the included file \"COPYING\".\n\nCopyright (C) 2005-2024 Jordi Sanfeliu.\nhttps://www.monitorix.org\n\n","funding_links":[],"categories":["Perl","server"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmikaku%2FMonitorix","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmikaku%2FMonitorix","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmikaku%2FMonitorix/lists"}