Go to file
OpenDev Sysadmins c64df25d62 OpenDev Migration Patch
This commit was bulk generated and pushed by the OpenDev sysadmins
as a part of the Git hosting and code review systems migration
detailed in these mailing list posts:

http://lists.openstack.org/pipermail/openstack-discuss/2019-March/003603.html
http://lists.openstack.org/pipermail/openstack-discuss/2019-April/004920.html

Attempts have been made to correct repository namespaces and
hostnames based on simple pattern matching, but it's possible some
were updated incorrectly or missed entirely. Please reach out to us
via the contact information listed at https://opendev.org/ with any
questions you may have.
2019-04-19 19:52:17 +00:00
attributes Name changes for the agent package. 2014-07-25 16:22:42 -06:00
recipes Fixing issue with plugin configuration 2014-09-25 12:06:14 -06:00
spec Upgrade rather than install 2014-08-01 08:45:02 -06:00
templates/default Update plugin recipe and template, remove plugin attribute files replaced by mon_setup 2014-06-26 10:28:01 -06:00
.gitignore Name changes for the agent package. 2014-07-25 16:22:42 -06:00
.gitreview OpenDev Migration Patch 2019-04-19 19:52:17 +00:00
.rubocop.yml Get initial build to work. 2014-07-16 18:16:19 -06:00
Berksfile Get initial build to work. 2014-07-16 18:16:19 -06:00
Gemfile Get initial build to work. 2014-07-16 18:16:19 -06:00
README.md Monasca has moved to Ansible for deployment 2015-02-22 08:33:35 -07:00
Strainerfile Get initial build to work. 2014-07-16 18:16:19 -06:00
metadata.rb Last commit did not bump version of the cookbook. 2014-10-02 09:01:38 -06:00

README.md

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.

cookbook-monasca-agent

Overview

This cookbook installs and configures the Monasca Monitoring Agent

Data Bags

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.

Example

{
  "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"
}

Recipes

default

The default recipe sets up the Monitoring Agent and runs mon-setup to configure.

plugin_cfg

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.yaml
  • checks_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.

Attributes

default

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.

network

These attributes configure the network plugin.

plugin_config_basenode

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

Templates

agent.conf.erb

This is the primary configuration file for the Agent, in /etc/monasca-agent/agent.conf

plugin_yaml.erb

This template provides the basis for plugin .yaml configuration files.