Как установить анализатор логов GoAccess на Ubuntu 24.04

GoAccess — это анализатор веб-логов в реальном времени для систем, подобных Unix, включая Ubuntu. Он предоставляет эффективный и удобный способ визуализации и анализа логов веб-сервера, поддерживая различные форматы, такие как логи Apache, Nginx и Amazon S3. GoAccess можно запускать в терминале или как веб-интерфейс, предлагая динамические отчеты с основными метриками, такими как количество посетителей, детали запросов, географические местоположения и ссылающиеся сайты. Он ценится за свою скорость, интерактивность и всесторонние аналитические данные, что делает его ценным инструментом для системных администраторов и разработчиков, стремящихся контролировать и оптимизировать производительность веб-сервера на системах Ubuntu.

В этом руководстве вы узнаете, как установить анализатор логов GoAccess на сервер Ubuntu 24.04.

Предварительные требования

Перед тем как начать, убедитесь, что у вас есть следующее:

Сервер Ubuntu 24.04.
Пользователь без прав root с правами администратора.
Установленный веб-сервер Apache/Nginx.

Установка GoAccess с помощью APT

Анализатор логов GoAccess можно установить двумя способами: через менеджер пакетов и вручную из исходного кода. В этом разделе вы узнаете, как установить GoAccess на Ubuntu с помощью менеджера пакетов APT.

Сначала выполните следующую команду, чтобы добавить GPG-ключ для репозитория GoAccess.

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

Добавьте репозиторий GoAccess для дистрибутивов на базе Ubuntu/Debian, используя команду ниже.

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

Затем выполните следующую команду ‘apt’, чтобы обновить индекс пакетов Ubuntu и установить ‘ goaccess ‘. Введите ‘ Y ‘, чтобы подтвердить установку.

sudo apt update && sudo apt install goaccess

add repo update instakk

После завершения установки найдите двоичный файл ‘ goaccess ‘ и проверьте версию ‘ goaccess ‘ с помощью следующей команды:

which goaccess  
goaccess --version

Как видно ниже, GoAccess 1.9.3 установлен в ‘ /usr/bin/goaccess ‘.

check goaccess

Установка GoAccess из исходного кода

Если вы хотите собрать GoAccess вручную из исходного кода, вы можете использовать следующие шаги:

Перед компиляцией GoAccess выполните следующую команду ‘apt’, чтобы установить зависимости пакетов.

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

install deps

Перейдите на страницу загрузки GoAccess, получите ссылку на последнюю версию, затем загрузите исходный код GoAccess и извлеките его с помощью команды ‘tar’ ниже.

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

Перейдите в директорию ‘ goaccess- ‘ и настройте установку с помощью следующей команды. В этом примере вы включите поддержку GeoIP через файл базы данных ‘ mmdb* ‘.

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

configure build

Теперь выполните команду ниже, чтобы скомпилировать GoAccess и установить его в вашу систему. После выполнения GoAccess будет установлен в ‘ /usr/local/bin/goaccess ‘ с каталогом конфигурации по умолчанию ‘ /usr/local/etc/goaccess ‘.

sudo make && sudo make install

compile install

Теперь выполните команду ниже, чтобы проверить версию GoAccess. Вы можете увидеть, что GoAccess 1.9.3 установлен в /usr/local/bin/goaccess.

which goaccess  
goaccess --version

check version

Интеграция GoAccess с базой данных GeoIP

Анализатор логов GoAccess поддерживает интеграцию GeoIP. С помощью этого вы можете отображать страну происхождения посетителя. В этом разделе вы настроите GoAccess и интегрируете его с файлом базы данных GeoIP.

Сначала посетите https://db-ip.com/db/lite.php и получите ссылку на файл базы данных GeoIP, затем загрузите его с помощью команды ‘ wget ‘ ниже.

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

Извлеките файл базы данных GeoIP в директорию /opt/geoip с помощью следующей команды.

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

Затем выполните команду ‘ goaccess ‘ ниже, чтобы найти каталог конфигурации по умолчанию. Если вы устанавливаете через APT, ваш каталог GoAccess будет находиться в директории ‘/etc/goaccess’. Если вы компилируете из исходного кода, ваш каталог GoAccess находится в директории ‘ /usr/local/etc/goaccess ‘.

