Matomo (software)

Matomo, 이전에 Piwik (/ˈpiːwiːk/로 발음)는 PHP/MySQL 웹서버에서 실행되는 국제 개발자 팀에 의해 개발된 자유와 오픈-소스 웹 분석 응용 프로그램입니다. 그것은 하나 이상의 웹사이트에 대한 온라인 방문을 추적하고 분석을 위해 이들 방문에 대한 보고서를 표시합니다. 2018년 6월 기준으로, Matomo는 1,455,000개 이상의 웹사이트, 또는 알려진 트래픽 분석 도구를 갖는 모든 웹사이트의 1.3%에서 사용되었고, 54개 언어로 번역되어 왔습니다. 새 버전이 정기적으로 출시됩니다.

Prerequisites

Piwiki의 정상적인 사용을 위해서는 다음이 필요합니다:

• Webserver such as Apache, Nginx, IIS, or others;
• PHP 5.5.9 (recommendend PHP 7);
• MySQL > 5.7, or MariaDB;
• PHP extensions: php-curl php-gd php-cli php-geoip php-mysql

Make Ubuntu Package

데비안 패키지는 piwik 제작한 곳에서 직접 관리를 하고 있습니다. 여기서는 우분투 시스템에 맞게 설치 의존성만 수정해서 패키지를 만들어 보겠습니다.

Download

• mkdir -p ~/package/piwik
• cd ~/package/piwik
• git clone https://github.com/piwik/piwik-package
• cd piwik-package

Adjust for ubuntu

업데이트 정보를 debian/changelog에 씁니다.

piwik (3.7.0-1) stable; urgency=high

  * Initial release for ubuntu 18.10

 -- user <user@email.com>  Mon, 10 Dec 2018 16:46:16 +0900

우분투 18.10에서는 여기부터는 수정하지 않았습니다.

우분투 시스템에 맞게 의존성을 debian/control에서 수정합니다.

Depends: php5.6-cli (>= 5.5.9)|php7.0-cli|php7.1-cli, php5.6-mysql|php5.6-mysqlnd|php7.0-mysql|php7.1-mysql, php5.6-curl|php7.0-curl|php7.1-curl, php5.6-gd|php7.0-gd|php7.1-gd
Recommends: logrotate, libapache2-mod-php5.6 (>= 5.3.3)|php5.6-cgi (>= 5.5.9)|php5.6-fpm (>= 5.5.9)|libapache2-mod-php7.0|php7.0-cgi|php7.0-fpm|libapache2-mod-php7.1|php7.1-cgi|php7.1-fpm, php-geoip|php5.6-geoip|php7.0-geoip|php7.1-geoip

패키지 제작에 필요한 lintian을 debian/rules에서 제거합니다.

install: build
	@dh_testdir
	@dh_testroot
	@dh_prep
	@dh_installdirs
	@$(MAKE) checkfetch DESTDIR=$(CURDIR)/$d
	@$(MAKE) cleanup DESTDIR=$(CURDIR)/$d
	@$(MAKE) checkconfig DESTDIR=$(CURDIR)/$d
	@dh_install
#	@dh_lintian
	@dh_link


# build architecture-independent files
binary-indep: build install
	@dh_testdir
	@dh_testroot
	@dh_installdirs -i
	@dh_install -i
	@dh_installcron
	@dh_installchangelogs
	@dh_installdocs
	@dh_installdebconf
	@dh_compress
	@dh_link
	@dh_fixperms
	@$(MAKE) fixperms DESTDIR=$(CURDIR)/$d
	@$(MAKE) fixsettings DESTDIR=$(CURDIR)/$d
#	@$(MAKE) checklintianlic DESTDIR=$(CURDIR)/$d
#	@$(MAKE) checklintianextralibs DESTDIR=$(CURDIR)/$d
	@$(MAKE) manifest DESTDIR=$(CURDIR)/$d
	@dh_installdeb
	@dh_gencontrol
	@dh_md5sums
	@dh_builddeb

아파치 서버 대신에 nginx를 작동중이므로 debian/piwik.postinst에서 제거합니다.

if [ -d "/etc/apache2/conf-available" ]
then
	if [ -e "/etc/apache2/conf.d/piwik.conf" -a ! -e "/etc/apache2/conf-available/piwik.conf" ];
	then
		echo "  * Migrating previous '/etc/apache2/conf.d/piwik.conf' to '/etc/apache2/conf-available/piwik.conf'"
		mv /etc/apache2/conf.d/piwik.conf /etc/apache2/conf-available/piwik.conf
		# the conf is enabled since it was debian 7 default behavior
		#a2enconf --maintmode piwik
		#invoke-rc.d apache2 reload 2>/dev/null || true
	else
		if [ ! -e /etc/apache2/conf-available/piwik.conf ];
		then
			ln -s /etc/piwik/apache.conf /etc/apache2/conf-available/piwik.conf
			#a2enconf --maintmode piwik
			#invoke-rc.d apache2 reload 2>/dev/null || true
		fi
		echo "  * Check Piwik web configuration in /etc/apache2/conf-available/piwik.conf"
	fi
else
	echo "Apache2.4 not installed, skipping"
fi

우분투 18.10에서는 여기까지는 수정하지 않았습니다

이제 이진 패키지를 제작해 봅니다.

• sudo apt install gnupg2
• dpkg-buildpackage -i -uc -us -b

몇 가지 문제가 있긴 하지만 사용하는 데에는 크게 지장이 없을 것으로 판단됩니다.

Install

만들어진 패키지를 설치합니다.

• cd ..
• sudo dpkg -i piwik_3.7.0-1_all.deb

Piwik에 사용할 MariaDB의 데이터베이스와 사용자를 만들어 줍니다.

