历史评估
将当前测量应用于已记录的事件,选择保留或替换先前的答案,并妥善处理证据不可用和异步完成的情况。
历史评估会对组织中已收集的事件执行测量。你可以用它将新标准应用于以往的翻译、测量从提供方历史记录中导入的事件,或按修订后的定义检查指定时间段内的事件。在测量详情页中,这项功能位于回填选项卡。
如需处理提供方的旧内容,请先导入 GitHub 或 Zendesk 历史记录,并确认所需事件已出现在 Radar → 日志中。导入进度统计的是已加入收集队列的提供方条目;映射和存储可能稍后才会完成。历史评估读取的是已存储的事件数据。导入的历史记录需要进行测量回填,因为这些事件在收集时不会同步接受测量。
查看已测量的事件 #
已测量部分显示,在全部已记录的时间范围内,属于该测量适用事件类型的事件中,有多少已有答案(包括 N/A),例如“8,154 个事件中已测量 1,204 个”。这里只统计数据已存储的事件;无论测量开启还是关闭,都会统计该测量的事件类型,且统计结果不会随回填日期的调整而变化。总数下方会按来源(GitHub 仓库、Zendesk 帮助中心、Crowdin 项目或 Lingo.dev)列出各自已测量的事件数量,例如“acme/web:7,600 个事件中已测量 1,180 个”;记录中未注明来源的事件则归为未知来源。调用 GET /v2/organizations/:orgId/measurements/:measurementId/period-counts 时,无论指定哪个时间区间,使用 ISO 格式的 from(包含)和 to(不包含)都会返回相同的 events、measured 和 origins。
选择定义和时间段 #
开始前请先开启测量:测量关闭时,开始回填不可用。测量中已启用的事件类型决定哪些历史事件会被纳入处理,每个事件都会按其条件当前设置的语言、引擎和抽样范围进行检查。不符合这些设置的事件会得到 N/A 答案,与实时评估一致。
在起始日期和结束日期下方,选项卡会按来源统计所选时间段内的事件:各个 GitHub 仓库、Zendesk 帮助中心、Crowdin 项目和 Lingo.dev;记录中未注明来源的事件归为未知来源。这里统计的是回填将读取、尚未经条件筛选的事件,即属于测量已启用的事件类型且数据已存储的事件。不符合条件所指定语言、引擎或来源的事件也会计入此处,并得到 N/A 答案。测量关闭时不显示数量。
请选择一个较短的时间段,便于逐一检查其中的事件。确认事件数据包含标准所需的源文、译文、草稿或上下文。检查术语表遵循情况和规则遵循情况时,还应保留本地化引擎当前的相关指导:这些检查会在评估运行时读取已关联的术语和规则,而不会重建生成时的上下文。
时间区间按已记录的 eventAt 值筛选事件。Crowdin 审批使用建议的创建时间戳,该时间可能早于审批日期。选择时间段时,请检查事件的时间戳;如果只选择收到审批的那一天,可能会遗漏该事件。
保留或替换先前的答案 #
仅测量尚未测量的事件默认开启。此选项会保留时间段内已有的答案,只测量尚无答案的事件;N/A 答案也视为已测量,会予以保留。
关闭此选项,即可按当前定义重新测量整个时间段。此时启动回填会提示重新测量该时间段?,因为该测量在此时间段内的先前答案会先被删除,再随着事件的测量重新写入。
替换前请保存先前的答案
关闭仅测量尚未测量的事件后,系统会删除该测量在整个所选区间内的答案,包括不再选中的事件类型或语言区域所对应的答案。请先保存比较所需的先前定义和结果。如果事件数据被跳过或替换失败,原本有答案的位置可能会留下空缺。
启动指定时间范围内的评估 #
- 打开测量的回填选项卡。
- 设置起始日期和结束日期。日期控件会将所选的起止两个 UTC 日期都纳入范围,且不能选择今天之后的日期;起止日期选为同一天时,只评估当天的事件。
- 决定是否继续开启仅测量尚未测量的事件。
- 选择开始回填;如果要替换答案,请确认操作。
- 关注进度行中的状态和已测量事件数:状态会从正在回填变为回填完成或回填失败。回填任务也会显示在每个页面角落的后台任务栏中;选择进度行或任务栏中的回填任务,都可查看进度。
底层启动接口为 POST /v2/organizations/:orgId/measurements/:measurementId/backfill,使用 ISO 时间戳,包含 from 边界、不包含 to 边界,并要求提供 from < to 和 unmeasuredOnly。通过 API 调用时,unmeasuredOnly 默认为 false,会替换答案;发送 true 可保留答案。对于一个 UTC 日,区间从当天午夜开始,到次日午夜结束;界面会将包含在内的结束日期转换为次日午夜这一边界。响应为 HTTP 202,并返回异步运行的 id。同一测量已有回填正在运行时,再次启动回填会被拒绝;GET /v2/organizations/:orgId/backfills 列出最近的运行,status=running&startedBy=me 则将列表限定为由你启动且仍在运行的任务。
核对新答案 #
处理时会分页读取事件,并且只为已存储数据可用的事件将测量任务加入队列。回填完成表示其中的事件已接受测量,但每个答案仍会记录各自的结果。回填运行与实时运行采用相同的计量方式,但因条件而跳过的答案除外。回填答案不会生成本地化引擎建议。
检查所选的事件和结果。结果历史记录不显示回填运行的标识,因此需要根据事件标识、测量标识、事件时间区间和计算时间进行匹配。核对时,也应将预期存在但缺少答案的事件纳入检查,而不是仅凭实际返回的记录判断是否完成。
查看每个新 N/A 答案的原因。它可能源于条件筛选、证据缺失、没有适用的指导,或评判者无法给出明确答案。执行失败与符合条件但缺少源文的翻译,需要采用不同的恢复方式。
在替换历史记录之外保留比较依据 #
如果你想判断修订后的标准能否更可靠地发现错误,请保留新旧定义,以及经独立评判的示例及其结果。如果你想判断翻译是否有所改进,请在可比条件下保留两个翻译版本。
回填目前没有明确的取消或答案回滚操作。排查缺失结果时,请勿启动相互重叠的重复运行;应先确认所选事件、缺失的事件数据和已返回的答案。比较翻译模型介绍了如何在不依赖可变历史记录的情况下保留可重复的试验。