Introduction aux objets de configuration

Nagios possède une configuration orientée objets. Cela permet entre des fonctions d’héritage puissantes entre ceux-ci. Encore faut-il savoir quels sont les différents types d’objets qu’il est possible de manipuler. C’est l’objet de cette petite introduction aux objets de configuration Nagios.

  • Chaque objet est défini par une série de caractéristiques.
  • L’héritage de caractéristiques est possible entre les objets.

Les hôtes

Une définition d’hôte s’applique à un serveur « physique », une station de travail, un périphérique, un équipement, un serveur virtuel qui se trouve sur votre réseau. Tout équipement possédant une adresse IP peut être considéré comme hôte. Voici une définition d’objet de configuration de type host.

define host{ 
	host_name	host_name 
	alias	alias 
	display_name	display_name 
	address	address 
	parents	host_names 
	hostgroups	hostgroup_names 
	check_command	command_name 
	initial_state	[o,d,u] 
	max_check_attempts	# 
	check_interval	# 
	retry_interval	# 
	active_checks_enabled	[0/1] 
	passive_checks_enabled	[0/1] 
	check_period	timeperiod_name 
	obsess_over_host	[0/1] 
	check_freshness	[0/1] 
	freshness_threshold	# 
	event_handler	command_name 
	event_handler_enabled	[0/1] 
	low_flap_threshold	# 
	high_flap_threshold	# 
	flap_detection_enabled	[0/1] 
	flap_detection_options	[o,d,u] 
	process_perf_data	[0/1] 
	retain_status_information	[0/1] 
	retain_nonstatus_information	[0/1] 
	contacts	contacts 
	contact_groups	contact_groups 
	notification_interval	# 
	first_notification_delay	# 
	notification_period	timeperiod_name 
	notification_options	[d,u,r,f,s] 
	notifications_enabled	[0/1] 
	stalking_options	[o,d,u] 
	notes	note_string 
	notes_url	url 
	action_url	url 
	icon_image	image_file 
	icon_image_alt	alt_string 
	vrml_image	image_file 
	statusmap_image	image_file 
	2d_coords	x_coord,y_coord 
	3d_coords	x_coord,y_coord,z_coord 
   	} 

Les services

La définition d’un service identifie un service tournant sur un hôte. Le terme service est très générique. Il peut s’appliquer à un service ( POP, SMTP, HTTP, etc.) ou bien tout autre type de mesures associé à l’hôte (temps de réponse à un ping, nombre d’utilisateurs connectés, usage des disques). En résumé, tout contrôle aboutit à un service. Voyons les options acceptées par un objet de configuration de type service.

define service{ 
	host_name	host_name 
	hostgroup_name	hostgroup_name 
	service_description	service_description 
	display_name	display_name 
	servicegroups	servicegroup_names 
	is_volatile	[0/1] 
	check_command	command_name 
	initial_state	[o,w,u,c] 
	max_check_attempts	# 
	check_interval	# 
	retry_interval	# 
	active_checks_enabled	[0/1] 
	passive_checks_enabled	[0/1] 
	check_period	timeperiod_name 
	obsess_over_service	[0/1] 
	check_freshness	[0/1] 
	freshness_threshold	# 
	event_handler	command_name 
	event_handler_enabled	[0/1] 
	low_flap_threshold	# 
	high_flap_threshold	# 
	flap_detection_enabled	[0/1] 
	flap_detection_options	[o,w,c,u] 
	process_perf_data	[0/1] 
	retain_status_information	[0/1] 
	retain_nonstatus_information	[0/1] 
	notification_interval	# 
	first_notification_delay	# 
	notification_period	timeperiod_name 
	notification_options	[w,u,c,r,f,s] 
	notifications_enabled	[0/1] 
	contacts	contacts 
	contact_groups	contact_groups 
	stalking_options	[o,w,u,c] 
	notes	note_string 
	notes_url	url 
	action_url	url 
	icon_image	image_file 
	icon_image_alt	alt_string 
   	}

Les contacts

Une définition de contact s’applique à la personne physique qui doit être contactée en cas de problèmes sur le système d’information supervisé.

