Come installare GoAccess Log Analyzer su Ubuntu 24.04

GoAccess è un analizzatore di log web in tempo reale per sistemi simili a Unix, incluso Ubuntu. Fornisce un modo efficiente e user-friendly per visualizzare e analizzare i log dei server web, supportando vari formati come Apache, Nginx e log di Amazon S3. GoAccess può essere eseguito nel terminale o come interfaccia web, offrendo report dinamici con metriche essenziali come conteggi dei visitatori, dettagli delle richieste, posizioni geografiche e siti di riferimento. È apprezzato per la sua velocità, interattività e approfondimenti completi, rendendolo uno strumento prezioso per gli amministratori di sistema e gli sviluppatori che desiderano monitorare e ottimizzare le prestazioni del server web sui sistemi Ubuntu.

In questa guida, imparerai come installare GoAccess Log Analyzer su un server Ubuntu 24.04.

Prerequisiti

Prima di iniziare, assicurati di avere quanto segue:

• Un server Ubuntu 24.04.
• Un utente non root con privilegi di amministratore.
• Un server web Apache/Nginx installato.

Installazione di GoAccess con APT

GoAccess Log Analyzer può essere installato in due modi diversi, tramite il gestore di pacchetti e manualmente tramite codice sorgente. In questa sezione, imparerai come installare GoAccess su Ubuntu con il gestore di pacchetti APT.

Prima di tutto, esegui il seguente comando per aggiungere la chiave GPG per il repository GoAccess.

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

Aggiungi il repository GoAccess per distribuzioni basate su Ubuntu/Debian utilizzando il comando qui sotto.

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

Successivamente, esegui il seguente comando ‘apt’ per aggiornare l’indice dei pacchetti di Ubuntu e installare ‘ goaccess ‘. Inserisci ‘ Y ‘ per confermare l’installazione.

sudo apt update && sudo apt install goaccess

Dopo che l’installazione è completata, individua il file binario ‘ goaccess ‘ e controlla la versione di ‘ goaccess ‘ con il seguente comando:

which goaccess  
goaccess --version

Come puoi vedere qui sotto, GoAccess 1.9.3 è installato in ‘ /usr/bin/goaccess ‘.

Installazione di GoAccess dal codice sorgente

Se desideri compilare GoAccess manualmente dal codice sorgente, puoi utilizzare i seguenti passaggi:

Prima di compilare GoAccess, esegui il seguente comando ‘apt’ per installare le dipendenze dei pacchetti.

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

Visita la pagina di download di GoAccess, prendi il link per l’ultima versione e poi scarica il codice sorgente di GoAccess ed estrailo con il comando ‘tar’ qui sotto.

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

Spostati nella directory ‘ goaccess- ‘ e configura la tua installazione con il seguente comando. In questo esempio, abiliterai il supporto GeoIP tramite il file di database ‘ mmdb* ‘.

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

Ora esegui il comando qui sotto per compilare GoAccess e installarlo sul tuo sistema. Una volta eseguito, GoAccess sarà installato in ‘ /usr/local/bin/goaccess ‘ con la directory di configurazione predefinita ‘ /usr/local/etc/goaccess ‘.

sudo make && sudo make install

Ora esegui il comando qui sotto per verificare la tua versione di GoAccess. Puoi vedere qui sotto che GoAccess 1.9.3 è installato in /usr/local/bin/goaccess.

which goaccess  
goaccess --version

Integrazione di GoAccess con il database GeoIP

GoAccess Log Analyzer supporta l’integrazione GeoIP. Con questo, puoi visualizzare il paese di origine dei visitatori. In questa sezione, configurerai GoAccess e lo integrerai con il file del database GeoIP.

Prima di tutto, visita https://db-ip.com/db/lite.php e prendi il link per il file del database GeoIP e scaricalo utilizzando il comando ‘ wget ‘ qui sotto.

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

Estrai il file del database GeoIP nella directory /opt/geoip con il seguente comando.

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

Successivamente, esegui il comando ‘ goaccess ‘ qui sotto per localizzare la directory di configurazione predefinita. Se stai installando tramite APT, la tua directory GoAccess si troverà nella directory ‘/etc/goaccess’. Se stai compilando dal codice sorgente, la tua directory GoAccess si trova nella directory ‘ /usr/local/etc/goaccess ‘.

