README

Goaccess 是一个开源的日志分析器，可以从多种网络日志格式中提取指标，并在您的终端或 HTML 中进行可视化。指标可以导出为 json 和 csv 格式。此 TYPO3 扩展提供了仪表板小部件和后端模块，用于显示各种 goaccess.io 指标。

安装

composer require xima/xm-goaccess

• 安装和配置 goaccess 以生成目录中的 json 和/或 html 输出
• 确保 web 服务器用户有权读取生成的文件

配置

要启用后端模块，请通过扩展配置设置生成的 html 路径

$GLOBALS['TYPO3_CONF_VARS']['EXTENSIONS']['xm_goaccess']['html_path] = '/tmp/goaccess/goaccess.html';

要使新的仪表板小部件正常工作，您需要传递生成的 json 文件的路径

$GLOBALS['TYPO3_CONF_VARS']['EXTENSIONS']['xm_goaccess']['json_path] = '/tmp/goaccess/goaccess.json';

使用方法

您可以将单个小部件添加到自定义仪表板中，或使用预设，该预设创建一个包含所有可用 goaccess 集成的全新仪表板。

Debian/Ubuntu 上的 Goaccess 安装

该应用程序是用 go 编写的，并可在多个 Linux 发行版的标准存储库中获得。还提供了一个 Debian/Ubuntu 存储库。请参阅 [官方 goaccess.io 文档](https://goaccess.io/get-started) 以获取完整指南。

apt install goaccess

可以通过以下方式从 Apache 日志生成 TYPO3 扩展的 HTML 和 JSON 输出

usr/bin/zcat --force /var/log/apache2/access_example.org.log* | \ # You usually want to parse rotated and gzipped logs as well.
    /usr/bin/goaccess -
    -o goaccess.html -o goaccess.json                           \ # Export processed metrics as html and json.
    --log-format=COMBINED                                       \ # Apache Combined Log Format. Custom log formats are supported, too.
    --ignore-crawlers                                           \ # Ignore web crawlers.
    --exclude-ip ::1 --exclude-ip 127.0.0.1                     \ # Exclude status checks originating from local ip addresses.

要定期刷新这些文件，您可能需要使用 cron 作业，例如。

*/15 * * * /usr/bin/mkdir -p /tmp/goaccess; chmod 750 /tmp/goaccess; /home/user/goaccess-generation.sh