「默认值和配置谁赢」。
代码里一份,配置里一份,容易不知道哪份生效。定一个顺序写进说明。
给后来的人看,所以写能照着做的步骤,不写感受。每一步写期望看到什么。看不到,就停在这一步,不要继续往下猜。步骤结束以后,用干净环境再做一次。自己的机器上能过,只能说明自己的机器上能过。
先写不做什么。多一个组件就多一种故障,量不大就不要先加队列或缓存。每一层的等待时间写明,重试要有次数和间隔的上限。同一状态只在一个地方改。请求编号从入口带下去,不然日志对不起来。决定用一段话记下来。
收尾只留三行在仓库里:现象,改了哪一处,怎样确认。聊天记录会沉,仓库还在。三行对不上,就还没完,先不要告诉别人已经好了。对得上,别人才能在不找作者的情况下把同一件事再做一遍。
复查「默认值和配置谁赢」时按这四步,不靠感觉。用改之前的同一组输入再走一遍,结果要变成预期的那样。在日志里打出实际读到的配置名、端口或库名,确认不是另一个还没关的进程。换一个干净环境再做一次。最后把现象、改动、确认方法写成三行放进仓库。
补充记录。讨论先写三行不做什么,避免范围越加越大。量不大就不要先加队列或缓存,多一个组件就多一种故障。每一层等待时间写明,用户看到的失败常常只是最外层超时。重试要有次数和间隔的上限,否则失败会把下游打满。同一状态只允许一个地方改。请求编号从入口生成并往后传,没有编号就不要谈跨服务排查。决定用一段话记在仓库里。两个月后没这段话,会原样再吵一次。
操作顺序。1. 开头写三件不做什么。2. 标出每一层谁调用谁,以及等待多久。3. 重试写上次数和间隔的上限。4. 同一状态指定唯一可以改它的地方。5. 量不大就先不要加队列或缓存,把直接路径做稳。6. 请求编号从入口生成并往后传。7. 决定用一段话写进仓库:为什么这样,什么时候再看。没有这段话,两个月后会用同样的论据再吵一次。图只保留调用关系,例外用文字说明。