Como instalar a ferramenta Matomo Web Analytics no Debian

Matomo, anteriormente Piwik, é uma ferramenta de software de análise da web gratuita e de código aberto. Ele foi projetado para fornecer informações importantes sobre o comportamento dos visitantes do seu site e para ajudá-lo a compreender os dados coletados para tomar decisões informadas. Matomo também inclui um recurso Super Search para pesquisa de dados rápida, simples e automatizada em vários sites.

Matomo fornece diversos relatórios, como estatísticas de visitantes diários, semanais e mensais; principais sites de referência; estatísticas de mídia social, como desempenho de campanha publicitária no Facebook ou crescimento de seguidores no Twitter; dados demográficos dos visitantes e informações de localização geográfica, etc.

Ele também oferece uma análise detalhada do comportamento dos visitantes em seu site – suas ações e tempo de engajamento gasto nas páginas – para ver o que funciona bem para você ou o que poderia ser melhorado.

Matomo é perfeito para provedores de serviços como agências da web, desenvolvedores de sites de comércio eletrônico e proprietários de blogs analisarem o comportamento dos visitantes no site. Ele funciona junto com quase todos os CMS comuns e outros sistemas de gerenciamento de conteúdo (CMS), como WordPress, Drupal ou Joomla.

Matomo é escrito em PHP e totalmente compatível com Apache, Microsoft IIS Web Server ou Nginx. Ele usa MySQL ou PostgreSQL para armazenar dados em um servidor de banco de dados e pode ser usado, segundo seu próprio site, “junto com as linguagens de programação mais populares”. Matomo também suporta análises em tempo real com rastreamento de visitantes em tempo real. Além disso, o Matomo oferece suporte a vários tipos de tags de rastreamento para campanhas de remarketing. Matomo suporta rastreamento de instalação de aplicativos móveis e rastreamento de aplicativos móveis para aplicativos Android e iOS.

Matomo é uma ferramenta indispensável de coleta de dados para monitoramento e aprimoramento de campanhas de geração de leads online, análise de interação do usuário e análise de desempenho de sites.

Mas você está tentando instalar o matomo web analytics no Debian, mas parece não estar funcionando. Se você ler o artigo abaixo, encontrará muitas dicas úteis e fáceis de usuários experientes que instalaram com sucesso o Matomo no Debian. Você aprenderá como instalar o matomo de uma maneira que funcione para o seu ambiente exclusivo.

Pré-requisitos

Para instalar o Matomo no Debian, você precisa ter:

Um servidor executando uma nova instância do Debian 10 ou Debian 11. Embora o Matomo possa ser dimensionado para medir vários milhões de visualizações de páginas, é recomendado começar com uma pequena instância como ambiente de teste. Recomenda-se um mínimo de 4 GB de RAM e 50 GB de espaço livre em disco no servidor.
Um usuário não root com privilégios sudo para executar comandos como root. Você pode aprender como criar uma conta de usuário aqui.
Um nome de domínio totalmente qualificado (por exemplo: exemplo.com) apontado para o endereço IP do seu servidor.

Atualizando os pacotes de software Debian

Primeiro, você precisa atualizar o sistema antes de executar qualquer comando de instalação de software em sua caixa Debian. Isso garante que todos os pacotes do sistema estejam totalmente atualizados.

sudo apt update && sudo apt upgrade -y

Instalando o Servidor Web Apache

Matomo exigia uma pilha LAMP (Linux, Apache, MySQL (ou MariaDB) e PHP) para rodar em um servidor. Apache é um desses elementos da pilha. O Apache HTTP Server é um dos servidores web mais populares, com milhões de downloads e uma ampla gama de recursos. O servidor Web Apache HTTPD é uma ferramenta poderosa para hospedar sites e outros aplicativos baseados em servidor. É uma plataforma robusta, flexível e altamente personalizável para o desenvolvimento de sites dinâmicos da Internet em qualquer escala que atinja mais de 50% de participação de mercado.

Você deve usar o servidor web Apache gratuito com Matomo (antigo Piwik) se já o tiver em execução em seu sistema, ou desejar configurá-lo de uma forma específica, ou se tiver um ambiente de rede complexo.

Execute o seguinte comando para instalar o Apache em seu sistema. No Debian, o programa apache2 fornece o servidor Apache HTTP (httpd). O pacote Apache contém os programas necessários para configurar um servidor Apache. No Debian, o programa apache2-utils fornece vários utilitários para uso com o Apache HTTP Server (httpd).

sudo apt install -y apache2 apache2-utils

Assim que a instalação for concluída, inicie o serviço Apache para que ele possa ser usado por outros programas.

