Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Make by tools (01.00.01) - action=clean_corrupted_html
Panel
titleSommaire

Table of Contents
stylenone

Contexte

Le check check Global Backend Status by SSH permet d'obtenir une vue synthétique et globale des backends de votre HAproxy. permet de vérifier l'état de fonctionnement des backends.

Il remonte, pour chacun d'entre eux, les informations générales de fonctionnement au moment de la vérification.


En fonction de sa configuration, un backend dispose de un ou plusieurs endpoints. Les endpoints sont les serveurs applicatifs (serveur WEB, applications internes, etc ... ) vers lesquels sont redirigés les utilisateurs transitant par ce backend. Plusieurs endpoints par backends permettent à HA Proxy de faire de la répartition de charges, en répartissant les utilisateurs sur les différents serveurs disponibles.

Dans le cas où un endpoint n'est plus disponibles, l'ensemble des sessions gérées par celui-ci seront réparties entre les autres toujours disponibles. Cela peut causer :

  • De la latence
  • Des erreurs applicatives
  • Une indisponibilité du service


Ce check permet donc :

  • De repérer rapidement un backend incomplet
  • D'avertir en cas d'erreur

Pour résumer, ce check est un indicateur clé pour assurer que la partie applicative est bien opérationnelle.

Panel

Image Added

Panel

Image Removed

Paramétrage

Le check utilise la ligne de commande suivante :

Code Block
languagebash
themeEmacs
$SHINKEN$GLOBAL_HAPROXY-BY-SSH_SHINKEN_PLUGINSDIR$/check_haproxy_SSH.py
        
	-H "$HOSTADDRESS$"
        
	-u "$_HOSTHAPROXY-BY-SSH__SSH-USER$"
        
	-k "$_HOSTHAPROXY-BY-SSH__SSH-KEY$"
        
	-x "$_HOSTHAPROXY-BY-SSH__SSH-PASSPHRASE$"
        
	-p "$_HOSTHAPROXY-BY-SSH__SSH-PORT$"
        
	--mode global_backend_status
        
	-w "$_HOSTHAPROXY-BY-SSH__ENDPOINTGLOBAL-AVAILABILITYBACKEND__ENDPOINT-AVAILABILITY-WARN$
       ;$_HOSTHAPROXY-BY-SSH__SESSIONS-USAGE__SESSIONS-USAGE-WARN$
       ;$_HOSTHAPROXY-BY-SSH__AVERAGE-LATENCY__AVERAGE-LATENCY-WARN$"
       -" 
	-c "$_HOSTHAPROXY-BY-SSH__ENDPOINTGLOBAL-AVAILABILITYBACKEND__ENDPOINT-AVAILABILITY-CRIT$
       ;$_HOSTHAPROXY-BY-SSH__SESSIONS-USAGE__SESSIONS-USAGE-CRIT$
       ;" 
	-e "$_HOSTHAPROXY-BY-SSH__AVERAGE-LATENCY__AVERAGE-LATENCY-CRIT$INCLUDE-MAINTENANCE$"

Données utilisées provenant du modèle

Données communes pour les checks des modèles

Authentification

Excerpt Include
NEW_PAGE - SPAC-55 - Modèle HAproxy-by-SSHNEW_PAGE - SPAC-55 - __base__shinken
Modèle HAproxy-by-SSH__base__shinken
nopaneltrue

Données spécifiques pour ce check

Donnée
NomModifiable surUnitéDéfautValeur par défaut à l'installation de ShinkenDescription
No Format
HAPROXY-BY-SSH__
ENDPOINT-AVAILABILITY
BACKEND__ENDPOINT-AVAILABILITY-
WARN
CRIT

l'Hôte

( Onglet Données )

%

-

2Définit le nombre de serveurs endpoint présent par backend à partir duquel le check passe en ATTENTION

50

50

Un backend peut posséder plusieurs endpoint pour répartir la charge. Si certains endpoints ne sont pas fonctionnels, la charge va se concentrer sur les endpoints restants.

