A contact definition is used to identify someone who should be contacted in the event of a problem on your network. The different arguments to a contact definition are described below.
Bold directives are required, while the others are optional.
define contact{ | |
contact_name | *contact_name* |
alias | alias |
contactgroups | contactgroup_names |
host_notifications_enabled | [0/1] |
service_notifications_enabled | [0/1] |
host_notification_period | *timeperiod_name* |
service_notification_period | *timeperiod_name* |
host_notification_options | [d,u,r,f,s,n] |
service_notification_options | [w,u,c,r,f,s,n] |
host_notification_commands | *command_name* |
service_notification_commands | *command_name* |
email_address | |
pager | pager_number or pager_email_gateway |
address*x* | additional_contact_address |
can_submit_commands | [0/1] |
is_admin | [0/1] |
retain_status_information | [0/1] |
retain_nonstatus_information | [0/1] |
min_business_impact | [0/1/2/3/4/5] |
} |
define contact{
contact_name jdoe
alias John Doe
host_notifications_enabled 1
service_notifications_enabled 1
service_notification_period 24x7
host_notification_period 24x7
service_notification_options w,u,c,r
host_notification_options d,u,r
service_notification_commands notify-service-by-email
host_notification_commands notify-host-by-email
email jdoe@localhost.localdomain
pager 555-5555@pagergateway.localhost.localdomain
address1 xxxxx.xyyy@icq.com
address2 555-555-5555
can_submit_commands 1
}
This directive is used to determine whether or not the contact will receive notifications about host problems and recoveries. Values :
- 0 = don’t send notifications
- 1 = send notifications
This directive is used to determine whether or not the contact will receive notifications about service problems and recoveries. Values:
- 0 = don’t send notifications
- 1 = send notifications
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:
- d = notify on DOWN host states
- u = notify on UNREACHABLE host states
- r = notify on host recoveries (UP states)
- f = notify when the host starts and stops flapping,
- s = send notifications when host or service scheduled downtime starts and ends. If you specify n (none) as an option, the contact will not receive any type of host notifications.
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:
- w = notify on WARNING service states
- u = notify on UNKNOWN service states
- c = notify on CRITICAL service states
- r = notify on service recoveries (OK states)
- f = notify when the service starts and stops flapping.
- n = (none) : the contact will not receive any type of service notifications.
This directive is used to determine whether or not the contact can submit external commands to Shinken from the CGIs. Values:
- 0 = don’t allow contact to submit commands
- 1 = allow contact to submit commands.
This directive is used to determine whether or not the contact can see all object in WebUI. Values:
- 0 = normal user, can see all objects he is in contact
- 1 = allow contact to see all objects
This directive is used to determine whether or not status-related information about the contact is retained across program restarts. This is only useful if you have enabled state retention using the retain_state_information directive. Value :
- 0 = disable status information retention
- 1 = enable status information retention.
This directive is used to determine whether or not non-status information about the contact is retained across program restarts. This is only useful if you have enabled state retention using the retain_state_information directive. Value :
- 0 = disable non-status information retention
- 1 = enable non-status information retention
This directive is use to define the minimum business criticity level of a service/host the contact will be notified. Please see root_problems_and_impacts for more details.
- 0 = less important
- 1 = more important than 0
- 2 = more important than 1
- 3 = more important than 2
- 4 = more important than 3
- 5 = most important