Como Instalar Matomo Web Analytics no Ubuntu 22.04

Matomo, anteriormente Piwik, é um software de análise de web gratuito e de código aberto que pode rastrear visitas a sites e exibir relatórios para análise de dados e público. Matomo é licenciado sob a Licença GPL. É escrito em PHP e pode ser executado com servidor de banco de dados MySQL ou MariaDB.

Matomo fornece relatórios perspicazes para rastreamento de usuários em seus sites. Isso inclui o mecanismo de busca referenciador e as palavras-chave, idiomas, visitas a páginas como downloads de arquivos e muito mais. Matomo está se tornando cada vez mais popular como uma alternativa a serviços de análise como o Google Analytics.

Neste tutorial, você configurará e protegerá sua análise de web com Matomo em um servidor Ubuntu 22.04. Você instalará a análise de web Matomo com PHP 8.1, servidor web Apache2 e banco de dados MariaDB e protegerá a implantação com certificados SSL/TLS via Certbot e Letsencrypt. Uma vez que você tenha terminado este tutorial, você será capaz de rastrear e monitorar o tráfego em seus sites, e você obterá resultados detalhados de rastreamento em sua instalação Matomo auto-hospedada.

Pré-requisitos

Abaixo estão os requisitos que você deve ter para completar este tutorial:

• Um servidor Ubuntu 22.04 - Este exemplo usa um servidor Ubuntu com o nome do host ‘ matomo-server ‘.
• Um usuário não-root com privilégios de administrador sudo/root.
• Um nome de domínio apontado para o endereço IP do servidor - Este exemplo usará o subdomínio ‘ analytics.howtoforge.local ‘.

Uma vez que todos os requisitos estejam em vigor, você pode começar.

Instalando e Configurando o Servidor MariaDB

Matomo é uma análise de web de código aberto que usa MySQL ou MariaDB como backend de banco de dados. No momento da redação deste documento, o Matomo exigia pelo menos o MySQL Server v8 ou MariaDB v10.x. Neste guia, você instalará e usará o MariaDB como o banco de dados para a análise de web Matomo.

No primeiro passo, você instalará o servidor MariaDB, configurará a implantação do MariaDB e criará um novo banco de dados e usuário MariaDB.

Antes de começar, execute o comando apt abaixo para atualizar e refrescar seu índice de pacotes.

sudo apt update

Agora instale o servidor MariaDB via o comando apt abaixo. Quando solicitado, insira y e pressione ENTER para prosseguir.

sudo apt install mariadb-server

Após a instalação do servidor MariaDB, execute o utilitário de comando systemctl abaixo para verificar e garantir que o servidor MariaDB esteja em execução.

sudo systemctl is-enabled mariadb  
sudo systemctl status mariadb

Você deve receber uma saída semelhante a esta - O servidor MariaDB está habilitado e em execução por padrão. Além disso, o servidor MariaDB será iniciado automaticamente na inicialização.

Em seguida, você protegerá a implantação do servidor MariaDB via o comando ‘ mariadb-secure-installation ‘, que é fornecido pelo pacote do servidor MariaDB.

Execute o comando abaixo para proteger a implantação do servidor MariaDB.

sudo mariadb-secure-installation

Agora você será questionado sobre as seguintes configurações do MariaDB:

• Mudar a autenticação local para unix_socket? Insira n.
• Configurar a nova senha root do MariaDB? Insira y para confirmar, em seguida, digite a nova senha para sua implantação do servidor MariaDB.
• Remover usuário anônimo? Insira y para confirmar.
• Remover o banco de dados de teste padrão da implantação? Insira y para confirmar.
• Proibir login root do MariaDB de conexões remotas? Insira y para confirmar.
• Recarregar privilégios de tabela e aplicar as alterações? Insira y e pressione ENTER.

Agora a implantação do servidor MariaDB deve estar protegida e você adicionou a senha para o usuário root do MariaDB.

Em seguida, você criará um novo banco de dados e usuário MariaDB para a instalação do Matomo via o shell do MariaDB.

