Como Instalar o Analisador de Logs GoAccess no Ubuntu 24.04

GoAccess é um analisador de logs da web em tempo real para sistemas semelhantes ao Unix, incluindo o Ubuntu. Ele fornece uma maneira eficiente e amigável de visualizar e analisar logs de servidores web, suportando vários formatos como logs do Apache, Nginx e Amazon S3. O GoAccess pode ser executado no terminal ou como uma interface baseada na web, oferecendo relatórios dinâmicos com métricas essenciais, como contagem de visitantes, detalhes de solicitações, localizações geográficas e sites de referência. É apreciado por sua velocidade, interatividade e insights abrangentes, tornando-se uma ferramenta valiosa para administradores de sistemas e desenvolvedores que buscam monitorar e otimizar o desempenho do servidor web em sistemas Ubuntu.

Neste guia, você aprenderá como instalar o Analisador de Logs GoAccess em um servidor Ubuntu 24.04.

Pré-requisitos

Antes de começar, certifique-se de que você possui o seguinte:

• Um servidor Ubuntu 24.04.
• Um usuário não-root com privilégios de administrador.
• Um servidor web Apache/Nginx instalado.

Instalando o GoAccess com APT

O Analisador de Logs GoAccess pode ser instalado de duas maneiras diferentes, através do gerenciador de pacotes e manualmente através do código-fonte. Nesta seção, você aprenderá como instalar o GoAccess no Ubuntu com o gerenciador de pacotes APT.

Primeiro, execute o seguinte comando para adicionar a chave GPG para o repositório do GoAccess.

wget -O - https://deb.goaccess.io/gnugpg.key | gpg --dearmor | sudo tee /usr/share/keyrings/goaccess.gpg >/dev/null

Adicione o repositório do GoAccess para distribuições baseadas em Ubuntu/Debian usando o comando abaixo.

echo "deb [signed-by=/usr/share/keyrings/goaccess.gpg arch=$(dpkg --print-architecture)] https://deb.goaccess.io/ $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/goaccess.list

Em seguida, execute o seguinte comando ‘apt’ para atualizar o índice de pacotes do Ubuntu e instalar o ‘goaccess‘. Digite ‘Y‘ para confirmar a instalação.

sudo apt update && sudo apt install goaccess

Após a conclusão da instalação, localize o arquivo binário ‘goaccess‘ e verifique a versão do ‘goaccess‘ com o seguinte:

which goaccess  
goaccess --version

Como você pode ver abaixo, o GoAccess 1.9.3 está instalado em ‘ /usr/bin/goaccess‘.

Instalando o GoAccess a partir do código-fonte

Se você deseja compilar o GoAccess manualmente a partir do código-fonte, pode usar os seguintes passos:

Antes de compilar o GoAccess, execute o seguinte comando ‘apt’ para instalar as dependências do pacote.

sudo apt install libncursesw5-dev libgeoip-dev libtokyocabinet-dev build-essential

Visite a página de download do GoAccess, pegue o link para a versão mais recente e, em seguida, baixe o código-fonte do GoAccess e extraia-o com o comando ‘tar’ abaixo.

wget https://tar.goaccess.io/goaccess-1.9.3.tar.gz  
tar -xzvf goaccess-1.9.3.tar.gz

Mova-se para o diretório ‘goaccess-‘ e configure sua instalação com o seguinte. Neste exemplo, você habilitará o suporte GeoIP através do arquivo de banco de dados ‘mmdb*‘.

cd goaccess-*/  
./configure --enable-utf8 --enable-geoip=mmdb

Agora execute o comando abaixo para compilar o GoAccess e instalá-lo em seu sistema. Uma vez executado, o GoAccess será instalado em ‘ /usr/local/bin/goaccess‘ com o diretório de configuração padrão ‘ /usr/local/etc/goaccess‘.

sudo make && sudo make install

Agora execute o comando abaixo para verificar sua versão do GoAccess. Você pode ver abaixo que o GoAccess 1.9.3 está instalado em /usr/local/bin/goaccess.

which goaccess  
goaccess --version

Integrando o GoAccess com o Banco de Dados GeoIP

O Analisador de Logs GoAccess suporta integração com GeoIP. Com isso, você pode exibir o país de origem do visitante. Nesta seção, você configurará o GoAccess e o integrará com o arquivo de banco de dados GeoIP.

Primeiro, visite https://db-ip.com/db/lite.php e pegue o link para o arquivo de banco de dados GeoIP e faça o download usando o comando ‘wget‘ abaixo.

wget https://download.db-ip.com/free/dbip-country-lite-2024-07.mmdb.gz

Extraia o arquivo de banco de dados GeoIP para o diretório /opt/geoip com o seguinte.

gunzip dbip-country-lite-2024-07.mmdb.gz /opt/geoip/

