== AWStats ==

AWStats ist ein Tool zur graphischen Auswertung von Logfiles.

mehr Infos unter http://www.awstats.org/

=== Vorarbeiten ===

Als Paketadmin die Logfiles per Eintrag in die config.ini auf die entsprechende Domain verteilen (http_log_directory = domain)
siehe Traffic_logs.

=== Download und Entpacken ===

Login als Domainadmin, in unserem Fall heißt dieser xyz00-doms. In unserem Beispiel verwenden wir die Version 6.9 und laden sie direkt mit wget ins Home-Verzeichnis:
<pre>
xyz00-doms:~$ wget http://prdownloads.sourceforge.net/awstats/awstats-6.9.tar.gz
</pre>
Datei entpacken:
<pre>
xyz00-doms:~$ tar -xvzf awstats-6.9.tar.gz
</pre>
Die entpackten Ordner verteilen:
<pre>
xyz00-doms:~$ mv awstats-6.9/wwwroot/cgi-bin/ doms/example.com/cgi/awstats
xyz00-doms:~$ mv awstats-6.9/wwwroot/icon doms/example.com/subs/www/icon
xyz00-doms:~$ mv awstats-6.9/wwwroot/js doms/example.com/subs/www/js
</pre>
Der Rest kann wieder gelöscht werden:
<pre>
xyz00-doms:~$ rm awstats-6.9.tar.gz
xyz00-doms:~$ rm -rf awstats-6.9
</pre>
Verzeichnis anlegen, in das awstats seine Daten schreiben kann:
<pre>
xyz00-doms:~$ mkdir aw_data
</pre>
Verzeichnis anlegen, in das die erzeugten Statistiken abgelegt werden:
<pre>
xyz00-doms:~$ mkdir doms/example.com/subs/www/statistik
</pre>

=== Konfiguration ===
Config-datei zum Editieren öffnen, z.b. mit nano:
<pre>
xyz00-doms:~$ nano doms/example.com/cgi/awstats/awstats.example.com.conf
</pre>

Folgende Einträge sind anzupassen:

* LogFile="gzip -cd /home/doms/example.com/var/*example.com-%YYYY-0%MM-0%DD-0*|"
* SiteDomain="www.example.com"
* DirData="/home/pacs/xyz00/aw_data/"
* DirCgi="/cgi-bin/awstats"
* Lang="de"

Die wichtigsten weiteren Möglichkeiten:

* Um über den Browser eine Jahressortierung zu ermöglichen:
AllowFullYearView=3
* Um Client-Informationen über Javascript auszulesen:
o MiscTrackerUrl="/js/awstats_misc_tracker.js"
o ShowScreenSizeStats=1
o ShowMiscStats=anjdfrqwp

(hinweis: dazu muss die Startseite (index.html) innerhalb des body-tags um folgenden Eintrag ergänzt werden:
<pre>
<script language=javascript src="/js/awstats_misc_tracker.js"></script>
<noscript><img src="/js/awstats_misc_tracker.js?nojs=y" height=0 width=0 border=0 style="display: none"></noscript>
</pre>

Weiterführende Informationen zu den Einträgen in der Config-Datei sind hier zu finden: http://awstats.sourceforge.net/docs/awstats_config.html

Config-Datei unter cgi/awstats/awstats.example.com.conf abspeichern.
=== Rechtevergabe ===

Folgende Rechte müssen wir noch setzen:
<pre>
Prüfen:
xyz00-doms:~$ chmod 755 doms/example.com/cgi/awstats/lang
xyz00-doms:~$ chmod 755 doms/example.com/cgi/awstats/lib
xyz00-doms:~$ chmod 755 doms/example.com/cgi/awstats/plugins
xyz00-doms:~$ chmod 755 doms/example.com/cgi/awstats/awstats.pl
xyz00-doms:~$ chmod 755 doms/example.com/cgi/awstats/awredir.pl
xyz00-doms:~$ chmod 755 doms/example.com/subs/www/icon
xyz00-doms:~$ chmod 755 doms/example.com/subs/www/js

Ändern:
xyz00-doms:~$ chmod 644 doms/example.com/cgi/awstats/awstats.example.com.conf
xyz00-doms:~$ chmod 777 aw_data
</pre>

=== Ausführen und Automatisieren ===

Falls schon ein Log-file für den aktuellen Tag vorhanden ist, kann

awstats durch folgenden Befehl gestartet werden (alles in einer Zeile!):
<pre>
xyz00-doms:~$ /home/doms/example.com/cgi/awstats/awstats.pl -config=example.com -update -output > /home/doms/example.com/subs/www/statistik/index.html
</pre>

Diesen Befehl kann man z.B. mit dem [[Eventhandler]] @weblogsplit verbinden. Mit Cronjobs lässt sich der Aufruf natürlich auch automatisieren.

Die Statistiken sind dann im web unter www.example.com/statistik/ erreichbar.

== Weitere WebStatistik Tools bei HS ==

[[Analog_installieren|analog]]

[[visitors]]

[[Piwik Installieren|Piwik]]

----
[[Kategorie:HSDoku]]
[[Kategorie:Installationsanleitungen]]
[[Kategorie:Software]]

Matomo Installieren

2011-06-21T15:17:29Z

Ves00: 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…“

[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).

Piwik 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 http://piwik.org/latest.zip
$ unzip latest.zip
$ 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:

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

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

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.

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

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.

<pre>

<script type="text/javascript">
var pkBaseURL = (("https:" == document.location.protocol) ? "https://www.mydomain.de/piwik/" : "http://www.mydomain.de/piwik/");
document.write(unescape("%3Cscript src='" + pkBaseURL + "piwik.js' type='text/javascript'%3E%3C/script%3E"));
</script><script type="text/javascript">
try {
var piwikTracker = Piwik.getTracker(pkBaseURL + "piwik.php", 1);
piwikTracker.trackPageView();
piwikTracker.enableLinkTracking();
} catch( err ) {}
</script><noscript><p><img src="http://www.mydomain.de/piwik/piwik.php?idsite=1" style="border:0" alt="" /></p></noscript>

</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.

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.

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:
<pre>
[Tracker]
ip_address_mask_length = 2
</pre>

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.

<pre>
[Tracker]
ip_address_mask_length = 2
cookie_expire = 640800
</pre>

=== 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.

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

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

----

[[Kategorie:HSDoku]]
[[Kategorie:Installationsanleitungen]]
[[Kategorie:Software]]