Vues

bext-tui est organisé en 11 vues de niveau supérieur, chacune axée sur un aspect de l'exécution d'une instance bext. Basculez entre eux avec la barre d'onglets en haut, avec les raccourcis 1 – 9, avec l'accord g ( gd = tableau de bord, gs = sites, gr = requêtes, gt = TLS, etc.), ou via la palette de commandes.

Tableau de bord#

La vue de la maison. Ouvrir avec 1 ou gd.

Une mise en page à quatre panneaux :

• Santé de la plateforme — points colorés pour le serveur, le cache, les nœuds de calcul, la licence et la disponibilité
• Métriques — lignes sparkline étiquetées pour le taux de requêtes et la latence moyenne (60 derniers échantillons)
• Statistiques rapides — totaux pour les sites, les entrées de cache, les demandes, les erreurs, les travailleurs, les certificats
• Meilleurs sites — classement des sites par taux de requêtes
• Événements récents — 10 dernières demandes avec coloration du code d'état

Les données du tableau de bord sont actualisées au niveau d'interrogation rapide (2 s par défaut).

Sites#

Ouvrir avec 2 ou gs. Vue en liste de chaque site desservi par bext. Colonnes :

Appuyez sur Enter sur une ligne pour accéder à la vue détaillée, qui comporte cinq onglets (cycle avec h / l ) :

• Informations — nom, framework, version, disponibilité, liste complète des domaines
• Métriques — taux de requêtes, accès au cache, statistiques de latence étendue
• déploie — historique de déploiement filtré sur ce site
• Journaux — requêtes récentes filtrées vers les domaines de ce site
• Travailleurs — travailleurs attachés à ce site

Esc réduit la vue détaillée à la liste. Appuyez sur d pour déployer, r pour restaurer, e pour modifier les variables d'environnement.

Demandes#

Ouvrir avec 3 ou gr. Un journal des requêtes à défilement en direct : votre tail -f pour le trafic HTTP.

Colonnes : horodatage, méthode, chemin, statut, durée, statut du cache, hôte. Les codes d'état sont codés par couleur (2xx vert, 3xx cyan, 4xx jaune, 5xx rouge gras). L'état du cache utilise HIT vert / STALE bleu / MISS jaune / BYPASS faible.

Contrôles :

• Space — mettre en pause/reprendre le flux en direct (le décompte continue mais les lignes se figent)
• / — filtre sur le chemin, l'hôte ou le code d'état. Le filtre est interprété comme une expression régulière insensible à la casse lors de la compilation, et revient à la correspondance de sous-chaîne dans le cas contraire. Le mode actif est affiché dans la barre de saisie ( (regex) ou (substring) ).
• Enter — ouvre une fenêtre contextuelle de détail pour la ligne sélectionnée (méthode complète, statut, timing, en-têtes)
• Esc — fermez la fenêtre contextuelle de détail ou effacez le filtre

La source de données est le /__bext/admin/ws/logs WebSocket si disponible, sinon le /__bext/admin/api/requests interrogé. Le TUI met en mémoire tampon jusqu'à 2 048 entrées côté client.

Cache#

Ouvrir avec 4 ou gc. Deux panneaux :

• Présentation du cache — Entrées ISR, verrous de bousculade, taux de réussite, taux d'échecs, mémoire
• Compteur de taux de réussite — barre d'utilisation à code couleur (vert > 60 % > jaune > 85 % > rouge)

Actes:

