Quick Start

Présentation

Dans ce document, nous allons prendre en main l’outil de supervision.

Les points abordés seront :

• la connexion au dashboard
• l’installation d’un agent avec les kits de déploiement
• la présentation des plugins et des alertes associées
• le plan de communication
• la supervision des équipements réseau (Devices SNMP et pools d’agents)
• la supervision d’un hyperviseur
• les rapports personnalisés
• un aperçu des données collectées
• TIPS : Dashboard et Dark mode

Se connecter au dashboard

Rendez-vous sur le dashboard à l’adresse suivante : http://dashboard.rg-supervision.com

La connexion à votre dashboard requiert une adresse email et un mot de passe :

Une fois authentifié, vous arrivez sur votre dashboard (évidemment, votre dashboard sera vide dans un premier temps).

Prendre en main votre arborescence

Sur la gauche du dashboard, vous pouvez voir votre nœud principal.

Vous pouvez effectuer plusieurs actions :

Faire apparaître le menu

Un clic droit sur un nœud fera apparaître le menu de gestion des nœuds.

Installer votre premier agent

La méthode recommandée pour installer un agent est le kit de déploiement. Un kit est un installeur pré-paramétré : il est rattaché à un nœud de votre arborescence et contient déjà toutes les informations nécessaires à l’enregistrement de l’agent. Aucun identifiant ni mot de passe n’est demandé pendant l’installation, et l’agent apparaît directement dans le bon nœud.

Un kit peut être utilisé de trois façons :

• Lien public de téléchargement : vous envoyez un lien à l’utilisateur final, qui télécharge et lance lui-même l’installeur.
• Exécutable du kit : vous lancez l’installeur directement sur la machine (ou vous le distribuez par vos propres moyens).
• Ligne de commande : vous copiez-collez une commande (Windows, macOS ou Linux) qui télécharge et installe l’agent en une seule étape, idéale pour un script de déploiement en masse.

Créer un kit de déploiement

1. Dans l’arborescence, sélectionnez le nœud dans lequel les agents doivent apparaître.
2. Dans le menu de gauche, cliquez sur “Téléchargements” puis “Kit de déploiement”.
3. Cliquez sur “Ajouter un kit”, saisissez un nom (par exemple le nom du client ou du site), puis cliquez sur “Ajouter”.

Le kit apparaît dans la liste avec son nom, son nœud, sa date de création et son lien public. Le sélecteur en haut de liste permet d’afficher les kits du nœud courant uniquement, ou ceux du nœud courant + nœuds enfants. La création d’un kit n’est possible que depuis la vue “Nœud courant”. Il n’y a pas de limite au nombre de kits par nœud.

REMARQUE : la gestion des kits (création, modification, suppression) nécessite le droit dédié aux kits de déploiement. Sans ce droit, la page n’est pas accessible. 
Un nœud qui contient des kits ne peut pas être supprimé : supprimez d’abord ses kits.

Utiliser le kit

Cliquez sur la ligne d’un kit pour afficher ses détails. Vous y trouverez le lien public et les lignes de commande d’installation, chacune accompagnée d’une action “Copier”.

1. Par le lien public

Envoyez le lien du kit à l’utilisateur final. Il arrive sur une page de téléchargement à votre logo qui lui explique la marche à suivre : choisir son système, télécharger l’exécutable puis le lancer.

2. Par l’exécutable (Windows)

Au lancement de l’exécutable :

1. Windows demande une élévation des droits (UAC) : l’installation nécessite des droits administrateur. Si l’élévation est refusée, l’installation s’arrête.
2. La fenêtre “Installation de l’agent de supervision” s’ouvre. Cliquez sur “Installer”.
3. Une barre de progression indique l’avancement de l’installation.
4. Un message confirme la fin de l’installation. Cliquez sur “Fermer”.

NOTE : si un agent de supervision est déjà présent sur la machine, l’installation est bloquée et le message “Agent de supervision détecté” s’affiche. L’agent existant n’est jamais écrasé, ce qui évite d’avoir deux agents sur un même poste.

3. Par la ligne de commande

Copiez la ligne de commande correspondant au système cible et exécutez-la dans un terminal avec des droits administrateur (invite de commandes ou PowerShell sur Windows, Terminal avec sudo sur macOS, shell root sur Linux). La commande télécharge l’installeur et enregistre l’agent dans le nœud du kit, sans autre manipulation.

