puppet-monasca/README.md

2.8 KiB

puppet-monasca

Table of Contents

  1. Overview - What is the monasca module?
  2. Module Description - What does the module do?
  3. Setup - The basics of getting started with monasca
  4. Implementation - An under-the-hood peek at what the module is doing
  5. Limitations - OS compatibility, etc.
  6. Development - Guide for contributing to the module
  7. Contributors - Those with commits

Overview

The monasca module is a part of OpenStack, and is meant to assist with the installation and configuration of monasca itself, and its dependent services (mentioned below).

Module Description

Setup

What the monasca module affects:

  • monasca, monitoring as a service for OpenStack.
  • storm, Apache's distributed realtime computational system.
  • kafka, Apache's publish-subscribe messaging system.
  • influxdb, a stand-alone open-source distributes time series database.

Implementation

monasca

monasca is a combination of Puppet manifest that configures the monasca client and server configuration, as well as monasca's dependent services.

Types

monasca_config

The monasca_config provider is a child of the ini_setting provider. It allows one to write an entry in the /etc/monasca/monasca.conf file.

monasca_config { 'DEFAULT/debug' :
  value => true,
}

This will write debug=true in the [DEFAULT] section.

name

Section/setting name to manage from monasca.conf

value

The value of the setting to be defined.

secret

Whether to hide the value from Puppet logs. Defaults to false.

ensure_absent_val

If value is equal to ensure_absent_val then the resource will behave as if ensure => absent was specified. Defaults to <SERVICE DEFAULT>

agent_config

The agent_config provider is a children of the ini_setting provider. It allows one to write an entry in the /etc/monasca/agent/agent.conf file.

agent_config { 'DEFAULT/verbose' :
  value => true,
}

This will write verbose=true in the [DEFAULT] section.

name

Section/setting name to manage from agent.conf

value

The value of the setting to be defined.

secret

Whether to hide the value from Puppet logs. Defaults to false.

ensure_absent_val

If value is equal to ensure_absent_val then the resource will behave as if ensure => absent was specified. Defaults to <SERVICE DEFAULT>

Limitations

This module currently only supports debian based installs.

Development

Developer documentation for the entire puppet-openstack project.

Contributors