define contact{
	contact_name	contact_name
	alias	alias
	contactgroups	contactgroup_names
	host_notification_period	timeperiod_name
	service_notification_period	timeperiod_name
	host_notification_options	[d,u,r,f,n]
	service_notification_options	[w,u,c,r,f,n]
	host_notification_commands	command_name
	service_notification_commands	command_name
	email	email_address
	pager	pager_number or pager_email_gateway
	addressx	additional_contact_address
   	}

Exemple de Définition:

define contact{
	contact_name                    jdoe
	alias                           John Doe
	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-by-email
	host_notification_commands      host-notify-by-email
	email				jdoe@localhost.localdomain
	pager				555-5555@pagergateway.localhost.localdomain
	address1			xxxxx.xyyy@icq.com
	address2			555-555-5555
	}

Les périodes de temps

Une période est une liste de tranches horaires pour les différents jours de la semaine, qui sont “valides” pour l’envoi des notifications et les contrôles de service. Ces tranches sont elles-mêmes composées d’autres tranches de temps pour chaque jour de la semaine, qui “tournent” une fois que la semaine est terminée. Définition du Format:

define timeperiod{
	timeperiod_name	timeperiod_name
	alias	alias
	sunday	timeranges
	monday	timeranges
	tuesday	timeranges
	wednesday	timeranges
	thursday	timeranges
	friday	timeranges
	saturday	timeranges
   	}

Exemple de définition

define timeperiod{
	timeperiod_name		nonworkhours
	alias			Non-Work Hours
	sunday			00:00-24:00
	monday			00:00-09:00,17:00-24:00
	tuesday			00:00-09:00,17:00-24:00
	wednesday		00:00-09:00,17:00-24:00
	thursday		00:00-09:00,17:00-24:00
	friday			00:00-09:00,17:00-24:00
	saturday		00:00-24:00
	}

Les groupes

Les groupes permettent de rassembler en entités logiques différents hôtes ou services. Il est par exemple d’usage de créer un groupe d’hôtes par type de système d’exploitation pour que chaque équipe système puisse avoir une vue globale du type de système dont elle s’occupe. Ainsi, l’équipe système Linux peut savoir si les machines de type Linux sont ok ou pas d’un seul coup d’œil.

Groupe d'hôtes

Une définition de groupe d’hôtes est utilisée pour regrouper un ou plusieurs groupes ensemble pour les afficher sous une seule entité dans la console. Ci-dessous un exemple de définition

define hostgroup{
        hostgroup_name          linux-servers
        alias                   Linux Servers
        members                 jeos,hardy,olivier-desktop
        }

Groupe de services

Une définition de groupe de services est utilisée pour regrouper un ou plusieurs services sous une seule entité dans la console. Ci-dessous un exemple de définition.

define servicegroup{
        servicegroup_name       dbservices
        alias                   Database Services
        members                 ms1,SQL Server,ms1,SQL Server Agent,ms1,SQL DTC
        }

Groupe de contacts

Une définition de groupe de contacts permet de regrouper un ou plusieurs contacts pour émettre des notifications. Quand un hôte ou un service a un problème ou se rétablit, Nagios recherche les groupes de contacts à qui envoyer des notifications, et notifie tous les contacts de ces groupes.

define contactgroup{
	contactgroup_name	contactgroup_name
	alias	alias
	members	members
   	}

Exemple de définition

define contactgroup{
	contactgroup_name		novell-admins
	alias			Novell Administrators
	members			jdoe,rtobert,tzach
	}

Les dépendances

Les dépendances permettent à Nagios de tenir compte de la topologie réseau pour distinguer si un hôte est injoignable (UNREACHABLE) ou éteint (DOWN). Ceci est utilisé dans la logique de contrôle et de notifications.

Les dépendances d’hôtes

Les définitions de dépendances d’hôte sont une fonctionnalité avancée de Nagios qui permet de supprimer des notifications et des contrôles actifs, à partir de l’état d’un ou plusieurs hôtes.

define hostdependency{
	dependent_host_name	host_name
	host_name	host_name
	inherits_parent	[0/1]
	execution_failure_criteria	[o,d,u,p,n]
	notification_failure_criteria	[o,d,u,p,n]
   	}

Exemple de définition

define hostdependency{
	host_name			WWW1
	dependent_host_name		DBASE1
	notification_failure_criteria	d,u
	}

Les dépendances de services

