Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Make by tools (01.00.01) - action=clean_macro_parameter
Scroll Ignore
scroll-pdftrue
scroll-officetrue
scroll-chmtrue
scroll-docbookhtmltruefalse
scroll-eclipsehelpdocbooktrue
scroll-epubeclipsehelptrue
scroll-htmlepubtrue
Panel
titleSommaire

Table of Contents
stylenone

Contexte

Nous avons fait le choix que le statut de ce modèle check reste en OK il ne passera pas en Warning ou en Critical. Les métriques supervisées par ce modèle  ne sont pas bloquantes pour le bon fonctionnement du serveur web IIS.

Créer de nouveaux checks et commandes

Vous pouvez cloner les commandes , checks et le modèle d'hôte apporté par le pack IIS et modifier les clones voici des pages de doc à ce sujet :

Les différents arguments personnalisable

Les commandes utilisées pour superviser un serveur web IIS possèdent différents arguments dont la personnalisation par des données n'est pas possible étant utile que dans des cas particuliers et pouvant amener à des confusions, les voici :

  • -a : Le nom de l'instance du serveur web pour lequel on veut voir les statistiques. Utilisez _Total pour les statistiques totales de tous les sites web. (Par défaut Shinken utilise _Total), sinon pour monitorer un serveur web particulier, entrez son nom.

Il existe aussi différents arguments que nous n'utilisons pas et qui peuvent vous être utile en fonction des cas d'utilisation, les voici : 

  • -y : DELAY (optionnel) spécifie le nombre de secondes sur lequel l'utilisation est calculée. Plus le délai est long, plus le calcul sera précis. Vous pouvez également avoir besoin d'utiliser le paramètre -t pour définir un délai de script plus long si vous définissez un valeur supérieur à 15 sec. Valable uniquement si vous spécifiez également --nokeepstate, c'est-à-dire si vous n'utilisez pas la fonction de conservation de l'état. La valeur par défaut est 5. Les métriques utilisant le DELAY sont celles ayant "PerSec" dans leurs noms.
  • -t :  spécifie le nombre de secondes avant que le script ne s'arrête. Certaines requêtes WMI prennent plus de temps que d'autres et les liens réseau avec une latence élevée peuvent également nécessiter une augmentation de la valeur par défaut de 15. 
  • -w :  Définis à qu'elle valeur le check passe en Warning, pour chacune des commandes de supervision d'un serveur web IIS une métrique par défaut est supervisé, voir la suite de la doc , vous pouvez personnalisé la métrique supervisée avec -w METRIQUE=VALUE, METRIQUE étant le nom de la métrique à superviser et VALUE la valeur à laquelle le check passe en Warning 
  • -c :  Définis à qu'elle valeur le check passe en Crtitique, pour chacune des commandes de supervision d'un serveur web IIS une métrique par défaut est supervisé, voir la suite de la doc , vous pouvez personnalisé la métrique supervisée avec -c METRIQUE=VALUE, METRIQUE étant le nom de la métrique à superviser et VALUE la valeur à laquelle le check passe en Critique
  • --nokeepstate : Permets de conserver l'état, le check va créer un fichier dans /Tmp pour conserver l'état des métriques et faire une moyenne lors des prochains appelés, cela permet d'avoir une moyenne plus précise. Mais nous ne vous recommandons pas de conserver l'état et donc de ne pas utiliser --nokeepstate lorsque  vous utilisez plusieurs Pollers, les pollers ne partageant pas leurs /tmp.

Les métriques supervisé par défauts

Pour chacune des commandes de supervision d'un serveur web IIS une métrique par défaut est supervisé les voici : Check NameMétriques supervisé par défautConnections
CurrentConnections
Errors
_NotFoundErrorsPersec
RequestsActivity
_GetRequestsPersec
TransfertsActivity
_BytesTotalPersec
Users
_LogonAttemptsPersec

Exemple

Création d'une nouvelle commande

Voici un exemple pour une modification de la commandes "Connections", le procédé reste le même pour toutes les autres commandes.

Nous vous conseillons de créer un clone de la commande plutôt que de modifier directement la commande, cela vous éviteras d'avoir des "Différence" dans le Staging

Sélection de la commande que vous voulez modifier :

Panel

Image Removed

Clone de la commande : 

