Agent reads its configuration files from:
Default installation creates the following files:
/etc/glouton/glouton.conf: common default configuration and description of some customizable option.
/etc/glouton/conf.d/05-system.conf: default option for integration with system. For example it includes syslog logger.
/etc/glouton/conf.d/30-install.conf: credentials used to communicate with Bleemeo Cloud platform.
For more details on configuration files, see Configuration
Bleemeo agent have a built-in web server, which provide a diagnostic page, available by default at http://localhost:8015/diagnostic
This page may helps you finding the issues you had.
It also provide a diagnostic archive, which contains more details, including recent debug log messages. This archive is primarily targeted for Bleemeo support or Bleemeo agent developer.
In case of trouble, the most valuable source of information is the log file.
Log messages may be at various locations, depending how you run the agent:
- On Linux, when agent is installed with package or with the standard method,
logs are in syslog (usually
/var/log/messages). You can also use
journalctl -u glouton -fto see the last logs.
- On Windows, logs are usually in
docker logsfor Docker images
The log destination is set in the configuration files. For example in case of
system installation, logging is setup in
For more details, add the following to your configuration
/etc/glouton/conf.d/90-custom.conf) to increase log level to DEBUG:
After the configuration change, the agent will reload automatically. You can
force it to restart with
systemctl restart glouton or
docker restart glouton.
On each server, the agent should use its own credentials. If an agent detects that another agent is already connected to the Bleemeo Cloud platform using the same credentials, it will stop sending metrics to avoid overwriting data. It will also log an error message and send an email to the account managers to notify them of the problem.
To detect that another agent is using the same credentials, the agent uses two methods:
- It checks if some server properties (like the MAC address) have been modified on the Bleemeo API not by the agent itself (this works only for agents on different servers).
- It detects if multiple Glouton processes are running on the same machine. In some cases this might be valid, this detection can be disabled with the setting agent.disable_local_duplication_detection_by_process.
There are three main cases where this can happen:
- Two agents are running on the same host, in this case you should stop one of them.
- You are migrating a server to a new hardware, you should follow our migration guide.
- You copied the state to another server (possibly because you cloned a server through AMI or server image creation). On the server where the state was copied, you should stop the agent, then remove both state files, and restart the agent.
If you want to create a cloud image, please follow the installation for cloud image creation.
The agent is stateful. It keeps in a state some information specific to the server which runs it. For example its registration ID, the metrics seen and the metrics registered with the Bleemeo Cloud platform.
There are two state files:
- a static state file that
stores static information on the agent (like its credentials for the Bleemeo
Cloud platform). It is usually stored in
- a cache state file
that stores the cache of the detected services and metrics. It is usually