Les définitions de dépendances du service sont une fonctionnalité avancée de Nagios qui permet de supprimer des notifications et des contrôles actifs, à partir de l’état d’un ou plusieurs services. Elles sont optionnelles et sont principalement destinées aux utilisateurs avertis qui ont des configurations de supervision complexes.

define servicedependency{
	dependent_host_name	host_name
	dependent_service_description	service_description
	host_name	host_name
	service_description	service_description
	execution_failure_criteria	[o,w,u,c,n]
	notification_failure_criteria	[o,w,u,c,n]
   	}

Exemple de définition

define servicedependency{
	host_name			WWW1
	service_description		Apache Web Server
	dependent_host_name		WWW1
	dependent_service_description	Main Web Site
	execution_failure_criteria	n
	notification_failure_criteria	w,u,c
	}

Les escalades

Les escalades permettent de notifier des personnes différentes suivant la durée de résolution d’un incident. Le concept est similaire aux escalades de support niveau 1,2 et 3.

Les escalades d’hôtes

Une définition d’escalade pour un hôte est complètement optionnelle et est utilisée pour escalader les notifications liées à un hôte particulier.

define hostescalation{
	host_name	host_name
	hostgroup_name	hostgroup_name
	contact_groups	contactgroup_name
	first_notification	#
	last_notification	#
	notification_interval	#
	escalation_period	timeperiod_name
	escalation_options	[d,u,r]
   	}
define hostescalation{
	host_name		router-34
	first_notification	5
	last_notification	8
	notification_interval	60
	contact_groups		all-router-admins
	}

Les escalades de services

Une définition d’escalade pour un service est complètement optionnelle et est utilisée pour escalader les notifications liées à un service particulier.

define serviceescalation{
	host_name	host_name
	service_description	service_description
	contact_groups	contactgroup_name
	first_notification	#
	last_notification	#
	notification_interval	#
	escalation_period	timeperiod_name
	escalation_options	[w,u,c,r]
   	}

Exemple de définition

define serviceescalation{
	host_name		nt-3
	service_description	Processor Load
	first_notification	4
	last_notification	0
	notification_interval	30
	contact_groups		all-nt-admins,themanagers
	}

Les commandes

Une définition de commande est un appel depuis Nagios à un script ou à un binaire exécuté à différentes fins. Les commandes qu’on peut définir sont les contrôles de service, les notifications de service, les gestionnaires d’événements de service, les contrôles d’hôte, les notifications d’hôte et les gestionnaires d’événements d’hôte. Les définitions de commande peuvent contenir des macros.

define command{
        command_name    check_pop
        command_line    /opt/nagios/libexec/check_pop -H $HOSTADDRESS$    
        }
Cet objet possède son écran de configuration correspondant dans Centreon

Les ressources & macros

Une des fonctionnalités disponibles dans Nagios est la possibilité d’utiliser des macros (lire macro-commandes) dans les définitions de commandes. Avant d’exécuter une commande, Nagios remplace toutes les macros dans celle-ci par les valeurs correspondantes. Avant qu’une commande (contrôles d’hôte et de service, notifications, gestionnaires d’évènements, etc.) soit exécutée, Nagios va remplacer toutes les macros qu’il trouve dans la définition de la commande par les valeurs correspondantes. Les macros d’hôte et de service dans les définitions de commandes font référence aux valeurs de l’hôte ou du service pour lequel s’exécute la commande.

Les gabarits ou modèles

La configuration des objets par héritage est le moyen le plus commode d’industrialiser la configuration de Nagios. L’héritage de propriétés d’objets s’accomplit de manière récursive lors de la lecture des fichiers de configurations par Nagios. Il y a trois variables concernant le principe de récursion et d’héritage qui sont disponibles dans toutes définitions d’objets.

        define someobjecttype{
                object-specific variables ...
                name            template_name
                use             name_of_template_to_use
                register        [0/1]
                }

Voilà le tour du propriétaire des objets et directives de configuration disponibles dans Nagios terminé.

nagios/configobjects.txt · Dernière modification: 02/03/2017 16:41 (modification externe)
CC Attribution-Noncommercial-Share Alike 4.0 International
www.chimeric.de Valid CSS Driven by DokuWiki do yourself a favour and use a real browser - get firefox!! Recent changes RSS feed Valid XHTML 1.0