Parc et arborescence

Ce que fait la page Parc

La page Parc est la liste de tous les endpoints du MSP actif. Elle sert à retrouver une machine, et à travailler sur un groupe de machines.

La page a deux outils. L'Arbre du parc, à gauche, réduit la page à un client ou à un groupe de machines. Les filtres, au-dessus de la liste, réduisent la liste à un type, à un statut, à une version ou à un tag.

L'arbre et les filtres restent dans l'adresse de la page. Vous pouvez donc garder l'adresse dans vos favoris, ou l'envoyer à un collègue : il ouvrira la même vue.

Prérequis

• Le rôle Lecture seule, Technicien, Administrateur ou Administrateur plateforme pour lire la page. Voir Rôles et droits.
• Le rôle Administrateur ou Administrateur plateforme pour changer les niveaux de l'arbre.
• Au moins un client. Voir Clients.
• Au moins une clé de tag pour que l'arbre ait un niveau sous le client. Voir Tags et actions sur une sélection.

Ouvrir le parc et lire la liste

1. Dans le menu principal, cliquez Parc.
2. Lisez le tableau des endpoints.

Le tableau donne sept colonnes.

Colonne	Ce qu'elle donne
Nom	Le nom d'affichage de l'endpoint, son nom d'hôte, puis le nom de son client.
Type	Machine ou Tenant Microsoft 365.
Statut	En ligne ou Hors ligne pour un agent. L'étiquette Version trop ancienne s'ajoute quand l'agent est bloqué. Un tiret pour un tenant Microsoft 365.
Dernière sauvegarde	L'état et la date de la dernière sauvegarde de fichiers. Pas encore de sauvegarde quand il n'y en a aucune. Le lien Voir le tenant pour un tenant Microsoft 365.
Dernière sauvegarde d'image	L'état et la date de la dernière sauvegarde d'image. Un tiret quand la machine n'en a pas.
Version	La version de l'agent.
Tags	Les tags de l'endpoint.

Avec le rôle Technicien, Administrateur ou Administrateur plateforme, une case à cocher s'ajoute devant chaque ligne. Voir Tags et actions sur une sélection.

Chaque ligne ouvre la fiche de l'endpoint. Trois liens d'une ligne ouvrent autre chose :

• le nom du client ouvre le nœud de ce client dans l'arbre ;
• un tag ajoute ce tag aux filtres de la liste ;
• la date de la dernière sauvegarde ouvre la fiche de la tâche. Voir Suivre une tâche de sauvegarde.

Cliquez Voir plus, en bas du tableau, pour la suite de la liste.

Entre 768 et 1023 pixels de large, les colonnes Type et Version sont masquées : les autres colonnes gardent ainsi la place de leur texte.

Filtrer la liste

Chercher une machine par son nom

1. Dans le champ Rechercher par nom ou nom d'hôte, tapez une partie du nom.
2. Attendez un instant. La liste se met à jour sans bouton.

La recherche porte sur le nom d'affichage et sur le nom d'hôte. Elle ne porte pas sur les tags.

Garder un seul type d'endpoint

Au-dessus de la liste, cliquez Tous, Machine ou Tenant Microsoft 365.

Ajouter un filtre

1. Cliquez Filtres.
2. Réglez un ou plusieurs filtres du panneau.
3. Pour le filtre Version, tapez la version, puis cliquez Appliquer.

Le panneau porte six filtres.

Filtre	Ce qu'il garde
Client	Les endpoints d'un client.
Statut	Les agents En ligne, ou les agents Hors ligne.
Version	Les agents dans cette version.
Démarrage	Les machines en UEFI, en BIOS ou MBR, ou de mode Inconnu.
Version trop ancienne seulement	Les agents sous la version minimale de la plateforme. Ils sont bloqués. Voir Agent trop ancien.
Tag	Les endpoints qui ont ce tag. Choisissez une clé, puis une valeur.

Le bouton Filtres porte le nombre de filtres actifs. Le filtre BIOS ou MBR repère les machines qui ne peuvent pas avoir de sauvegarde d'image. Voir Passer de BIOS et MBR à UEFI et GPT.

