當運營向我們上報BUG時,我們第一時間是捕獲相關的接口。從[監控系統](https://www.cnblogs.com/strick/p/14577054.html)中,就可以查到用戶使用時接口的請求和響應數據。
  若接口的請求正常,那么就需要深入到接口代碼中,查看相關的日志,通常會先瀏覽數據庫查詢語句以及內部接口的通信日志。
  在本地也可以查看到上述日志,但有個問題,有時候打開某個頁面會報錯,那是因為本地的數據庫沒有與測試或正式環境的同步。
  可能是有些字段缺失了,也可能是某張表缺失了,情況比較多。所以,最保險的是在測試或正式環境查看。
  在這兩個環境中,都有日志管理系統,但日志量是非常巨大的,若要查找某一條記錄,就得有非常精確的過濾條件,并且日志無法連續。
  這條日志下面的一條,很可能是另外一個接口留下的,因此,需要一個小工具能查看到指定接口的日志,解決日常開發的一個痛點。
## 一、搜集日志
**1)管理系統**
  首先需要將需要的日志搜集起來,我使用了一個比較簡單的方法。
  就是在啟動文件中,新增一個全局的logMessages變量,聲明為一個空數組。
~~~
global.logMessages = [];
~~~
  然后在MongoDB、MySQL、請求內部接口函數中,將他們的查詢語句日志和通信日志塞入logMessages數組內。
~~~
mongoose.set('debug', (...args) => {
logger.debug(...args);
global.logMessages.push(args);
});
new Sequelize(database, username, password, {
...options,
logging: (msg, benchmark) => {
logger.debug(msg, `${benchmark}ms`);
global.logMessages.push(msg);
}
});
~~~
  再新增一個中間件(Server項目基于KOA2),這個中間件的作用就是清空logMessages數組,免得將所有接口的日志都搜集起來,因為我只要一個接口的日志。
~~~
export default () => async (ctx, next) => {
//每次請求清空要讀取的日志數組
global.logMessages.length = 0;
await next();
};
~~~
  這么設計會有一個問題,服務器在處理多個請求(高并發)時,互相會影響各自的日志搜集,可能會出現這個接口日志中夾雜著另一個接口的日志,也可能是搜集到一半的日志就被清除了。
  當然,在測試環境,這種情況可以控制住。但是測試環境有時候數據不完整,邏輯可能走不下去,得上生產環境,那生產環境就有概率出現上述問題。
  后面將中間件去除,logMessages變量在一個接口中聲明,這個接口就是下面界面中點提交時請求的接口,能解決日志被無故清除的問題,但還是會出現串線的問題。
  生產環境暫時無解,好在還有一個預發環境,它使用的數據源和生產是相同的,只要保證代碼和生產同步,那么就能得到想要的日志列表。
**2)Web API**
  Web API是另一個接口服務,也需要監控其中的日志,但是它與之前的管理系統不同,它是一個獨立的服務。
  也就是說,我無法直接在管理系統中通過 global.logMessages 讀取日志。
  一開始是想將日志寫入緩存中,然后在管理系統中讀取緩存中的日志,不過這樣做不僅太繞,平添復雜度,而且日志寫法也會與之前的不一致。
  于是否決了此方案,改用一個中間件,日志的寫入和讀取與之前保持一致。不同點是在一個中間件中,將日志作為響應的參數返回。
  在下面的代碼中,當需要日志時,我會帶上一個特殊的參數:isLogMessages,只有這個參數存在時,才表示需要返回記錄。