• Windows : une seule commande pour télécharger et installer l’agent.
• macOS : la commande télécharge l’image disque de l’agent, l’ouvre et enregistre l’agent.
• Linux (64 et 32 bits) : la commande installe l’agent en tant que service systemd. Elle est compatible avec les distributions basées sur systemd (Debian, Ubuntu, Red Hat, SUSE…) et ne fonctionne pas sur les distributions qui n’utilisent pas systemd.

ASTUCE : la ligne de commande est la méthode idéale pour déployer l’agent sur plusieurs machines d’un même client, via un script, une GPO ou votre outil de déploiement habituel. Les lignes de commande contiennent les paramètres d’enregistrement du kit : ne les diffusez pas publiquement.

Déployer avec Chocolatey (Windows)

L’agent est aussi disponible sous forme de paquet Chocolatey (rgsupervision). Il nécessite un jeton de déploiement, à générer depuis votre page de profil (onglet Paramètres), et accepte en option l’identifiant du nœud de destination :

choco install rgsupervision --params "'/Token:VOTRE_JETON /Node:ID_DU_NOEUD'"

Une fois installé, l’agent se met à jour automatiquement.

Apparition dans le dashboard

Une fois l’installation terminée, l’agent apparaît dans le nœud auquel le kit est rattaché.

Si votre agent n’apparaît pas, faites un clic droit sur le nœud puis “Actualiser”.

Pour aller plus loin avec les kits de déploiement

Les plugins

Les plugins sont des modules que l’agent va utiliser pour collecter les données de votre machine.

Accéder aux plugins

Cliquez sur le menu “Configuration” puis “Plugins”.

Présentation des plugins

Vous avez plusieurs plugins à votre disposition pour votre agent.

En activant un plugin, vous permettez à l’agent de collecter des données depuis votre machine.

Paramétrer les plugins

Un plugin peut avoir 3 états différents :

• Hérité, il héritera de la configuration de son nœud parent.
• Activé, l’héritage est “cassé”. Il restera actif quoi qu’il arrive à son nœud parent.
• Désactivé, l’héritage est “cassé”. Il restera inactif quoi qu’il arrive à son nœud parent.

Les plugins ont un état par défaut. Vous pouvez changer cette configuration comme vous le souhaitez.

Les alertes

Les alertes sont organisées par plugin et pour chacun d’entre eux, il est possible d’affiner au niveau de l’objet. Pour rappel, un objet est une partie de la machine affectée à un plugin. Par exemple, le disque “C:” est un objet de type “Disque”.

Accéder aux alertes

Cliquez sur le menu “Configuration” puis “Alertes”.

Une alerte se déclenche si ses conditions sont atteintes ensuite un ticket est créé.

En fonction de votre plan de communication, un email et/ou un SMS sera envoyé.

Type d’alerte

Les alertes comportent un ou plusieurs “Type d’alerte”. Par exemple, l’alerte sur le plugin “Antivirus” a 3 types d’alerte : “Antivirus expiré”, “Antivirus désactivé” et “Virus détecté” (l’alerte Virus détecté n’est disponible que pour RG Security)

Pour chaque type d’alerte, les informations suivantes sont disponibles et modifiables (suivant l’alerte, certaines ne seront pas présentes):

• Niveau de criticité : faible (un carreau jaune), moyenne (deux carreaux oranges), haute (trois carreaux rouges)
• Seuil : associé à la durée définie, niveau à partir duquel l’alerte se déclenchera.
• Durée : associée au seuil, délai au delà duquel l’alerte se déclenchera.
• Escalade : une fois le nombre de relance(s) atteint, l’alerte passera d’une criticité faible à moyenne puis/ou de moyenne à haute

Les utilisateurs concernés vont recevoir ces alertes pendant une plage horaire définie dans le plan de communication.

Pour aller plus loin avec les alertes

Plan de communication

Le plan de communication permet de définir les paramètres et les personnes habilitées à recevoir l’information par email et/ou SMS qu’un incident s’est produit.

Accéder au plan de communication

Cliquez sur le menu “Configuration” puis “Communication”.

Gestion de la communication

Tout se paramètre au niveau d’un nœud et en fonction du niveau de criticité des alertes.

Pour chaque niveau, vous pouvez :

