Express+Cloud Run日志优化：如何将console.log关联至请求日志？

一、如何将自定义日志与API请求日志关联 #

Cloud Run生成的请求日志自带唯一的trace标识，只要把这个trace ID嵌入到你的自定义日志中，就能在Cloud Logging里通过这个ID关联同一请求下的所有日志。具体实现分两步：

1. 提取请求的Trace ID #

Cloud Run会将Trace信息放在请求头X-Cloud-Trace-Context里，格式为TRACE_ID/SPAN_ID;o=TRACE_TRUE。你可以写一个Express中间件提取其中的Trace ID：

app.use((req, res, next) => {
  const traceHeader = req.headers['x-cloud-trace-context'];
  if (traceHeader) {
    // 拆分出Trace ID部分
    const [traceId] = traceHeader.split('/');
    req.traceId = traceId;
  }
  next();
});

2. 用日志库自动注入Trace ID #

推荐用结构化日志库（如Winston、Pino）替代原生console.log，它们能自动将Trace ID加入日志元数据，同时输出标准JSON格式（Cloud Logging会自动识别为jsonPayload）。

示例：用Winston实现

const winston = require('winston');

// 配置Winston，自动加入Trace ID和时间戳
const logger = winston.createLogger({
  level: 'info',
  format: winston.format.combine(
    winston.format.timestamp(),
    winston.format.json(),
    winston.format((info) => {
      info.traceId = info.traceId || 'unknown';
      return info;
    })()
  ),
  transports: [new winston.transports.Console()]
});

// 在路由中使用，传入当前请求的Trace ID
app.get('/api/test', (req, res) => {
  logger.info('处理测试请求', { traceId: req.traceId });
  res.send('OK');
});

示例：用Pino实现（更轻量）

const pino = require('pino');
const logger = pino();

// 中间件为每个请求创建带Trace ID的子日志实例
app.use((req, res, next) => {
  const traceHeader = req.headers['x-cloud-trace-context'];
  req.logger = traceHeader 
    ? logger.child({ traceId: traceHeader.split('/')[0] })
    : logger;
  next();
});

// 路由中直接使用子日志
app.get('/api/test', (req, res) => {
  req.logger.info('处理测试请求');
  res.send('OK');
});

之后在Cloud Logging里，只要搜索jsonPayload.traceId="你的TraceID"，就能找到该请求对应的所有自定义日志和系统请求日志。

二、Express + Cloud Run 日志最佳实践 #

1. 强制输出JSON格式日志：避免直接输出纯字符串，用日志库输出结构化JSON，Cloud Logging会自动解析为jsonPayload，方便筛选、查询和统计。
2. 严格区分日志级别：用info记录正常业务流程、warn记录潜在问题、error记录异常错误，不要用console.error输出非错误信息（会被Cloud Logging标记为错误级别）。
3. 不要在日志中存储敏感数据：比如用户密码、API密钥、银行卡号等，避免数据泄露。
4. 利用Cloud Logging过滤器：常用过滤规则示例：
   • 筛选Cloud Run所有日志：resource.type="cloud_run_revision"
   • 筛选特定Trace ID的日志：jsonPayload.traceId="xxx"
   • 筛选错误级别日志：severity="ERROR"
5. 避免冗余日志：不要重复记录系统已有的信息（比如请求路径、状态码，Cloud Run请求日志已经包含），只补充业务相关的自定义信息。

内容的提问来源于stack exchange，提问作者mdmb