La case Problèmes seulement, sous la barre des filtres, garde les endpoints qui ont un problème en cours : un agent hors ligne, ou une dernière sauvegarde ou sauvegarde d'image Échouée, Interrompue, Manquée ou Partielle. Les tenants Microsoft 365 n'entrent pas dans ce contrôle.

Lire et retirer les filtres actifs

Une étiquette par filtre actif s'affiche sous la barre des filtres. Cliquez une étiquette pour retirer ce filtre.

Les filtres se cumulent. La liste ne garde que les endpoints qui passent tous les filtres. Avec plusieurs filtres de tag, la liste ne garde que les endpoints qui ont tous ces tags. Une vue porte 30 filtres de tag au plus.

Quand aucun endpoint ne passe les filtres, le portail écrit « Aucun endpoint ne correspond à ces filtres » et propose d'effacer les filtres.

Se déplacer dans l'arborescence

L'Arbre du parc est une vue des tags, pas un classement séparé. Le premier niveau est le client. Les niveaux suivants sont les clés de tag que votre MSP a choisies comme clés d'arbre.

Un nœud de l'arbre est donc un filtre : un client, et une valeur par clé d'arbre. Le portail n'a pas de dossier à créer ni à déplacer. Vous posez un tag sur un endpoint, et l'endpoint entre dans le nœud correspondant. Voir Tags et actions sur une sélection.

À partir de 1024 pixels de large, l'arbre est à gauche de la page. En dessous de cette largeur, le bouton Périmètre ouvre l'arbre dans un panneau.

1. Ouvrez la page Parc.
2. Dans l'arbre, cliquez la flèche d'un nœud pour l'ouvrir. Les nœuds du niveau suivant se chargent.
3. Cliquez le nom d'un nœud pour le choisir.
4. Lisez la liste. Elle ne porte plus que sur ce nœud.

Le nœud choisi reste dans l'adresse de la page. Il s'ajoute aux filtres de la liste.

Pour revenir au parc entier, cliquez Tous les endpoints, en haut de l'arbre.

Le nom d'un nœud prend trois formes :

Forme	Ce que le nœud contient
Le nom d'un client	Les endpoints de ce client.
site: Lyon	Les endpoints dont la clé site vaut Lyon.
(sans site)	Les endpoints qui n'ont pas la clé site.

L'icône ⚙ d'un nœud de client ouvre la fiche de ce client. Sous l'arbre, le lien Ouvrir la page client de … ouvre la même fiche pour le nœud choisi.

Se déplacer au clavier

L'arbre se parcourt entièrement au clavier.

Touche	Ce qu'elle fait
↓ et ↑	Va au nœud suivant ou précédent.
Début et Fin	Va au premier ou au dernier nœud affiché.
→	Ouvre le nœud, puis va à son premier enfant.
←	Ferme le nœud, ou va à son parent.
Entrée ou Espace	Choisit le nœud.
Une lettre	Va au nœud suivant dont le nom commence par cette lettre.

Lire les chiffres d'un nœud

Chaque nœud porte son nombre d'endpoints, à droite de son nom. Deux chiffres s'ajoutent quand ils ne sont pas à zéro :

Chiffre	Ce qu'il compte
Rouge, avec l'icône d'erreur	Endpoints dont la dernière sauvegarde ou sauvegarde d'image a échoué.
Orange, avec l'icône d'alerte	Endpoints à vérifier : hors ligne, dernière sauvegarde Interrompue, Manquée ou Partielle, ou aucune sauvegarde réussie depuis 7 jours.

Un nœud prend l'état le plus grave de ses endpoints. Ces chiffres ne portent que sur les machines qui ont un agent : un tenant Microsoft 365 n'est jamais rouge ni orange.

Chercher un nœud

1. Dans le champ Client, tag ou endpoint de l'arbre, tapez une partie du nom.
2. Lisez l'arbre. Il ne garde que les nœuds qui correspondent.

La recherche porte sur le nom d'un endpoint, sur le nom d'un client et sur une valeur de clé d'arbre. Chaque nœud gardé affiche alors deux chiffres, par exemple « 3 / 12 » : le nombre d'endpoints qui correspondent, sur le nombre d'endpoints du nœud.

