Ganglia

Ganglia is a scalable distributed system monitor tool for high-performance computing systems such as clusters and grids. It allows the user to remotely view live or historical statistics (such as CPU load averages or network utilization) for all machines that are being monitored.

The Ganglia Wiki contains all the information you need to get started with Ganglia.

Installation

Ganglia is available as the ganglia^AUR package, along with the web frontend ganglia-web^AUR. There is also a reduced-dependency version named ganglia-minimal^AUR, which would be appropriate on boxes where you do not require gmetad and want to avoid pulling in rrdtool as a dependency, which would in turn pull in Cairo and Mesa.

Ganglia Web Interface

The ganglia web frontend is available as the ganglia-web^AUR package on the AUR.

You will also need a web server with a working PHP setup. The following sections include some example setups.

Make sure that the open_basedir setting in your /etc/php/php.ini includes /tmp, /usr/share/webapps and /var/lib/ganglia.

Nginx with php-fpm

Firstly, install the nginx and packages.

Secondly, read the nginx article. Note its nginx#FastCGI and subsequent php-fpm sections. nginx#nginx configuration details a minimum to use.

An older minimal configuration for nginx would be something like this:

Then start , gmond.service, php-fpm.service and .

Go to http://localhost/ganglia and check that your setup is working.

Troubleshooting

Issues with IP-address binding or undesirable hostnames

If in the section of , the daemon will determine which IP to bind to (and report in the XML data) by determining the IP address of the default hostname. You should be able to replicate this behaviour with one of these commands:

The hostname to report is determined by asking the system to look up a hostname for the chosen IP address, in order to ensure the hostname is that by which other machines on the network identify the monitored machine:

The hostname listed at the top of the list is the one that will be reported by , and will appear in the web UI. You can influence the returned hostname by modifying your or files. In particular, watch out for placing myhostname before on the hosts line in . This will cause to attempt to bind to a UDP port on 127.0.0.1, and it will fail to load.

If you are not able to achieve the desired behaviour, the hostname can be overridden in the file by adding the following lines to the section:

gollark: I don't, actually.

gollark: (those are on pastebin anyway)

gollark: And here I was thinking they might want to be forewarned of any mildly evil project I made or something...

gollark: That prompted me to check my stuff, and hydraz/matheus followed me on github for some reason? How odd.

gollark: Wait, you have projects involvng web terminal thingies?