• Définir quels utilisateurs vont être alertés en activant un ou plusieurs mode(s) de communication.

  REMARQUE : Les SMS ne peuvent être activés que sur les alertes ayant une criticité haute (3 carreaux rouges).

• Bornes horaires : plage horaire pendant laquelle les alertes seront envoyées.
• Weekend : activation de la communication samedi et/ou dimanche.
• Fréquence d’envoi : délai après lequel une alerte email ou SMS sera renvoyée.
• Relances : Si l’escalade est activée et que le nombre de relance(s) est atteint, la criticité de l’alerte est augmentée.

Superviser vos équipements réseau (Devices SNMP)

Les switchs, routeurs, pare-feux, imprimantes, onduleurs ou NAS ne peuvent pas recevoir d’agent. Pour les superviser, vous créez dans l’arborescence un Device SNMP : un agent “virtuel” représentant l’équipement. Les données sont collectées via le protocole SNMP par un agent interrogateur, c’est-à-dire un de vos agents Windows situé sur le même réseau que l’équipement.

L’agent interrogateur peut être :

• un agent unique, que vous désignez directement ;
• un pool d’agents, c’est-à-dire un groupe d’agents qui se répartissent les interrogations. Si un agent du pool passe hors ligne, un autre prend le relais : c’est la solution recommandée pour une supervision continue.

Créer un pool d’agents (recommandé)

1. Sélectionnez un nœud puis cliquez sur le menu “Configuration” > “Pool d’agents” > “Device SNMP”.
2. Cliquez sur “Créer un pool d’agents”.
3. Renseignez le nom du pool et, si vous le souhaitez, une description.
4. Dans la liste “Agents éligibles” (à droite), ajoutez les agents qui composeront le pool. Pour vous aider à choisir, chaque agent affiche :
   • sa disponibilité (7 jours), c’est-à-dire le temps pendant lequel il a été en ligne au cours des 7 derniers jours ;
   • son adresse IP, qui permet de vérifier qu’il se trouve sur le même réseau que les équipements à superviser.
5. Les agents ajoutés apparaissent dans “Composition du pool”. Cliquez sur “Créer”.

Bon à savoir :

• Un pool contient de 1 à 100 agents Windows (serveurs ou postes de travail). Privilégiez des serveurs, allumés 24h/24.
• Un pool peut superviser jusqu’à 10 Devices SNMP par agent qui le compose : ajoutez des agents si vous atteignez cette limite.
• Les pools créés sur un nœud sont utilisables par ses nœuds enfants. Un pool ne peut être modifié que depuis le nœud sur lequel il a été créé.
• La liste des pools affiche pour chacun la disponibilité moyenne de ses agents, le nombre d’agents interrogateurs et le nombre de devices supervisés.
• Si vous supprimez un pool, les Devices SNMP dont il avait la charge continuent d’être supervisés par les agents qui leur sont actuellement assignés.

Créer un Device SNMP

Prérequis : le SNMP doit être activé sur l’équipement, et vous devez connaître sa communauté SNMP. L’agent interrogateur doit pouvoir joindre l’équipement (port UDP 161 par défaut).

1. Dans l’arborescence, faites un clic droit sur un nœud puis “Nouveau device SNMP”.
   Vous pouvez aussi créer le device directement depuis un équipement détecté dans le Voisinage réseau.
2. Renseignez les informations de connexion (les champs marqués d’un astérisque sont obligatoires) :
   • Adresse IP de l’équipement ;
   • Port SNMP ;
   • Communauté SNMP ;
   • Agent interrogateur : choisissez “Agent unique” ou “Pool d’agents”, puis sélectionnez l’agent ou le pool ;
   • Nœud de destination du device dans l’arborescence.
3. Laissez activée l’option “Lancer l’inventaire SNMP automatiquement” (activée par défaut), puis validez.

Inventaire SNMP et widgets

L’inventaire interroge l’équipement pour lister toutes les valeurs qu’il expose (les OID). Il peut prendre quelques minutes selon l’équipement. Chaque OID est enrichi d’un libellé lisible grâce aux MIB connues. L’inventaire peut être relancé à tout moment.

Les données du device s’affichent ensuite sous forme de widgets, disposés en tuiles redimensionnables et déplaçables sur la page du device :

• Widgets suggérés : à partir de l’inventaire, le dashboard vous propose des widgets adaptés à votre équipement, que vous pouvez ajouter en un clic.
• Widgets personnalisés : choisissez un ou plusieurs OID à superviser (l’icône loupe du champ OID vous permet d’explorer les résultats de l’inventaire, classés par popularité), activez si besoin les courbes, puis définissez des alertes sur les valeurs.

