如何在Google Cloud Run上正确配置使用GCP Profiler？

Cloud Run 未纳入 Node.js 版 Profiler 的默认免配置支持环境列表，直接调用无参profiler.start()时，Profiler无法自动完成鉴权、服务元数据识别，就会出现控制台无数据的情况，按以下步骤配置即可正常上报：

1. 配置服务账号权限 #

找到Cloud Run服务绑定的运行时服务账号，为其绑定roles/cloudprofiler.agent角色，该角色是Profiler上报性能数据的必需权限，缺失时上报请求会被GCP侧直接拦截。

2. 修改Profiler初始化代码，显式传入必填参数 #

不要使用无参启动方式，显式传入服务、项目相关参数，参考代码：

import * as profiler from "@google-cloud/profiler";

if (process.env.NODE_ENV === "production") {
  profiler.start({
    // 服务名，直接读取Cloud Run内置注入的K_SERVICE变量即可，无需手动硬编码
    service: process.env.K_SERVICE,
    // 可选，传入服务版本，直接读取Cloud Run内置的K_REVISION变量，方便多版本性能对比
    serviceVersion: process.env.K_REVISION,
    // 项目ID，读取Cloud Run内置的GCP_PROJECT变量，避免元数据识别失败
    projectId: process.env.GCP_PROJECT,
  });
}

上述K_SERVICE/K_REVISION/GCP_PROJECT都是Cloud Run运行时自动注入的环境变量，不需要用户手动在服务配置中添加

3. 排查常见异常点 #

• 确保使用的@google-cloud/profiler包版本不低于4.1.0，低版本存在Cloud Run运行时适配bug，无法正常初始化
• Profiler初始化是异步逻辑，不要在初始化执行前运行长时间阻塞事件循环的同步代码，否则会导致初始化中断
• 如果配置了Cloud Run VPC出口规则为「仅路由内部流量」，需要为cloudprofiler.googleapis.com配置私网访问权限，否则上报请求会被网络规则拦截
• Profiler上报存在1~3分钟的延迟，服务启动后等待5分钟再刷新控制台即可看到数据，不需要立刻排查问题

初始化成功后，Cloud Run服务日志中会出现Profiler启动成功的标记日志，没有对应日志时优先排查权限、网络和代码配置问题。

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