Topologie et statistiques de visite

La page Topology de kuploy.app montre où tournent vos instances kuploy-cloud et quel trafic de visiteurs elles servent. Elle vous sert à confirmer que vos clusters rendent bien compte, à comparer leur portée, et à exporter des instantanés pour vos propres rapports.

Elle regroupe trois choses, pour le compte exploitant sous lequel vous êtes connecté :

• Les clusters — une ligne par instance sous licence, avec sa ville et son pays, ses coordonnées, l'heure de son dernier signe de vie, et le nombre d'organisations qu'elle héberge.
• La portée auprès des visiteurs — les principaux pays et les principales villes des 30 derniers jours, agrégés sur toutes vos instances.
• Les sessions dans le temps — une courbe journalière sur les 7, 30 ou 90 derniers jours.

Toutes ces données sont cloisonnées par exploitant. Vous ne voyez jamais que les lignes des instances rattachées à votre propre licence.

Comment les données y parviennent

Chaque instance kuploy-cloud rapporte deux choses lors de sa synchronisation de licence horaire :

1. L'emplacement du cluster — la ville, le pays et les coordonnées du cluster, détectés automatiquement au démarrage d'après son adresse IP publique. Stockés une fois par instance, et mis à jour si l'emplacement change.
2. Un résumé des visiteurs — les principaux pays, les principales villes et les totaux de sessions des 30 derniers jours, préalablement agrégés.

La charge utile est agrégée avant de quitter votre cluster. Les adresses IP brutes et les données individuelles ne sortent jamais de l'instance : seuls les N premiers paniers et leurs décomptes la quittent.

Vous n'avez rien à configurer : dès lors qu'une instance kuploy-cloud est sous licence et joignable, ses données apparaissent sur la page Topology après la synchronisation suivante.

Lire la page Topology

Les totaux

Quatre cartes, en haut :

Carte	Ce qu'elle montre
Instances	Le nombre de vos instances ayant déjà rapporté un emplacement.
Organizations	Le total des organisations, toutes instances confondues.
Sessions (30d)	Le dernier décompte glissant de sessions sur 30 jours, cumulé sur vos instances.
Countries reached	Le nombre de pays distincts observés dans l'ensemble des paniers de pays.

Les sessions dans le temps

Une courbe des sessions journalières de visiteurs. Chaque point est la somme du dernier instantané rapporté ce jour-là par chaque instance. Changez la plage avec les onglets 7d / 30d / 90d.

Si le graphique indique « No data yet » pour une plage, c'est qu'aucune instance n'a rapporté de statistiques de visite dans cette fenêtre.

Les principaux pays, les principales villes

Agrégés depuis le dernier résumé de visiteurs de chaque instance. La longueur des barres est relative au plus grand panier de la liste.

Le tableau des instances

Colonne	Description
Instance	Le nom que vous avez donné à l'instance lors de sa revendication, avec son URL en dessous.
Location	La ville, le pays et la latitude/longitude. « — » si le cluster n'a pas pu se géolocaliser : pas d'accès sortant, plage privée.
Orgs	Le nombre d'organisations que cette instance héberge actuellement.
Sessions (30d)	Le dernier décompte de sessions sur 30 jours rapporté par cette instance.
Last seen	La dernière fois que cette instance a rapporté son emplacement avec succès.

Exporter en CSV

Chaque tableau et la courbe temporelle disposent d'un bouton Export CSV. Les fichiers comportent une marque d'ordre des octets UTF-8, pour qu'Excel et Numbers les ouvrent d'emblée avec le bon encodage.

Bouton	Fichier
Le tableau des instances	topology-instances.csv
Les sessions dans le temps	topology-sessions-{plage}.csv

Servez-vous de ces CSV pour vos rapports mensuels, vos présentations au conseil, ou une importation dans votre propre outil décisionnel.

Vie privée et limites des données

Ce qui est envoyé de votre cluster vers kuploy.app lors de la synchronisation de licence :

• la ville, le pays et les coordonnées du cluster — la machine, et non vos utilisateurs finaux ;
• les N premiers pays et les N premières villes, agrégés ;
• des décomptes — le total des sessions, le nombre de sessions par pays et par ville.

Ce qui n'est pas envoyé :

• les adresses IP brutes ;
• les identifiants d'utilisateur, de session ou les chemins de requête ;
• un détail par organisation, dans la charge utile des visiteurs.

Les bases de données de vos clusters (cloud_cluster_regions, cloud_session_locations) conservent les données en pleine résolution, pour un usage interne à votre instance — le globe de la page d'accueil, par exemple. Seuls les agrégats sont recopiés en amont.

Dépannage

Mon instance n'apparaît pas

1. Vérifiez qu'elle se synchronise : Settings → License, sur l'instance kuploy-cloud, doit afficher un Last sync récent.
2. Vérifiez qu'elle a un emplacement de cluster : sur le Postgres de l'instance, SELECT * FROM cloud_cluster_regions WHERE is_local = true; doit renvoyer une ligne avec une latitude et une longitude non nulles. L'emplacement est résolu une fois, au démarrage ; un cluster sans accès sortant ne se géolocalisera pas et n'apparaîtra pas sur la page Topology.
3. Attendez un cycle de synchronisation — jusqu'à une heure — après la mise sous licence d'une nouvelle instance.

Les sessions restent bloquées à zéro

Les données de visite viennent de cloud_session_locations, que remplit la chaîne de géolocalisation par IP du globe de la page d'accueil. Si le globe n'est pas activé, ou si aucun visiteur n'a encore atteint un point d'accès géo-résolu, la valeur restera à 0 — c'est normal : cela signifie simplement que rien n'a encore été agrégé pour cette instance.

L'emplacement est faux

La géolocalisation par IP d'un cluster peut sembler fausse si l'adresse de sortie appartient au point de présence de périphérie d'une région d'hébergeur — ce qui est courant avec un Kubernetes géré. Vous pouvez corriger la ligne de cloud_cluster_regions directement : la page Topology reflète la ligne is_local = true, quelle qu'elle soit. À la synchronisation suivante, les valeurs corrigées apparaîtront en amont.