From ce04cb8c607ad5e217c5ec393062aeb2ff079f5b Mon Sep 17 00:00:00 2001 From: jiarongping Date: Mon, 9 May 2022 13:18:30 +0800 Subject: [PATCH] fix: update file uni-stat-v2.md --- docs/uni-stat-v2.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/docs/uni-stat-v2.md b/docs/uni-stat-v2.md index e9a698aed..0d6635965 100644 --- a/docs/uni-stat-v2.md +++ b/docs/uni-stat-v2.md @@ -168,20 +168,20 @@ uni统计2.0 是基于 uniCloud 开发的开源、免费统计平台。 - 统计页面：`pages/uni-stat` 文件夹 ::: -#### 定时跑批周期 +#### 设置定时任务云函数的触发周期 -`uni统计2.0`默认跑批间隔为1小时，即：每隔1小时，针对采集到的数据进行统计，计算新增、活跃、留存等。 +`uni统计2.0`中`定时任务云函数（uni-stat-cron）`的默认触发周期为每小时触发一次（即：每隔1小时，系统会自动触发一次`uni-stat-cron`云函数）。 -你可以根据需要修改跑批周期到分钟级，但要注意开启分钟级定时任务后，需要确保[定时任务配置项](#定时任务配置说明)中设置的分钟数是否会被触发，比如你的配置项中设置的是每小时的第10分钟触发（表达式：`* * * 10`），而定时触发器设置的为每20分钟触发1次（`0 1/20 * * * * *`），那这个配置项将永远不会触发。 +你可以根据需要修改`定时任务云函数（uni-stat-cron）`的触发周期到分钟级(即每隔n分钟触发一次)，但要注意触发周期修改后，需要确保[定时任务配置项](#定时任务配置说明)中设置的分钟数是否会被触发，比如你的配置项中设置的是每小时的第10分钟触发（表达式：`* * * 10`），而定时触发器设置的为每20分钟触发1次（`0 1/20 * * * * *`），那这个配置项将永远不会触发。 ::: warning 注意 -1. 现阶段阿里云仅支持小时级的定时任务，预计很快支持分钟级定时任务，现阶段阿里云用户如想开通分钟级定时任务必须先向DCloud申请后再开启。[申请方式](https://uniapp.dcloud.io/uniCloud/price.html#aliyun) -2. 因云函数运行时长为最大10分钟，所以开启分钟级定时任务后，如果想重新设置定时任务触发时间的话，需要确保各定时任务之间的触发间隔时间要大于等于10分钟，防止出现运行超时的问题。 +1. 现阶段阿里云仅支持小时级的定时任务（即阿里云云函数的定时触发的最小间隔只能设置为每小时触发一次），因此现阶段阿里云用户如想将`定时任务云函数（uni-stat-cron）`的触发周期设置为分钟级须先向DCloud申请后再开启。[申请方式](https://uniapp.dcloud.io/uniCloud/price.html#aliyun) +2. 因云函数单次最大运行时长为10分钟，所以开启分钟级定时任务后，如果想重新设置定时任务中触发时间的话，最好确保各定时任务之间的触发间隔时间要大于等于10分钟，防止出现运行超时的问题。默认定时任务类型和触发时间可参考下方[定时任务配置说明](#定时任务配置说明)的说明。 ::: - 我们这里以将跑批周期修改为每隔10分钟触发1次为例，正确的步骤为： -1. 修改uni统计配置项将`cronMin`参数的值改为`true`。 +1. 修改[uni统计配置项](#公共模块配置项说明)将`cronMin`参数的值改为`true`。 2. 修改`定时任务云函数（uni-stat-cron）`下的`package.json`文件中的定时触发器配置项，关于定时触发器的具体说明可以参考官方文档[定时触发器](https://uniapp.dcloud.io/uniCloud/trigger.html)。 ``` javascript "cloudfunction-config": { @@ -213,7 +213,7 @@ uni统计2.0 是基于 uniCloud 开发的开源、免费统计平台。 ::: **开启步骤：** -1. 修改uni统计配置项将`redis`参数的值改为`true`。 +1. 修改[uni统计配置项](#公共模块配置项说明)将`redis`参数的值改为`true`。 2. 分别在数据`上报数据接收器（uni-stat-receiver）`和`定时任务云函数（uni-stat-cron）`下的`package.json`文件中添加redis拓展库。 3. 重新上传部署数据`上报数据接收器（uni-stat-receiver）`、`定时任务云函数（uni-stat-cron）`和`配置中心（uni-config-center）`。 @@ -619,7 +619,7 @@ uni统计配置项存放于uniCloud配置中心（`uni-config-center`）下的 ` | cachetime | 604800 |redis缓存有效期，单位秒。 | | sessionExpireTime| 1800 |会话过期时间，该配置用来判断当前会话是否已过期，一般情况下无需修改此项。 | | realtimeStat | true |开启实时统计，true: 开启，false:关闭，开启后会每小时统计一次，数据库读写次数会增多，可按需决定是否开启。 | -| cronMin | false |开启分钟级定时任务，true: 开启，false:关闭。开启后定时任务将细分到分钟级执行，分摊数据计算压力，适合应用日活较大或有特殊需求的用户群体。开启方法见[定时跑批周期](#定时跑批周期)。 | +| cronMin | false |开启分钟级定时任务，true: 开启，false:关闭。开启后定时任务将细分到分钟级执行，分摊数据计算压力，适合应用日活较大或有特殊需求的用户群体。具体的开启方法见[设置定时任务云函数的触发周期](#设置定时任务云函数的触发周期)。 | | cron | - |用于配置定时任务触发时间，详情见下方[定时任务配置说明](#定时任务配置说明)。 | | batchInsertNum | 5000 |当有批量写入操作时，限制单次写入数据库的最大条数。为防止写入超时，最大值为5000条。 | | errorCheck | - |错误检测，此项用于在规定时间内限制相同的错误日志写入数据库，防止有高频错误产生时造成大量的数据库写入操作。[详情](#错误检测配置说明) | -- GitLab