Home > Guides > RightScale 101 > Management Tools > Monitoring System > Setting up collectd

MindTouch
Copyright (c) 2006-2014 MindTouch Inc.
http://mindtouch.com

This file and accompanying files are licensed under the MindTouch Master Subscription Agreement (MSA).

At any time, you shall not, directly or indirectly: (i) sublicense, resell, rent, lease, distribute, market, commercialize or otherwise transfer rights or usage to: (a) the Software, (b) any modified version or derivative work of the Software created by you or for you, or (c) MindTouch Open Source (which includes all non-supported versions of MindTouch-developed software), for any purpose including timesharing or service bureau purposes; (ii) remove or alter any copyright, trademark or proprietary notice in the Software; (iii) transfer, use or export the Software in violation of any applicable laws or regulations of any government or governmental agency; (iv) use or run on any of your hardware, or have deployed for use, any production version of MindTouch Open Source; (v) use any of the Support Services, Error corrections, Updates or Upgrades, for the MindTouch Open Source software or for any Server for which Support Services are not then purchased as provided hereunder; or (vi) reverse engineer, decompile or modify any encrypted or encoded portion of the Software.

A complete copy of the MSA is available at http://www.mindtouch.com/msa

Setting up collectd

In order to use the Monitoring utility, collectd must be installed on each instance.

Installing collectd with RightScripts

If you are using a ServerTemplate that does not have monitoring enabled, you can add the SYS Monitoring install RightScript as a boot script to install and configure collectd.   A server cannot be monitored by RightScale unless this RightScript or recipe has installed our Monitoring utility on it.  Since new features are constantly being added to the Monitoring utility, it is highly recommended that you install collectd using our RightScripts or recipes.

Assuming you've already imported one of RightScale's ServerTemplates from the MultiCloud Marketplace that contains the SYS Monitoring install RightScript, you can add this script to another ServerTemplate.  Be sure to add it as a boot script.

screen-MonitoringBootScript-v1.png

 

You can also find each of our SYS Monitoring Install RightScripts directly within our MultiCloud Marketplace here

Installing collectd with Chef recipes

If you are configuring a ServerTemplate that does not have monitoring enabled, you must add the following Chef recipes to the Boot Sequence to properly set up monitoring on your server, otherwise you will not be able to see any graphs (under a server's Monitoring tab) or set any alert specifications. For this reason, it's recommended that you start your ServerTemplate development by cloning the "Base" ServerTemplate. See Base ServerTemplate for Linux (Chef) (v13 Infinity).

  • rightscale::setup_monitoring 

 

        screen-BootMonitorRecipe-v1.png

 

Installing additional collectd plugins

Out of the box collectd comes with a nice set of plugins that auto-configure themselves. We've eliminated the ones that don't apply to EC2 (e.g. bluetooth or mbmon) to keep everything streamlined.  You'll notice that we install some of the most relevant collectd plugins by default in some of our ServerTemplates (e.g. MySQL EBS), and a list of these relevant plugins can be found here.   Once again, you can add these RightScripts to your own ServerTemplate, assuming you've already imported one of our ServerTemplates that contains these RightScripts.

See also, Collectd Plugin: Apache Log Monitor.

screen-MonitoringPlugins-v1.png
 

Installing Collectd yourself

Warning! It is highly recommend that you only install Collectd from Rightscale's official scripts and recipes mentioned above. If you need a specific collectd version or must install it yourself, it is best to contact our support team for further clarification and insight before moving on.

That being said, if you must install collectd yourself and use a non-Rightscale sanctioned version then you will want to follow the advice below.

 

If RightScale's RightScripts cannot be used, collectd can be installed from public repositories or from a specified source.  An appropriate config file should also be copied from the RightScripts.  If for some reason you need to install collectd yourself, use the following steps:

  • Install collectd version 4.3.1 or later. Version 5.x has not been officially tested and may not work with Rightscale properly
  • Set the hostname in the config file to the Sketchy ID number (formatted like this: 01-3IPDVL6CR0FSK) found on the info tab of your server, or the Env variable RS_Instance_UUID)
  • Configure the network plugin to send the monitoring data to the monitoring server specified in the launch data as RS_sketchy=<hostname>
  • Use a 20-second interval
  • Be sure to add the following tag to your server: "rs_monitoring:state=active"
You must to post a comment.
Last Modified
09:14, 7 Oct 2013

Tags

Classifications

This page has no classifications.

Announcements

None

Glossary | 用語용어 Site Map | Site Help Community Corporate Site Get Support Dashboard Login
Doc Feedback Product Feedback Resources MultiCloud Marketplace Forums

Dashboard Status


© 2006-2014 RightScale, Inc. All rights reserved.
RightScale is a registered trademark of RightScale, Inc. All other products and services may be trademarks or servicemarks of their respective owners.