--- GW IMAGE NOT DISPLAYED --- Configuring Escalations

Copyright 2006 GroundWork Open Source, Inc. (“GroundWork”).
All rights reserved. Use is subject to GroundWork commercial license.

Contents

Configuring Escalations


--- GW IMAGE NOT DISPLAYED --- How Do I Configure a Host or Service Escalation?


Step 1 – Configuring a Host or Service Escalation

This step shows how to add escalations in the configuration tool Monarch.

  1. Select Escalations from the Configuration menu options.
  2. Expand the Escalations drop-down menu.
  3. Expand the Host (or Service) drop-down menu.
  4. Select New.
  5. In the Host (or Service) Escalation Properties screen, enter the properties (see Table 5.8.1a. below).
  6. Select Add to add the new Host (or Service) Escalation.
  7. You will be prompted that the new Host (or Service) Escalation has been saved. Select Continue.

    Figure 5.8.1a. Host (or Service) Escalation Properties

    --- GW IMAGE NOT DISPLAYED ---

    Table 5.8.1a. Host (or Service) Escalation Properties

    Name Host (or Service) Escalation name.
    First Notification [Required] Which Notification does this Escalation start with? This directive is a number that identifies the first Notification for which this escalation is effective. For instance, If you start with 1, the first Notification, this Escalation will control Notifications from the beginning Notification. Or, if you set this value to 3, this Escalation will only be used if the Host (is down or unreachable long enough for a third Notification to go out or if the Service is in a non-OK state long enough for a third Notification to go out.
    Last Notification [Required] This directive is a number that identifies the last Notification for which this Escalation is effective. For instance, if you set this value to 5, this Escalation will not be used if more than five Notifications are sent out for the Host or Service. Setting this value to 0 means this Escalation will control all Notifications sent.
    Notification Interval [Required] When should Notifications be sent? This directive is used to determine the time interval, (unless you’ve changed the interval_length directive from the default value of 60, this number will mean minutes), at which Notifications should be made while this Escalation is valid. The average interval is 15 minutes. If you specify a value of 0 for the interval, Nagios® will send the first Notification only, and will then prevent any more problem Notifications from being sent out for the Host. Specifying any other value will send continuous notifications at the time interval specified. Note: If multiple Escalation entries for a Host overlap for one or more Notification ranges, the smallest Notification interval from all Escalation entries is used.
    Escalation Period [Optional] This directive is used to specify the name (e.g. Work Hours, 24×7 no limit) of the time period during which this Escalation is valid. If this directive is not specified, the Escalation is considered to be valid during all times.
    Escalation Options [Optional] When should a Notifications be sent? This directive is used to define the criteria that determine when this Host (or Service) Escalation is used (e.g. Recovery, Down, Unreachable). The Escalation is used only if the Host (or Service) is in one of the states specified in this directive. If this directive is not specified in a Host (or Service) Escalation, the Escalation is considered to be valid during all Host (or Service) states. Valid options are a combination of one or more of the following: Recovery = escalate on an UP (recover) state, Down = escalate on a DOWN state, and Unreachable = escalate on an UNREACHABLE state. Example: If you specify Down in this field, the Escalation will only be used if the Host (or Service) is in a DOWN state.

Configuring Escalations


--- GW IMAGE NOT DISPLAYED --- How Do I Define a Host or Service Escalation Tree?


Step 1 – Defining a Host or Service Escalation Tree

  1. Select Escalations from the Configuration menu options.
  2. Expand the Escalation Trees drop-down menu.
  3. Expand the Host (or Service) drop-down menu.
  4. Select New.
  5. Enter a name for the Host (or Service) Escalation Tree.
  6. Select Add to create the new Host (or Service) Escalation Tree. The new Escalation Tree name will then be listed in the navigation tree. At this point the Escalation Tree will be added to the database but it will not yet have any particular escalation assigned to it. Continue with Step 2 – Modifying a Host (or Service) Escalation Tree.

    Figure 5.8.2a. Defining a Host (or Service) Escalation Tree

    --- GW IMAGE NOT DISPLAYED ---

Step 2 – Modifying a Host Escalation Tree – Adding Escalations

By selecting Modify and selecting an Escalation Tree entry we can add Escalations to the tree where you can build up a number of Escalations to accomplish elaborate Notification schemes. For example, a Technical Contact Group could be assigned an Escalation that sends out the first through the last Notifications. Whereas a different Escalation might start with the 5th Notification and end with the 6th Notification and go to a Senior Manager that might want to be notified only when a alarm hasn’t been acknowledged within the 4 previous Notifications.

  1. Expand the Modify drop-down menu and select an Escalation Tree name to add Escalations to.
  2. Here you will see a list of defined Escalations. Select an Escalation and click on the Add Escalation button. Continue with Step 3 – Adding One or More Contact Groups
  3. Figure 5.8.2b. Modifying a Host Escalation Tree

    --- GW IMAGE NOT DISPLAYED ---

Step 3 – Modifying a Host Escalation Tree – Adding One or More Contact Groups

Contact Groups that are selected will be notified when the Host Notification is escalated.

  1. Adding an Escalation takes you to the next screen where you need to add one or more Contact Groups.
  2. Select Assign Contact Groups.

    Figure 5.8.2c. Assigning Contact Groups

    --- GW IMAGE NOT DISPLAYED ---

Step 4 – Modifying a Host Escalation Tree – Adding Additional Escalations (Escalation Templates)

Here we will add Host Groups and/or Hosts to the Escalation Tree.

  1. You will see the selected Escalation listed displaying the name, first notification, and assigned Contact Groups.
  2. Here you can also, for any Escalation, select Modify Groups to change the list of Contact Groups associated with the Escalation, or you can select Remove to delete an Escalation from the Escalation Tree. Continue with Step 5 – Assigning Host Groups.

    Figure 5.8.2d. Modifying a Host Escalation Tree

    --- GW IMAGE NOT DISPLAYED ---

Step 5 – Modifying a Host Escalation Tree – Assigning Host Groups

Now you can optionally assign Host Groups which will set the default Host Escalation for all Hosts in a Host Group. You also have the option to set a Host Escalation for a Host.

  1. Select the Assign Host Groups tab.
  2. Select the Host Groups to assign to the Escalation Tree.
  3. Select Save and Close.

    Figure 5.8.2e. Assigning Host Groups

    --- GW IMAGE NOT DISPLAYED ---

Note – Adding an Escalation to a Host Group via Host > Host Groups > Modify

  1. Note that you could have also added this Escalation to the Linux Server Host Group by selecting Hosts > Host Groups > Modify and Linux Servers, then selecting from the Host Escalation ID drop-down list Hostgroup Escalation Tree Example 1.

    Figure 5.8.2f. Adding an Escalation to a Host Group via Host>Host Groups>Modify

    --- GW IMAGE NOT DISPLAYED ---

Nagios® Configuration Object Definitions

When the Escalation Tree is committed to the Nagios® engine cfg files, the configurator creates the following Nagios® configuration object definition:

define hostescalation {
         use Hostgroup Escalation Example 1
         hostgroup_name Linux Servers
         contact_groups nagiosadmin
         }

define hostescalation {
         name                        Hostgroup Escalation Example 1
         first_notification          1
         last_notification           0
         notification_interval     15
         escalation_period        24x7
         escalation_options       d
         register                      0
}

For more information about Host Escalation definitions see http://nagios.sourceforge.net/docs/2_0/xodtemplate.html#hostescalation.


Leave a Reply

Your email address will not be published. Required fields are marked *

clear formPost comment