Matomo Installieren: Unterschied zwischen den Versionen

Aus Hostsharing Wiki
Zur Navigation springen Zur Suche springen
(Die Seite wurde neu angelegt: „[http://piwik.org/ Piwik] ist eine Open Source-Alternative zu Google Analytics und anderen Analysetools. Es kann datenschutzkonform eingerichtet werden und ist ma…“)
 
 
(13 dazwischenliegende Versionen von 5 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
[http://piwik.org/ Piwik] ist eine Open Source-Alternative zu Google Analytics und anderen Analysetools. Es kann datenschutzkonform eingerichtet werden und ist mandantenfähig (in Piwik eingerichtete User sehen nur die Daten der für sie freigeschalteten Domains).  
[https://matomo.org/ Matomo] (früher Piwik) ist eine Open Source-Alternative zu Google Analytics und anderen Analysetools. Es kann datenschutzkonform eingerichtet werden und ist mandantenfähig. In Matomo eingerichtete User sehen nur die Daten der für sie freigeschalteten Domains.  


Piwik benötigt serverseitig [[PHP]] und [[MySQL]] (oder [[PostgreSQL]]) und setzt im Default clientseitig JavaScript voraus. Statische Zählpixel sind alternativ möglich.
Dabei ist eine Installation von Matomo für alle zu analysierenden Webseiten ausreichend. Zum Einrichten von weiteren Webseiten, die Matomo überwachen soll, siehe [[Matomo]].
 
Matomo benötigt serverseitig [[PHP]] und [[MySQL]] (oder [[PostgreSQL]]) und setzt im Default clientseitig JavaScript voraus. Statische Zählpixel sind alternativ möglich.


== Download und Installation ==
== Download und Installation ==


  $ cd
  $ cd
  $ wget http://piwik.org/latest.zip
  $ wget https://builds.matomo.org/matomo-latest.zip
  $ unzip latest.zip
  $ unzip matomo-latest.zip
  $ mv piwik /home/pacs/xyz00/users/otto/doms/mydomain.de/subs/www/.
  $ mv piwik /home/pacs/xyz00/users/otto/doms/mydomain.de/subs/www/.


Bei einer Installation von komplexen Anwendungen wie z.B. [[Plone]] kann es notwendig sein, die Zugriffe auf den Unterordner piwik vor anderen RewriteRule-Anweisungen einzufügen, damit die Installation erreicht werden kann:   
=== Apache Rewrite ===
 
Bei einer Installation von komplexen Anwendungen wie z.B. [[Plone]] kann es notwendig sein, die Zugriffe auf den Unterordner matomo vor anderen RewriteRule-Anweisungen einzufügen, damit die Installation erreicht werden kann:   


  $ vim /home/pacs/xyz00/users/otto/doms/mydomain.de/subs/www/.htaccess
  $ vim /home/pacs/xyz00/users/otto/doms/mydomain.de/subs/www/.htaccess
Zeile 17: Zeile 21:
  RewriteCond %{SERVER_PORT} ^80$
  RewriteCond %{SERVER_PORT} ^80$
  RewriteCond %{REQUEST_URI} !=/index.php
  RewriteCond %{REQUEST_URI} !=/index.php
  RewriteRule ^piwik/(.*)$ piwik/$1 [L,PT]
  RewriteRule ^matomo/(.*)$ matomo/$1 [L,PT]
 
=== Installationsassistent ===
 
Dann die Seite http://www.mydomain.de/matomo aufrufen und den Installationsassistenten durchklicken. Hierbei müssen Fragen zur MySQL-Anbindung, dem Matomo-Superuser und der ersten Webseite, die in Matomo ausgewertet werden soll, beantwortet werden. Der Assistent weist mit deutlicher Farbgebung und einem "Fortschrittsbalken" auf den Fortschritt der Installation hin.
 
Matomo behauptet von sich eine "5-Minuten-Installation" zu ermöglichen ([https://matomo.org/faq/on-premise/installing-matomo/ offizielle Installationsanleitung]).
 
Für die Installation sind die Anleitungen von Hostsharing zum Anlegen und Verwalten von [[Datenbanken]] hilfreich. Folgende Angaben müssen für Matomo bereitgehalten werden:
* Adresse des Datenbankservers ("localhost")
* der Name der angelegten Datenbank
* der vergebene DB-Benutzername (z.B. xyz00_otto)
* das DB-Passwort, das beim Anlegen dieser Datenbank für xyz00_otto vergeben wurde)
* ein (optionales) Datenbank-Prefix (Voreinstellung: matomo)
 
Danach wird ein Superuser-Account angelegt, der über einen frei definierbaren Benutzernamen, ein Passwort und eine Mailadresse definiert wird.
 
Standardmäßig werden Daten der ersten Webseite, die erfasst werden soll, mit abgefragt. Wichtigste Angaben sind Name und URL.
 
=== Debugging ===
siehe https://github.com/matomo-org/matomo/blob/4.x-dev/config/global.ini.php#L94-L116
 
In die Datei matomo/config/config.inc.php kann eingesetzt werden:


Dann die Seite http://www.mydomain.de/piwik aufrufen und den Assistenten durchklicken. Hierbei müssen Fragen zur MySQL-Anbindung, dem Piwik-Superuser und der ersten Webseite, die in Piwik ausgewertet werden soll, beantwortet werden. Piwik behauptet von sich eine "5-Minuten-Installation" zu ermöglichen.
[log]
log_writers[] = "file"
logger_file_path = "/home/pacs/xyz00/users/otto/matomo.log"
log_level_file = "DEBUG"


Hierfür sind die Anleitungen von Hostsharing zum Anlegen und Verwalten von [[Datenbanken]] hilfreich.
=== Update durchführen ===


Die Analyse geschieht zumeinst über ein JavaScript-Snippet, der in jede zu berücksichtigende Seite einzufügen ist und das beim Aufruf geladen wird. Die allgemeine Empfehlung ist, das als letzten Teil des HTML vor dem <code></body></code>-Tag zu tun.
siehe auch https://matomo.org/faq/on-premise/update-matomo/


<pre>
# Sicherung erstellen
<!-- Piwik -->
tar czf matomo-backup.tar.gz matomo
<script type="text/javascript">
# see https://github.com/matomo-org/matomo/releases
var pkBaseURL = (("https:" == document.location.protocol) ? "https://www.mydomain.de/piwik/" : "http://www.mydomain.de/piwik/");
wget https://github.com/matomo-org/matomo/releases/download/4.16.1/matomo-4.16.1.tar.gz
document.write(unescape("%3Cscript src='" + pkBaseURL + "piwik.js' type='text/javascript'%3E%3C/script%3E"));
tar xzf matomo-4.16.1.tar.gz
</script><script type="text/javascript">
rm How\ to\ install\ Matomo.html
try {
cd matomo
var piwikTracker = Piwik.getTracker(pkBaseURL + "piwik.php", 1);
./console diagnostics:unexpected-files
piwikTracker.trackPageView();
./console diagnostics:unexpected-files --delete
piwikTracker.enableLinkTracking();
./console core:update
} catch( err ) {}
</script><noscript><p><img src="http://www.mydomain.de/piwik/piwik.php?idsite=1" style="border:0" alt="" /></p></noscript>
<!-- End Piwik Tracking Code -->
</pre>


Hier ist zu beachten, dass der Code einen Parameter <code>"idsite=n"</code> enthält, wobei der Wert von '<code>n</code>' je nach zu analysierender Webseite verschieden ist. Der Code wird sinnvollerweise in den Piwik-Einstellungen unter "neue Webseite hinzufügen" generiert.
== Datenschutz ==


Um die Installation gemäß deutschen Rechts datenschutzkonform zu halten empfiehlt sich eine Anpassung gemäß der Vorgaben des [https://www.datenschutzzentrum.de/ Unabhängigen Datenschutzzentrums Schleswig-Holstein], die [https://www.datenschutzzentrum.de/tracking/piwik/ als PDF heruntergeladen werden] kann.
Um die Installation gemäß deutschen Rechts datenschutzkonform zu halten empfiehlt sich eine Anpassung gemäß der Vorgaben des [https://www.datenschutzzentrum.de/ Unabhängigen Datenschutzzentrums Schleswig-Holstein], die [https://www.datenschutzzentrum.de/uploads/projekte/verbraucherdatenschutz/20110315-webanalyse-piwik.pdf als PDF heruntergeladen werden] kann.


Das gesamte Dokument wird zum Lesen empfohlen. Hieraus sind u.a. wichtig:
Das gesamte Dokument wird zum Lesen empfohlen. Hieraus sind u.a. wichtig:
Zeile 65: Zeile 90:
=== Abschnitt 3.2 "Widerspruchsmöglichkeit bereitstellen" ===
=== Abschnitt 3.2 "Widerspruchsmöglichkeit bereitstellen" ===


Piwik ermöglicht opt-out mittels der Nutzung eines eines Cookies. Die Möglichkeit hierzu ist dem User der Webseite bereitzustellen.  Die Einbindung erfolgt über einen IFrame, dessen Code im Piwik unter Einstellungen > Allgemeine Einstellungen > "Piwik-Deaktivierung für Ihre Besucher" zu finden ist.
Piwik ermöglicht opt-out mittels der Nutzung eines Cookies. Die Möglichkeit hierzu ist dem User der Webseite bereitzustellen.  Die Einbindung erfolgt über einen IFrame, dessen Code im Piwik unter Einstellungen > Allgemeine Einstellungen > "Piwik-Deaktivierung für Ihre Besucher" zu finden ist.


<pre>
<pre>
Zeile 72: Zeile 97:


Siehe auch hierzu die Erläuterungen im oben verlinkten PDF.
Siehe auch hierzu die Erläuterungen im oben verlinkten PDF.
== Weitere WebStatistik Tools bei HS ==
* [[AWStats_installieren|AWStat]]
* [[Goaccess]]
* [[Matomo Installieren|Matomo]]


----
----
Zeile 78: Zeile 109:
[[Kategorie:Installationsanleitungen]]
[[Kategorie:Installationsanleitungen]]
[[Kategorie:Software]]
[[Kategorie:Software]]
[[Kategorie:WebStatistik]]
[[Kategorie:Piwik]]
[[Kategorie:Matomo]]

Aktuelle Version vom 18. April 2024, 16:55 Uhr

Matomo (früher Piwik) ist eine Open Source-Alternative zu Google Analytics und anderen Analysetools. Es kann datenschutzkonform eingerichtet werden und ist mandantenfähig. In Matomo eingerichtete User sehen nur die Daten der für sie freigeschalteten Domains.

Dabei ist eine Installation von Matomo für alle zu analysierenden Webseiten ausreichend. Zum Einrichten von weiteren Webseiten, die Matomo überwachen soll, siehe Matomo.

Matomo benötigt serverseitig PHP und MySQL (oder PostgreSQL) und setzt im Default clientseitig JavaScript voraus. Statische Zählpixel sind alternativ möglich.

Download und Installation

$ cd
$ wget https://builds.matomo.org/matomo-latest.zip
$ unzip matomo-latest.zip
$ mv piwik /home/pacs/xyz00/users/otto/doms/mydomain.de/subs/www/.

Apache Rewrite

Bei einer Installation von komplexen Anwendungen wie z.B. Plone kann es notwendig sein, die Zugriffe auf den Unterordner matomo vor anderen RewriteRule-Anweisungen einzufügen, damit die Installation erreicht werden kann:

$ vim /home/pacs/xyz00/users/otto/doms/mydomain.de/subs/www/.htaccess

RewriteBase /
RewriteCond %{SERVER_PORT} ^80$
RewriteCond %{REQUEST_URI} !=/index.php
RewriteRule ^matomo/(.*)$ matomo/$1 [L,PT]

Installationsassistent

Dann die Seite http://www.mydomain.de/matomo aufrufen und den Installationsassistenten durchklicken. Hierbei müssen Fragen zur MySQL-Anbindung, dem Matomo-Superuser und der ersten Webseite, die in Matomo ausgewertet werden soll, beantwortet werden. Der Assistent weist mit deutlicher Farbgebung und einem "Fortschrittsbalken" auf den Fortschritt der Installation hin.

Matomo behauptet von sich eine "5-Minuten-Installation" zu ermöglichen (offizielle Installationsanleitung).

Für die Installation sind die Anleitungen von Hostsharing zum Anlegen und Verwalten von Datenbanken hilfreich. Folgende Angaben müssen für Matomo bereitgehalten werden:

  • Adresse des Datenbankservers ("localhost")
  • der Name der angelegten Datenbank
  • der vergebene DB-Benutzername (z.B. xyz00_otto)
  • das DB-Passwort, das beim Anlegen dieser Datenbank für xyz00_otto vergeben wurde)
  • ein (optionales) Datenbank-Prefix (Voreinstellung: matomo)

Danach wird ein Superuser-Account angelegt, der über einen frei definierbaren Benutzernamen, ein Passwort und eine Mailadresse definiert wird.

Standardmäßig werden Daten der ersten Webseite, die erfasst werden soll, mit abgefragt. Wichtigste Angaben sind Name und URL.

Debugging

siehe https://github.com/matomo-org/matomo/blob/4.x-dev/config/global.ini.php#L94-L116

In die Datei matomo/config/config.inc.php kann eingesetzt werden:

[log]
log_writers[] = "file"
logger_file_path = "/home/pacs/xyz00/users/otto/matomo.log"
log_level_file = "DEBUG"

Update durchführen

siehe auch https://matomo.org/faq/on-premise/update-matomo/

# Sicherung erstellen
tar czf matomo-backup.tar.gz matomo
# see https://github.com/matomo-org/matomo/releases
wget https://github.com/matomo-org/matomo/releases/download/4.16.1/matomo-4.16.1.tar.gz
tar xzf matomo-4.16.1.tar.gz
rm How\ to\ install\ Matomo.html
cd matomo
./console diagnostics:unexpected-files
./console diagnostics:unexpected-files --delete
./console core:update

Datenschutz

Um die Installation gemäß deutschen Rechts datenschutzkonform zu halten empfiehlt sich eine Anpassung gemäß der Vorgaben des Unabhängigen Datenschutzzentrums Schleswig-Holstein, die als PDF heruntergeladen werden kann.

Das gesamte Dokument wird zum Lesen empfohlen. Hieraus sind u.a. wichtig:

Abschnitt 3.1 "Plugin AnonymizeIP einsetzen"

Hierfür ist im Piwik-Menü als superuser das Plugin zu aktivieren: Einstellungen > Plugins > AnonymizeIP aktivieren. Die Anzahl der zu kürzenden Oktale gibt man über eine Konfiguration in config/config.ini.php an:

[Tracker]
ip_address_mask_length = 2

Mit dieser Einstellung wird die IP-Adresse z.B. als 89.247.0.0 angezeigt. Siehe hierzu die Erläuterungen im oben verlinkten PDF. Nach Abschnitt 3.6 soll die Lebensdauer der Cookies auf kleine Werte, z.B. weniger als 1 Woche (640800 Sekunden) gesetzt werden.

[Tracker]
ip_address_mask_length = 2
cookie_expire = 640800


Abschnitt 3.2 "Widerspruchsmöglichkeit bereitstellen"

Piwik ermöglicht opt-out mittels der Nutzung eines Cookies. Die Möglichkeit hierzu ist dem User der Webseite bereitzustellen. Die Einbindung erfolgt über einen IFrame, dessen Code im Piwik unter Einstellungen > Allgemeine Einstellungen > "Piwik-Deaktivierung für Ihre Besucher" zu finden ist.

<iframe frameborder="no" width="600px" height="200px" src="http://www.example.com/x_piwik/index.php?module=CoreAdminHome&action=optOut&language=de"></iframe>

Siehe auch hierzu die Erläuterungen im oben verlinkten PDF.

Weitere WebStatistik Tools bei HS