Execute o comando ‘mariadb’ abaixo para fazer login no shell do MariaDB via o usuário root do MariaDB. Quando solicitado pela senha, insira sua senha root do MariaDB.

sudo mariadb -u root -p

Agora execute as seguintes consultas para criar um novo banco de dados e usuário MariaDB. Neste exemplo, você criará o banco de dados e o usuário ‘ matomo ‘ para a instalação do Matomo. Além disso, certifique-se de substituir a senha padrão na consulta a seguir.

CREATE DATABASE matomo;  
CREATE USER 'matomo'@'localhost' IDENTIFIED BY 'p4ssw0rddb';  
GRANT SELECT, INSERT, UPDATE, DELETE, CREATE, INDEX, DROP, ALTER, CREATE TEMPORARY TABLES, LOCK TABLES ON matomo.* TO 'matomo'@'localhost';  
FLUSH PRIVILEGES;

Em seguida, execute a consulta abaixo para verificar a lista de privilégios do usuário ‘ matomo@localhost ‘.

SHOW GRANTS FOR 'matomo'@'localhost';  
quit

Você deve obter uma saída semelhante a esta - O usuário MariaDB ‘matomo@localhost’ tem todos os privilégios para acessar o banco de dados ‘matomo’.

Nesta seção, você instalou o servidor MariaDB, protegeu a implantação do MariaDB via o comando ‘ mariadb-secure-installation ‘, e criou um novo banco de dados e usuário para o Matomo. Em seguida, você instalará o servidor web Apache2 e PHP 8.x.

Instalando o Servidor Web Apache2 e PHP 8

Matomo é uma análise de web de código aberto escrita em PHP. Para a instalação, a versão mais recente do Matomo é totalmente suportada com PHP 8.x. Além disso, o Matomo pode ser executado com servidores web Apache2 e Nginx.

Neste passo, você agora instalará o servidor web Apache2 e PHP 8.1, configurará a instalação do PHP, e então verificará o serviço Apache2 e a versão do PHP.

O repositório padrão do Ubuntu fornece pacotes tanto para Apache2 quanto para PHP. O repositório do Ubuntu 22.04 fornece a versão mais recente do PHP, PHP8.1, que é totalmente suportada para a instalação do Matomo.

Execute o comando apt abaixo para instalar os pacotes Apache2 e PHP 8.1.

sudo apt install apache2 php php-cli libapache2-mod-php php-common php-curl php-gd php-mbstring php-mysql php-xml php-intl php-zip wget unzip

Quando solicitado, insira y para confirmar e pressione ENTER para prosseguir.

Após a instalação do Apache2 e PHP, execute o utilitário de comando systemctl abaixo para verificar o serviço Apache2 e garantir que o serviço esteja em execução.

sudo systemctl is-enabled apache2  
sudo systemctl status apache2

Você receberá uma saída como esta - O serviço Apache2 está habilitado e será executado automaticamente na inicialização. E o status do serviço Apache2 está em execução.

Em seguida, abra o arquivo ‘ php.ini ‘ para o Apache2 via o comando do editor nano abaixo.

sudo nano /etc/php/8.1/apache2/php.ini

Altere a configuração padrão do php.ini com as seguintes linhas. Ajuste o valor de date.timezone e memory_limit com seu ambiente atual.

date.timezone = Europe/Stockholm  
memory_limit = 256M  
upload_max_filesize = 16M  
max_execution_time = 300

Salve e saia do arquivo quando terminar.

Agora execute o utilitário de comando systemctl abaixo para reiniciar o serviço Apache2 e aplicar as alterações.

sudo systemctl restart apache2

O servidor web Apache2 agora deve estar em execução com o novo arquivo de configuração php.ini.

Por fim, execute o comando php abaixo para verificar a versão do PHP que está instalada em seu sistema. Em seguida, verifique a lista de extensões PHP que estão habilitadas.

sudo php --version  
sudo php -m

