Installing the Quanta agent

In order to install the Quanta agent, you will need your autoregistration Token which can be found in the ‘System’ section of the configuration of your site in Quanta.

For Debian/Ubuntu

- Add the following line into the file /etc/apt/sources.list.d/quanta.list: deb http://apt.quanta.io quanta/ (if you're still using Debian Squeeze, use this line instead deb http://apt.quanta.io quanta-squeeze/)

- Create the repository configuration file in /etc/yum.repos.d/quanta.repo. In order to do this you can download the configuration file here : https://rpm.quanta.io/quanta-centos-repo.txt (if you're using Centos/Redhat version 6, you'll need to replace the line baseurl=http://rpm.quanta.io/quanta by baseurl=http://rpm.quanta.io/quanta-el6 in this file)

- To start the agent by itself at server setup: chkconfig quanta-agent on

You should see the system data in Quanta a minute later.

For other operating systems

We don’t provide packages for other operating systems, the sources are however publicly available on Github : https://github.com/quanta-computing/quanta-agent

The agent is only compatible with Linux.

Do not forget the advanced system metrics

The agent is able to retrieve advanced system data on different components of your infrastructure (available from Quanta Business licence).

- Apache

- MySQL

- Nginx

- Varnish

- Redis

- Memcached

For each of these components you will need to install an extra package and edit the respective configuration if needed (you will therefore have to have configured and installed the agent as explained above).

The packages are called quanta-agent-<service> and their configuration files are stored in /etc/quanta/modules.d/.

You will need to restart the agent after installing these packages.

Apache

- Install the package quanta-agent-apache

- Verify that the status module is configured correctly on your server with the following command: curl http://127.0.0.1/server-status

- If this isn’t the case, you will need to implement the Apache module mod_status as written here : https://httpd.apache.org/docs/current/mod/mod_status.html

- If you wish to change the URL used by our probe, you can update the file /etc/quanta/modules.d/apache.yml

- Restart the agent and you should see the metrics in Quanta within a few minutes.

MySQL

- Install the package quanta-agent-mysql

- We recommend creating a MySQL user dedicated to our probe even though it’s not obligatory, it can be done with the following command : echo "CREATE USER quanta@localhost IDENTIFIED BY <supersecret>" | mysql -u root -p

- Fill in the username and password that you chose in the file /etc/quanta/modules.d/mysqlstat.yml

- Restart the agent and you should see the metrics in Quanta within a few minutes.

Nginx

- Install the package quanta-agent-nginx

- Verify that the status module is configured correctly with the command : curl http://127.0.0.1/status

- If this isn’t the case, you must fulfil the proper Nginx configuration as follows : http://nginx.org/en/docs/http/ngx_http_stub_status_module.html

- If you wish to change the URL used by our probe, you can update the file /etc/quanta/modules.d/nginx.yml

- Restart the agent and you should see the metrics in Quanta within a few minutes.

Varnish

- Install the package quanta-agent-varnish

- Restart the agent and you should see the Varnish metrics in Quanta within a few minutes.

The Varnish plugin is only compatible with the version 3 of Varnish at this time.

If you use the "-n" argument in your Varnish configuration (and thus in Varnish administration tools such as varnishstat), it will be needed to specify the instance name in the Varnish agent configuration file /etc/quanta/modules.d/varnish.yml (this setting is available since version 1.1.0 of Quanta agent):

varnish:

instance: your_varnish_instance_name

Redis

- Install the package quanta-agent-redis

- If you don’t use the default port (6379) for Redis, you can change this in the file /etc/quanta/modules.d/redis.yml

- You should see the metrics in Quanta a few minutes after restarting the agent.

Memcached

- Install the package quanta-agent-memcached

- If you don’t use the default port (11211) for Memcached, you can change this in the file /etc/quanta/modules.d/memcached.yml

- You should see the metrics in Quanta a few minutes after restarting the agent