Configure IPFabric MCP server for topology discovery #47

Closed
opened 2026-07-09 08:23:58 +00:00 by Damien · 0 comments
Owner

Remplace l'approche SVG manuelle (Inkscape) par une découverte automatique de la topologie via IPFabric.

  • Déployer/configurer le serveur MCP IPFabric (officiel, intégré à l'appliance) pointant vers l'instance IPFabric du lab
  • Renseigner l'URL et un token API (rôle avec accès lecture Inventory/Snapshots/Discovery)
  • Valider la connexion et lister le snapshot du lab (sites : campus, core, dc — le site "core" regroupe core1 et core2)
  • Documenter le mapping entre les noms de devices IPFabric et les noms de devices Containerlab (doivent correspondre pour l'étape de génération auto)

Endpoints API validés (callable avec le token actuel) :

  • GET /snapshots — sélection du snapshot à traiter
  • POST /tables/inventory/devices — génère les nœuds (hostname, siteName, vendor, model, sn)
  • POST /tables/interfaces/connectivity-matrix — génère les liens : paires de devices connectés + noms d'interface de chaque côté (localHost/localInt/remoteHost/remoteInt/protocol). Endpoint clé pour construire les liens bidirectionnels.
  • POST /tables/inventory/interfaces (optionnel) — enrichissement speed/media/l1-l2 status, pour griser un lien down

Endpoints écartés : /tables/neighbors/* (redondant avec connectivity-matrix), PoE/802.1x/UDLD/LDP/stacks/cloud (hors périmètre), /tables/inventory/summary/* (reporting, pas topologie).

Point d'attention mapping interface : les noms d'interface remontés par connectivity-matrix (ex. Ethernet1) doivent correspondre aux labels name/source exposés par gnmic. Si désynchronisation, fallback possible via interface aliasing dans la config gnmic plutôt que complexifier le script de génération (#48).

Remplace l'approche SVG manuelle (Inkscape) par une découverte automatique de la topologie via IPFabric. - Déployer/configurer le serveur MCP IPFabric (officiel, intégré à l'appliance) pointant vers l'instance IPFabric du lab - Renseigner l'URL et un token API (rôle avec accès lecture Inventory/Snapshots/Discovery) - Valider la connexion et lister le snapshot du lab (sites : campus, core, dc — le site "core" regroupe core1 et core2) - Documenter le mapping entre les noms de devices IPFabric et les noms de devices Containerlab (doivent correspondre pour l'étape de génération auto) **Endpoints API validés (callable avec le token actuel) :** - `GET /snapshots` — sélection du snapshot à traiter - `POST /tables/inventory/devices` — génère les nœuds (hostname, siteName, vendor, model, sn) - `POST /tables/interfaces/connectivity-matrix` — génère les liens : paires de devices connectés + noms d'interface de chaque côté (localHost/localInt/remoteHost/remoteInt/protocol). Endpoint clé pour construire les liens bidirectionnels. - `POST /tables/inventory/interfaces` (optionnel) — enrichissement speed/media/l1-l2 status, pour griser un lien down Endpoints écartés : `/tables/neighbors/*` (redondant avec connectivity-matrix), PoE/802.1x/UDLD/LDP/stacks/cloud (hors périmètre), `/tables/inventory/summary/*` (reporting, pas topologie). **Point d'attention mapping interface :** les noms d'interface remontés par `connectivity-matrix` (ex. `Ethernet1`) doivent correspondre aux labels `name`/`source` exposés par gnmic. Si désynchronisation, fallback possible via interface aliasing dans la config gnmic plutôt que complexifier le script de génération (#48).
Damien added the telemetry label 2026-07-09 08:23:58 +00:00
Damien reopened this issue 2026-07-09 14:02:13 +00:00
Damien added reference feat/telemetry 2026-07-10 13:01:26 +00:00
Damien changed reference from feat/telemetry to feat/telemetry 2026-07-10 13:01:30 +00:00
Sign in to join this conversation.