NAME

hhvm_ - Munin plugin to monitor HHVM.

LICENCE

This source file is subject to the Open Software License (OSL 3.0) Which is available through the world-wide-web at this URL: http://opensource.org/licenses/osl-3.0.php

Copyright (c) 2014 Jeroen Vermeulen - http://www.jeroenvermeulen.eu

USAGE

- You need HHVM 3.0 or greater. - The HHVM AdminServer needs to be locally accessible via HTTP. - Since version 3.0 HHVM has no longer a built-in webserver. Not even for the AdminServer. - You will need to configure a special HHVM Admin webserver like Apache or Nginx, and connect it via FastCGI to the HHVM AdminServer Port. More info below. - You can use the HHVM Config setting "AdminServer.Port" or ini variable "hhvm.admin_server.port" to choose that port. For example 8080. - Copy this file to "/usr/share/munin/plugins/hhvm_". - Create a symlink in "/etc/munin/plugins" - By default this script will try to connect to a webserver on 127.0.0.1 port 8081. - You can make it connect to another IP and port by naming the symlink "hhvm_[IP]_[PORT]", for example hhvm_11.22.33.44_8081 - You can also use the plugin config to set "env.host" and "env.port"

ADMIN WEBSERVER CONFIG

NGINX CONFIG

server { listen 127.0.0.1:8081 default; location ~ { fastcgi_pass 127.0.0.1:8080; include fastcgi_params; } }

APACHE 2.2 CONFIG

FastCgiExternalServer /var/run/hhvm_admin.fcgi -host 127.0.0.1:8080 Listen 127.0.0.1:8081 <VirtualHost 127.0.0.1:8081> Alias /check-health /var/run/hhvm_admin.fcgi Alias /status.json /var/run/hhvm_admin.fcgi Alias / /var/run/hhvm_admin.fcgi </VirtualHost>

APACHE 2.4 CONFIG

Listen 127.0.0.1:8081 <VirtualHost 127.0.0.1:8081> ProxyPass / fcgi://127.0.0.1:8080/ </VirtualHost>