sudo systemctl start apache2

Execute o seguinte comando para verificar se o Apache está funcionando ou não.

sudo systemctl status apache2

Se você vir a seguinte saída, o Apache está em execução no seu sistema:

Você pode solicitar uma página da web do servidor Apache para verificar se está funcionando corretamente.

Quando você abre uma página no seu navegador, os cabeçalhos HTTP enviados do servidor web para o seu computador incluem muitas informações sobre o conteúdo da página.

Por exemplo, na tag HTML você pode encontrar um cabeçalho chamado “Content-Type”, que contém a codificação de caracteres usada naquela página. Neste ponto, você só pode ver a página de boas-vindas padrão do Apache, conforme mostrado abaixo.

Instalar o servidor de banco de dados MariaDB

MariaDB é um servidor SQL (Structured Query Language) poderoso, multithread, multiusuário e robusto. É uma implementação de código aberto do servidor MySQL e um substituto imediato para o servidor MySQL.

Muitos usuários do Matomo estão usando o MariaDB para salvar seus dados de análise da web. Mesmo que o MariaDB não seja oficialmente suportado pelo Matomo, ele pode ser usado como um backend de banco de dados adequado para o Matomo.

No mínimo, você precisará de um servidor mariadb e de um cliente mariadb. O pacote mariadb-server fornece o servidor MariaDB, que permite que o MariaDB seja executado como um serviço. O pacote mariadb-client fornece os programas clientes MariaDB, que são baseados em libmysql.

Execute o seguinte comando para instalar o MariaDB Database Server em seu sistema Debian.

sudo apt install -y mariadb-server mariadb-client

Assim que a instalação for concluída, proteja e otimize seu servidor MariaDB seguindo este guia.

Execute o seguinte comando para iniciar o serviço MariaDB para que possa ser usado por outros programas.

sudo systemctl start mariadb

Por fim, execute o seguinte comando para verificar se o MariaDB está funcionando ou não.

sudo systemctl status mariadb

Se você vir a seguinte saída, então o MariaDB está em execução no seu sistema.

Instalando PHP

PHP é uma linguagem de script do lado do servidor projetada para desenvolvimento web. Ele pode ser usado para criar páginas web dinâmicas que são armazenadas na memória de um servidor web e acessadas por um navegador web.

O Matomo Web Analytics requer PHP para várias tarefas, sendo as mais importantes o registro de solicitações do servidor web e o rastreamento de visitantes.

Execute o seguinte comando para instalar o PHP 7.3 e seus módulos. Módulos PHP são extensões da linguagem de programação PHP. Esses módulos são fornecidos por bibliotecas externas que aprimoram ou ampliam a funcionalidade do PHP. Um módulo nada mais é do que uma biblioteca compartilhada (arquivo .so no Linux, .dll no Windows ou .dylib no macOS) que é carregada pelo interpretador PHP em tempo de execução. O Matomo Web Analytics usa módulos PHP para implementar recursos específicos que estão disponíveis para usuários do Matomo (Piwik).

sudo apt install php -y
sudo apt install php-cli php-fpm php-json php-common -y
sudo apt install php-mysql php-zip php-gd php-mbstring php-curl -y
sudo apt install php-xml php-pear php-bcmath -y

Execute o seguinte comando para verificar a versão do PHP em seu sistema.

php -v

Você obterá a seguinte saída no Debian 10

No Debian 11, a versão do PHP será PHP 7.4

Criando banco de dados para Matomo

Matomo mantém todos os dados dentro de um banco de dados. Então, vamos criar um.

Execute o seguinte comando para fazer login em seu shell MariaDB. No prompt de senha, forneça sua senha root e pressione ENTER para continuar.

sudo mysql -u root -p

Execute o seguinte comando para criar um novo banco de dados chamado matomo. Sua instalação do Matomo usará esse banco de dados para armazenar todos os dados.

CREATE DATABASE matomo;

Execute o seguinte comando para criar um novo usuário chamado matomouser para o banco de dados matomo. Substitua a senha por uma senha segura. Um usuário é uma coleção de permissões. Pode ser qualquer coisa, desde a criação de bancos de dados e tabelas até a verificação de dados ou a execução de consultas. As permissões são guiadas principalmente pela segurança. Para obter a melhor segurança possível, você não deve conceder mais permissões do que o necessário ao seu usuário.

CREATE USER 'matomouser'@'localhost' IDENTIFIED BY 'mysecurepassword';

Substitua 'mysecurepassword' por uma senha segura de sua escolha. Execute o seguinte comando para conceder ao usuário matomouser o privilégio SUPER. O privilégio SUPER permite que um usuário execute toda e qualquer instrução. Você vai querer ter certeza de que o matomouser pode fazer o que quiser no banco de dados do matomo.

