Monarch Managing Nagios Contacts


--- GW IMAGE NOT DISPLAYED --- Defining Contacts

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

Contents

Defining Contacts


--- GW IMAGE NOT DISPLAYED --- How Do I Define a New Contact?


Step 1 – Contact Properties

  1. Select Contacts from the Configuration menu options.
  2. Expand the Contacts drop-down menu.
  3. Select New.
  4. In the Contact Properties screen, enter the properties (see Table 5.7.1a. below).
  5. Select Add.
  6. You will be prompted that the contact has been added. Select Continue.

    Note: To copy an existing Contact select Copy from the Configuration menu options. This will let you name and edit the copied properties for a new Contact. To modify or delete a Contact select Modify. You will then be able to edit and Save a modified Contact. Select Delete to remove a selected Contact, Rename to change the name, or Cancel to exit out without any changes.

    Figure 5.7.1a. Contact Properties

    --- GW IMAGE NOT DISPLAYED ---

    Table 5.7.1a. Contact Properties

    Name [Required] Name of Contact.
    Alias [Required] This directive is used to define a longer name or description for the contact. Under the rights circumstances, the $CONTACTALIAS$ macro will contain this value.
    Email [Optional] This directive is used to define an email address for the contact. Depending on how you configure your Notification commands, it can be used to send out an alert email to the contact. Under the right circumstances, the $CONTACTEMAIL$ macro will contain this value.
    Pager [Optional] This directive is used to define a pager number for the contact. It can also be an email address to a pager gateway (i.e. pagejoe@pagenet.com). Depending on how you configure your Notification commands, it can be used to send out an alert page to the contact. Under the right circumstances, the $CONTACTPAGER$ macro will contain this value.
    Contact Template [Required] Select the contact template most suitable for this contact. Note: inheritance (left check box) on directives below. To override the template value, uncheck the left check box.
    Set Inheritance Selecting this button sets all directives to inherit values from the selected template. Uncheck left checkbox on directives below to override template values.
    Host Notification Period [Required] This directive is used to specify the short name of the time period during which the contact can be notified about Host problems or recoveries. You can think of this as an ‘on call’ time for Host Notifications for the contact. Read the documentation on time periods for more information on how this works and potential problems that may result from improper use.
    Host Notification Options [Required] This directive is used to define the Host states for which Notifications can be sent out to this contact. Valid options are a combination of one or more of the following: Down checked notify on DOWN Host states, Unreachable checked notify on UNREACHABLE Host states, and Recovery checked notify on Host recoveries (UP states). If you specify None as an option, the contact will not receive any type of Host Notifications.
    Host Notification Commands [Optional] This directive is used to define a list of the short names of the commands used to notify the contact of a Host problem or recovery. All Notification commands are executed when the contact needs to be notified. The maximum amount of time that a Notification command can run is controlled by the notification_timeout option.
    Service Notification Period [Required] This directive is used to specify the short name of the time period during which the contact can be notified about service problems or recoveries. You can think of this as an ‘on call’ time for Service Notifications for the contact. Read the documentation on time periods for more information on how this works and potential problems that may result from improper use.
    Service Notification Options [Required] This directive is used to define the Service states for which Notifications can be sent out to this contact. Valid options are a combination of one or more of the following: Warning checked notify on WARNING Service states, Unknown checked notify on UNKNOWN Service states, Critical checked notify on CRITICAL Service states, and Recovery checked notify on Service recoveries (OK states). Nagios® 2.x users may also specify Notifications on flapping starts and stops for Hosts and Services. If you specify None as an option, the contact will not receive any type of Service Notifications.
    Service Notification Commands [Optional] This directive is used to define a list of the short names of the commands used to notify the contact of a Service problem or recovery. All Notification commands are executed when the contact needs to be notified. The maximum amount of time that a Notification command can run is controlled by the notification_timeout option.
    Contact Groups [Optional] Define which Contact Groups are used for the purpose of sending out alert/recovery Notifications.

Defining Contacts


--- GW IMAGE NOT DISPLAYED --- How Do I Define a New Contact Group?