Cette donnée permet de définir à partir de combien de endpoints injoignables en pourcentage par rapport au nombre total de endpoint, le check doit passer en CRITIQUE.

No Format
HAPROXY-BY-SSH__
ENDPOINT-AVAILABILITY
BACKEND__ENDPOINT-AVAILABILITY-
CRIT
WARN

l'Hôte

( Onglet Données )

-

1Définit le nombre de serveurs endpoint présent par backend à partir duquel le check passe en CRITIQUE
%

75

75

Un backend peut posséder plusieurs endpoint pour répartir la charge. Si certains endpoints ne sont pas fonctionnels, la charge va se concentrer sur les endpoints restants.

Cette donnée permet de définir à partir de combien de endpoints injoignables en pourcentage par rapport au nombre total de endpoint, le check doit passer en ATTENTION.

No Format
_HAPROXY-BY-SSH__
SESSIONS-USAGE__SESSIONS-USAGE-CRIT
INCLUDE-MAINTENANCE

l'Hôte

( Onglet Données )

--
%

false

80Définit le nombre de serveurs endpoint présent par backend à partir duquel le check passe en ATTENTION. No Format
false

Dans HA Proxy, un frontend peut être placé dans un état spécial de maintenance pour y effectuer des opérations. Dans cet état, le frontend n'est plus accessible.

Par défaut, ces frontends ne sont pas inclus dans les remontées du check pour éviter les critiques.


Utiliser true dans cette donnée permet de les récupérer malgré tout.

Données DFE ( Duplicate Foreach )

Pas de données DFE pour ce modèle

Données utilisées provenant du check

Pas de données provenant du check pour ce modèle

Excerpt
Section

Données globales

Section
NomModifiable surUnitéDéfautValeur par défaut à l'installationDescription
No Format
USERPLUGINSDIR

Non modifiable

( Sauf Admin Shinken )

--/var/lib/shinken-user/libexec /var/lib/shinken-user/libexec

Chemin absolu contenant les sondes installées par Shinken.

No Format
GLOBAL_HAPROXY-BY-SSH_
_SESSIONS-USAGE__SESSIONS-USAGE-CRIT

l'Hôte

( Onglet Données )

%

95Définit le pourcentage de sessions avant que le check ne passe en CRITIQUE
SHINKEN_VENDOR

Non modifiable

( Sauf Admin Shinken )

--shinken-additional-packs shinken-additional-packs

Dossier fourni par Shinken.

No Format
GLOBAL_HAPROXY-BY-SSH_SHINKEN_PACKNAME

Non modifiable

( Sauf Admin Shinken )


HAproxy-by-SSH__
AVERAGE-LATENCY__AVERAGE-LATENCY-WARN
shinkenHAproxy-by-SSH__shinken

Dossier contenant les sondes.

No Format
GLOBAL_HAPROXY-BY-SSH_SHINKEN_PLUGINSDIR

Non modifiable

( Sauf Admin Shinken )

--
No Format
$USERPLUGINSDIR$/$GLOBAL_HAPROXY-BY-SSH_SHINKEN_VENDOR$/$GLOBAL_

l'Hôte

( Onglet Données )

ms

200Définit le temps de latence avant que le check ne pass en ATTENTION. No Format
HAPROXY-BY-SSH_
_AVERAGE-LATENCY__AVERAGE-LATENCY-CRIT
SHINKEN_PACKNAME$
/var/lib/shinken-user/libexec/shinken-additional-packs/HAproxy-by-SSH__shinken

Chemin absolu du dossier contenant les sondes du pack HAproxy-by-SSH__shinken  ( non modifiable ).

Section

Propriétés de l'hôte

Section
NomModifiable surUnitéDéfautValeur par défautDescription
No Format
HOSTADDRESS

l'Hôte

( Onglet

Données

Général )

ms

500Définit le temps de latence avant que le check ne pass en CRITIQUE.

Données utilisées provenant du check

