• Sales: 1-800-961-2888
  • Support: 1-800-961-4454

Creating a Monitoring Check Using the Cloud Control Panel


This article describes how to create a ping, TCP, or HTTP monitoring check using the New Cloud Control Panel. Each of the monitoring checks you can create with the New Cloud Control Panel are based on predefined check templates. You can view the settings for each check template in the Cloud Monitoring API Developers Guide.

For the latest information about Cloud Monitoring pricing and other general questions, see the Cloud Monitoring FAQ and the Cloud Monitoring main product page.

Create a Monitoring Check

  1. Log into the New Cloud Control Panel, and click Servers.
  2. Click the server you'd like to create the check for.

    The Server Details page opens.

  3. Scroll to the Monitoring Checks section and click Create Check.

  4. In the create check pop-over, select the Check Type: Ping Check (Server), HTTP Check (Website), or TCP Check (Port).

     

  5. Enter a descriptive name for the check in the Check Name text box.

     

    For Ping Check (Server)

    1. Select Ping Check (Server).
    2. Select either IP Address or Hostname as the Target Type.
    3. Select the IP address or enter the server's hostname in the Target Hostname text box.
    4. Click Create Check.

      The check is created and appears in the Monitor Checks table with a status of "Pending First Run."

     

    For HTTP Check (Website)

    1. Select HTTP Check (Website).
    2. Enter the URL of the website you want to monitor.

    3. (Optional) Click Advanced Options and fill in the Body Match with a word or phrase that will appear on the page when it loads successfully. For example, you can do a body match on the copyright date to verify if the website is up.
    4. Click Create Check.

      The check is created and appears in the table of Monitoring Checks with a status of "Pending First Run."

     

    For TCP Check (Port)

    1. Select TCP Check (Port).
    2. Enter the port number you want to monitor.
    3. Select either IP Address or Hostname as the Target Type.
    4. Select the IP address or enter the server's hostname in the Target Hostname text box.
    5. Click Create Check.

      The check is created and appears in the table of Monitoring Checks with a status of "Pending First Run."

The Check Status

As you create new checks, they'll appear in the Monitoring Checks table. The bar to the left of the check name indicates the status of the check:

When a check is first created, its status is "Pending First Run" as shown below:

Each check is currently launched from three different monitoring zones (regions):

  • DFW (Dallas-Ft. Worth)
  • ORD (Chicago)
  • LON (London)

Note: The terms monitoring zone and regions can be used interchangeably here, as they both represent the geographical locations where Rackspace has a data center and where the Rackspace Cloud Monitoring API is hosted.

The check status is calculated by determining if there is an agreement from a quorum of the monitoring zones (two out of three monitoring zones running the check). This helps avoid reporting false negatives. A check has to fail in two of the three monitoring zones/regions before the check state is deemed CRITICAL.

The combined results of the check from all three monitoring zones determines the check's state. The check state can be one of the following:

  • Green = OK

  • Yellow = WARNING

  • Red = CRITICAL, the check failed in at least two of three monitoring zones. The Technical Contact (the primary contact on the Rackspace account) will receive an email describing the situation.

The following screen-shot shows a check with an OK state and one in CRITICAL state:

Managing a Check

From the New Cloud Control Panel, click the Action cog to the left of the check name to Rename, Edit, or Delete a check:

 

You can also use the Rackspace Cloud Monitoring API or the raxmon command line interface to perform these and other actions on a check.



© 2011-2013 Rackspace US, Inc.

Except where otherwise noted, content on this site is licensed under a Creative Commons Attribution-NonCommercial-NoDerivs 3.0 Unported License


See license specifics and DISCLAIMER

9 Comments

Hi people at Rackspace, I am eager to start using Monitoring Checks. I need to create a simple TCP port check using ping/pong style. To be more precise I need to connect to a given port send a text message "PING" and the server will respond immediatly with "PONG" response. How can I send that text message and then check the correct answer? Many thanks.

Hey Roque,

Cloud Monitoring supports a generic TCP check that can do exactly what you want. From the Control Panel, what you'll need to do is:

1. On the server you want to monitor click "Create Check"
2. From the Check Type dropdown select "TCP Check (Port)"
3. Fill in the details you want including the port of the service you are monitoring and click "Create Check"
4. Once the check has been created, click on the small gear icon to the left of the check's name in the list of checks and select "Edit TCP Details...", then click "Advanced Options"
5. Enter ".*" (without the quotes) in the Body Match field, and "PING" in the Send Body field

At this point the check will be executing, sending the "PING" and gathering each response. In order to verify the response, click "Create Alarm" and put in the following criteria:

if (metric['body_match'] == 'PONG') {
return new AlarmStatus(OK, 'Received PONG');
}

return new AlarmStatus(CRITICAL, 'Received #{body_match}');



Let us know if you run into any issues!

Hi, thank you very much! It worked nicely, but there is a little side effect: the email sent to my mailbox is using an old server name, I renamed the server a while ago and it looks like the old name is being used on alarms notifications. Where that old name is being taken from? I could not find it anywhere. Thanks for any hint. I am already satisfied, but if I could solve that small problem it would be perfect.

Glad its working for you! Our system that keeps Monitoring synchronized with Cloud Servers appears to have missed the name change on your server for some reason. I've gone ahead and updated it for you, so you should be good to go. Don't hesitate to let us know if you run into any other issues!

Is it possible to have a SSL TCP Check?

Shawn,

Great question. That is possible, although its a little difficult to configure via the control panel today. First, create the check on the port that you want, then, once the check is created, click on the "Actions" dropdown and select "Edit TCP Details". There you'll see a checkbox for SSL. Check that, hit save, and it should begin handling the ssl negotiation, allowing you to do banner matching, body matching, etc. We have some improvements planned that should make this easier in the future.

Let us know if you run into any issues!

Hi, I'd like to be able to monitor my mysql and memcached servers by doing a TCP check. Obviously, I don't want to open up ports 3306 and 11211 to the world. How can I open those ports only to the monitoring client?

my questions is more about the cost of this services what I want to do is a
CPU and network monitor but they do not show the price that's why my question

I'll add a link to the main product page for Cloud Monitoring to the article. Sorry to make the pricing hard to find from here - you can see the full pricing info here:

http://www.rackspace.com/cloud/monitoring/pricing/

Pricing is charged hourly based on the number of active checks, with the price per check determined by how many zones the check is active in.

Add new comment