Suivre une tâche de sauvegarde

Ce que fait la fiche d'une tâche

Chaque fois que BaaStide exécute un travail sur une machine, il crée une tâche. Une sauvegarde, une sauvegarde d'image, une mise à jour d'agent et une opération de maintenance du dépôt sont des tâches.

La fiche d'une tâche dit ce que la tâche a fait, combien de temps elle a pris, et ce qu'elle a produit. Quand la tâche n'a pas réussi, la fiche ouvre sur la cause, en une phrase, avec l'action à mener. Elle porte aussi le journal envoyé par l'agent.

Tant que la tâche est active, la fiche se met à jour toute seule, sans que vous rechargiez la page.

Prérequis

• Le rôle Lecture seule, Technicien, Administrateur ou Administrateur plateforme pour lire une tâche et son journal. Voir Rôles et droits.
• Le rôle Technicien ou Administrateur pour annuler une sauvegarde ou pour la relancer.
• Une machine qui porte un agent. Un tenant Microsoft 365 n'a pas de tâche de ce type : ses sauvegardes ont leurs propres écrans. Voir Sauvegarder Microsoft 365.

Les états d'une tâche

État	Ce que cela veut dire
Planifiée	La tâche est créée. Elle attend son heure, ou l'ordre de départ.
Envoyée	L'ordre est parti vers l'agent. L'agent n'a pas encore répondu.
En cours	L'agent exécute la tâche.
Réussie	La tâche a fait tout son travail. Une sauvegarde a donné un point de restauration.
Partielle	La sauvegarde a abouti, mais des fichiers n'ont pas pu être lus. Elle donne un point de restauration.
Échouée	La tâche n'a pas fait son travail.
Interrompue	La tâche a démarré, mais elle ne s'est pas terminée.
Manquée	La tâche n'a pas démarré.
Annulée	Un utilisateur ou la plateforme a arrêté la tâche.
Remplacée	Une sauvegarde planifiée plus récente de la même politique est arrivée, ou une sauvegarde de la même politique était encore en cours à l'heure prévue.
Reportée	Une tâche de la plateforme a laissé la place à une sauvegarde due sur le même dépôt.

Les états Échouée, Interrompue, Manquée et Partielle sont les quatre états qui font un problème sur le tableau de bord. Voir Tableau de bord et problèmes.

Lister les tâches d'une machine

1. Ouvrez le portail.
2. Ouvrez Parc, puis la machine.
3. Ouvrez l'onglet Activité.
4. Cliquez le type d'une tâche pour ouvrir sa fiche.
5. Cliquez Charger plus pour la suite de la liste, par tranches de 25 tâches.

Le tableau liste les tâches de la machine, de la plus récente à la plus ancienne. Il porte les colonnes Type, Statut, Taille, Nombre, Envoyée, Demandée, Terminée et Durée.

La colonne Nombre compte dans l'unité du type de sauvegarde : des fichiers, des bases, des disques ou des volumes. La colonne Envoyée donne les nouvelles données écrites dans le dépôt par cette tâche.

Le lien Problèmes des 7 derniers jours, en bas du tableau, ouvre la liste des problèmes de cette machine seulement.

Quand la machine n'a aucune tâche, le portail écrit « Aucune tâche pour le moment. ». Il ajoute « Rien ne s'exécute tant que cette machine n'a pas de politique de sauvegarde. » quand la machine n'a pas de politique. Voir Quel type de sauvegarde choisir.

Lire la fiche d'une tâche

1. Ouvrez la fiche de la tâche, depuis l'onglet Activité ou depuis le tableau de bord.
2. Lisez le titre : le type de la tâche et le nom de la machine.
3. Lisez l'état, à droite du titre, puis la date : Terminée, Démarrée ou Demandée.
4. Lisez les blocs de la page, de haut en bas.