Step 1 – Contact Group Properties

  1. Select Contacts from the Configuration menu options.
  2. Expand the Contactgroups drop-down menu.
  3. Select New.
  4. In the Contactgroup Properties screen, enter the properties (see Table 5.7.2a. below).
  5. Select Add.
  6. You will be prompted that the Contact Group has been added. Select Continue.

    Note: To copy an existing Contact Group select Copy from the Configuration menu options. This will let you name and edit the copied properties for a new Contact Group. To modify or delete a Contact Group select Modify. You will then be able to edit and Save a modified Contact Group. Select Delete to remove a selected Contact Group, Rename to change the name, or Cancel to exit out without any changes.

    Figure 5.7.2a. Contact Group Properties

    --- GW IMAGE NOT DISPLAYED ---

    Table 5.7.2a. Contact Group Properties

    Name [Required] Name of Contact Group. Note: Use a unique Contact Group name and do not label Contact Groups and Host Groups the same name.
    Alias [Required] This directive is used to define a longer name or description used to identify the Contact Group.
    Contacts [Required] Assign pre-defined Contacts to the Contact Group.

Defining Contacts


--- GW IMAGE NOT DISPLAYED --- How Do I Create Contact Templates?


Step 1 – Contact Template Properties

  1. Select Contacts from the Configuration menu options.
  2. Expand the Contact Templates drop-down menu.
  3. Select New.
  4. In the Contact Properties screen, enter the properties (see Table 5.7.3a. below).
  5. Select Add to add and save the new Contact Template.
  6. You will be prompted that the Contact Template has been added. Select Continue.

    Note: To copy an existing Contact Template select Copy from the Configuration menu options. This will let you name and edit the copied properties for a new Contact Template. To modify or delete a Contact Template select Modify. You will then be able to edit and Save a modified Contact Template. Select Delete to remove a selected Contact Template, Rename to change the name, or Cancel to exit out without any changes.

    Figure 5.7.3a. Contact Template Properties

    --- GW IMAGE NOT DISPLAYED ---

    Table 5.7.3a. Contact Template Properties

    Name [Required] Name of Contact Template.
    Host Notification Period [Required] This directive is used to specify the short name of the time period during which the contact can be notified about Host problems or recoveries. You can think of this as an ‘on call’ time for Host Notifications for the contact. Read the documentation on time periods for more information on how this works and potential problems that may result from improper use.
    Service Notification Period [Required] This directive is used to specify the short name of the time period during which the contact can be notified about Service problems or recoveries. You can think of this as an ‘on call’ time for Service Notifications for the contact. Read the documentation on time periods for more information on how this works and potential problems that may result from improper use.
    Host Notification Options [Required] This directive is used to define the Host states for which Notifications can be sent out to this contact. Valid options are a combination of one or more of the following: Down checked notify on DOWN Host states, Unreachable checked notify on UNREACHABLE Host states, and Recovery checked notify on Host recoveries (UP states). If you specify None as an option, the contact will not receive any type of Host Notifications.
    Service Notification Options [Required] This directive is used to define the Service states for which Notifications can be sent out to this contact. Valid options are a combination of one or more of the following: Warning checked notify on WARNING Service states, Unknown checked notify on UNKNOWN Service states, Critical checked notify on CRITICAL Service states, and Recovery checked notify on Service recoveries (OK states). Nagios® 2.x users may also specify Notifications on flapping starts and stops for Hosts and Services. If you specify None as an option, the contact will not receive any type of Service Notifications.
    Host Notification Commands [Optional] This directive is used to define a list of the short names of the commands used to notify the contact of a Host problem or recovery. All Notification commands are executed when the contact needs to be notified. The maximum amount of time that a Notification command can run is controlled by the notification_timeout option.
    Service Notification Commands [Optional] This directive is used to define a list of the short names of the commands used to notify the contact of a Service problem or recovery. All Notification commands are executed when the contact needs to be notified. The maximum amount of time that a Notification command can run is controlled by the notification_timeout option.