Base de connaissances

Documentation SynoCockpit

Tout pour installer, configurer et exploiter la plateforme en autonomie. La même documentation est disponible dans votre espace client (menu « 📖 Aide »).

Prise en main

SynoCockpit supervise vos NAS Synology en lecture seule. Trois étapes :

  1. Créez vos clients/sites (Paramètres → Clients).
  2. Ajoutez vos NAS (NAS → + Ajouter, ou Import CSV).
  3. Laissez la collecte tourner : le tableau de bord se remplit et les alertes partent par e-mail.
💡 Pour un parc existant, l'import CSV crée les clients manquants automatiquement.
SynoCockpit · Tableau de bord
9NAS
8En ligne
2À mettre à jour
1Alertes
Siège OK
Volume 162%
HBARX
Agence MAJ
Volume 188%
AB365
Client X HL
Dernier relevé6 min

Ajouter / configurer un NAS

ChampRôle & remplissageImpact
NomNom d'affichage.Cosmétique
ClientRattachement obligatoire (bouton « + » pour créer à la volée).Organisation / filtrage
QuickConnectCochez si le NAS n'a pas d'IP publique fixe ; renseignez l'identifiant QuickConnect.Accès via le relais Synology
Hôte / PortAdresse directe (IP/DDNS) et port HTTPS DSM (5001).Connexion directe
Utilisateur / Mot de passeCompte de service DSM, idéalement en lecture seule. Chiffré en base.Identité de collecte
Code 2FAUniquement si le compte a la double authentification.Mémorise un jeton d'appareil
URL DSM directe / TagsLien d'ouverture DSM (optionnel) ; étiquettes de recherche.Confort / filtrage
💡 Cliquez « Tester la connexion » avant d'enregistrer : vous validez identifiants + adresse et mémorisez le jeton 2FA.
Ajouter une NAS
Nom *NAS Siège
Client *Client Dupont ▾   +
Hôte / Port192.168.1.10 : 5001
Utilisateursvc-supervision
Code 2FA123456
Tester la connexion   ✓ jeton 2FA vérifié

Gestion des clients

Depuis le menu Clients, organisez votre parc par client final. Chaque client possède un identifiant unique et un nom, complétés d'une référence interne, d'un contact et de notes.

  • Créez, modifiez ou supprimez vos clients (selon vos droits manage_nas / manage_settings).
  • Rattachez vos NAS à un client pour cloisonner la supervision et les vues par client.
  • Les clients sont exposés dans l'API métier (/api/v1/clients) avec leur identifiant, pour vos outils tiers.

Connexion & double authentification (2FA)

Saisissez un code 2FA actuel puis « Tester la connexion » : un jeton d'appareil est mémorisé et rafraîchi automatiquement à chaque relevé — plus besoin de code ensuite.

SymptômeCauseSolution
« jeton non mémorisé »Aucun jeton et aucun code fourni.Ressaisir un code 2FA frais et tester.
« jeton REFUSÉ »Le compte impose la 2FA au niveau API.Utiliser un compte de service DSM en lecture seule SANS 2FA.
Erreur relais / TLSQuickConnect injoignable côté serveur.Privilégier un accès direct/DDNS.

Règles d'alerte

Une règle = métrique {opérateur} seuil → gravité. Les règles intégrées sont personnalisables (Régler / Couper / Rétablir) sans impacter les autres environnements.

MétriqueExempleDétecte
Disponibilité= 0 → critiqueNAS injoignable
CPU / Mémoire %> 90 → warningSurcharge
Température °C> 60 → warningSurchauffe
Remplissage volume %> 90 → warningVolume plein
Volumes dégradés> 0 → warningRAID/volume anormal
Disques défaillants> 0 → critiquePanne disque
Sauvegardes en échec / en retard> 0Sauvegarde KO ou douteuse
Alertes actives
critical[Client X] NAS injoignable (aucune réponse)il y a 6 min
warning[Siège] Volume dégradé — 2 volumes en état anormalil y a 1 h
warning[Agence] Sauvegarde à risque — AB365 : activé, aucune tâcheil y a 3 h

Notifications e-mail

Trois niveaux anti-spam : interrupteur maître (tout couper), choix des niveaux de gravité notifiés (cases info / warning / critical en multi-sélection), et coche par type d'alerte (« Notif ✉ » dans chaque règle). À défaut de destinataires, l'e-mail de l'environnement est utilisé.

ℹ️ Un e-mail part si : SMTP actif ET maître ON ET la gravité de l'alerte est cochée dans les niveaux notifiés ET la règle a « Notif ✉ » activé. Dans l'onglet Règles, une note grisée signale une règle dont le niveau n'est pas coché (aucun e-mail malgré ✉).

🤖 Assistant IA

L'assistant IA transforme les données de supervision en analyses claires, en français et actionnables. Trois usages :

FonctionOùCe qu'elle produit
Diagnostic d'alertePage Alertes → bouton « 🤖 Diagnostic »Signification de l'alerte, causes probables et actions priorisées (Haute/Moyenne/Basse).
Analyse par NASFiche NAS → bouton « 🤖 Analyse IA »Bilan du NAS : stockage/volumes, performances (tendance 7 j), disques, sauvegardes, avec recommandations et risques.
Rapport de supervisionTableau de bord → bouton « 🤖 Rapport IA »Bilan de parc structuré (sujets importants, actions, risques) — prêt à transmettre au client.
🇫🇷 Confidentialité & souveraineté : les appels IA se font côté serveur ; aucune donnée ni clé n'est exposée au navigateur. Le traitement repose sur un modèle d'IA interne, hébergé en France ou en local — vos données ne partent pas chez un géant du cloud.