Em seguida, execute o comando ‘goaccess‘ abaixo para localizar o diretório de configuração padrão. Se você estiver instalando através do APT, seu diretório GoAccess estará localizado em ‘/etc/goaccess’. Se você estiver compilando a partir do código-fonte, seu diretório GoAccess está localizado em ‘ /usr/local/etc/goaccess‘.

goaccess --dcf

Agora abra o arquivo de configuração do GoAccess ‘ /usr/local/etc/goaccess/goaccess.conf‘ com o seguinte comando do editor ‘nano‘.

sudo nano /usr/local/etc/goaccess/goaccess.conf

Descomente as linhas ‘time-format’ e ‘date-format‘ como a seguinte:

# O seguinte formato de hora funciona com qualquer um dos  
# formatos de log do Apache/NGINX abaixo.  
#  
time-format %H:%M:%S  
  
# O seguinte formato de data funciona com qualquer um dos  
# formatos de log do Apache/NGINX abaixo.  
#  
date-format %d/%b/%Y

Na opção ‘log-format’, altere para ‘COMBINED‘ para logs comuns do Nginx/Apache.

log-format COMBINED  
  
or  
log-format VCOMBINED  
log-format %v:%^ %h %^[%d:%t %^] "%r" %s %b "%R" "%u"

Descomente a opção ‘geoip‘ e adicione o caminho do arquivo de banco de dados GeoIP.

geoip-database /home/geoip/dbip-country-lite-2021-10.mmdb

Quando terminar, salve o arquivo e saia do editor.

Analisando Logs do Apache/Nginx com GoAccess

Agora que você configurou o GoAccess e o integrou com o GeoIP. No próximo passo, você aprenderá como analisar arquivos de log com o GoAccess.

Para analisar logs com o GoAccess, execute o comando ‘goaccess‘ abaixo.

goaccess access.log

Você pode ver uma saída como a seguinte:

• Visitantes únicos por dia: listas de visitantes únicos por dia.
• Arquivos Solicitados (URLs): arquivos mais solicitados - para arquivos não estáticos.
• Solicitações Estáticas: listas de solicitações para arquivos estáticos, como imagens, CSS e JavaScript.
• URLs Não Encontradas (404s): páginas com erros 404 não encontradas.
• Nomes de Host e IPs dos Visitantes: listas de nomes de host e endereços IP dos visitantes. Você pode expandir para obter informações como país, cidade e rDNS.
• Sistemas Operacionais: exibe os sistemas operacionais dos visitantes.
• Navegadores: exibe os navegadores web dos visitantes.
• Distribuição de Tempo: exibe relatórios horários para visitantes únicos, número de acessos e largura de banda consumida.
• Hosts Virtuais: exibe logs de hosts virtuais. Somente ativo quando você habilita VCOMBINED ou ‘%s’ na opção ‘log-format’.
• URLs de Referência: exibe os referenciadores dos visitantes.

Você também pode usar as seguintes teclas para navegar pelo GoAccess:

• TAB para avançar entre seções ou SHIFT+TAB para voltar.
• F5 para atualizar o painel do goaccess.
• j para rolar para baixo e k para rolar para cima.
• / para procurar um padrão e, em seguida, digite n para mover.
• q para sair do painel.
• F1 ou h para exibir ajuda.

Abaixo você pode ver o painel padrão do GoAccess:

Com a integração do GeoIP, você verá a seção ‘Geo Localização‘ como a seguinte:

Gerando relatórios com GoAccess

Nesta seção, você gerará relatórios de log para HTML, JSON e CSV usando o Analisador de Logs GoAccess. Você também configurará um analisador de logs em tempo real.

Para gerar relatórios HTML para o GoAccess, inclua a opção ‘-o’ seguida pelo ‘filename.html’ como a seguinte:

goaccess access.log -o access-log.html

Agora use seu navegador web e navegue até o arquivo ‘access-log.html‘. Você verá o seguinte relatório do GoAccess:

Além disso, você também pode gerar relatórios de log nos formatos JSON e CSV. Use o comando ‘goaccess’ abaixo.

goaccess access.log -a -d -o access.json  
goaccess access.log --no-csv-summary -o access.csv

Em seguida, você também pode configurar o monitoramento de logs em tempo real com o seguinte comando ‘goaccess‘.

goaccess access.log -o /var/www/html/reports.html --real-time-html

Agora navegue até a página ‘reports.html’ usando um navegador web e você verá os relatórios em tempo real gerados pelo GoAccess.

Conclusão

Parabéns! Você completou a instalação do Analisador de Logs GoAccess em um servidor Ubuntu 24.04. Você aprendeu a instalar o GoAccess com APT e a partir do código-fonte. E então você aprendeu como analisar arquivos de log com o GoAccess, gerando relatórios de log em vários formatos como HTML, JSON e CSV. Por último, você realizou um analisador de logs em tempo real com o GoAccess.