README.rdoc

DESCRIPTION:¶ ↑

Opscode Chef cookbook for MongoDB Monitoring System (MMS) agent. MMS is a hosted monitoring service, provided by 10gen, Inc. Once the small python agent program is installed on the MongoDB host, it automatically collects the metrics and upload them to the MMS server. The graphs of these metrics are shown on the web page. It helps a lot for tackling MongoDB related problems, so MMS is the baseline for all production MongoDB deployments.

NOTE: This cookbook only installs the MMS agent program, not MongoDB itself. Using this cookbook together with edelight’s great MongoDB cookbook is recommended.

INSTALLATION:¶ ↑

The knife-github-cookbooks gem is a plugin for knife that supports installing cookbooks directly from a GitHub repository. To install with this plugin, please follow these steps:

$ gem install knife-github-cookbooks
$ cd chef-repo
$ knife cookbook github install treasure-data/chef-mongodb-mms-agent

REQUIREMENTS:¶ ↑

This cookbook has these external dependencies.

• python cookbook

• runit cookbook

ATTRIBUTES:¶ ↑

API Key, and the Secret Key are required. Please get them at your MMS Settings page.

• node[:api_key] (required)

• node[:secret_key] (required)

USAGE:¶ ↑

This is an example role file, together with edelight’s great MongoDB cookbook.

name "mongo"
description "mongo server role."
run_list(
  "recipe[mongodb::10gen_repo]",
  "recipe[python]",
  "recipe[runit]",
  "recipe[mms-agent]",
)
override_attributes(
  # for mongodb
  :mongodb => {
    :cluster_name => "cluster_foo",
    :dbpath       => "/md0/mongo/db/",
    :logpath      => "/md0/mongo/logs/",
    :port         => 27017,
  },
  # for mms-agent
  :mms_agent => {
    :api_key => 'foo',
    :secret_key => 'bar'
  }
)