Panel

Image Removed

Contenue de la page d'édition de la commande :

Panel

Image Removed

Ici nous allons modifier le contenue de la commande, pour plus d'informations concernant le reste des éléments de cette page pouvez lire cette page Les commandes.

Nous voulons que notre commande puisse passer en warning :

Panel

Image Removed

On ajoute l'argument -w pour que le check puisse passer en Warning, ainsi qu'une donnée "_HOSTIIS_CONNECTIONS_WARN" pour pouvoir définir à quel seuil le check passe en Warning.

Info

Lors de la création d'une nouvelle donnée toujours ajouter _HOST devant le nom de votre donnée.

Comme expliqué plus dans plus haut le warning ne se feras que sur une seule métrique, ici "CurrentConnections", le check connections contient aussi une métrique _ConnectionAttemptsPerSec. Si nous voulez superviser la métrique _ConnectionAttemptsPerSec plutot que la métrique CurrentConnections nous pouvons le spécifier dans notre commande avec "METRIQUE=VALUE", ici "_ConnectionAttemptsPerSec="$_HOSTIIS_CONNECTIONS_WARN$"

Panel

Image Removed

Ce modèle n'ajoute pas de check sur un hôte :

  • Il n'est utile que pour définir un modèle commun qui contient les données nécessaires pour l'utilisation du modèle iis.
    • C'est pour cela que ce model n'est visible que pour les admins Shinken.

Les données

Les données communes pour tous les checks

Il s'agit de l'ensemble de données pour se connecter à une machine Windows ( serveur ou client ).

Excerpt
NomModifiable surDéfautValeur par défaut à l'installation de ShinkenDescription
No Format
DOMAINUSERSHORT

l'Hôte

( Onglet Données )

$DOMAINUSERSHORT$ shinken_user Nom d'utilisateur utilisé, sans le domaine.
No Format
DOMAINPASSWORD

l'Hôte

( Onglet Données )

$DOMAINPASSWORD$ superpassword Mot de passe de l'utilisateur.
No Format
DOMAIN

l'Hôte

( Onglet Données )

$DOMAIN$ MYDOMAIN

Nom du domaine Active Directory du compte. Si vide, alors c'est le domaine du serveur qui sera utilisé, ou un compte local s'il n'est pas dans un domaine Active Directory.

No Format
DOMAINUSER

l'Hôte

( Onglet Données )

$_HOSTDOMAIN$\\
$_HOSTDOMAINUSERSHORT$
MYDOMAIN\\shinken_user

Nom complet utilisé pour se connecter, il faut par défaut DOMAINE\DOMAINUSERSHORT.

  • À n'utiliser que si vous ne souhaitez pas utiliser les variables DOMAINUSERSHORT et DOMAIN, et que votre connexion se fait sur un autre format que Domaine/utilisateur.


No Format
WINDOWS_SECURITY
_MECANISMS

l'Hôte

( Onglet Données )

integrity integrity

Niveau de sécurité utilisé pour se connecter sur le serveur Windows :

  • integrity : ( par défaut ) valeur de sécurité élevée
  • connect: valeur de sécurité faible, qui sera bloquée sur les serveurs Windows à partir de mi-2022 ( voir la page l'article de microsoft sur le sujet ), à partir des serveurs windows 2008.
    • Cette valeur ne doit être utilisée que sur de vieux serveurs qui ne gèrent pas les connexions au niveau integrity.


Les données spécifiques

Pas de données spécifiques pour ce modèle

Les données DFE ( Duplicate Foreach )

Pas de données DFE pour ce modèle

Création d'un nouveau modèle d'hôte 

Nous allons créer un nouveau modèle d'hôte :

Panel

Image Removed

Notre modèle va hériter du modèle Windows-base pour que notre modèle est accès aux données nécessaires au bon fonctionnement des checks

Création d'un nouveau check appliqué aux modèle d'hôtes

Nous allons créer un nouveau check utilisant notre commande, nous allons copier notre check Connections

Panel

Image Removed

Voici la page d'édition de votre check

Panel

Image Removed

  • 1 : Si vous avez apporté des modifications au Modèle de Check iis-service vous pouvez le conserver, sinon créer votre propre modèle de check ou simplement utilisé le modèle generic-service 
  • 2 : Ici vous s