Bloc	Ce qu'il donne	Quand il s'affiche
Le bloc du problème	La cause, en une phrase, puis l'action à mener.	États Échouée, Interrompue, Manquée et Partielle.
Progression	La phase, la part faite, les fichiers, les données, le débit et le temps restant.	Tant que la tâche envoie sa progression.
Détails	Type, Origine, Cause, Demandée, Démarrée, Terminée, Durée, Fin de la fenêtre, limite de débit et Point de restauration.	Toujours.
Volumétrie	Source, Modifiée, Nouvelle et Envoyée.	Sauvegarde réussie ou partielle.
Résultat	Nouveaux fichiers, fichiers modifiés, fichiers inchangés, données ajoutées, données stockées et durée.	Sauvegarde de fichiers terminée.
Logs	Les lignes de journal envoyées par l'agent.	Toujours.

Le champ Origine dit qui a demandé la tâche : Planning, Manuel ou Système.

La phase d'une sauvegarde en cours est Analyse, Envoi ou Finalisation. La phase Analyse lit la source pour mesurer le travail : la part faite avance peu pendant ce temps.

Dans le bloc Volumétrie, les colonnes Modifiée et Nouvelle portent la mention « Sans objet : sauvegarde complète » pour une image, une sauvegarde SQL Server ou une sauvegarde de VM : ces sauvegardes relisent toute leur source à chaque fois.

Quand la tâche a produit un point de restauration, le bloc Détails donne son identifiant. Pour une sauvegarde de fichiers, le bouton Parcourir ce point de restauration ouvre l'assistant de restauration sur ce point. Ce bouton demande le rôle Technicien ou Administrateur.

Comprendre pourquoi une tâche n'a pas réussi

1. Ouvrez la fiche de la tâche.
2. Lisez le titre du premier bloc. Il dit déjà ce qui s'est passé : Pourquoi elle a échoué, Pourquoi elle s'est arrêtée, Pourquoi elle n'a pas démarré, ou Ce qui n'a pas pu être lu.
3. Lisez la première phrase du bloc : c'est la cause.
4. Lisez la deuxième phrase : c'est l'action à mener.
5. Quand le bloc Message de l'agent est présent, lisez-le. Il vient de l'agent et il est en anglais. Le bouton de copie le copie tel quel.
6. Dans le bloc Détails, relevez le champ Cause. C'est un code court, utile au support.

Une sauvegarde Partielle commence par le nombre de fichiers non lus, puis par la phrase « Les autres fichiers ont été sauvegardés. ». Les lignes du journal, plus bas, peuvent nommer ces fichiers.

La liste complète des codes et de leurs actions est dans la référence : Codes de cause d'une tâche.

Quand la plateforme n'a pas typé la cause, le portail écrit le code tel quel, ou une phrase générale comme « La tâche a échoué, et la plateforme n'a donné aucune cause. »

Relancer la tâche

Sur la fiche d'une sauvegarde de fichiers qui n'a pas réussi, le bouton Réessayer lance une nouvelle sauvegarde de fichiers. Après une sauvegarde Partielle, ce bouton s'appelle Sauvegarder maintenant : la tâche a déjà donné un point de restauration.

Le bouton demande le rôle Technicien ou Administrateur, et une version d'agent acceptée par la plateforme. Voir Agent trop ancien.

Une sauvegarde d'image ne se relance pas depuis la fiche de la tâche. Le portail écrit « Une image a lieu à l'heure de sa politique. Le portail ne peut pas en lancer une maintenant. » Lancez-la depuis la ligne de sa politique. Voir Sauvegarder maintenant.

Lire le journal d'une tâche

1. Ouvrez la fiche de la tâche.
2. Descendez jusqu'au bloc Logs.
3. Dans la liste Niveau, choisissez ce que vous voulez lire : Tous les niveaux, Info et plus, Avertissements et erreurs ou Erreurs seulement.
4. Lisez les lignes. Chaque ligne porte son heure, son niveau et son message.
5. Cliquez Charger plus pour les lignes plus récentes.
6. Cliquez Copier les lignes pour copier les lignes affichées, en texte, vers le support.

Le filtre Niveau porte sur les lignes déjà chargées. Pour voir tout, choisissez Tous les niveaux.

