Santé de la plateforme

Ce que montre la santé de la plateforme

Deux pages répondent à la question « la plateforme va-t-elle bien ? ».

La page Santé donne l'état des processus de la plateforme et de ses files de travail. Elle dit si le canal des agents est servi, si les tâches avancent, et si des tâches sont en échec.

La page Vue d'ensemble donne trois indicateurs de fond : l'état du séquestre des clés, l'état de la sauvegarde de la plateforme, et la version de production de l'agent. Cette page décrit les deux premiers. La carte Version de production est décrite avec le déploiement des mises à jour.

Ces deux pages ne montrent aucune donnée d'un client. Elles ne nomment ni un MSP, ni un endpoint.

Prérequis

• Le rôle Administrateur plateforme, avec une session du portail. Une clé API de MSP et un accès MCP n'atteignent aucune de ces pages. Voir Rôles et droits.
• Un accès au serveur de l'instance pour agir sur un processus arrêté. Le portail lit la santé ; il ne redémarre rien.

Ouvrir la page Santé

1. Connectez-vous au portail avec un compte Administrateur plateforme.
2. Dans la barre du haut, cliquez sur Plateforme.
3. Dans le menu des pages de la plateforme, cliquez sur Santé.

Voir Écrans de la plateforme.

Lire l'en-tête de la page Santé

L'en-tête porte un repère de lecture et une phrase.

• Le repère dit que la page relit les valeurs toutes les 10 secondes. Les processus envoient leur signal au même rythme.
• La phrase donne l'heure de la dernière lecture : « Lu le date. Un processus sans signal depuis 30 s est en retard. ».

Vous n'avez pas besoin de recharger la page. Elle se met à jour seule.

Lire les gateways

La carte Gateways donne les processus qui portent le canal des agents.

1. Lisez la colonne État de chaque ligne.
2. Lisez la colonne Connexions d'agents. Elle donne le nombre d'agents connectés à ce processus.

Colonne	Ce qu'elle donne
Nœud	Le nom du processus.
État	En vie ou En retard.
Dernier signal	La date du dernier signal reçu.
Connexions d'agents	Le nombre d'agents connectés à ce processus.

Quand aucun signal n'arrive, la carte affiche « Aucun signal de gateway. Vérifiez que les gateways tournent. ». Aucun agent ne peut alors recevoir d'ordre.

Lire les workers

La carte Workers donne les processus qui exécutent les tâches des files.

Colonne	Ce qu'elle donne
Worker	Le nom du processus.
État	En vie ou En retard.
Dernier signal	La date du dernier signal reçu.
Tâches en cours	Le nombre de tâches traitées en ce moment par ce processus, toutes files comprises.

Quand aucun signal n'arrive, la carte affiche « Aucun signal de worker. Vérifiez que les workers tournent. ». Les sauvegardes planifiées, les restaurations et les mises à jour n'avancent alors plus.

Lire les files

La carte Files donne une ligne par file de travail.

Colonne	Ce qu'elle donne
File	Le nom de la file.
En attente	Les tâches prêtes, qui attendent un worker libre.
En cours	Les tâches prises par un worker.
Différées	Les tâches programmées pour plus tard.
En échec	Les tâches qui ont échoué et qui sont gardées dans la file.

Un nombre En échec supérieur à zéro s'affiche en rouge.

Quand aucune file n'est trouvée, la carte affiche « Aucune file trouvée. Vérifiez que les workers tournent. ».

Traiter un indicateur en alerte

1. Lisez l'état de chaque carte, de haut en bas.
2. Pour une ligne En retard, ouvrez le serveur de l'instance et vérifiez le processus de ce nom. Un processus sans signal depuis 30 secondes est peut-être arrêté. Les tâches qu'il tenait n'avancent plus.
3. Pour une carte vide, vérifiez que les processus de ce type tournent sur le serveur.
4. Pour un nombre En attente qui monte sans redescendre, vérifiez l'état des workers. Trop peu de workers en vie retarde toutes les tâches.
5. Pour un nombre En échec supérieur à zéro, lisez les journaux des workers sur le serveur de l'instance. La page Santé donne le compteur, pas la cause.

Un processus sans signal pendant 24 heures sort de la liste. Une carte vide ne veut donc pas dire que le processus n'a jamais tourné.

Lire l'état du séquestre des clés

Le séquestre des clés est la copie des clés des dépôts. Sans ces clés, les sauvegardes des clients ne sont plus lisibles.