Você deve receber uma saída semelhante a esta - PHP 8.1 está instalado em seu sistema Ubuntu. Além disso, certifique-se de que as extensões PHP que são necessárias para o Matomo estão habilitadas.

Agora, você terminou de instalar as dependências para a análise de web Matomo, incluindo o servidor MariaDB, servidor web Apache2 e PHP 8.1.

No próximo passo, você fará o download do código-fonte do Matomo e configurará as permissões adequadas para o diretório de instalação do Matomo para que o PHP e o Apache2 possam ler e executar o aplicativo Matomo.

Baixando o Código-Fonte do Matomo

Neste passo, você fará o download do código-fonte do Matomo e configurará as permissões adequadas para o diretório de instalação do Matomo.

Mude seu diretório de trabalho atual para ‘/var/www/ ‘ e faça o download do código-fonte do Matomo via o comando wget.

cd /var/www/  
wget https://builds.matomo.org/matomo.zip

Após o código-fonte do Matomo ser baixado, extraia o Matomo via o comando unzip abaixo. E você deve obter o novo diretório ‘ matomo ‘ em seu diretório de trabalho atual.

unzip matomo.zip

Com isso, seu diretório de instalação do Matomo deve ser ‘/var/www/matomo ‘.

Execute o comando abaixo para mudar a propriedade do diretório de instalação do Matomo ‘ /var/www/matomo ‘ para o usuário e grupo ‘ www-data ‘.

sudo chown -R www-data:www-data /var/www/matomo

Após você ter configurado o diretório de instalação do Matomo e baixado o código-fonte do Matomo. Em seguida, você criará uma nova configuração de host virtual que será usada para executar a análise de web Matomo.

Configurando o Host Virtual Matomo

Antes de começar, certifique-se de que você tenha o nome de domínio apontado para o endereço IP do seu servidor. Este exemplo usa o subdomínio ‘ analytics.howtoforge.local ‘ para a instalação do Matomo.

Crie um novo arquivo de host virtual Apache2 ‘/etc/apache2/sites-available/matomo.conf ‘ usando o comando do editor nano abaixo.

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

Adicione as seguintes linhas ao arquivo e certifique-se de alterar o nome do domínio para o seu domínio.

  
    ServerAdmin webmaster@localhost  
    ServerName analytics.howtoforge.local  
    DocumentRoot /var/www/matomo/  
  
      
        DirectoryIndex index.php  
        Options FollowSymLinks  
        AllowOverride All  
        Require all granted  
      
  
      
        Options None  
        Require all denied  
      
  
      
        Options None  
        Require all granted  
      
  
      
        Options None  
        Require all denied  
      
  
      
        Options None  
        Require all denied  
      
  
    ErrorLog ${APACHE_LOG_DIR}/matomo_error.log  
    CustomLog ${APACHE_LOG_DIR}/matomo_access.log combined  
  

Salve o arquivo e saia do editor quando terminar.

Em seguida, execute o comando abaixo para ativar a nova configuração de host virtual ‘ matomo.conf ‘. Então verifique as configurações do Apache2 para garantir que você tenha a configuração adequada sem erros.

sudo a2ensite matomo.conf  
sudo apachectl configtest

Você deve receber uma saída como ‘ Syntax OK ‘ quando você tiver configurações adequadas do Apache2.

Por fim, execute o utilitário de comando systemctl abaixo para reiniciar o serviço Apache2 e aplicar as alterações.

sudo systemctl restart apache2

Com isso, você agora terminou a configuração do host virtual Apache2 para a análise de web Matomo. Isso significa que seu Matomo agora é acessível de fora da rede e você pode acessá-lo via o navegador web. Mas, isso ainda usa conexões HTTP inseguras.

No próximo passo, você protegerá sua instalação de análise de web Matomo com certificados SSL/TLS via Certbot e Letsencrypt.

Protegendo o Matomo com SSL/TLS via Certbot e Letsencrypt

Neste passo, você instalará a ferramenta Certbot e o plugin para o servidor web Apache2. Então, você gerará novos certificados SSL/TLS para a análise de web Matomo.