Cochez Seulement les nœuds avec un problème pour ne garder que les nœuds qui ont un endpoint rouge ou orange.

Quand rien ne correspond, le portail écrit « Aucun nœud ne correspond. Changez la recherche ou décochez « Seulement les nœuds avec un problème ». »

Choisir les niveaux de l'arbre

Les niveaux de l'arbre sont un réglage du MSP. Ils valent pour tous vos clients et pour tous vos utilisateurs. Une clé qui n'est pas un niveau est une clé libre : elle sert de filtre et d'étiquette, mais elle ne fait pas de niveau.

Choisissez des niveaux qui décrivent un lieu ou un rôle, par exemple site, puis rôle. Un arbre site → rôle donne une lecture par agence, puis par type de machine.

1. Dans le menu principal, ouvrez le menu Administration.
2. Cliquez Clés de tag.
3. Lisez le bloc Niveaux de l'arbre.
4. Dans le champ Ajouter une clé à l'arbre, choisissez une clé libre. Elle devient le dernier niveau.
5. Avec les boutons Monter et Descendre, mettez les clés dans l'ordre voulu.
6. Avec le bouton Retirer de l'arbre, sortez une clé de l'arbre. Elle redevient une clé libre.
7. Cliquez Enregistrer les niveaux.

Le portail écrit « Les niveaux ont des changements non enregistrés » tant que vous n'avez pas enregistré. Le bouton Annuler les changements revient aux niveaux enregistrés.

L'arbre porte 20 niveaux au plus, sous le niveau du client. Quand l'arbre est plein, le portail écrit « 20 niveaux au plus. Retirez d'abord une clé de l'arbre. »

Sans clé d'arbre, le bloc écrit « L'arbre n'a que le niveau client. » L'arbre liste alors vos clients, et rien en dessous. Un administrateur lit en plus « Ajoutez une clé pour faire un niveau sous le client. »

Avec le rôle Technicien ou Lecture seule, le bloc affiche les niveaux sans les boutons, et la phrase « Seul un administrateur peut changer les niveaux. »

Limites et précautions

• Un nœud de l'arbre est un filtre, pas un dossier. Un nœud n'existe que s'il a au moins un endpoint. Il n'y a donc jamais de nœud vide, et vous ne pouvez pas préparer un nœud à l'avance.
• Un endpoint a une seule valeur par clé. Il est donc dans un seul nœud de chaque niveau.
• Les valeurs se comparent sans la casse. Lyon et lyon font un seul nœud. Le portail affiche la première forme enregistrée dans votre MSP.
• Un client sans endpoint est quand même un nœud de l'arbre, avec 0 endpoint. L'arbre est donc aussi la liste de vos clients.
• Un changement des niveaux change l'arbre pour tout votre MSP, tout de suite. Les adresses enregistrées qui pointent un ancien nœud ne sont plus valides : le portail recharge alors l'arbre depuis Tous les endpoints.
• Les niveaux ne déplacent aucun tag. Retirer une clé de l'arbre ne retire pas le tag des endpoints. Supprimer la clé, en revanche, retire le tag de chaque endpoint. Voir Tags et actions sur une sélection.
• La case Problèmes seulement de la liste et la case Seulement les nœuds avec un problème de l'arbre ne suivent pas la même règle. L'arbre compte en plus les machines sans sauvegarde réussie depuis 7 jours.
• Un endpoint dont la suppression est demandée reste dans la liste et dans l'arbre jusqu'à la fin du délai. Voir Supprimer un endpoint ou un client.

Référence

• API : Endpoints, route GET /endpoints et ses filtres client_id, type, agent_status, version, boot, q, problems, too_old, tag et no_tag.
• API : Fleet, routes GET /fleet/tree pour un nœud de l'arbre et GET /tree-levels pour les niveaux.
• API : le changement des niveaux de l'arbre se fait depuis le portail. Il n'a pas de route dans l'API publique du MSP.
• Outils MCP : get_fleet_tree et list_endpoints, pour lire l'arbre et la liste depuis un assistant IA.