• mysql -u root -p

MariaDB [(none)]> CREATE DATABASE piwikdb;
MariaDB [(none)]> USE piwikdb;
MariaDB [(none)]> grant all privileges on piwikdb.* to piwikadmin@localhost identified by 'password';
MariaDB [(none)]> flush privileges;
MariaDB [(none)]> exit;

추가로 추천 패키지를 설치합니다.

• sudo apt install php-geoip
• sudo apt install geoip-database-extra

Configuration

Nginx

Nginx 서버에 대한 자세한 설정이 piwik 제작한 곳에서 관리가 되고 있습니다. 해당 git 서버에서 내려받습니다.

• git clone https://github.com/perusio/piwik-nginx.git

설정 /etc/nginx/sites-available/piwik을 맞게 수정합니다.

server {
    listen 80;
    server_name brajo.duckdns.org;
    root /usr/share/piwik;
    index index.html index.htm index.php;
 
    location / {
        try_files $uri $uri/ /index.php?q=$uri&$args;
    }

    location /config.ini.php {
        root /etc/piwik;
        index config.ini.php;
    }

    location ~ \.php$ {
        try_files $uri =404;
        include fastcgi_params;
        fastcgi_pass unix:/var/run/php/php7.1-fpm.sock;
        fastcgi_index index.php;
     	fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        fastcgi_intercept_errors on;
        fastcgi_split_path_info ^(.+\.php)(.*)$;
        fastcgi_hide_header X-Powered-By;
    }

    location ~* ^.+\.php$ {
        return 403;
    }

    location ~* (?:DESIGN|(?:gpl|README|LICENSE)[^.]*|LEGALNOTICE)(?:\.txt)*$ {
        return 302 /;
    }

    location ~* \.(?:bat|git|ini|sh|svn[^.]*|txt|tpl|xml)$ {
        return 404;
    }

    location ~ ^/(config|core|lang|misc|tmp)/ {
        deny all;
    }
}

이제 http://brajo.duckdns.org/ 으로 접근을 해서 설치를 계속합니다.

varnish를 운영하고 있다면, 웹 서버의 포트를 맞추어야 합니다.

웹 설정

Welcome

특별한 내용이 없습니다.

System Check

패키지 만들 때, README.md가 없어졌습니다. 이것은 특별한 문제가 아니니 놔두셔도 상관없습니다.

Writeable Javascript Tracker("/piwik.js") 부분은 아래와 같이 설정해 줍니다.

• sudo chmod +w /usr/share/matomo/piwik.js
• sudo chown www-data:www-data /usr/share/matomo/piwik.js

Database Setup

위에서 만든 데이터베이스 정보를 적어줍니다. 입력이 되어 있는 항목은 기본값으로 진행합니다. Adapter는 MYSQLI를 선택해야 합니다.

Creating the Tables

테이블 생성을 합니다.

Super User

Piwik 관리를 위한 관리자 계정을 만드는 것입니다. 설치시마다 1명만 만들 수 있다고 합니다.

아래쪽의 2개의 항목은 체크해제하셔도 좋겠습니다.

Setup a Website

모니터링을 할 웹사이트를 하나 적습니다.

1. Website name: DawoumWiki
2. Website URL: http://dawoum.duckdns.org
3. Website time zone: Seoul
4. Ecommerce: Not an Ecommerce site

JavaScript Tracking Code

헤드 태그를 닫기 직전에, 즉 </head> 바로 위에 코드를 삽입합니다.

<!-- Matomo -->
<script type="text/javascript">
  var _paq = _paq || [];
  /* tracker methods like "setCustomDimension" should be called before "trackPageView" */
  _paq.push(['trackPageView']);
  _paq.push(['enableLinkTracking']);
  (function() {
    var u="//brajo.duckdns.org/";
    _paq.push(['setTrackerUrl', u+'piwik.php']);
    _paq.push(['setSiteId', '1']);
    var d=document, g=d.createElement('script'), s=d.getElementsByTagName('script')[0];
    g.type='text/javascript'; g.async=true; g.defer=true; g.src=u+'piwik.js'; s.parentNode.insertBefore(g,s);
  })();
</script>
<!-- End Matomo Code -->

Congratulations

설치 축하 메시지입니다. 미디어위키를 사용하시는 분들은 미디어위키 Piwik 확장으로 이동하셔서 계속 설정을 하시기 바랍니다.

파일 올리기

플럭-인 또는 테마를 적용하기 위해서는 먼저 해당 파일을 내려받아야 합니다. 내려받은 파일을 적용하기 위해서는 파일을 정해진 위치로 업로드해야 합니다. 이를 위해서는 2가지가 필요합니다. 첫 번째는 파일 올리기가 가능하도록 설정 파일 /etc/piwik/config.ini.php을 수정해야 합니다.

[General]
enable_plugin_upload = 1

두 번째는 파일이 올라갈 디렉토리의 소유자가 맞도록 수정해 주어야 합니다.

• sudo chown www-data:www-data /usr/share/piwik/plugins

Do Not Track!!

Piwik와 Extension:Piwik을 설치하고 실시간 트랙킹이 되지 않아서 문서와 설정을 많이 찾아보게 되었습니다. 문제는 firefox nightly에 있었습니다. Nightly 내부에서 트랙킹을 허용하더라도 리눅스용은 전혀 트랙킹이 되지 않고, 윈도우용은 잘못된 정보로 트랙킹이 됩니다. 모바일 웹 브라우저도 설정에 트랙킹을 허용해도 정보가 기록되는 것이 있고 안 되는 것이 있습니다. 주로 chrome은 정보를 제대로 잘 알려주는 것으로 보입니다.

External links

• Official website
• matomo-org on GitHub