Antes de começar, certifique-se de que seu nome de domínio esteja apontado para o endereço IP do seu servidor. Além disso, você precisa de um endereço de e-mail que será usado para se registrar no Letsencrypt.

Agora execute o comando apt abaixo para instalar a ferramenta Certbot e o plugin Certbot para o servidor web Apache2.

sudo apt install certbot python3-certbot-apache2

Insira y quando solicitado e pressione ENTER para prosseguir.

Em seguida, execute o comando certbot abaixo para gerar certificados SSL/TLS para seu nome de domínio. Certifique-se de alterar o nome de domínio e o endereço de e-mail no comando a seguir.

sudo certbot --apache2 --agree-tos --redirect --hsts --staple-ocsp --email [email protected] -d analytics.howtoforge.local

Após o processo ser concluído, sua análise de web Matomo agora deve estar em execução com HTTPS seguro habilitado em cima do seu servidor web Apache. Além disso, você tem o redirecionamento automático configurado de HTTP para HTTPS e o OSCP staple habilitado.

Instalando Matomo Web Analytics

Abra seu navegador web e visite o nome de domínio da sua instalação do Matomo (ou seja: https://analytics.howtoforge.local). Você deve agora obter a página de boas-vindas ao Matomo como na captura de tela abaixo.

Clique em Próximo para iniciar a instalação.

Agora o instalador do Matomo estará verificando os ambientes do servidor para a instalação. Certifique-se de que todos os requisitos e configurações estejam verificados com a cor verde como abaixo.

Além disso, você deve garantir que os principais requisitos sejam atendidos com os requisitos do sistema Matomo.

Clique em Próximo para continuar.

Agora você configurará os detalhes do banco de dados MariaDB para sua análise de web Matomo. Certifique-se de inserir o nome de usuário e a senha do banco de dados corretos. Então, clique em Próximo novamente.

O instalador web do Matomo deve criar automaticamente tabelas quando os detalhes do seu banco de dados estiverem corretos.

Clique em Próximo para continuar.

Em seguida, você precisará criar um novo usuário administrador para sua instalação de análise de web Matomo. Certifique-se de usar uma senha forte para seu usuário administrador do Matomo. Então clique em Próximo novamente.

Aqui, você configurará o primeiro rastreamento para seu site. No nome de domínio do seu site que você deseja rastrear, selecione o fuso horário, em seguida, clique em Próximo.

Agora você deve ver o código JavaScript que deve inserir em seus sites. Clique em Próximo novamente para continuar.

Você deve agora receber a mensagem de congratulações de que você terminou a instalação do Matomo. Clique no botão CONTINUAR PARA MATOMO na parte inferior da página.

Você agora será redirecionado para uma conexão HTTPS segura para a página de login da administração do Matomo. Insira seu nome de usuário e senha do Matomo, em seguida, clique em ENTRAR.

Se você tiver o usuário administrador e a senha corretos, você deve obter a administração web da análise de web Matomo.

Agora clique no menu Todos os Sites no canto superior direito para obter a lista de rastreamento ativo do seu site. Você deve ver o primeiro rastreamento do site que você criou durante a instalação do Matomo.

Você agora terminou a instalação do Matomo Web Analytics. Você pode adicionar mais sites e começar a rastrear via a análise de web Matomo auto-hospedada.

Conclusão

Neste artigo, você instalou a análise de web Matomo de código aberto com o servidor de banco de dados MariaDB, servidor web Apache2 e PHP 8.1 em um servidor Ubuntu 22.04. Você também protegeu o Matomo com certificados SSL/TLS gerados via Certbot e Letsencrypt.

Agora que você instalou a análise de web Matomo básica, você pode agora integrar o Matomo com CMS (Sistema de Gerenciamento de Conteúdo) como WordPress, TYPO3, Joomla, Drupal, etc. Além disso, você pode integrar com aplicações de eCommerce como Magento, Prestashop, Woocommerce e OpenCart.