~~~
export default () => async (ctx, next) => {
// 只有帶了特殊參數的請求,才會把接口日志帶上
const isLogMessages = ctx.query.isLogMessages || ctx.request.body.isLogMessages;
if(isLogMessages) {
global.logMessages = [];
}
await next();
if(isLogMessages) {
const { body } = ctx;
if(typeof body === 'string') {
ctx.body = {
data: body
};
}else {
ctx.body = {
...body
}
}
ctx.body.logMessages = global.logMessages;
delete global.logMessages;
}
~~~
## 二、界面
  在完成上述的日志搜集之后,就需要有一張操作界面(如圖所示),提升我們組自己的用戶體驗,借助之前封裝的[模板組件](https://github.com/pwstrick/shin-admin/blob/main/docs/template.md),搭建這樣一個頁面幾十分鐘就好了。
:-: 
  界面中包括API路徑、方法、項目和參數,其中參數可動態增加,點擊提交就會開始模擬請求接口,得到日志(如圖所示)和響應。
:-: 
  這樣一套操作之后,就能馬上知道接口內的細節,可幫助我們快速定位問題,也是一種降低時間成本的手段。
*****
> 原文出處:
[博客園-Node.js躬行記](https://www.cnblogs.com/strick/category/1688575.html)
[知乎專欄-Node.js躬行記](https://zhuanlan.zhihu.com/pwnode)
已建立一個微信前端交流群,如要進群,請先加微信號freedom20180706或掃描下面的二維碼,請求中需注明“看云加群”,在通過請求后就會把你拉進來。還搜集整理了一套[面試資料](https://github.com/pwstrick/daily),歡迎閱讀。

推薦一款前端監控腳本:[shin-monitor](https://github.com/pwstrick/shin-monitor),不僅能監控前端的錯誤、通信、打印等行為,還能計算各類性能參數,包括 FMP、LCP、FP 等。
- ES6
- 1、let和const
- 2、擴展運算符和剩余參數
- 3、解構
- 4、模板字面量
- 5、對象字面量的擴展
- 6、Symbol
- 7、代碼模塊化
- 8、數字
- 9、字符串
- 10、正則表達式
- 11、對象
- 12、數組
- 13、類型化數組
- 14、函數
- 15、箭頭函數和尾調用優化
- 16、Set
- 17、Map
- 18、迭代器
- 19、生成器
- 20、類
- 21、類的繼承
- 22、Promise
- 23、Promise的靜態方法和應用
- 24、代理和反射
- HTML
- 1、SVG
- 2、WebRTC基礎實踐
- 3、WebRTC視頻通話
- 4、Web音視頻基礎
- CSS進階
- 1、CSS基礎拾遺
- 2、偽類和偽元素
- 3、CSS屬性拾遺
- 4、浮動形狀
- 5、漸變
- 6、濾鏡
- 7、合成
- 8、裁剪和遮罩
- 9、網格布局
- 10、CSS方法論
- 11、管理后臺響應式改造
- React
- 1、函數式編程
- 2、JSX
- 3、組件
- 4、生命周期
- 5、React和DOM
- 6、事件
- 7、表單
- 8、樣式
- 9、組件通信
- 10、高階組件
- 11、Redux基礎
- 12、Redux中間件
- 13、React Router
- 14、測試框架
- 15、React Hooks
- 16、React源碼分析
- 利器
- 1、npm
- 2、Babel
- 3、webpack基礎
- 4、webpack進階
- 5、Git
- 6、Fiddler
- 7、自制腳手架
- 8、VSCode插件研發
- 9、WebView中的頁面調試方法
- Vue.js
- 1、數據綁定
- 2、指令
- 3、樣式和表單
- 4、組件
- 5、組件通信
- 6、內容分發
- 7、渲染函數和JSX
- 8、Vue Router
- 9、Vuex
- TypeScript
- 1、數據類型
- 2、接口
- 3、類
- 4、泛型
- 5、類型兼容性
- 6、高級類型
- 7、命名空間
- 8、裝飾器
- Node.js
- 1、Buffer、流和EventEmitter
- 2、文件系統和網絡
- 3、命令行工具
- 4、自建前端監控系統
- 5、定時任務的調試
- 6、自制短鏈系統
- 7、定時任務的進化史
- 8、通用接口
- 9、微前端實踐
- 10、接口日志查詢
- 11、E2E測試
- 12、BFF
- 13、MySQL歸檔
- 14、壓力測試
- 15、活動規則引擎
- 16、活動配置化
- 17、UmiJS版本升級
- 18、半吊子的可視化搭建系統
- 19、KOA源碼分析(上)
- 20、KOA源碼分析(下)
- 21、花10分鐘入門Node.js
- 22、Node環境升級日志
- 23、Worker threads
- 24、低代碼
- 25、Web自動化測試
- 26、接口攔截和頁面回放實驗
- 27、接口管理
- 28、Cypress自動化測試實踐
- 29、基于Electron的開播助手
- Node.js精進
- 1、模塊化
- 2、異步編程
- 3、流
- 4、事件觸發器
- 5、HTTP
- 6、文件
- 7、日志
- 8、錯誤處理
- 9、性能監控(上)
- 10、性能監控(下)
- 11、Socket.IO
- 12、ElasticSearch
- 監控系統
- 1、SDK
- 2、存儲和分析
- 3、性能監控
- 4、內存泄漏
- 5、小程序
- 6、較長的白屏時間
- 7、頁面奔潰
- 8、shin-monitor源碼分析
- 前端性能精進
- 1、優化方法論之測量
- 2、優化方法論之分析
- 3、瀏覽器之圖像
- 4、瀏覽器之呈現
- 5、瀏覽器之JavaScript
- 6、網絡
- 7、構建
- 前端體驗優化
- 1、概述
- 2、基建
- 3、后端
- 4、數據
- 5、后臺
- Web優化
- 1、CSS優化
- 2、JavaScript優化
- 3、圖像和網絡
- 4、用戶體驗和工具
- 5、網站優化
- 6、優化閉環實踐
- 數據結構與算法
- 1、鏈表
- 2、棧、隊列、散列表和位運算
- 3、二叉樹
- 4、二分查找
- 5、回溯算法
- 6、貪心算法
- 7、分治算法
- 8、動態規劃
- 程序員之路
- 大學
- 2011年
- 2012年
- 2013年
- 2014年
- 項目反思
- 前端基礎學習分享
- 2015年
- 再一次項目反思
- 然并卵
- PC網站CSS分享
- 2016年
- 制造自己的榫卯
- PrimusUI
- 2017年
- 工匠精神
- 2018年
- 2019年
- 前端學習之路分享
- 2020年
- 2021年
- 2022年
- 2023年
- 2024年
- 日志
- 2020