• p — purger tout (avec confirmation)
• P — purge par modèle (ouvre une entrée — prend en charge glob)
• w — préchauffe le cache (met en file d'attente un rendu de chaque itinéraire connu)

Les actions de purge sont confirmées avant le tir. La purge de modèle accepte un chemin global comme /api/* ou /blog/2025-*.

Ouvriers#

Ouvrir avec 5 ou gw. Tableau de chaque travailleur sur chaque runtime (V8, Bun, PHP, plugins).

Colonnes : type, ID, PID, mémoire, demandes traitées, statut, disponibilité.

Actes:

• r : redémarrez le travailleur sélectionné (redémarrage d'un seul travailleur, pas de confirmation)
• R — redémarrez tous les travailleurs du type sélectionné (confirmé — draine d'abord les demandes en cours)

Les redémarrages des travailleurs se font en douceur : les demandes en cours se terminent avant que le travailleur ne soit remplacé.

TLS#

Ouvrir avec 6 ou gt. Inventaire des certificats.

Colonnes : domaine, émetteur, validité jusqu'à, jours restants, type de clé, statut OCSP. La cellule « jours restants » est codée par couleur :

• Vert : > 30 jours
• Jaune : 10 à 30 jours
• Rouge : < 10 jours

Actes:

• r — forcer le renouvellement du certificat sélectionné
• p — provisionner un nouveau certificat (ouvre l'entrée de domaine)
• Enter : affiche la chaîne complète, l'empreinte digitale et les SAN

Procuration#

Ouvrir avec 7 ou gp. Surveillance de la santé en amont.

Colonnes : nom, adresse, état, connexions actives, taux de requêtes, latence, % d'erreur, état du disjoncteur. Les statuts et les états du disjoncteur sont codés par couleur.

Actes:

• h — forcer une vérification de l'état dès maintenant
• d : vidangez l'amont (suppression progressive - termine les requêtes en cours, puis supprime du pool)
• Enter — ouvre les détails en amont avec l'histogramme de latence et le journal des erreurs récentes

WAF#

Ouvrir avec 8 ou gf. Surveillance du pare-feu d'applications Web.

Trois panneaux récapitulatifs en haut :

• Total bloqué / 24h bloqué
• Principales règles par nombre d'accès
• Principales adresses IP bloquées

Ci-dessous : table de règles avec ID, nom, indicateur activé, action, nombre d'accès.

Actes:

• e — activer/désactiver la règle sélectionnée
• Enter — afficher le modèle de règle et les correspondances récentes

Déployer#

Ouvrir avec 9 ou gy. Calendrier de déploiement sur tous les sites.

Colonnes : horodatage, site, version, statut, durée, déclenché par. Couleurs d'état : vert pour succès, rouge pour échec, jaune pour en cours.

Actes:

• d — déployer le site sélectionné (dernier commit)
• r : restaurer le déploiement sélectionné
• p — promouvoir un canari à l'écurie

Tous les trois sont confirmés.

Journaux#

Ouvrir avec gl. Visionneuse de journaux consultable soutenue par le magasin de journaux bext ( SQLite ).

• / — recherche dans tous les journaux stockés (texte intégral)
• Sélecteur de plage horaire en haut : 1h / 6h / 24h / 7j / personnalisé
• Enter sur une ligne affiche l'entrée de journal structurée complète avec le corps JSON

La vue Journaux est le bon endroit pour rechercher des événements historiques : la vue Requêtes affiche uniquement le trafic en direct et les anciennes entrées défilent hors du tampon.

Configuration#

Ouvrir avec go. Visionneuse en lecture seule pour le bext.config.toml analysé.

Actes:

• r — rechargez à chaud la configuration (confirmé — exécute d'abord la validation, refuse de l'appliquer si elle n'est pas valide)
• v — réexécuter la validation uniquement

Le texte de configuration est extrait de /__bext/admin/api/config en mode distant ou lu directement à partir du disque en mode local.

Tutoriels#

Procédures pas à pas guidées interactives intégrées à la base de code TUI. Ils ne sont pas encore connectés à une vue navigable ou à une combinaison de touches : le contenu ci-dessous sera livré une fois que la vue Tutoriels sera exposée dans une prochaine version.

Quatre tutoriels sont prévus :

Chaque didacticiel est une procédure pas à pas scriptée qui montre la commande à exécuter et un indice. Navigation:

• j / k — parcourez la liste des didacticiels
• Enter : sélectionnez un didacticiel ou passez à l'étape suivante
• Backspace — passer à l'étape précédente
• Esc — retour à la liste des didacticiels

La vue du didacticiel est conçue pour une intégration au terminal d'abord : les nouveaux utilisateurs peuvent apprendre entièrement bext à partir de la TUI sans passer à un navigateur.

Aide#

Appuyez sur ? depuis n’importe quelle vue pour superposer une feuille d’aide contextuelle affichant toutes les combinaisons de touches actives dans la vue actuelle. Appuyez à nouveau sur ? ou sur Esc pour fermer.

En rapport#

• Raccourcis clavier TUI — référence complète du clavier pour chaque vue
• Palette de commandes TUI — actions de recherche floue sans mémoriser les clés
• Modes de connexion TUI — comment se connecter avant de parcourir les vues
• Guides → Mise en cache — arrière-plan sur les statistiques ISR affichées par la vue Cache
• Opérations → Surveillance — contexte pour les métriques et les vues de journaux