Basically this allows you to view recent data in cantal and use carbon for archival of statistics
The support is currently far from be comprehensive. Only some data can be sent to carbon. Sending whole collected statistics to graphite is too much, so we adding features one by one.
Cantal starting with v0.3.0, has a default configuration directory
/etc/cantal. You need to put some configuration file there:
# /etc/cantal/localhost.carbon.yaml host: localhost port: 2003 interval: 10 enable-cgroup-stats: true enable-application-metrics: true
All configurations which end with
.carbon.yaml will be read. Multiple
configurations may be used, each configuration is a separate connection with
it’s own set of metrics.
- (required) The IP address to send data to. Hostnames are not supported yet.
2003) Port where carbon listens with text protocol. The default matches the same of carbon.
10) Interval of sending data to carbon. The cantal’s collection interval is
2seconds for most metrics. But there is no much value of sending such detailed statistics to carbon. Cantal will provide 1 hour of highest precision history in it’s own interface and send averages of the values to a carbon.
false) Send data about cgroups to carbon
false) Send data with application metrics to carbon. The application must have an unique
CANTAL_APPNAMEin environment to have metrics delivered to carbon. Anyway
CANTAL_APPNAMEis ignored if application is in cgroup.
By default cantal sends nothing, even if connection params are set.
CGroup statistics (enabled with
Metrics (all represent the sum for all processes in the group):
vsize– virtual memory size
rss– resident set size
num_processes– total number of processes in the group
num_threads– total number of threads in the group
user_cpu_percent– percentage of CPU spent in user mode
system_cpu_percent– percentage of CPU spent in system mode
read_bps– average bytes per second read on disk
writes_bps– average bytes per second written to disk
Ggroup is a dot-delimited hierarchy of cgroups with systemd-like suffixes removed, for example:
/sys/fs/cgroup/systemd/system.slice/nscd.servicewill turn into
.mount(systemd-specific) groups are skipped
The root group
user(upstart- and systemd-specific) group is ignored
If the process is in group
a.bit will not count for group
a, the statistics for
acontains only processes immediately in the group
cantal.<CLUSTER_NAME>.<HOSTNAME>.cgroups.<GROUP_NAME>.states.<STATE_NAME>.<METRIC_NAME>– application-submitted metrics which have a
cantal.<CLUSTER_NAME>.<HOSTNAME>.cgroups.<GROUP_NAME>.groups.<STATE_NAME>.<METRIC_NAME>– application-submitted metrics which have a
Application metrics that are outside of cgroups have similar layout but do not
have any system metrics yet (enabled with
cantal.<CLUSTER_NAME>.<HOSTNAME>.apps.<APPLICATION_NAME>.states.<STATE_NAME>.<METRIC_NAME>– application-submitted metrics which have a
cantal.<CLUSTER_NAME>.<HOSTNAME>.apps.<APPLICATION_NAME>.groups.<STATE_NAME>.<METRIC_NAME>– application-submitted metrics which have a
no-cluster if no
specified in the command-line.
APPLICATION_NAME is the value of
CANTAL_APPNAME environment variable
that exists alongside with the