Pesquisa de site

Como instalar o Matomo Open Source Analytics no Ubuntu 18.04 Bionic Beaver Linux


Objetivo

Instale a análise do Matomo no Ubuntu 18.04 Bionic Beaver

Distribuições

Ubuntu 18.04

Requisitos

Uma instalação funcional do Ubuntu 18.04 com privilégios de root

Dificuldade

Fácil

Convenções

  • # – requer que determinados comandos do Linux sejam executados com privilégios de root diretamente como usuário root ou pelo uso do comando sudo

  • $ – requer que determinados comandos do Linux sejam executados como um usuário normal sem privilégios

Introdução

As análises são importantes para quase todos os sites, mas se você é fã de software gratuito e de código aberto, a ideia de deixar o Google monitorar todo o tráfego do seu site pode não parecer muito boa. Existe, no entanto, outra opção. Você pode instalar e hospedar suas próprias análises com Matomor (antigo Piwik). Matomo é um aplicativo PHP de código aberto que você mesmo pode executar, colocando você no controle de sua plataforma analítica. Além disso, o Matomo realmente respeita seus usuários e não tenta quebrar a proteção de rastreamento.

Instale os pacotes PHP

Claro, você baseará isso em uma pilha LAMP ou LEMP padrão, mas o Matomo é um aplicativo bastante grande com seus próprios requisitos. Antes de começar, instale essas dependências do PHP.

$ sudo apt install php-curl php-gd php-cli php-geoip php-mysql php-mbstring php-xml unzip

Configurar LAMP/LEMP

Matomo é um aplicativo PHP. Você pode hospedá-lo como faria com qualquer outro aplicativo da web escrito em PHP. Então, você precisará configurar o Ubuntu como um servidor LAMP ou LEMP. Se ainda não o fez, use nosso guia LAMP tradicional, nosso guia MariaDB LAMP ou nosso guia LEMP para configurar o Ubuntu para servir PHP.

Crie um banco de dados

A menos que você tenha criado um banco de dados especificamente para o Matomo durante a configuração do LAMP/LEMP, você precisará criar um novo para o Matomo usar. Faça login no MySQL como seu usuário root.

$ mysql -u root -p

Quando estiver no console MySQL, crie um novo banco de dados.

mysql> CREATE DATABASE matomo;

Crie um novo usuário para ele também.

mysql> CREATE USER `matomo_admin`@`localhost` IDENTIFIED BY 'yourpass';

Conceda ao seu novo usuário permissões no banco de dados.

mysql> GRANT ALL ON matomo.* TO `matomo_admin`@`localhost`;

Libere seus privilégios e saia.

mysql> FLUSH PRIVILEGES;

Obter Matomo

Matomo é gratuito e de código aberto, mas é melhor obtê-lo diretamente dos desenvolvedores do que de qualquer repositório de distribuição. Isso apenas garante que a versão que você obtém seja atual. Obtenha a versão mais recente com wget.

$ wget https://builds.matomo.org/piwik.zip

Esse link pode mudar para refletir a mudança de nome de Piwik para Matomo num futuro próximo. Certifique-se de estar atento a isso.

Descompacte o arquivo e copie-o para o diretório raiz da web.

$ unzip piwik.zip
$ sudo cp -r piwik /var/www/

O resultado deve ser um diretório piwik em /var/www/piwik. Mude a propriedade dele para o servidor web.

$ sudo chown -R www-data:www-data /var/www/piwik

Configurar o servidor web

A configuração do seu servidor web dependerá se você está usando Apache ou Nginx. Qualquer um deles presumirá que você hospedará em um servidor com mais de um site usando hosts virtuais.

Apache

Você precisará criar um novo host virtual para o seu site. Comece copiando a configuração padrão ou uma configuração anterior para modificar no host Matomo.

sudo cp /etc/apache2/sites-available/000-default.conf /etc/apache2/sites-available/matomo.conf

