HYPHApar S33D
Documentation › Alerter et agir

Explication des pannes et réparation d'un clic

HYPHA dit ce qui se passe, la cause probable et ses preuves, le correctif. Quand le correctif est un geste connu, il le propose : un humain le valide, l'agent l'exécute.

Une alerte expliquée, une réparation proposée · 27 s
Ce que montre la vidéo
  1. La vue Problèmes : quatre alertes en cours, classées par priorité.
  2. Le bouton Expliquer de l'alerte « Unité systemd en échec » : shop-worker.service sur web-01.
  3. Le panneau d'explication : le service tué par le manque de mémoire, les lignes de journal qui le prouvent, le correctif. L'attente de l'analyse est coupée.
  4. Le geste proposé, « Redémarrer shop-worker.service sur web-01 », à valider d'un clic.

Expliquer

Le bouton Expliquer figure sur une alerte (vue Problèmes, vue d'ensemble, moniteurs), sur la fiche d'un hôte, sur le détail d'une ligne de journal, sur une trace et sur une erreur applicative.

HYPHA rassemble alors, dans l'espace et pour l'objet concerné :

Le modèle répond en quatre parties : Ce qui se passe, Cause probable (avec ses preuves : une ligne de journal, une valeur mesurée), Correctif (les commandes pour le système de l'hôte), Éviter la récidive. Il ne doit rien inventer ; si les éléments manquent, il le dit et indique quoi vérifier. Le panneau donne aussi le modèle utilisé, la durée et le contexte lu.

Où tourne le modèle

Limite : 60 explications par heure et par espace ; le nombre mensuel dépend de la formule (voir les tarifs).

Réparer d'un clic

HYPHA relit la partie Correctif. S'il y trouve un geste qu'il connaît (systemctl restart|start|stop <unité>, Restart-Service <service>, service <nom> restart), il le propose sous forme de bouton, par exemple « Redémarrer shop-worker.service sur web-01 », à deux conditions : l'agent de l'hôte accepte ce geste, et l'unité ou le service existe sur l'hôte.

  1. Un clic ouvre une confirmation : geste, hôte, raison.
  2. Si vous êtes administrateur, l'action est créée et approuvée d'un même geste. Sinon, elle attend l'approbation d'un administrateur dans Réglages › Actions.
  3. L'agent la reçoit par son canal de contrôle, vérifie qu'elle est permise, l'exécute, puis rend le code de sortie et la sortie.
  4. Le suivi est en direct : en attente, envoyée, en cours, réussie ou échouée. L'agent renvoie aussitôt l'état de l'unité.

Une action non approuvée expire après une heure ; une action approuvée que l'agent n'a pas prise expire après 10 minutes. Tout passe au journal d'audit.

Ce que l'agent accepte

Les actions sont coupées par défaut. Sur chaque hôte, vous décidez :

actions:
  enabled: true
  allow: [restart_service, start_service]        # gestes permis
  services: ["nginx*", "shop-*"]                 # unités ou services visés
  deny_services: ["sshd*", "ssh*", "hypha-agent*", "systemd-*"]
  scripts:
    vider-cache: /etc/hypha/scripts/vider-cache.sh
  timeout: 120s

Une action se propose aussi à la main, par le formulaire de proposition (geste, unité ou script, raison) ou par l'API. L'historique et les actions en attente sont dans Réglages › Actions.

Mise à jour : 19 novembre 2026