Comme pour les agents, les alertes d’un Device SNMP créent des tickets et suivent votre plan de communication.

Pour aller plus loin avec les Devices SNMP

Superviser un hyperviseur

L’agent hyperviseur gère aujourd’hui spécifiquement les hôtes VMware ESXi à partir de la version 5. Concernant Microsoft Hyper-V, il suffira d’installer l’agent de supervision directement sous Windows.

Il n’est pas possible d’installer l’agent de supervision directement sur l’hôte ESXi, nous allons créer un agent “virtuel” dans l’arborescence puis un agent interrogateur récupérera les informations de supervision via les APIs VMware.

Sur un nœud de votre arborescence, faites un clic droit puis “Nouvel hyperviseur”.

Maintenant qu’il est créé, nous allons renseigner les informations d’authentification. Pour cela :

• cliquez sur l’hyperviseur dans votre arborescence, cliquez sur le menu Configuration / Hyperviseur

• Renseignez les informations d'authentification ainsi que l’agent qui interrogera l’hyperviseur (ce dernier peut être une VM hébergée par ce même hyperviseur)

(1) Compte utilisateur, “root” dans la majorité des cas
(2) Mot de passe de l’hyperviseur
(3) Adresse IP de l’hyperviseur
(4) Ajout de l’agent interrogateur (privilégiez un agent serveur qui sera allumé 24/7)
(5) Enregistrez les informations

• Votre hyperviseur est maintenant supervisé

Les rapports

Les rapports personnalisés vous permettent d’envoyer à vos clients un document PDF récapitulant l’état de leur parc et l’activité de la période : supervision, tickets, interventions Assist, App Manager, sauvegardes, cybersécurité… Vous choisissez les données à inclure, la fréquence d’envoi et les destinataires.

Accéder aux rapports

Sélectionnez un nœud de votre arborescence, puis cliquez sur le menu “Rapports” > “Rapports personnalisés”.

La page comporte deux onglets :

• Rapports configurés : les rapports du nœud, avec leur nom, leur date de création, leur fréquence d’envoi, la date du prochain envoi, leur description et leur identifiant ;
• Historique : chaque envoi réalisé (automatique ou manuel), avec la période de données couverte et l’état de délivrabilité.

Créer un rapport

Cliquez sur “Nouveau rapport” (ou “Générer un rapport” si aucun rapport n’existe encore sur le nœud). La page de configuration s’ouvre en plein écran.

1. Définition du contexte

• Nom du rapport (obligatoire) et description (facultative) ;
• Langue du rapport : français, anglais ou néerlandais ;
• Adresse de réponse (Reply-To) (facultative) : l’adresse sur laquelle arriveront les réponses de vos clients au mail du rapport. Le format Prénom Nom <adresse@societe.com> est accepté.

2. Fréquence d’envoi

Laissez l’option “Envoi automatique” activée pour programmer un envoi récurrent : choisissez le fuseau horaire, la fréquence (mensuelle par défaut, ou quotidienne, hebdomadaire, tous les X jours / semaines / mois) et la date du premier envoi.

La période de données du rapport est déduite de la fréquence : un rapport mensuel couvre le mois écoulé, un rapport hebdomadaire la semaine écoulée, etc. Une phrase sous la section “Choix du contenu” vous rappelle la période couverte.

Si vous désactivez l’envoi automatique, le rapport ne sera envoyé que manuellement, et vous choisirez la période de données au moment de l’envoi.

3. Choix du contenu

Chaque nouveau rapport contient par défaut trois blocs de données : la synthèse du parc, la liste des tickets critiques actifs et le résumé du pedigree des agents. Le récapitulatif affiche les blocs inclus dans le rapport.

Cliquez sur “Modifier les données” pour personnaliser le contenu :

• Le menu de gauche classe les données par catégorie : Général, Tickets, Pedigree, App Manager, Assist, Backup, Cybersécurité.
• Chaque bloc de données est présenté avec un aperçu (données fictives) et des filtres : type d’agent (postes de travail, serveurs), système d’exploitation (Windows, macOS, Linux, ESX) et autres plateformes (Microsoft 365, Device, Device SNMP). Les filtres sont pré-cochés : vous pouvez ajouter un bloc en un clic avec “Ajouter”.
• Dans le récapitulatif (à droite), réorganisez les blocs par glisser-déposer : leur numéro indique leur ordre dans le PDF. L’icône corbeille retire un bloc, le bouton “Vider” les retire tous.
• Cliquez sur “Enregistrer” pour revenir à la configuration du rapport.

