Ubuntu 24.04にGoAccessログアナライザーをインストールする方法

GoAccessは、Ubuntuを含むUnix系システム用のリアルタイムWebログアナライザーです。Apache、Nginx、Amazon S3ログなど、さまざまな形式をサポートし、Webサーバーログを視覚化および分析するための効率的でユーザーフレンドリーな方法を提供します。GoAccessは、ターミナルまたはWebベースのインターフェースで実行でき、訪問者数、リクエストの詳細、地理的位置、参照サイトなどの重要なメトリックを含む動的レポートを提供します。その速度、インタラクティブ性、包括的な洞察が評価されており、Ubuntuシステム上でWebサーバーのパフォーマンスを監視および最適化しようとするシステム管理者や開発者にとって貴重なツールとなっています。

このガイドでは、Ubuntu 24.04サーバーにGoAccessログアナライザーをインストールする方法を学びます。

前提条件

始める前に、以下のものを用意してください：

Ubuntu 24.04サーバー。
管理者権限を持つ非ルートユーザー。
インストールされたWebサーバーApache/Nginx。

APTを使用したGoAccessのインストール

GoAccessログアナライザーは、パッケージマネージャーを介してとソースコードを介して手動でインストールする2つの方法でインストールできます。このセクションでは、APTパッケージマネージャーを使用してUbuntuにGoAccessをインストールする方法を学びます。

まず、以下のコマンドを実行してGoAccessリポジトリのGPGキーを追加します。

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

次に、以下のコマンドを使用してUbuntu/Debianベースのディストリビューション用のGoAccessリポジトリを追加します。

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-」ディレクトリに移動し、以下のコマンドでインストールを構成します。この例では、「mmdb*」データベースファイルを介してGeoIPサポートを有効にします。

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

GeoIPデータベースとのGoAccessの統合

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

次に、以下の「nano」エディタコマンドでGoAccess構成ファイル「/usr/local/etc/goaccess/goaccess.conf」を開きます。

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

完了したら、ファイルを保存してエディタを終了します。

GoAccessでApache/Nginxのログを分析する

GoAccessを構成し、GeoIPと統合したので、次のステップではGoAccessを使用してログファイルを分析する方法を学びます。

GoAccessでログを分析するには、以下の「goaccess」コマンドを実行します。

goaccess access.log

以下のような出力が表示されます：

ユニーク訪問者数：日ごとのユニーク訪問者のリスト。
リクエストされたファイル（URL）：最もリクエストされたファイル - 非静的ファイル用。
静的リクエスト：画像、CSS、JavaScriptなどの静的ファイルのリクエストのリスト。
見つからないURL（404）：404のページが見つかりませんエラー。
訪問者のホスト名とIP：訪問者のホスト名とIPアドレスのリスト。国、都市、rDNSなどの情報を取得するために展開できます。
オペレーティングシステム：訪問者のオペレーティングシステムを表示します。
ブラウザ：訪問者のWebブラウザを表示します。
時間分布：ユニーク訪問者数、ヒット数、消費された帯域幅の時間ごとのレポートを表示します。
仮想ホスト：仮想ホストのログを表示します。「log-format」オプションでVCOMBINEDまたは’%s’を有効にした場合のみアクティブになります。
リファラーURL：訪問者のリファラーを表示します。

GoAccessをナビゲートするために、以下のキーも使用できます：

TAB：セクション間を前に進む、またはSHIFT+TABで後ろに戻る。
F5：goaccessダッシュボードを更新します。
j：下にスクロール、k：上にスクロール。
/：パターンを検索し、次にnを入力して移動します。
q：ダッシュボードを終了します。
F1またはh：ヘルプを表示します。

以下に、デフォルトのGoAccessダッシュボードを示します：

check logs

GeoIP統合により、以下のような「Geo Location」セクションが表示されます：

geoip

GoAccessでレポートを生成する

このセクションでは、GoAccessログアナライザーを使用してHTML、JSON、CSV形式のログレポートを生成します。また、リアルタイムログアナライザーを設定します。

GoAccessのHTMLレポートを生成するには、「-o」オプションを含め、その後に「filename.html」を指定します。

goaccess access.log -o access-log.html

次に、Webブラウザを使用して「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

次に、Webブラウザを使用して「reports.html」ページに移動すると、GoAccessによって生成されたリアルタイムレポートが表示されます。

real time via websocket

結論

おめでとうございます！Ubuntu 24.04サーバーにGoAccessログアナライザーのインストールが完了しました。APTおよびソースコードからGoAccessをインストールする方法を学びました。そして、GoAccessを使用してログファイルを分析し、HTML、JSON、CSVなどの複数の形式でログレポートを生成する方法を学びました。最後に、GoAccessを使用してリアルタイムログアナライザーを実行しました。