Umami

Umami est un outil d’analytics open source respectueux de la vie privée. Metribay lit depuis des serveurs Umami que tu héberges.

Ce que tu obtiens

Métrique	Signification	Valeur sur la période
Visitors	Visiteurs uniques	Visiteurs uniques exacts sur toute la période, depuis Umami
Visits	Visites (sessions)	Somme des jours
Page views	Pages vues	Somme des jours

Les jours sont comptés en UTC. Le tableau de bord Umami utilise le fuseau de ton navigateur, donc les jours isolés peuvent différer légèrement. Les totaux sur la période concordent.

Avant de commencer

Umami self-hosted uniquement

Metribay se connecte à Umami avec identifiant et mot de passe, ce qui fonctionne avec Umami self-hosted. Umami Cloud utilise des clés API et n’est pas encore pris en charge.

Ton serveur Umami doit être joignable depuis Internet :

• en HTTPS sur le port standard 443,
• à une adresse publique. Les serveurs sur un réseau privé, derrière un VPN ou joignables seulement par IP interne ne sont pas accessibles.

Étape 1 : Créer un utilisateur pour Metribay

Tu peux utiliser ton propre login Umami, mais un utilisateur séparé est plus sûr : il garde ton mot de passe admin hors de Metribay et tu peux le retirer à tout moment.

1. Dans Umami, va dans Settings → Users et crée un utilisateur, par exemple metribay, avec le rôle View only.

2. Donne à cet utilisateur l’accès aux sites à suivre. Dans Umami, cela signifie en général l’ajouter à l’équipe qui possède les sites.

3. Connecte-toi une fois en tant que nouvel utilisateur pour vérifier qu’il voit les sites.

Étape 2 : Le connecter dans Metribay

1. Sur la page projet, sélectionne Add data source et choisis Umami.

2. Ouvre Connect an account with your own credentials et remplis :

   • Server URL : l’adresse à laquelle tu ouvres Umami, comme https://analytics.example.com. N’ajoute pas /login ou d’autres chemins.
   • Username et Password de l’utilisateur de l’étape 1.

3. Sélectionne Save account and continue. Metribay se connecte pour vérifier les détails.

4. Choisis un site dans la liste. Tu peux chercher par nom ou domaine.

5. Sélectionne Add and start import.

Saisir le site à la main

Ouvre Enter it manually et colle Website UUID. Dans Umami, trouve-le sous Settings → Websites → Edit comme Website ID, par exemple 4fb7fa4c-5b46-438d-94b3-3a8fb9bc2e8b.

Si la collecte échoue

« Use a public HTTPS server URL on port 443. » L’adresse commence par http://, a un port comme :3000 ou des segments en trop. Utilise l’adresse simple https://.

Le site n’est pas listé. L’utilisateur ne le voit pas. Vérifie son accès dans Umami, puis sélectionne Refresh list.

« Needs attention » alors que ça marchait. Le mot de passe de l’utilisateur a peut-être changé, ou le serveur est injoignable. Connecte-toi à Umami avec les mêmes identifiants pour vérifier, puis mets à jour le compte connecté.

Voir aussi Dépannage.