Le nombre d'analyses IA par jour dépend de l'offre (essai : 5/jour ; Starter : 25 ; Pro : 75 ; Illimité : 300). Un compteur indique les analyses restantes ; au-delà, un message invite à passer à l'offre supérieure.

Analyse IA du NAS
À surveillerVolumes et disques sains ; mémoire élevée (moy. 92 %, pic 95 %) à investiguer.
⚡ Mémoire élevée · RTS INDUSTRIE — seuil 90 % dépasséSujet
HauteIdentifier les services gourmands en RAM et redémarrer ceux concernés.

Sauvegardes

SynoCockpit remonte l'état réel quand DSM l'expose. Sources :

HBHyper BackupABPosteActive Backup for BusinessAB365Microsoft 365ABGSuiteGoogle WorkspaceARXCloud ArxOneCSCloud Sync (Dropbox, OneDrive, Google Drive…)

ÉtatSignification
VertDernière sauvegarde vérifiée réussie.
Gris « installé — non vérifié »Paquet présent mais DSM n'expose pas le résultat (ex. poste protégé : état sur le serveur ABB).
Orange « activé mais aucune tâche »Le module tourne mais ne sauvegarde rien — à corriger.
RougeDernière sauvegarde en échec.
💡 Le bouton « 🩺 Diagnostic sauvegardes » (fiche NAS) montre exactement ce que DSM expose.
Sauvegardes (fiche NAS)
Sauvegarde DriveHBdone
Active Backup 365AB365activé, aucune tâche
Agent (NAS protégé)ABPosteinstallé — non vérifié
Sauvegarde cloudARXà jour

Connecteur ArxOne

Paramètres → onglet « Connecteurs » → ArxOne : activez la corrélation et renseignez le token API (seul champ nécessaire — les comptes sont découverts automatiquement). La liaison des machines aux NAS se fait dans le menu « Sauvegardes ArxOne ».

Sur la fiche d'un NAS corrélé, une carte « Activité de sauvegarde ArxOne » affiche l'état de l'agent, la dernière sauvegarde, le quota cloud (volume sauvegardé / alloué), un calendrier d'activité (30 jours) et une courbe de volume. ArxOne ne fournissant pas d'historique, le calendrier et la courbe se construisent jour après jour à partir des relevés.

Groupes & tags de NAS

Les tags font office de groupes. Sur la page NAS, cochez plusieurs NAS puis « Ajouter le tag » pour créer/gérer un groupe (ou éditez le champ Tags d'une NAS). Filtrez ensuite par tag.

UsageDétail
OrganisationRegrouper par site, criticité, client…
Portée des alertesUne règle peut être limitée à un tag (« lot »).
Sauvegardes attenduesTags HB, ABPoste, AB365, ABGSuite, ARX = « ce NAS doit avoir cette sauvegarde » → alerte si absente/en échec.
💡 Taguez AB365 les NAS censés sauvegarder Microsoft 365 : la règle « Sauvegarde attendue manquante » alertera si l'un d'eux n'a pas de sauvegarde 365 saine.

API & intégrations

API REST lecture seule pour vos outils (RMM, ticketing, dashboards).

  1. Mon compte → Mes clés d'API → Générer (clé affichée une seule fois ; filtrage IP possible).
  2. En-tête X-API-Key: VOTRE_CLE sur chaque requête. La clé sélectionne votre environnement.
  3. Documentation interactive Swagger disponible dans l'app et sur le domaine docs.….
Exemple
curl -H "X-API-Key: VOTRE_CLE" https://api.mondomaine.fr/api/v1/overview
EndpointRetour
/api/v1/healthÉtat global (ok/critical)
/api/v1/overviewCompteurs : NAS, en ligne, hors ligne, mises à jour, clients, alertes
/api/v1/clientsListe des clients (identifiant, nom, référence, nombre de NAS)
/api/v1/servers, /servers/{id}Inventaire, état, volumes, disques, sauvegardes, alertes
/api/v1/servers/{id}/metricsHistorique des métriques d'un NAS
/api/v1/backups, /api/v1/arxoneSauvegardes du parc (HB, Active Backup, M365, Google Workspace, Cloud Sync) / cloud ArxOne
/api/v1/alerts?state=&server_id=Alertes filtrables

Confidentialité des données (RGPD)

Par défaut, votre environnement est protégé : le support SynoCockpit n'accède pas à vos données, même pour du dépannage. Pour une intervention, décochez la protection dans Paramètres → Confidentialité et fixez une date de fin : l'accès se referme automatiquement ensuite.

Abonnement

Essai 15 jours puis Starter (49€, ≤20 NAS), Pro (79€, ≤100 NAS) ou Illimité (149€). Paiement par prélèvement SEPA (mandat signé) ou carte bancaire, géré depuis le menu Abonnement. Le volume d'analyses IA augmente selon l'offre (25 / 75 / 300 par jour).

Sans engagement, au mois le mois, avec un préavis d'un mois.

Demander un accès →

Contrat & signature électronique

Le passage de l'essai à la commande s'accompagne de la signature du contrat (CGV/CGU). Le client lit l'intégralité du contrat (défilement obligatoire), coche les cases de validation explicites (dont la renonciation au droit de rétractation, la sécurité/RGPD et les responsabilités NAS/partenaires), renseigne ses coordonnées de facturation et signe.

Signature à distance : votre prestataire peut envoyer un lien sécurisé valable 72 h pour signer le contrat et/ou déposer le RIB du mandat SEPA, sans connexion. Passé ce délai, un nouveau lien peut être régénéré par e-mail.

La preuve de signature (date, version du contrat, empreinte, coordonnées) est conservée et consultable côté administration. Le contrat est éditable par l'exploitant.