GRANT ALL ON matomo.* TO 'matomouser'@'localhost' WITH GRANT OPTION;

Execute o seguinte comando para recarregar os bancos de dados. O comando FLUSH PRIVILEGES é usado para recarregar as tabelas de concessão, permitindo que as instruções atualmente em execução sejam concluídas normalmente.

PRIVILÉGIOS DE FLUSH;

Finalmente, saia do shell.

exit;

Configurando seu host virtual Apache

Um host virtual é um tipo de site onde cada site veicula conteúdo de seu próprio nome de domínio. Hosts virtuais são normalmente usados para sites com vários nomes de domínio, mas também são usados para fornecer sites com nomes de host diferentes para balanceamento de carga.

Existem vários motivos pelos quais você deve usar um Host Virtual. Neste tutorial, vamos nos concentrar no seguinte:

Melhoria de desempenho
Segurança

Execute o seguinte comando para criar um novo arquivo de configuração de host virtual chamado matomo.conf no diretório /etc/apache2/sites-available.

sudo nano /etc/apache2/sites-available/matomo.conf

Preencha o arquivo matomo.conf com as seguintes linhas e salve e feche o arquivo. Substitua your-domain.com pelo seu domínio real.

<VirtualHost *:80>

ServerAdmin [email 
ServerName your-domain.com
DocumentRoot /var/www/matomo/

<Directory /var/www/matomo>
DirectoryIndex index.php
Options FollowSymLinks
AllowOverride All
Require all granted
</Directory>

<Files "console">
Options None
Require all denied
</Files>

<Directory /var/www/matomo/misc/user>
Options None
Require all granted
</Directory>

<Directory /var/www/matomo/misc>
Options None
Require all denied
</Directory>

<Directory /var/www/matomo/vendor>
Options None
Require all denied
</Directory>

ErrorLog ${APACHE_LOG_DIR}/matomo_error.log
CustomLog ${APACHE_LOG_DIR}/matomo_access.log combined

</VirtualHost>

Execute o seguinte comando para desabilitar o arquivo de configuração padrão do Apache e habilitar seu arquivo de configuração matomo.

sudo a2dissite 000-default.conf está basicamente desabilitando o site padrão que vem com a instalação do Apache, para garantir que ninguém possa visitar o site padrão. Desta forma, seus usuários podem acessar o Matomo Analytics sem problemas.

sudo a2ensite matomo.conf habilita ou cria um arquivo de configuração do site apache que deve ser habilitado para usar o Matomo. Este é o arquivo de configuração onde estão escritos os detalhes do seu site Matomo Analytics.

sudo a2dissite 000-default.conf && sudo a2ensite matomo.conf

Execute o seguinte comando para habilitar a reescrita do Apache. O comando sudo a2enmod rewrite está basicamente habilitando o módulo Apache ‘rewrite’. que é necessário para Matomo Analytics.

sudo a2enmod rewrite

Por fim, reinicie seu servidor Apache com o seguinte comando para aplicar as alterações.

sudo systemctl restart apache2

Instalando o Matomo

Agora que você configurou sua pilha LAMP, é hora de instalar o Matomo Analytics.

Execute o seguinte comando wget para baixar a versão estável mais recente do Matomo para o seu diretório atual.

wget http://builds.matomo.org/matomo-latest.zip

Execute o seguinte comando para criar um novo diretório de instalação do matomo no diretório raiz da web, descompacte o arquivo baixado e mova os arquivos extraídos para o diretório de instalação do matomo.

sudo mkdir -p /var/www/matomo && sudo unzip matomo-latest.zip && sudo mv matomo/* /var/www/matomo

Por fim, execute o seguinte comando para definir as permissões adequadas para o diretório de instalação do matomo.

sudo chown -R www-data:www-data /var/www/matomo && sudo chmod -R 755 /var/www/matomo

Acessando a UI do Matomo Web

Agora que você tem sua pilha LAMP e o Matomo instalados, você está pronto para acessar a UI da Web do Matomo Analytics.

Abra seu navegador favorito e navegue até http://seu-domínio.com. No diretório de instalação do Matomo, existem ferramentas de exemplo que você pode usar para verificar se sua instalação está totalmente operacional. Clique em Avançar e siga as instruções na tela para concluir a instalação.

Conclusão

Neste tutorial, explicamos a instalação do Matomo Analytics e da pilha LAMP para Matomo Analytics. Esperamos que depois de ler este artigo, você consiga configurar seu próprio Matomo Analytics em seu servidor web.