4. Destinataires

Ajoutez l’adresse email d’au moins un destinataire.

Cliquez enfin sur “Créer”. Le rapport apparaît dans l’onglet Rapports configurés et sera envoyé à la date du prochain envoi programmé (ou lors de votre envoi manuel si l’envoi automatique est désactivé).

Réception du rapport

• Les destinataires reçoivent un email contenant un lien de téléchargement du rapport au format PDF (le PDF n’est pas joint au mail).
• Le PDF reprend le logo de votre compte sur sa page de garde, indique la période couverte et contient une page de légende.
• Consentement (RGPD) : un destinataire qui n’est pas utilisateur du dashboard reçoit d’abord un email lui demandant d’accepter de recevoir les rapports. Tant qu’il n’a pas accepté, il ne reçoit pas les rapports. S’il refuse, aucun rapport ne lui sera plus envoyé et son adresse apparaît en rouge dans la configuration du rapport.

Modifier, envoyer ou supprimer un rapport

Dans l’onglet Rapports configurés, chaque rapport propose trois actions :

• Modifier : rouvre la page de configuration pour changer n’importe quel paramètre.
• Envoyer maintenant : réalise un envoi ponctuel en deux étapes. Choisissez les destinataires, puis la date de début de la période de données (la fin de la période est la date du jour). Cet envoi ne modifie pas l’envoi automatique programmé.
• Supprimer : supprime définitivement le rapport ainsi que tout son historique d’envoi.

Suivre les envois

L’onglet Historique liste chaque envoi avec sa date, la période couverte et son état global de délivrabilité : Délivré, En cours ou Erreur. Cliquez sur une ligne pour voir le détail par destinataire :

• En cours : le mail a été envoyé, en attente de confirmation de réception ;
• Délivré : le mail est arrivé dans la boîte de réception ;
• Ouvert : le destinataire a ouvert le mail ;
• Non délivré : le mail n’a pas pu être délivré, ou le rapport n’a pas pu être généré ;
• Non envoyé : le destinataire n’a pas encore donné son accord pour recevoir les rapports ;
• Refusé : le destinataire a refusé de recevoir les rapports.

REMARQUE : la création, la modification, l’envoi et la suppression des rapports nécessitent le droit de gestion des rapports. Sans ce droit, vous pouvez consulter les rapports mais pas les modifier.

NOTE : les rapports de sauvegarde (RG Backup et Microsoft 365) sont accessibles depuis le menu Backup.

Accès aux données

Le menu “Données” vous permettra de choisir ce que vous souhaitez voir comme information relative à un agent sélectionné. Un clic sur le bouton fera apparaître les courbes ou listes possibles pour cet agent et de là en cliquant sur la ligne désirée vous aurez le détail.

Détails de courbes :

Détails de listings :

Afficher les informations

• Sur la page regroupant toutes les courbes (après avoir cliqué sur Données - Courbes - Tous). Grâce au bouton situé sur la droite (1), ces dernières peuvent être visionnées sur une intervalle quotidienne ou annuelle

• Positionné sur la courbe d’un plugin visé (comme vu plus haut, clic sur le menu Données - Courbes et le plugin visé), la vue peut être journalière, hebdomadaire, mensuelle ou annuelle

Sur la droite de chaque courbe se trouvent des informations relatives au plugin associé. L’exemple suivant nous montre une courbe de trafic réseau. Passez le pointeur de la souris pour faire apparaître sa légende (1). Dans un tableau, sont affichées les valeurs minimales, moyennes et maximales (2).

TIPS : Dashboard et Dark mode

A défaut de pouvoir vous proposer le dark mode dans le dashboard (un jour promis 😁), nous vous proposons ce tips qui vous permet d'avoir un dashboard en dark mode mais pas que ! 
 

Votre navigateur préféré (Chrome, Firefox Edge) passera entièrement dans ce mode. 

Pour Chrome, voici le plugin

Pour Firefox, voici le plugin

Sinon voici d'autres alternatives pour Chrome et Edge.