Page History

define host {

	##### Définition générale de l’hôte ####

    host_name 					[OBLIGATOIRE]	  *Nom de l'hôte*
					[OBLIGATOIRE]	*Nom de l'hôte*
	name						[OBLIGATOIRE]	  *Nom de l'hôte (lorsqu'il s'agit d'un modèle d'hôte)*
	display_name								  *Description*
    address 									  *Adresse de l'hôte*
    use 										  *Liste des modèles d'hôte à utiliser*
    hostgroups 									  *Liste des groupes d'hôtes dans lesquels appartient l'hôte*
    realm 										  *Royaume de l'hôte*
    business_impact 							  [0-5]; Impact métier de l'hôte
    parents 									  *Liste des hôtes desquels dépend cet hôte (d'un point de vue réseau)*
    notes_url 									  *URL externe pouvant donner des informations supplémentaires sur l'hôte*
    notes_multi_url								  *Propriété utilisée pour définir plusieurs URL *
    enabled 									  [0/1]; Est -ce que l'hôte est activé/désactivé ?
    pack 									      *Pack auquel appartient l'hôte*
 
	#### Données ####

	_NOMDEDONNEE								  *valeur de la donnée*
 
	#### Droits de l'utilisateur ####

	view_contacts								  *Les utilisateurs qui voient l'hôte*
	view_contact_groups							  *Les groupes d'utilisateurs qui voient l'hôte*
	    notification_contacts						  *Les utilisateurs à notifier*
	notification_contact_groups					  *Les groupes d'utilisateurs à notifier*
	edition_contacts							  *Les utilisateurs peuvent modifier la configuration de l'hôte.*
	    edition_contact_groups						  *Les groupes d'utilisateurs qui peuvent modifier la configuration de l'hôte.*
    
	contacts 									*Liste des contacts qui pourront Voir/Editer/EtreNotifié*
    contact_groups 								*Groupes d'utilisateurs qui pourront Voir/Editer/EtreNotifié*
	
	#### Parametres de supervision ####
    check_period element_visibility_on_not_authenticated_view  [0/1]; Permet de rendre ( 1 ) ou non ( 0 ) l'hôte visible dans les vues sans authentification. La propriété n'est pas héritable.

	contacts 								*Période de temps pendant laquelle les checks sont exécutés	  *Liste des contacts qui pourront Voir / Éditer / Être Notifié*
    checkcontact_commandgroups 								*Commande utilisée pour vérifier le statut UP/DOWN de l'hôte*
	max_check_attempts 		  *Groupes d'utilisateurs qui pourront Voir / Éditer / Être Notifié*
  


    #### Parametres de supervision ####

    check_period 								  *NombrePériode de vérificationstemps pendant delaquelle l'étatles dechecks l'hôte pour passer en état HARD*
	check_running_timeout sont exécutés*
    check_command 								  *TimeoutCommande utilisée depour lavérifier commandele destatut vérificationUP/DOWN de l'hôte*
   (en secondes)*
	warning_threshold_cpu_usage thresholds_display							  *NombrePermet de secondesdécrire que peut consommer une commande avant d'apparaître en Warning dans le check 'Scheduler - Performance'*
	check_intervalles seuils utilisés pour changer le statut de l'élément en Avertissement / Critique*
    max_check_attempts                            *Nombre de vérifications de l'état de l'hôte pour passer en état HARD*
	check_running_timeout 								  *IntervalleTimeout d’exécution de la commande de vérification de l'hôte (en secondes)*
	retry_interval warning_threshold_cpu_usage					  *Nombre de secondes que peut consommer une commande avant d'apparaître en Warning dans le check 'Scheduler - Performance'*
	check_interval 								  *Intervalle d’exécution de la commande de vérification de l'hôte*
	retry_interval 								  *Intervalle de confirmation d'état (en minutes)* 
    active_checks_enabled 						  [0/1]; Est -ce que les checks actifs sont activés pour cet hôte ?
    passive_checks_enabled 						  [0/1]; Est -ce que les checks passifs sont activés pour cet hôte ?
    maintenance_period 							  *Période de temps récurrente pendant laquelle l'hôte est en maintenance*
 
	#### Notifications ####

    notifications_enabled 						  [0/1]; Est -ce que les notifications sont activées pour cet hôte ?
    notification_interval 						  *Intervalle d'envoi des notifications (en minutes)*
    notification_period 						  *Période de temps pendantdurant laquelle les notifications sont actives*
    notification_options						  *Cette propriété permet de définir quels états de l'hôte peuvent envoyer des notifications*
	first_notification_delay					  *Délai avant l'envoi de la première notification*
    escalations 								  *Liste des escalades de notifications utilisées pour cet hôte*
    
	#### Expert ####
 
	poller_tag 									  *Poller tag associé à cet hôte*
	reactionner_tag				    			  *Poller reactionnerReactionner associé à cet hôte*
	process_perf_data 							  [0/1]; Prendre en compte la métrique éventuellement retournée par la check_command ?
	flap_detection_enabled 						  [0/1]; Est -ce que la détection du flapping est activée ?
	flap_detection_options						  [o,d,u] ;Cette propriété permet de définir quel statut d'un hôte sont pris en compte pour le calcul du % de FLAPPING
    low_flap_threshold 							  [0-100]; Seuil de sortie de l'état Flapping
	high_flap_threshold 						  [0-100]; Seuil d'entrée dans l'état Flapping 
    event_handler_enabled 						  [0/1]; Le gestionnaire d’événements est-il activé pour cet hôte ?
    event_handler 								  *Commande utilisée pour le gestionnaire d’événements*
	check_freshness								  [0/1]; Est -ce que la vérification de fraîcheur du check est activée ?
    freshness_threshold 						  *Seuil de fraîcheur du check*
	business_impact_modulations 				  *Modulation d'impact métier à utiliser*
	macromodulations 							  *Modulation de données à utiliser*
	resultmodulations 							  *Modulation de données à utiliser*
    service_excludes 							  *Liste des checks à ne pas appliquer sur l'hôte*
	service_overrides							  [Check, propriété valeur]; Liste des surcharges appliquées à des checks (les surcharges peuvent être séparées par -=#=-)

	#### Modèles ####

	register									  [0/1]; L'objet est-il un hôte ? mettre 0 pour un modèle d'hôte et mettre 1 pour un hôte
	for_all_users								  
    template_can_be_applied_by_si_admin           [0/1]; Est-ce que leles modèleadministrateurs estSI visiblepeuvent parappliquer tout( le monde1 (1) ou seulementnon par les utilisateurs administrateurs Shinken (0)( 0 ) le modèle sur un hôte ?
}

Des checks peuvent avoir le même nom, par contre, ils ne peuvent pas être attachés aux mêmes hôtes ou clusters.

Cas particulier des check Dupliqué pour tous ( Duplicate Foreach ) :

• Ils peuvent partager le même nom et le même hôte, à condition que la valeur de leurs données soit différente. 
  ( voir la page Dupliquer des checks en fonction d'une liste de valeurs présentes dans la Donnée d'un hôte (duplicate_foreach) ).

define service {
 
    

define service {
 
    ##### Définition du check - Général ####

	service_description				[OBLIGATOIRE]	*Nom du check*
    name							[OBLIGATOIRE]	*Nom du check (lorsqu'il s'agit d'un modèle)*
	use 											*Liste des modèles de check à utiliser*
    hostgroup_name									*Liste des groupes d'hôtes sur lesquels va s'appliquer le check*
    host_name 										*Liste des hôtes, modèle d'hôtes, clusters ou modèle de cluster sur lesquels le check va s'appliquer (cf. la clé apply_on_type)*  
    notes_url 										*URL externe pouvant donner des informations supplémentaires sur le check*
	enabled 										[0/1]; Est -ce que le groupe d'hôtes est activé/désactivé ?
	pack 											*Pack auquel appartient le groupecheck*
    
    apply_on_type                                   [hosts/hosttpls/clusters/clustertpls]; Sur quel type d'objet le check sera appliqué ? (si non renseigné, sur un hôte)
 
	#### Données ####

	_NOMDEDONNEE									*valeur de la donnée*
 
	#### Paramètres de supervision ####

    maintenance_period 								*Période de temps récurrente pendant laquelle l'hôte est en maintenance*
    check_period 									*Période de temps pendantdurant laquelle les checks sont exécutés*
    check_command 					[OBLIGATOIRE]	*Commande utilisée pour vérifier le statut UP/DOWN du check*
    thresholds_display								*Permet de décrire les seuils utilisés pour changer le statut de l'élément en Avertissement / Critique*
    max_check_attempts 				              [OBLIGATOIRE]	   *Nombre de vérifications de l'état du check pour passer en état HARD*
    check_interval 					[OBLIGATOIRE]	*Intervalle d’exécution de la commande*
    retry_interval 					[OBLIGATOIRE]	*Intervalle de confirmation d'état (en minutes)*

    check_running_timeout 							*Timeout de la commande de vérification de l'hôte (en secondes)*

    active_checks_enabled 							[0/1]; Est -ce que les checks actifs sont activés pour ce check ?
    passive_checks_enabled 							[0/1]; Est -ce que les checks passifs sont activés pour ce check ?
	duplicate_foreach 								*Donnée utilisée pour la fonctionnalité Duplicate For Each (en majuscule et débutant par un _)*
	default_value									*VousPermet pouvezde fournir plusieurs arguments pour chaque valeur définie dans la donnée de l'hôte utilisé par la fonctionnalité Duplicate for Each.*
 
	#### Notifications ####

    notifications_enabled 							[0/1]; Est -ce que les notifications sont activées pour cet hôte ?	
    contacts 										*Liste des contacts auxquels envoyer les notifications*
    contact_groups 									*Groupes d'utilisateurs auxquels seront envoyéesenvoyés les notifications pour cet hôte*
    notification_interval 							*Intervalle d'envoi des notifications (en minutes)*
    notification_period 							*Période de temps pendant laquelle les notifications sont actives*
	notification_options							*EtatsÉtats pour lesquels il faut envoyer une notification*
    first_notification_delay 						*Délai avant l'envoi de la première notification*
    escalations 									*Liste des escalades de notifications utilisées pour cet hôte*
    
	#### Expert ####

	poller_tag 										*Poller tag associé à ce check*
	reactionner_tag									*Reactionner tag associé à ce check*
    business_impact 								[0-5]; Impact métier du check
	is_volatile										[0/1]; Cette propriété permet de forcer Shinken à envoyer une notification pour chaque retour en erreur d'un check.
	check_freshness									[0/1]; Est -ce que la vérification de fraicheur du check est activée ?
    freshness_threshold 							*Seuil de fraicheur du check*
	flap_detection_enabled 							[0/1]; Est -ce que la détection du flapping est activée ?
	flap_detection_options          				[o,d,u] ;Cette propriété permet de définir quel statut d'un hôte sont pris en compte pour le calcul du % de FLAPPING
    high_flap_threshold 							[0-100]; Seuil d'entrée dans l'état Flapping
    low_flap_threshold 								[0-100]; Seuil de sortie de l'état Flapping
    process_perf_data 								[0/1]; Prendre en compte la métrique éventuellement retournée par la check_command ?
    event_handler_enabled 							[0/1]; Le gestionnaire d’événements est-il activé pour cet hôte ?
    event_handler 									*Commande utilisée pour le gestionnaire d'évenements*
    business_impact_modulations 					*Modulation d'impact métier à utiliser*
    macromodulations 								*Modulation de données à utiliser*
    resultmodulations 								*Modulation de resultats à utiliser*
	definition_order								[100]

}

define contactgroup {

	contactgroup_name		[OBLIGATOIRE]	*Nom du contact group*
	members									*Membres du groupe*
	template_members						*Les Utilisateurs avec le Modèle d'utilisateur spécifié appartiendront au groupe*
	enabled									[0/1]; Contact désactivé/activé
	pack									*Cette propriété permet de définir dans quel pack se trouve le groupe de contacts*
}

define notificationway {

	notificationway_name			[OBLIGATOIRE]	*Cette propriété permet de définir le nom utilisé pour identifier la méthode de notification.*
	host_notification_period						*Cette propriété permet de définir la période de temps pendant laquelle les notifications concernant les hôtes seront envoyées.*
	service_notification_period						*Cette propriété permet de définir la période de temps pendant laquelle les notifications concernant les checks seront envoyées.*
	host_notifications_enabled						*Cette propriété permet de définir si Shinken va envoyer des notifications concernant les hôtes.*
	service_notifications_enabled					*Cette propriété permet de définir si Shinken va envoyer des notifications concernant les checks.*
	host_notification_commands						*Cette propriété permet de définir les commandes qui envoient les notifications pour un hôte.*
	service_notification_commands					*Cette propriété permet de définir les commandes qui envoient les notifications pour un check.*
	host_notification_options						*Cette propriété permet de définir quels Statuts et Contextes de l'hôte peuvent envoyer des notifications*
	service_notification_options					*Cette propriété permet de définir quels Statuts et Contextes du check peuvent envoyer des notifications*
	min_business_impact								*Cette propriété permet de définir le seuil d'Impact Métier qui enverra des notifications.*
	enabled											[0/1]; Contact désactivé/activé
	pack											*Cette propriété permet de définir dans quel pack se trouve le groupe d'hôte.*
}

define escalation {

	escalation_name				[OBLIGATOIRE]	*Nom du contact group*
	first_notification_time						*Cette propriété est utilisée pour définir combien de temps (en minutes) Shinken doit attendre après la première notification pour démarrer l'escalade.*
	last_notification_time						*Cette propriété est utilisée pour définir combien de temps (en minutes) Shinken doit attendre après la première notification pour arrêter l'escalade*
	notification_interval						*Cette propriété permet de définir les intervalles de temps entre les notifications.*
	escalation_period							*Cette propriété est utilisée pour définir la période pendant laquelle l'escalade sera activée.*
	escalation_options							*Cette propriété permet de définir quels états peuvent démarrer une escalade*
	contacts									*Cette propriété est utilisée pour définir quels sont les utilisateurs à notifier.*
	contact_groups								*Cette propriété est utilisée pour définir quels sont les utilisateurs à notifier.*
	enabled										[0/1]; Contact désactivé/activé
	pack										*Cette propriété permet de définir dans quel pack se trouve le groupe d'hôte.*
}

define businessimpactmodulation {

    business_impact_modulation_name     [OBLIGATOIRE]	*Nom de la modulation*

    modulation_period                   				*Période de temps pendant laquelle la modulation est effective*
    business_impact                    					[0-5]; Valeur de l'impact métier à utiliser pour la modulation

    pack                                				*Nom du pack dans lequel se trouve la modulation*
    enabled                             				[0/1]; La modulation est-elle activée ?
}

define macromodulation {

    macromodulation_name	[OBLIGATOIRE]	*Nom de la modulation*
    modulation_period                   	*Période de temps pendant laquelle la modulation est effective*

    pack                                	*Nom du pack dans lequel se trouve la modulation*
    enabled                             	[0/1]; La modulation est-elle activée ?
}

define resultmodulation {

    resultmodulation_name	[OBLIGATOIRE]	*Nom de la modulation*

    modulation_period                  	 	*Période de temps pendant laquelle la modulation est effective*
    output_rules                        	*Définition des règles de la modulation*

    pack                                	*Nom du pack dans lequel se trouve la modulation*
    enabled                             	[0/1]; La modulation est-elle activée ?

}

define command {

    command_name	[OBLIGATOIRE]	*Nom de la commande*
    command_line    [OBLIGATOIRE]	*Commande à executer*

    timeout             			*Temps en secondes à partir duquel la commande entre en timeout*

    enabled             			[0/1]; La commande est elle activée ?
    pack                			*Nom du pack dans lequel se trouve la commande*

    poller_tag                      *Poller tag associé à cette commande*
    reactionner_tag                 *Reactionner tag associé à cette commande*
    module_type                     *Cette propriété est utilisée pour définir si cette commande devrait être exécutée par un module spécifique de pollers ou reactionners.*
    shell_execution                 [0/1]; Cette propriété est utilisée pour définir si la commande doit être exécutée dans un shell.
 }

define timeperiod {

    timeperiod_name		[OBLIGATOIRE]	*Nom de la période de temps*

    monday              				08:00-18:00
    tuesday             				08:00-18:00
    wednesday           				08:00-18:00
    thursday            				08:00-18:00
    friday              				08:00-18:00
    sunday	            				08:00-18:00
    saturday            				08:00-18:00
    

    enabled	            				[0/1]; La modulation est-elle activée ?
    pack                				*Nom du pack dans lequel se trouve la modulation*
}

• Les clés d'import définissant les noms des éléments
  • Exemple : "host_name" pour les Hôtes.
• Et toutes les propriétés pouvant avoir des valeurs multiples : ( voir la page Éditer les Eléments ( hôte, clusters, checks, utilisateurs ... ) )
  • Exemple : "view_contacts" pour la propriété "Les utilisateurs qui voient l'hôte".

La liste exhaustive de toutes les clé est disponible ici : Liste des clés pouvant utiliser [FORCE] 

```

thresholds_display	 	```Affichage des seuils
						Avertissement : 50 %
						Critique : 80 %```