extract-matomo 镜像文档

镜像概述和主要用途

extract-matomo是一款用于将Matomo内容导出至PostgreSQL数据库的工具。该工具通过文件批量加载方式实现数据导出，因此需与PostgreSQL数据库部署在同一台机器上。

核心功能和特性

• 数据导出功能：支持将Matomo平台的内容数据导出至PostgreSQL数据库
• 批量加载机制：采用文件批量加载方式提升数据导入效率
• 环境变量配置：通过环境变量灵活配置数据库连接参数及Matomo认证信息
• 定时任务支持：可通过CRON任务实现定期自动数据导出

使用场景和适用范围

适用于需要将Matomo分析数据持久化存储到PostgreSQL，以便进行进一步数据分析、报表生成或与BI工具集成的场景，尤其适合需要定期同步Matomo数据的业务需求。

使用方法和配置说明

构建二进制文件

执行以下命令构建工具二进制文件：

./build/build-binary.sh

计划CRON任务

通过配置CRON任务实现定期自动导出，具体配置如下：

1. 创建CRON配置文件 /etc/cron.d/extract-jira：

SHELL=/bin/sh
PATH=/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin
0 9 * * * portainer /home/portainer/extract-matomo/extract-matomo.sh > /home/portainer/extract-matomo/log/extract-matomo.log 2>&1

（说明：每天9点由portainer用户执行导出脚本，日志输出至指定文件）

2. 创建导出执行脚本 extract-matomo.sh：

#!/bin/sh
cd /home/portainer/extract-matomo/
. /home/portainer/.profile
./extract-matomo

（说明：切换至工具目录，加载环境变量配置，执行导出程序）

环境变量配置

在 /home/portainer/.profile 文件中配置必要环境变量：

export MATOMO_TOKEN_AUTH=f2xxxx57  # Matomo认证令牌
export PG_DB_SERVER=localhost      # PostgreSQL服务器地址
export PG_DB_PORT=5432             # PostgreSQL端口
export PG_DB_USER=admin            # PostgreSQL用户名
export PG_DB_PASSWORD=xxxx         # PostgreSQL密码
export PG_DB_NAME=jira             # 目标数据库名称

Metabase部署示例

可部署Metabase作为BI仪表盘连接PostgreSQL进行数据可视化，部署命令如下：

docker run -d -p 3000:3000 \
  --name metabase \
  --restart=always \
  -e "MB_DB_TYPE=postgres" \
  -e "MB_DB_DBNAME=metabase" \
  -e "MB_DB_PORT=5432" \
  -e "MB_DB_USER=admin" \
  -e "MB_DB_PASS=xxxx" \
  -e "MB_DB_HOST=172.17.0.1" \
  metabase/metabase:latest

部署完成后，通过以下地址访问Metabase：
http://localhost:3000