Umami

Umami ist ein datenschutzfreundliches Open-Source-Analysetool. Metribay liest von Umami-Servern, die du selbst betreibst.

Was du bekommst

Kennzahl	Bedeutung	Wert im Zeitraum
Visitors	Eindeutige Besucher	Genaue eindeutige Besucher für den ganzen Zeitraum, von Umami
Visits	Besuche (Sitzungen)	Summe der Tage
Page views	Seitenaufrufe	Summe der Tage

Tage werden in UTC gezählt. Das Umami-Dashboard nutzt die Zeitzone deines Browsers, einzelne Tage können daher leicht abweichen. Die Summen über den Zeitraum stimmen überein.

Bevor du anfängst

Nur selbst gehostetes Umami

Metribay meldet sich mit Benutzername und Passwort bei Umami an. Das funktioniert mit selbst gehostetem Umami. Umami Cloud nutzt stattdessen API-Schlüssel und wird noch nicht unterstützt.

Dein Umami-Server muss aus dem Internet erreichbar sein:

• über HTTPS auf dem Standardport 443,
• unter einer öffentlichen Adresse. Server in einem privaten Netzwerk, hinter einem VPN oder nur intern per IP erreichbare Server kann Metribay nicht erreichen.

Schritt 1: Nutzer für Metribay anlegen

Du kannst deinen eigenen Umami-Login verwenden, ein eigener Nutzer ist aber sicherer: Dein Admin-Passwort bleibt aus Metribay heraus, und du kannst den Nutzer jederzeit entfernen.

1. Geh in Umami zu Settings → Users und leg einen Nutzer an, etwa metribay, mit der Rolle View only.

2. Gib diesem Nutzer Zugriff auf die Websites, die du verfolgen willst. In Umami heißt das meist: ihn dem Team hinzufügen, dem die Websites gehören.

3. Melde dich einmal als neuer Nutzer an und prüf, ob er die Websites sieht.

Schritt 2: In Metribay verbinden

1. Wähle Add source und dann Umami.

2. Öffne Use your own credentials und trag ein:

   • Server URL: die Adresse, unter der du Umami öffnest, etwa https://analytics.example.com. Lass /login und andere Pfade weg.
   • Username und Password des Nutzers aus Schritt 1.

3. Wähle Save account and continue. Metribay meldet sich zur Prüfung an.

4. Wähle eine Website aus der Liste. Du kannst nach Name oder Domain suchen.

5. Wähle ein Projekt und dann Connect and start import.

Website von Hand eintragen

Öffne Enter a resource manually und füge die Website UUID ein. Du findest sie in Umami unter Settings → Websites → Edit als Website ID, etwa 4fb7fa4c-5b46-438d-94b3-3a8fb9bc2e8b.

Wenn die Erfassung fehlschlägt

„Use a public HTTPS server URL on port 443.“ Die Adresse beginnt mit http://, hat eine Portnummer wie :3000 oder zusätzliche Teile. Nimm die schlichte https://-Adresse.

Die Website fehlt in der Liste. Der Nutzer sieht sie nicht. Prüf seinen Zugriff in Umami und wähle dann Refresh resources.

„Needs attention“, obwohl es vorher lief. Vielleicht hat sich das Passwort des Nutzers geändert oder der Server ist nicht erreichbar. Melde dich mit denselben Daten bei Umami an, um das zu prüfen, und aktualisiere dann das gespeicherte Konto.

Siehe auch Fehlerbehebung.