Abra sua configuração e modifique o DocumentRoot para apontar onde você descompactou o diretório piwik.

DocumentRoot /var/www/piwik

Defina ServerName como o domínio do seu site (ou localhost se você estiver apenas testando). Provavelmente este seria o subdomínio que você escolheu para suas análises.

ServerName analytics.your-site.com

Quando terminar, salve seu arquivo e saia.

Habilite seu site no Apache.

$ sudo a2ensite matomo.conf

Recarregue o Apache.

$ sudo systemctl reload apache2

Nginx

Crie uma nova configuração de site para Matomo no diretório /etc/nginx/sites-available. Abra esse arquivo.

Tudo aqui é completamente padrão para uma configuração PHP. Crie um novo bloco de servidor para seu site de análise. Deve ser semelhante a este.

server {
	listen 80;
	listen [::]:80;
	server_name analytics.your_site.com;

	index index.php;
	root /var/www/piwik;

	access_log /var/log/nginx/analytics.your-site.com.access_log;
	error_log /var/log/nginx/analytics.your-site.com.error_log;

	location / {
		try_files $uri $uri/ =404;
	}

	location ~ \.php$ {
		include snippets/fastcgi-php.conf;
		fastcgi_pass unix:/var/run/php/php7.1-fpm.sock;
	}
}

Se você estiver usando SSL (como o Matomo recomenda), inclua isso e o redirecionamento 301 também.

Não se esqueça de vincular a configuração do seu site e reiniciar o Nginx.

$ sudo ln -s /etc/nginx/sites-available/matomo /etc/nginx/sites-enabled/matomo
$ sudo systemctl restart nginx

Configuração do Matomo

Agora que você configurou seu servidor web e banco de dados, você pode começar a configurar o Matomo com seu instalador baseado na web. Navegue até o endereço onde você configurou seu servidor para hospedar o Matomo.

A primeira tela lhe dará as boas-vindas ao Matomo e solicitará que você inicie o processo de instalação. Depois disso, o Matomo realizará uma verificação completa do sistema quanto aos seus requisitos. Isso deve funcionar, já que você os instalou no início do processo.

A seguir, o Matomo solicitará que você se conecte ao banco de dados. Insira as informações que você usou para configurar seu banco de dados anteriormente. Levará alguns segundos para conectar e avisar quando isso for feito com sucesso.

Em seguida, você será solicitado a criar uma conta de superusuário. Esta é a conta principal que você usará para gerenciar tudo na plataforma.

Após o seu superusuário, Matomo solicitará a criação de um site. Isso adicionará um site à lista que o Matomo monitorará e fornecerá dados analíticos. Ele usará as informações fornecidas para gerar o código de rastreamento JavaScript.

Matomo lhe dará um bloco de JavaScript para inserir em seu site. Cole o código no código-fonte do seu site em um local que aparecerá em todas as páginas.

Quando terminar de inserir o JavaScript em seu site, você pode clicar no restante da configuração. Matomo irá parabenizá-lo por concluí-lo quando terminar.

Em seguida, você será direcionado para a tela de login. Use a conta que você criou para fazer login. Ao fazer isso, você receberá uma mensagem informando que Matomo ainda não coletou nenhum dado. Isso é bom. Você acabou de configurar. Diga ao Matomo para não mostrar a mensagem novamente na próxima hora e você poderá avançar para o seu painel. Matomo está sendo executado com sucesso em seu servidor!

Considerações finais

Explore o painel do Matomo. Ele oferece muitas opções diferentes. Ele registra muitas informações úteis e as organiza para você de quantas maneiras você precisar. Você também pode gerar código JavaScript adicional para sites adicionais. Matomo é mais do que capaz de monitorar vários sites ao mesmo tempo. Assim, depois de configurar o Matomo uma vez, você terá seu próprio serviço de análise auto-hospedado para quantos sites precisar.

Artigos relacionados: