Files
memind/docs/local-analytics.md
T
john 8348ce3625
Memind CI / Test, build, and release guards (push) Has been cancelled
docs: add analytics release runbook and 105 Umami topology
Cross-repo publish order for memind-analytics, Portal, and memind_adm;
update platform and 105 operations docs for systemd artifact deploy.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-08-10 16:21:57 +08:00

1.8 KiB
Raw Blame History

Local Memind analytics (Umami)

Rybbit 已退役,见 analytics-platform.md。下文仅描述 Umami。

Memind 通过同源 /analytics/* 代理本地或远程 Umami 服务(默认 http://127.0.0.1:3100)。

MEMIND_ANALYTICS_ENABLED=true
MEMIND_ANALYTICS_URL=http://127.0.0.1:3100
MEMIND_ANALYTICS_WEBSITE_ID=<website-id>
MEMIND_ANALYTICS_ID_SECRET=<random-local-secret>
MEMIND_ANALYTICS_IDENTITY_MODE=pseudonymous
MEMIND_ANALYTICS_DOMAINS=127.0.0.1,localhost

MEMIND_ANALYTICS_IDENTITY_MODE=raw 仅在明确批准的第一方分析环境中使用;其他环境保持 pseudonymous 默认。

Product shell(独立 Website

为 Memind 产品壳(H5 SPA)创建第二个 Umami Website,避免聊天与导航事件污染生成页 PV:

MEMIND_PRODUCT_ANALYTICS_ENABLED=true
MEMIND_PRODUCT_ANALYTICS_WEBSITE_ID=<product-website-id>

产品壳 tracker 同样走 /analytics/script.js,记录 SPA 路由 PV、product_click 与 10/30 秒参与事件。

SEO / GEO 发现流量

公开页 Umami 事件附带 discovery_channelseo / geo / direct / referral)与 discovery_source。memind_adm Analytics → SEO / GEO 流量 看板按页展示 SEO 与 GEO 来源的浏览明细(口径与 Umami「生成页明细」一致)。

管理后台

  • memind_adm → Analytics 配置Umami Website ID、密钥、SSO 入口
  • memind_adm → SEO / GEO 流量:按页监控搜索引擎 / 生成式引擎来源访问

生产发布与环境变量见 memind_adm docs/analytics-deploy.md
跨仓库发布顺序见 analytics-release-runbook.md

Analytics 服务 fail-open:未配置或 Umami 不可用时,页面生成与交付不受影响。勿向终端用户暴露 Umami 控制台。