Cómo instalar el analizador de registros GoAccess en Ubuntu 24.04

GoAccess es un analizador de registros web en tiempo real para sistemas similares a Unix, incluyendo Ubuntu. Proporciona una forma eficiente y fácil de usar para visualizar y analizar registros de servidores web, soportando varios formatos como Apache, Nginx y registros de Amazon S3. GoAccess se puede ejecutar en la terminal o como una interfaz basada en la web, ofreciendo informes dinámicos con métricas esenciales como conteos de visitantes, detalles de solicitudes, ubicaciones geográficas y sitios de referencia. Es apreciado por su velocidad, interactividad y conocimientos completos, lo que lo convierte en una herramienta valiosa para administradores de sistemas y desarrolladores que buscan monitorear y optimizar el rendimiento del servidor web en sistemas Ubuntu.

En esta guía, aprenderás a instalar el analizador de registros GoAccess en un servidor Ubuntu 24.04.

Prerrequisitos

Antes de comenzar, asegúrate de tener lo siguiente:

• Un servidor Ubuntu 24.04.
• Un usuario no root con privilegios de administrador.
• Un servidor web Apache/Nginx instalado.

Instalando GoAccess con APT

El analizador de registros GoAccess se puede instalar de dos maneras diferentes, a través del gestor de paquetes y manualmente a través del código fuente. En esta sección, aprenderás a instalar GoAccess en Ubuntu con el gestor de paquetes APT.

Primero, ejecuta el siguiente comando para agregar la clave GPG para el repositorio de GoAccess.

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

Agrega el repositorio de GoAccess para distribuciones basadas en Ubuntu/Debian usando el siguiente comando.

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

A continuación, ejecuta el siguiente comando ‘apt’ para actualizar tu índice de paquetes de Ubuntu e instalar ‘ goaccess ‘. Ingresa ‘ Y ‘ para confirmar la instalación.

sudo apt update && sudo apt install goaccess

Después de que la instalación esté completa, localiza el archivo binario ‘ goaccess ‘ y verifica la versión de ‘ goaccess ‘ con lo siguiente:

which goaccess  
goaccess --version

Como puedes ver a continuación, GoAccess 1.9.3 está instalado en ‘ /usr/bin/goaccess ‘.

Instalando GoAccess desde el código fuente

Si deseas compilar GoAccess manualmente desde el código fuente, puedes usar los siguientes pasos:

Antes de compilar GoAccess, ejecuta el siguiente comando ‘apt’ para instalar las dependencias del paquete.

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

Visita la página de descarga de GoAccess, obtén el enlace para la última versión y luego descarga el código fuente de GoAccess y extráelo con el comando ‘tar’ a continuación.

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

Muévete al directorio ‘ goaccess- ‘ y configura tu instalación con lo siguiente. En este ejemplo, habilitarás el soporte de GeoIP a través del archivo de base de datos ‘ mmdb* ‘.

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

Ahora ejecuta el comando a continuación para compilar GoAccess e instalarlo en tu sistema. Una vez ejecutado, GoAccess se instalará en ‘ /usr/local/bin/goaccess ‘ con el directorio de configuración predeterminado ‘ /usr/local/etc/goaccess ‘.

sudo make && sudo make install

Ahora ejecuta el comando a continuación para verificar tu versión de GoAccess. Puedes ver a continuación que GoAccess 1.9.3 está instalado en /usr/local/bin/goaccess.

which goaccess  
goaccess --version

Integrando GoAccess con la base de datos GeoIP

El analizador de registros GoAccess soporta la integración de GeoIP. Con esto, puedes mostrar el país de origen del visitante. En esta sección, configurarás GoAccess e integrarás con el archivo de base de datos GeoIP.

Primero, visita https://db-ip.com/db/lite.php y obtén el enlace para el archivo de base de datos GeoIP y descárgalo usando el comando ‘ wget ‘ a continuación.

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

Extrae el archivo de base de datos GeoIP al directorio /opt/geoip con lo siguiente.

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

A continuación, ejecuta el comando ‘ goaccess ‘ a continuación para localizar el directorio de configuración predeterminado. Si estás instalando a través de APT, tu directorio de GoAccess estará ubicado en el directorio ‘/etc/goaccess’. Si estás compilando desde el código fuente, tu directorio de GoAccess está ubicado en el directorio ‘ /usr/local/etc/goaccess ‘.