goaccess --dcf

Теперь откройте файл конфигурации GoAccess ‘ /usr/local/etc/goaccess/goaccess.conf ‘ с помощью следующей команды редактора ‘ nano ‘.

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

Распакуйте строки ‘time-format’ и ‘ date-format ‘ следующим образом:

# Следующий формат времени работает с любым из  
# форматов логов Apache/NGINX ниже.  
#  
time-format %H:%M:%S  
  
# Следующий формат даты работает с любым из  
# форматов логов Apache/NGINX ниже.  
#  
date-format %d/%b/%Y

В опции ‘log-format’ измените ее на ‘ COMBINED ‘ для общих логов Nginx/Apache.

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

Распакуйте опцию ‘ geoip ‘ и добавьте путь к файлу базы данных GeoIP.

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

Когда закончите, сохраните файл и выйдите из редактора.

Анализ логов Apache/Nginx с помощью GoAccess

Теперь, когда вы настроили GoAccess и интегрировали его с GeoIP. На следующем шаге вы узнаете, как анализировать файлы логов с помощью GoAccess.

Чтобы анализировать логи с помощью GoAccess, выполните команду ‘ goaccess ‘ ниже.

goaccess access.log

Вы можете увидеть вывод, похожий на следующий:

Уникальные посетители в день: списки уникальных посетителей за день.
Запрашиваемые файлы (URL): самые запрашиваемые файлы - для нестатических файлов.
Статические запросы: списки запросов на статические файлы, такие как изображения, CSS и JavaScript.
Не найденные URL (404): страницы с ошибками 404 не найдены.
Имена хостов и IP-адреса посетителей: списки имен хостов и IP-адресов посетителей. Вы можете развернуть, чтобы получить информацию, такую как страна, город и rDNS.
Операционные системы: отображение операционных систем посетителей.
Браузеры: отображение веб-браузеров посетителей.
Распределение времени: отображение почасовых отчетов о уникальных посетителях, количестве посещений и потребляемой полосе пропускания.
Виртуальные хосты: отображение логов виртуальных хостов. Активно только при включении VCOMBINED или ‘%s’ в опции ‘log-format’.
URL-адреса рефереров: отображение рефереров посетителей.

Вы также можете использовать следующие клавиши для навигации по GoAccess:

TAB для перехода вперед между разделами или SHIFT+TAB для перехода назад.
F5 для обновления панели управления goaccess.
j для прокрутки вниз и k для прокрутки вверх.
/ для поиска по шаблону, а затем введите n для перемещения.
q для выхода из панели управления.
F1 или h для отображения справки.

Ниже вы можете увидеть панель управления GoAccess по умолчанию:

check logs

С интеграцией GeoIP вы увидите раздел ‘ Geo Location ‘ следующим образом:

geoip

Генерация отчетов с помощью GoAccess

В этом разделе вы сгенерируете отчеты по логам в форматах HTML, JSON и CSV с помощью анализатора логов GoAccess. Вы также настроите анализатор логов в реальном времени.

Чтобы сгенерировать HTML-отчеты для GoAccess, добавьте опцию ‘-o’, за которой следует ‘filename.html’, как показано ниже:

goaccess access.log -o access-log.html

Теперь используйте веб-браузер и перейдите к файлу ‘ access-log.html ‘. Вы увидите следующий отчет GoAccess:

exported

Кроме того, вы также можете генерировать отчеты по логам в форматах JSON и CSV. Используйте команду ‘goaccess’ ниже.

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

Затем вы также можете настроить мониторинг логов в реальном времени с помощью следующей команды ‘ goaccess ‘.

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

Теперь перейдите на страницу ‘reports.html’ с помощью веб-браузера, и вы увидите отчеты в реальном времени, сгенерированные GoAccess.

real time via websocket

Заключение

Поздравляем! Вы завершили установку анализатора логов GoAccess на сервере Ubuntu 24.04. Вы узнали, как установить GoAccess с помощью APT и из исходного кода. Затем вы узнали, как анализировать файлы логов с помощью GoAccess, генерируя отчеты по логам в нескольких форматах, таких как HTML, JSON и CSV. Наконец, вы выполнили анализатор логов в реальном времени с помощью GoAccess.