Contexte

Le check $KEY$ Frontend Traffic by SSH permet de superviser l’activité réseau d’un frontend HAProxy.

Il collecte et analyse différents indicateurs de trafic afin de suivre l’utilisation du frontend et de détecter rapidement une anomalie ou une surcharge de celui-ci.


En fonction de l’activité des utilisateurs et des applications publiées, un frontend peut générer une charge réseau importante. Une évolution inhabituelle des métriques de trafic peut révéler :

  • Une surcharge de connexions utilisateurs
  • Une consommation réseau anormale
  • Une attaque DDoS ou un trafic malveillant
  • Un dysfonctionnement applicatif provoquant une hausse des requêtes
  • Une saturation progressive des ressources du frontend.


Ce check permet donc :

  • De surveiller le trafic entrant et sortant du frontend
  • De suivre le taux de requêtes et de connexions actives
  • D’estimer le nombre d’utilisateurs actuellement connectés
  • D’identifier rapidement une montée en charge inhabituelle

Pour résumer, ce check est un indicateur clé pour assurer le bon fonctionnement et la stabilité du trafic applicatif exposé par HAProxy.

Paramétrage

Le check utilise la ligne de commande suivante :

$SHINKEN_HAPROXY-BY-SSH_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 frontend_status
-w "$_HOSTHAPROXY-BY-SSH__SESSIONS-USAGE__SESSIONS-USAGE-WARN$
;$_HOSTHAPROXY-BY-SSH__WAITING-REQUESTS__WAITING-REQUESTS-WARN$"
-c "$_HOSTHAPROXY-BY-SSH__SESSIONS-USAGE__SESSIONS-USAGE-CRIT$
;$_HOSTHAPROXY-BY-SSH__WAITING-REQUESTS__WAITING-REQUESTS-CRIT$"
-n "$ARG1$

Données utilisées provenant du modèle

Données communes pour les checks des modèles

Authentification

Données spécifiques pour ce check

DonnéeModifiable surUnitéValeur par défautDescription
HAPROXY-BY-SSH__SESSIONS-USAGE__SESSIONS-USAGE-WARN

l'Hôte

( Onglet Données )

%

80Définit le nombre de sessions simultanées à partir duquel le check passe en ATTENTION.
HAPROXY-BY-SSH__SESSIONS-USAGE__SESSIONS-USAGE-WARN

l'Hôte

( Onglet Données )

%

95Définit le nombre de sessions simultanées à partir duquel le check passe en CRITIQUE.
HAPROXY-BY-SSH__WAITING-REQUESTS__WAITING-REQUESTS-WARN

l'Hôte

( Onglet Données )

-

200Définit le nombre de requêtes en attente à partir duquel le check passe en ATTENTION.
HAPROXY-BY-SSH__WAITING-REQUESTS__WAITING-REQUESTS-CRIT

l'Hôte

( Onglet Données )

-

1000Définit le nombre de requêtes en attente à partir duquel le check passe en CRITIQUE.

Les données DFE (Duplicate Foreach)


Nom

Unité

Description

Seuil d'avertissement

Seuil critique

HAPROXY-BY-SSH__FRONTENDS

--Définit une paire KEY$(VALUE)$, la KEY correspond à la description du frontend à vérifier et la VALUE au nom du processus.--


Données utilisées provenant du check

Pas de données spécifiques pour ce check

Résultat

Exemple

Interprétation des données

Statut

Il peut prendre 4 valeurs différentes  OK / CRITIQUE / ATTENTION / INCONNU .

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

    • WAITING-REQUESTS-WARN
    • WAITING-REQUESTS-CRIT
    • SESSIONS-USAGE-WARN
    • SESSIONS-USAGE-CRIT
  • Voici un tableau récapitulatif du statut attendu suivant le retour de sonde :

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

Situation

Statut

Exemple

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

CRITIQUE

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

ATTENTION

Résultat

Le résultat contient le statut du check.

Résultat long

Le résultat long contient un tableau listant

  • Le status du frontend ( OPEN, CLOSED, FULL ).
  • Le nombre de sessions en cours.
  • Le nombre de requêtes en attentes.
  • Un tableau récapitulatif des erreurs HTTP reçu par le frontend.

Métriques

Définition

Nom de la métriqueUnitéDescriptionSeuil d'avertissementSeuil critique
sessions_pct_X%Nombre totale de sessions sur le frontend

SESSIONS-USAGE-WARN

SESSIONS-USAGE-CRIT

queue_X-Nombre de requêtes en attentes.

WAITING-REQUESTS-WARN

WAITING-REQUESTS-CRIT

Exemple