goaccess --dcf

Ahora abre el archivo de configuración de GoAccess ‘ /usr/local/etc/goaccess/goaccess.conf ‘ con el siguiente comando del editor ‘ nano ‘.

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

Descomenta las líneas ‘time-format’ y ‘ date-format ‘ como sigue:

# El siguiente formato de tiempo funciona con cualquiera de los  
# formatos de registro de Apache/NGINX que se indican a continuación.  
#  
time-format %H:%M:%S  
  
# El siguiente formato de fecha funciona con cualquiera de los  
# formatos de registro de Apache/NGINX que se indican a continuación.  
#  
date-format %d/%b/%Y

En la opción ‘log-format’, cámbiala a ‘ COMBINED ‘ para registros comunes de Nginx/Apache.

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

Descomenta la opción ‘ geoip ‘ y agrega la ruta del archivo de base de datos GeoIP.

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

Cuando termines, guarda el archivo y sal del editor.

Analizando registros de Apache/Nginx con GoAccess

Ahora que has configurado GoAccess e integrado con GeoIP. En el siguiente paso, aprenderás a analizar archivos de registro con GoAccess.

Para analizar registros con GoAccess, ejecuta el comando ‘ goaccess ‘ a continuación.

goaccess access.log

Puedes ver una salida como la siguiente:

• Visitantes únicos por día: listas de visitantes únicos por día.
• Archivos solicitados (URLs): archivos más solicitados - para archivos no estáticos.
• Solicitudes estáticas: listas de solicitudes para archivos estáticos como imágenes, CSS y JavaScript.
• URLs no encontradas (404s): páginas con errores 404 no encontradas.
• Nombres de host y IPs de visitantes: listas de nombres de host e IPs de visitantes. Puedes expandir para obtener información como país, ciudad y rDNS.
• Sistemas operativos: muestra los sistemas operativos de los visitantes.
• Navegadores: muestra los navegadores web de los visitantes.
• Distribución de tiempo: muestra informes horarios para visitantes únicos, número de visitas y ancho de banda consumido.
• Hosts virtuales: muestra registros de hosts virtuales. Solo activo cuando habilitas VCOMBINED o ‘%s’ en la opción ‘log-format’.
• URLs de referencia: muestra los referidos de los visitantes.

También puedes usar las siguientes teclas para navegar a través de GoAccess:

• TAB para avanzar entre secciones o SHIFT+TAB para retroceder.
• F5 para actualizar el panel de GoAccess.
• j para desplazarte hacia abajo y k para desplazarte hacia arriba.
• / para buscar un patrón, y luego escribe n para moverte.
• q para salir del panel.
• F1 o h para mostrar ayuda.

A continuación, puedes ver el panel predeterminado de GoAccess:

Con la integración de GeoIP, verás la sección ‘ Geo Location ‘ como la siguiente:

Generando informes con GoAccess

En esta sección, generarás informes de registros en HTML, JSON y CSV utilizando el analizador de registros GoAccess. También configurarás un analizador de registros en tiempo real.

Para generar informes HTML para GoAccess, incluye la opción ‘-o’ seguida del ‘filename.html’ como sigue:

goaccess access.log -o access-log.html

Ahora usa tu navegador web y navega al archivo ‘ access-log.html ‘. Verás el siguiente informe de GoAccess:

Además de eso, también puedes generar informes de registros en formatos JSON y CSV. Usa el comando ‘goaccess’ a continuación.

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

A continuación, también puedes configurar el monitoreo de registros en tiempo real con el siguiente comando ‘ goaccess ‘.

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

Ahora navega a la página ‘reports.html’ usando un navegador web y verás los informes en tiempo real generados por GoAccess.

Conclusión

¡Felicidades! Has completado la instalación del analizador de registros GoAccess en un servidor Ubuntu 24.04. Has aprendido a instalar GoAccess con APT y desde el código fuente. Y luego has aprendido cómo analizar archivos de registro con GoAccess, generando informes de registro en múltiples formatos como HTML, JSON y CSV. Por último, has realizado un analizador de registros en tiempo real con GoAccess.