自托管 KMonitor v0.4.x 迁移指南

自托管 KMonitor v0.4.x 的迁移指南。可选删除旧数据和所需的数据回填。

仅当您的电量低于v0.4.0并升级到v0.4.x.

本文档中提到的步骤将导致停机。

升级，同时可选择删除旧数据

请按照以下步骤删除所有旧会话升级前.

升级到时请按照以下步骤操作0.4.x。涉及一些停机时间。在停机期间，SDK 将收到503 Service Unavailable发送会话时。升级完成后，摄取应该会正常恢复。 SDK 将自动重试发送未发送的会话。

1. 通过 SSH 连接到托管 KMonitor 的虚拟机

2. 关闭服务

如果您符合以下条件，请跳至步骤 4：不想删除旧数据

cd measure/self-host
sudo docker compose down api cleanup

3. 运行以下命令删除所有旧会话数据

如果您符合以下条件，请跳至步骤 4：不想删除旧数据

sudo docker compose exec clickhouse clickhouse-client --progress -q "truncate table events;"

sudo docker compose exec postgres psql -U postgres -c "truncate table unhandled_exception_groups, anr_groups, event_reqs;"

4. 执行升级

访问发布页面捕获匹配的最新标签[MAJOR].[MINOR].[PATCH]格式。

cd ~/measure
git fetch --tags
git checkout <git-tag>
cd self-host
sudo docker compose -f compose.yml -f compose.prod.yml \
  --profile init \
  --profile migrate \
  down
sudo docker compose pull
sudo ./install.sh

5. 运行数据回填

无论您是否选择删除数据，都请执行此步骤。否则，KMonitor 仪表板上的某些功能（例如过滤器、指标和一些图形）将不会显示。

这可能需要一些时间。确保您的 SSH 连接保持活动状态直至完成。

sudo ./migrations/v0.4.x-data-backfills.sh

`v0.4.x` 迁移指南