Les lignes sont gardées 7 jours après la dernière ligne de la tâche. Passé ce délai, le portail écrit « Aucune ligne de log. L'agent n'en a pas envoyé pour cette tâche, ou elles ont expiré (les lignes sont gardées 7 jours). »

Une tâche garde 2 000 lignes au plus, et 512 Kio au plus. Au-delà, les plus anciennes partent, et le portail écrit « N lignes anciennes n'ont pas été gardées (limite par tâche). ». Un agent a aussi un budget de 1 Mio de nouvelles lignes par jour : les lignes refusées après ce budget comptent dans ce même nombre.

Les noms de champ sensibles sont masqués dans les lignes. Une ligne trop longue est coupée, et porte la mention « (ligne coupée) ».

Annuler une sauvegarde

1. Ouvrez la fiche de la sauvegarde, ou trouvez sa ligne dans l'onglet Activité.
2. Cliquez Annuler.
3. Lisez l'explication :
   • « La sauvegarde n'a pas commencé. Elle ne sera pas lancée. », quand elle est Planifiée ;
   • « L'agent reçoit un ordre d'arrêt. Les données déjà envoyées restent dans le dépôt. », quand elle est Envoyée ou En cours.
4. Cliquez Annuler la sauvegarde.

Une sauvegarde Planifiée passe tout de suite à l'état Annulée. Une sauvegarde Envoyée ou En cours reste active jusqu'à la réponse de l'agent : le portail écrit Arrêt en cours… à la place du bouton. L'index déjà écrit dans le dépôt est gardé : la sauvegarde suivante de la même politique repart de là.

Le bouton Annuler n'existe que pour une Sauvegarde ou une Sauvegarde d'image, et seulement tant qu'elle est Planifiée, Envoyée ou En cours. Une tâche de maintenance, une mise à jour d'agent ou une tâche terminée ne s'annule pas.

Suivre une tâche en temps réel

Tant qu'une tâche est Planifiée, Envoyée ou En cours, le portail met sa fiche à jour sans action de votre part. Une phrase, sous les blocs, dit comment :

• « Mis à jour en temps réel tant que la tâche est active. » quand le flux d'événements du portail est ouvert ;
• « Actualisé toutes les 2 s tant que la tâche est active. » quand le flux est coupé : le portail redemande alors la tâche toutes les 2 secondes.

L'état du flux s'affiche aussi en haut du portail : Temps réel, ou Mise à jour toutes les N s. Le flux se rouvre tout seul après une coupure de réseau.

Les lignes de journal n'arrivent pas par le flux d'événements. Le portail les redemande toutes les 5 secondes tant que la tâche est active.

Limites et précautions

• Le rôle Lecture seule voit la fiche et le journal, mais ni Annuler, ni Réessayer, ni Parcourir ce point de restauration.
• Une sauvegarde annulée ne donne pas de point de restauration. Une annulation ne change pas le planning de la politique : la sauvegarde suivante a lieu à son heure.
• Les lignes de journal expirent 7 jours après la dernière ligne. Copiez-les avant, quand vous ouvrez un ticket avec le support.
• Le message de l'agent est en anglais. La cause et l'action à mener sont en français.
• Le bloc Progression ne s'affiche que si l'agent envoie sa progression. Un agent ancien envoie moins de valeurs : le débit ou le temps restant peuvent manquer.
• Le portail n'affiche pas un total plus petit que la valeur déjà faite, ni un temps restant de plus d'un an : une mesure fausse vaut mieux cachée.
• L'onglet Activité n'a pas de filtre par état. Pour ne voir que les tâches avec un problème, utilisez le lien Problèmes des 7 derniers jours. L'API, elle, filtre par type et par état.
• Une machine exécute une seule sauvegarde à la fois. Une tâche en cours empêche d'en lancer une autre sur la même machine.

Référence

• API : Backups, routes GET /endpoints/{id}/jobs, GET /jobs/{id}, GET /jobs/{id}/logs et POST /jobs/{id}/cancel.
• Outils MCP : list_jobs et get_job, pour lire les tâches depuis un assistant IA.
• Codes de cause d'une tâche : Codes de cause d'une tâche.