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__ERROR-RATE__ERROR-RATE-WARN$"
       " 
	-c "$_HOSTHAPROXY-BY-SSH__ENDPOINTGLOBAL-AVAILABILITYBACKEND__ENDPOINT-AVAILABILITY-CRIT$;" 
	-e "$_HOSTHAPROXY-BY-SSH__ERROR-RATE__ERROR-RATE-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 )

%

50

-

2Définit le nombre de serveurs endpoint présent par backend à partir duquel le check passe en ATTENTION
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__
ERROR-RATE__ERROR-RATE-WARN
INCLUDE-MAINTENANCE

l'Hôte

( Onglet Données )

%

30Définit le pourcentage d'erreurs de tous types avant que le check ne passe en ATTENTION. No Format
--

false

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_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__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_HAPROXY-BY-SSH_
_ERROR-RATE__ERROR-RATE-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 )

%

50Définit le pourcentage d'erreurs de tous types avant que le check ne passe 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 
      ERROR
      • HAPROXY-
      RATE-WARNERROR-RATE
      • BY-SSH__BACKEND__ENDPOINT-AVAILABILITY-CRIT
    Voici
    • Ci-dessous, un tableau récapitulatif

    du statut attendu suivant le retour de sonde
    • 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
La quantité de sessions simultanées est supérieur ou égale à la valeur de
  • Le pourcentage de endpoints down pour un backend dépasse la valeur de :
    • HAPROXY-BY-SSH__BACKEND__ENDPOINT-AVAILABILITY
SESSIONS
    • -CRIT

CRITIQUE

panel

Image Added

  • La quantité de sessions simultanées est supérieur ou égale à la valeur de SESSIONS-WARN

ATTENTION

panel
  • Le 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 contient le statut du check, ainsi que le nombres de backends problématiquescourt 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 visualisation.

Résultat long

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

  • Le taux d'usage des sessions du frontend en fonction du nombre maximale définie dans le fichier de configuration de HAproxy.
  • Le nombre de sessions en cours.
  • Le nombre maximale de sessions définie dans le fichier de configuration de HAproxy.

Métriques

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

Métriques

Interprétation des métriques

Définition

Nom de la métriqueUnitéDescriptionSeuil d'avertissementSeuil critique
sessions_usage
active_up_pct__(backend)%
Nombre totale de sessions sur tous les frontends

SESSIONS-WARN

SESSIONS-CRIT

sessions_total-Nombre totale de sessions sur tous les frontends

SESSIONS-WARN

SESSIONS-CRIT

Exemple

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__ENDPOINT-AVAILABILITY-WARN 

HAPROXY-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

panel