WARNING!!
Monasca is now deployed via Ansible. This project is no longer maintained and may be out of date. It will be moved to the StackForge attic soon.
This cookbook installs and configures the Monasca Monitoring Agent
For use with configuration, the monasca_agent data bag contains parameters
for interfacing with the Monitoring API, global dimensions (a set of
comma-delimited name:value pairs to be included in the Agent metrics),
and logging levels.
{
"id": "monasca_agent",
"keystone_url": "http://192.168.10.4:5000/v2.0",
"username": "joe_user",
"password": "correcthorsebatterystaple",
"project_name": "worldpeace",
"monasca_api_url": "http://192.168.10.4:8080/v2.0",
"service": "mini-mon"
}
The default recipe sets up the Monitoring Agent and runs mon-setup to configure.
monasca-agent plugins are configured in /etc/monasca-agent/conf.d/ as YAML files ending
in .yaml which are created by this recipe. The Agent will walk through these
files when the Collector (/usr/local/bin/monasca-collector) starts. The name of
the file must match a Python plugin in /etc/monasca-agent/checks.d/ or
/usr/local/lib/python2.7/dist-packages/monagent/collector/checks_d/
conf.d/file:process.yamlchecks_d/file:process.py- data bag item:
node.default[:monasca_agent][:plugin][:process]
The .yaml files are comprised of two different sections, init_config
containing global configuration parameters, and 'instances' containing one or
more stanzas containing details about the particular check to run. These are
defined in
node.default[:monasca_agent][:plugin][:process][:init_config]
and
node.default[:monasca_agent][:plugin][:process][:instances]
respectively.
The nagios_wrapper is a special case in the plugin_cfg recipe in that
if the check is defined, the dependent package nagios-plugins-basic is
installed to provide many standard Nagios plugins.
These are global attributes for use with the agent.conf file and installation settings.
With the case of dimensions, default['monasca-agent']['dimensions'] = nil appends
to the list of dimensions, if any, specified in the monasca_agent data bag.
These attributes configure the network plugin.
These attributes configure a basic set of plugins to be installed on every instance. These are in addition to the Monitoring Agent's existing set of basic metrics, listed on the monasca-agent wiki
This is the primary configuration file for the Agent, in /etc/monasca-agent/agent.conf
This template provides the basis for plugin .yaml configuration files.