Skip to main content

Troubleshoot

Agent Files​

Configuration​

Agent reads its configuration files from:

  • /etc/glouton/glouton.conf
  • /etc/glouton/conf.d/*.conf
  • etc/glouton.conf
  • etc/conf.d/*.conf
  • C:\ProgramData\glouton\glouton.conf
  • C:\ProgramData\glouton\conf.d

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

Diagnostic page​

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.

Logs​

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/syslog or /var/log/messages). You can also use journalctl -u glouton -f to see the last logs.
  • On Windows, logs are usually in C:\ProgramData\glouton\logs.
  • Using docker logs for Docker images

The log destination is set in the configuration files. For example in case of system installation, logging is setup in /etc/glouton/conf.d/05-system.conf:

logging:
output: syslog

For more details, add the following to your configuration (/etc/glouton/conf.d/90-custom.conf) to increase log level to DEBUG:

logging:
level: DEBUG

After the configuration change, the agent will reload automatically. You can force it to restart with systemctl restart glouton or docker restart glouton.

Duplicated agent​

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.

note

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.
info

If you want to create a cloud image, please follow the installation for cloud image creation.

State​

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 /var/lib/glouton/state.json.
  • a cache state file that stores the cache of the detected services and metrics. It is usually stored in /var/lib/glouton/state.cache.json.