--

Nom de l'hôte Nom de l'hôte

Adresse de l'hôte

Pas de données spécifiques pour ce check

Résultat

Exemple

Panel

Image RemovedImage Added

Interprétation des données

Statut

  • Il peut prendre

4 valeurs différentes  OK / CRITIQUE / ATTENTION / INCONNU 
  • 3 états  OK / CRITIQUE / ATTENTION .

    • Le statut va dépendre du retour de sonde et de la configuration spécifique du check pour les données suivantes :

      ENDPOINT
      • HAPROXY-
      AVAILABILITY-WARN
      • BY-SSH__BACKEND__ENDPOINT-AVAILABILITY-
      CRIT
      • WARN 
      SESSIONS
      • HAPROXY-
      USAGE-WARNSESSIONS-USAGE
      • BY-SSH__BACKEND__ENDPOINT-AVAILABILITY-CRIT
    • AVERAGE-LATENCY-WARN
    • AVERAGE-LATENCY-CRIT
    Voici un tableau récapitulatif du statut attendu suivant le retour de sonde
    • Ci-dessous, un tableau récapitulatif des différents retours possibles :

Info

Le texte de la colonne  "Affichage des seuils" montre les paramètres utilisés et leur valeur définie sur l'équipement supervisé.

Panel

Image RemovedImage Added

Situation Statut Exemple
  • Le
temps de latence moyen est supérieur ou égale à la valeur de
  • pourcentage de endpoints down pour un backend dépasse la valeur de :
    • HAPROXY-BY-SSH__BACKEND__ENDPOINT-AVAILABILITY
AVERAGE-LATENCY
    • -CRIT

CRITIQUE

PanelImage Removed

Image Added

  • Le
temps de latence moyen est supérieur ou égale à la valeur de AVERAGE-LATENCY-WARN

ATTENTION

Panel

Image Removed

Résultat

  • pourcentage de endpoints down pour un backenddépasse la valeur de :
    • HAPROXY-BY-SSH__BACKEND__ENDPOINT-AVAILABILITY-WARN  

ATTENTION

Image Added

Résultat

Le résultat court affiche, en une ligne, un résumé de l'état des Backends détéctés. Ce retour compact permet de pouvoir visualiser l'information même avec la taille des lignes réduites dans l'interface de visualisationLe résultat contient le statut du check, ainsi que le nombres de backends problématiques.

Résultat long

Le résultat long contient affiche un tableau listant les frontends trouvés avec :

  • L'état de chaque endpoint liée à ce backend.
  • Le taux de connections utilisateurs.
  • La latence moyenne

    regroupant l'ensemble des informations sur les informations détéctées.

    Métriques

    Définition

    Interprétation des métriques

    Nom de la métriqueUnitéDescriptionSeuil d'avertissementSeuil critique
    endpoint
    active_up
    _X
    _pct__(backend)%Retourne le pourcentage de endpoints actuellement disponible par rapport au maximal autorisé par HA Proxy ( Correspond au % affiché dans le résultat du check ).

    HAPROXY-BY-SSH__BACKEND__

    -Nombre de endpoint up par backends.

    ENDPOINT-AVAILABILITY-

    WARN

    WARN 

    ENDPOINT

    HAPROXY-

    AVAILABILITY-CRITsessions_usage_pct_X%Nombre totale de sessions sur tous les frontends

    SESSIONS-USAGE-WARN

    SESSIONS-USAGE-CRIT

    average_latency_XmsTemps de latence de chaque backends.

    AVERAGE-LATENCY-WARN

    AVERAGE-LATENCY-CRIT

    Exemple

    BY-SSH__BACKEND__ENDPOINT-AVAILABILITY-CRIT 

    Exemple


    Image Added


    Erreurs et pré-requis

    Excerpt Include
    Erreurs du pack HAproxy-by-SSH__shinken
    Erreurs du pack HAproxy-by-SSH__shinken
    nopaneltrue

    Image Removed