1. Ouvrez Plateforme, puis Vue d'ensemble.
2. Lisez la carte Séquestre des clés. Elle porte un bloc Sauvegarde de la plateforme et un bloc Export hors ligne, chacun avec son état.

La page Séquestre des clés décrit chaque état, l'export des clés et la restauration sans la plateforme. Lisez-la avant de mettre l'instance en production.

Lire l'état de la sauvegarde de la plateforme

La sauvegarde de la plateforme porte la base de données, les secrets et les clés des dépôts de l'instance. Un worker l'envoie dans le bucket de sauvegarde.

1. Ouvrez Plateforme, puis Vue d'ensemble.
2. Lisez la carte Sauvegarde de la plateforme.
3. Lisez l'état : À jour ou En danger. Avec En danger, la carte écrit la cause à côté de l'état.
4. Lisez Dernière sauvegarde réussie. Sans aucune sauvegarde réussie : « Jamais ».
5. Lisez Contrôles du bucket de sauvegarde. Sans aucun avertissement, la carte affiche « Le bucket de sauvegarde suit la configuration recommandée. ».

Quand la sauvegarde automatique est coupée dans la configuration de l'instance, la carte affiche seulement « La sauvegarde automatique de la plateforme est désactivée (BACKUP_ENABLED=false). ».

Causes de l'état « En danger »

Phrase de la carte	Ce qu'il faut faire
« La sauvegarde automatique de la plateforme est activée, mais aucun bucket de sauvegarde n'est configuré […] »	Réglez le bucket de sauvegarde dans la configuration de l'instance.
« La plateforme n'a encore jamais été sauvegardée. La première sauvegarde démarre quelques minutes après le démarrage du worker. »	Attendez quelques minutes, puis relisez la carte. Si rien ne change, vérifiez les workers sur la page Santé.
« La dernière sauvegarde de la plateforme a échoué. »	Lisez le message d'erreur donné sous la phrase, puis corrigez la cause.
« La dernière sauvegarde réussie de la plateforme date du date (il y a plus de n h). »	Vérifiez le worker de sauvegarde et l'accès au bucket de sauvegarde.

Ces mêmes phrases s'affichent dans le bandeau La plateforme est en danger, en haut de chaque page du portail, pour un administrateur de la plateforme seulement.

Contrôles du bucket de sauvegarde

Avertissement	Ce qu'il veut dire
« Le bucket de sauvegarde n'a pas d'Object Lock : une archive peut être supprimée ou remplacée. »	Activez l'Object Lock sur le bucket de sauvegarde.
« Le bucket de sauvegarde n'a pas de règle de cycle de vie : les anciennes archives ne sont jamais supprimées. »	Posez une règle de cycle de vie, ou acceptez la croissance du bucket.
« Les identifiants de sauvegarde peuvent lister le bucket : des identifiants en écriture seule sont recommandés. »	Donnez au worker des identifiants en écriture seule.
« Le bucket de sauvegarde est sur le même endpoint S3 que les données des clients : utilisez un autre compte ou un autre fournisseur. »	Déplacez la sauvegarde de la plateforme sur un autre compte S3. Voir Instance on-prem.

Un avertissement n'arrête pas la sauvegarde. Il signale un risque sur la destination.

Limites et précautions

• La page Santé est une lecture seule. Elle ne redémarre aucun processus et elle ne relance aucune tâche.
• Les valeurs de la page Santé ne sont pas gardées. La page donne l'état du moment, sans historique.
• Un processus En vie répond aux signaux. Cela ne veut pas dire que chaque tâche réussit. Suivez les tâches d'un MSP depuis son tableau de bord. Voir Superviser.
• Un gateway En retard ne sert plus les agents comptés sur sa ligne. Sa colonne Connexions d'agents donne le nombre d'agents concernés au dernier signal.
• La carte Sauvegarde de la plateforme ne lance pas de sauvegarde. La sauvegarde manuelle de l'instance se fait sur le serveur.
• Gardez la phrase secrète de la sauvegarde de la plateforme dans un gestionnaire de mots de passe. Sans elle, la sauvegarde ne peut pas être ouverte. Voir Séquestre des clés.
• La santé de la plateforme et la sauvegarde de la plateforme n'envoient aucun email. Le bandeau du portail et ces deux pages sont les seuls signaux. Ces pages ne remplacent pas une supervision externe du serveur.