北京
凌晨三點(diǎn)，刺耳的告警聲劃破寂靜。一位軟件工程師被緊急電話叫醒——他必須在60分鐘內(nèi)解決線上問(wèn)題，否則影響范圍會(huì)擴(kuò)大。可當(dāng)他點(diǎn)開(kāi)監(jiān)控面板，看著交織在一起的服務(wù)、缺失的文檔，他愣住了，完全不知道從哪里下手。
這是他的第一次On-Call輪值。系統(tǒng)里多個(gè)組件相互依賴，但沒(méi)有任何一份清晰的說(shuō)明。他只能依靠深夜里睡眼惺忪的同事遠(yuǎn)程指點(diǎn)，但問(wèn)題比想象中復(fù)雜。一個(gè)告警剛壓下去，另一個(gè)又冒出來(lái)，像是打地鼠。他開(kāi)始懷疑自己能否撐過(guò)這一周。
隨著輪值進(jìn)入后半程，他逐漸摸到一個(gè)規(guī)律：那些深夜反復(fù)出現(xiàn)的故障，絕大多數(shù)不是代碼Bug，而是因?yàn)榇蠹也磺宄到y(tǒng)到底怎么運(yùn)作。比如，一個(gè)參數(shù)的真實(shí)含義被曲解，或者兩個(gè)服務(wù)之間的依賴關(guān)系沒(méi)有口頭傳遞之外的解釋。團(tuán)隊(duì)里能找到的文檔少得可憐，即便有，也和當(dāng)前代碼對(duì)不上。他們被困在“只有老人知道”的知識(shí)陷阱里。
他決定不再硬撐。后四天，他切換成“學(xué)生模式”——從最頭疼的模塊開(kāi)始，一行行讀代碼，畫調(diào)用鏈路圖，把關(guān)鍵邏輯寫成筆記。他甚至寫了幾段自動(dòng)化腳本，把原來(lái)需要手動(dòng)執(zhí)行的重復(fù)檢查任務(wù)變成一鍵運(yùn)行。令人驚訝的事發(fā)生了：告警的數(shù)量開(kāi)始穩(wěn)步下降。哪怕偶爾再響，他也能在幾分鐘內(nèi)找到根源，完成修復(fù)。
那一刻他悟到：系統(tǒng)設(shè)計(jì)的成功，不在于功能多強(qiáng)大，而在于它是否“可被理解”。文檔是系統(tǒng)的一部分，就像代碼一樣不可或缺。你需要提前想好后來(lái)者——哪怕是下個(gè)月的自己——會(huì)問(wèn)出什么問(wèn)題，并在文檔里給出精準(zhǔn)答案。他開(kāi)始習(xí)慣在文檔里不只寫“是什么”，還寫“為什么這樣設(shè)計(jì)”和“如果出問(wèn)題，可以從哪里查起”。
這次值班被他視為職業(yè)生涯的分水嶺。之后，他在每一個(gè)項(xiàng)目中都把文檔放在和功能開(kāi)發(fā)同等優(yōu)先級(jí)。他會(huì)寫清楚每個(gè)模塊的職責(zé)邊界，畫出實(shí)時(shí)更新的架構(gòu)圖，甚至把繁瑣的運(yùn)維步驟腳本化。團(tuán)隊(duì)的值班體驗(yàn)從此完全不同。
當(dāng)然，值班的警報(bào)不會(huì)永遠(yuǎn)沉默，他仍偶爾在深夜被叫醒。但每次他從容解決完問(wèn)題，都會(huì)想起那個(gè)混亂的凌晨，然后慶幸自己選擇了一條更難，卻讓整個(gè)團(tuán)隊(duì)更輕盈的路。
特別聲明：以上內(nèi)容(如有圖片或視頻亦包括在內(nèi))為自媒體平臺(tái)“網(wǎng)易號(hào)”用戶上傳并發(fā)布，本平臺(tái)僅提供信息存儲(chǔ)服務(wù)。
Notice: The content above (including the pictures and videos if any) is uploaded and posted by a user of NetEase Hao, which is a social media platform and only provides information storage services.