goaccess --dcf

Ora apri il file di configurazione di GoAccess ‘ /usr/local/etc/goaccess/goaccess.conf ‘ con il seguente comando dell’editor ‘ nano ‘.

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

Decommenta le righe ‘time-format’ e ‘ date-format ‘ come segue:

# Il seguente formato orario funziona con qualsiasi dei  
# formati di log di Apache/NGINX qui sotto.  
#  
time-format %H:%M:%S  
  
# Il seguente formato data funziona con qualsiasi dei  
# formati di log di Apache/NGINX qui sotto.  
#  
date-format %d/%b/%Y

Nell’opzione ‘log-format’, cambiala in ‘ COMBINED ‘ per i log comuni di Nginx/Apache.

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

Decommenta l’opzione ‘ geoip ‘ e aggiungi il percorso del file del database GeoIP.

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

Quando hai finito, salva il file ed esci dall’editor.

Analisi dei log Apache/Nginx con GoAccess

Ora che hai configurato GoAccess e lo hai integrato con GeoIP. Nel passaggio successivo, imparerai come analizzare i file di log con GoAccess.

Per analizzare i log con GoAccess, esegui il comando ‘ goaccess ‘ qui sotto.

goaccess access.log

Puoi vedere un output come il seguente:

• Visitatori unici al giorno: elenchi di visitatori unici per giorno.
• File richiesti (URL): file più richiesti - per file non statici.
• Richieste statiche: elenchi di richieste per file statici come immagini, CSS e JavaScript.
• URL non trovati (404): pagine con errori 404 non trovati.
• Nomi host e IP dei visitatori: elenchi di nomi host e indirizzi IP dei visitatori. Puoi espandere per ottenere informazioni come paese, città e rDNS.
• Sistemi operativi: visualizza i sistemi operativi dei visitatori.
• Browser: visualizza i browser web dei visitatori.
• Distribuzione temporale: visualizza report orari per visitatori unici, numero di accessi e larghezza di banda consumata.
• Host virtuali: visualizza i log degli host virtuali. Solo attivo quando abiliti VCOMBINED o ‘%s’ nell’opzione ‘log-format’.
• URL di riferimento: visualizza i riferimenti dei visitatori.

Puoi anche utilizzare i seguenti tasti per navigare attraverso GoAccess:

• TAB per muoverti avanti tra le sezioni o SHIFT+TAB per muoverti indietro.
• F5 per aggiornare il dashboard di goaccess.
• j per scorrere verso il basso e k per scorrere verso l’alto.
• / per cercare un modello, e poi digita n per muoverti.
• q per uscire dal dashboard.
• F1 o h per visualizzare aiuto.

Qui sotto puoi vedere il dashboard predefinito di GoAccess:

Con l’integrazione GeoIP, vedrai la sezione ‘ Geo Location ‘ come segue:

Generazione di report con GoAccess

In questa sezione, genererai report di log in HTML, JSON e CSV utilizzando GoAccess Log Analyzer. Imposterai anche un analizzatore di log in tempo reale.

Per generare report HTML per GoAccess, includi l’opzione ‘-o’ seguita da ‘filename.html’ come segue:

goaccess access.log -o access-log.html

Ora utilizza il tuo browser web e naviga al file ‘ access-log.html ‘. Vedrai il seguente report di GoAccess:

In aggiunta a ciò, puoi anche generare report di log nei formati JSON e CSV. Usa il comando ‘goaccess’ qui sotto.

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

Successivamente, puoi anche impostare il monitoraggio dei log in tempo reale con il seguente comando ‘ goaccess ‘.

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

Ora naviga alla pagina ‘reports.html’ utilizzando un browser web e vedrai i report in tempo reale generati da GoAccess.

Conclusione

Congratulazioni! Hai completato l’installazione di GoAccess Log Analyzer su un server Ubuntu 24.04. Hai imparato a installare GoAccess con APT e dal codice sorgente. E poi hai imparato come analizzare i file di log con GoAccess, generando report di log in più formati come HTML, JSON e CSV. Infine, hai eseguito un analizzatore di log in tempo reale con GoAccess.